Links Docs Home Config Ref. Home Top Level Elements Server Service Connectors HTTP/1.1 Warp Containers Context Engine Host Nested Components Default Context Loader Logger Manager Realm Valve | # The WARP Connector
Introduction
The WARP Connector element represents a Connector component that communicates with a web connector via the `WARP` protocol. This is used for cases where you wish to invisibly integrate Tomcat 4 into an existing (or new) Apache installation, and you want Apache to handle the static content contained in the web application, and/or utilize Apache's SSL processing. In many application environments, this will result in better overall performance than running your applications under Tomcat stand-alone using the HTTP/1.1 Connector. However, the only way to know for sure whether it will provide better performance for your application is to try it both ways. FIXME - general description of what happens at server startup time when you have the WARP Connector configured.
Attributes
> Common Attributes
> > All implementations of Connector support the following attributes:
> > Attribute | Description
> > --- | ---
> > `className` | Java class name of the implementation to use. This class must implement the `org.apache.catalina.Connector` interface. You must specify the standard value defined below.
> > `enableLookups` | Set to `true` if you want calls to `request.getRemoteHost()` to perform DNS lookups in order to return the actual host name of the remote client. Set to `false` to skip the DNS lookup and return the IP address in String form instead (thereby improving performance). By default, DNS lookups are enabled.
> > `redirectPort` | If this Connector is supporting non-SSL requests, and a request is received for which a matching `<security-constraint>` requires SSL transport, Catalina will automatically redirect the request to the port number specified here.
> > `scheme` | Set this attribute to the name of the protocol you wish to have returned by calls to `request.getScheme()`. For example, you would set this attribute to "`https`" for an SSL Connector. The default value is "`http`". See SSL Support for more information.
> > `secure` | Set this attribute to `true` if you wish to have calls to `request.isSecure()` to return `true` for requests received by this Connector (you would want this on an SSL Connector). The default value is `false`.
> FIXME - Update the above descriptions for anything that the WARP Connector delegates to Apache.
> Standard Implementation
> > The standard implementation of WARP Connector is org.apache.catalina.connector.warp.WarpConnector. It supports the following additional attributes (in addition to the common attributes listed above):
> > Attribute | Description
> > --- | ---
> FIXME - Document any additional configuration attributes supported by the WARP connector.
Nested Components
FIXME - Document any use of a nested `Factory` element for communicating with `mod_webapp` over SSL.
Special Features
FIXME - Document any special features supported by the WARP Connector.
Copyright © 1999-2001, Apache Software Foundation