Links

- Docs Home
- Config Ref. Home

Top Level Elements

- Server
- Service

Connectors

- HTTP/1.1
- Warp
- AJP

Containers

- Context
- Engine
- Host

Nested Components

- Default Context
- Loader
- Logger
- Manager
- Realm
- Resources
- 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-2002, Apache Software Foundation