public class Connector extends LifecycleMBeanBase
Lifecycle.SingleUse
Modifier and Type | Field and Description |
---|---|
protected Adapter |
adapter
Coyote adapter.
|
protected boolean |
allowTrace
Do we allow TRACE ?
|
protected long |
asyncTimeout
Default timeout for asynchronous requests (ms).
|
protected boolean |
enableLookups
The "enable DNS lookups" flag for this Connector.
|
protected int |
maxParameterCount
The maximum number of parameters (GET plus POST) which will be
automatically parsed by the container. 10000 by default.
|
protected int |
maxPostSize
Maximum size of a POST which will be automatically parsed by the
container. 2MB by default.
|
protected int |
maxSavePostSize
Maximum size of a POST which will be saved by the container
during authentication. 4kB by default
|
protected java.lang.String |
parseBodyMethods
Comma-separated list of HTTP methods that will be parsed according
to POST-style rules for application/x-www-form-urlencoded request bodies.
|
protected java.util.HashSet<java.lang.String> |
parseBodyMethodsSet
A Set of methods determined by
parseBodyMethods . |
protected int |
port
The port number on which we listen for requests.
|
protected ProtocolHandler |
protocolHandler
Coyote protocol handler.
|
protected java.lang.String |
protocolHandlerClassName
Coyote Protocol handler class name.
|
protected java.lang.String |
proxyName
The server name to which we should pretend requests to this Connector
were directed.
|
protected int |
proxyPort
The server port to which we should pretend requests to this Connector
were directed.
|
static boolean |
RECYCLE_FACADES
Alternate flag to enable recycling of facades.
|
protected int |
redirectPort
The redirect port for non-SSL to SSL redirects.
|
protected static java.util.HashMap<java.lang.String,java.lang.String> |
replacements |
protected java.lang.String |
scheme
The request scheme that will be set on all requests received
through this connector.
|
protected boolean |
secure
The secure connection flag that will be set on all requests received
through this connector.
|
protected Service |
service
The
Service we are associated with (if any). |
protected static StringManager |
sm
The string manager for this package.
|
protected java.lang.String |
URIEncoding
URI encoding.
|
protected java.lang.String |
URIEncodingLower |
protected boolean |
useBodyEncodingForURI
URI encoding as body.
|
protected boolean |
useIPVHosts
Flag to use IP-based virtual hosting.
|
protected boolean |
xpoweredBy |
mserver
AFTER_DESTROY_EVENT, AFTER_INIT_EVENT, AFTER_START_EVENT, AFTER_STOP_EVENT, BEFORE_DESTROY_EVENT, BEFORE_INIT_EVENT, BEFORE_START_EVENT, BEFORE_STOP_EVENT, CONFIGURE_START_EVENT, CONFIGURE_STOP_EVENT, PERIODIC_EVENT, START_EVENT, STOP_EVENT
Constructor and Description |
---|
Connector() |
Connector(java.lang.String protocol) |
Modifier and Type | Method and Description |
---|---|
protected java.lang.String |
createObjectNameKeyProperties(java.lang.String type) |
Request |
createRequest()
Create (or allocate) and return a Request object suitable for
specifying the contents of a Request to the responsible Container.
|
Response |
createResponse()
Create (or allocate) and return a Response object suitable for
receiving the contents of a Response from the responsible Container.
|
protected void |
destroyInternal()
Sub-classes wishing to perform additional clean-up should override this
method, ensuring that super.destroyInternal() is the last call in the
overriding method.
|
boolean |
getAllowTrace()
True if the TRACE method is allowed.
|
long |
getAsyncTimeout()
Return the default timeout for async requests in ms.
|
java.lang.Object |
getAttribute(java.lang.String name)
Return a configured property.
|
protected java.lang.String |
getDomainInternal()
Method implemented by sub-classes to identify the domain in which MBeans
should be registered.
|
boolean |
getEnableLookups()
Return the "enable DNS lookups" flag.
|
java.lang.String |
getExecutorName() |
int |
getLocalPort()
Return the port number on which this connector is listening to requests.
|
int |
getMaxHeaderCount()
Return the maximum number of headers that are allowed by the container.
|
int |
getMaxParameterCount()
Return the maximum number of parameters (GET plus POST) that will be
automatically parsed by the container.
|
int |
getMaxPostSize()
Return the maximum size of a POST which will be automatically
parsed by the container.
|
int |
getMaxSavePostSize()
Return the maximum size of a POST which will be saved by the container
during authentication.
|
protected java.lang.String |
getObjectNameKeyProperties()
Allow sub-classes to specify the key properties component of the
ObjectName that will be used to register this component. |
java.lang.String |
getParseBodyMethods() |
int |
getPort()
Return the port number on which this connector is configured to listen
for requests.
|
java.lang.Object |
getProperty(java.lang.String name)
Return a configured property.
|
java.lang.String |
getProtocol()
Return the Coyote protocol handler in use.
|
ProtocolHandler |
getProtocolHandler()
Return the protocol handler associated with the connector.
|
java.lang.String |
getProtocolHandlerClassName()
Return the class name of the Coyote protocol handler in use.
|
java.lang.String |
getProxyName()
Return the proxy server name for this Connector.
|
int |
getProxyPort()
Return the proxy server port for this Connector.
|
int |
getRedirectPort()
Return the port number to which a request should be redirected if
it comes in on a non-SSL port and is subject to a security constraint
with a transport guarantee that requires SSL.
|
java.lang.String |
getScheme()
Return the scheme that will be assigned to requests received
through this connector.
|
boolean |
getSecure()
Return the secure connection flag that will be assigned to requests
received through this connector.
|
Service |
getService()
Return the
Service with which we are associated (if any). |
java.lang.String |
getURIEncoding()
Return the character encoding to be used for the URI using the original
case.
|
java.lang.String |
getURIEncodingLower()
Return the character encoding to be used for the URI using lower case.
|
boolean |
getUseBodyEncodingForURI()
Return the true if the entity body encoding should be used for the URI.
|
boolean |
getUseIPVHosts()
Test if IP-based virtual hosting is enabled.
|
boolean |
getXpoweredBy()
Indicates whether the generation of an X-Powered-By response header for
servlet-generated responses is enabled or disabled for this Connector.
|
protected void |
initInternal()
Sub-classes wishing to perform additional initialization should override
this method, ensuring that super.initInternal() is the first call in the
overriding method.
|
protected boolean |
isParseBodyMethod(java.lang.String method) |
void |
pause()
Pause the connector.
|
void |
resume()
Pause the connector.
|
void |
setAllowTrace(boolean allowTrace)
Set the allowTrace flag, to disable or enable the TRACE HTTP method.
|
void |
setAsyncTimeout(long asyncTimeout)
Set the default timeout for async requests.
|
void |
setAttribute(java.lang.String name,
java.lang.Object value)
Set a configured property.
|
void |
setEnableLookups(boolean enableLookups)
Set the "enable DNS lookups" flag.
|
void |
setMaxHeaderCount(int maxHeaderCount)
Set the maximum number of headers in a request that are allowed by the
container.
|
void |
setMaxParameterCount(int maxParameterCount)
Set the maximum number of parameters (GET plus POST) that will be
automatically parsed by the container.
|
void |
setMaxPostSize(int maxPostSize)
Set the maximum size of a POST which will be automatically
parsed by the container.
|
void |
setMaxSavePostSize(int maxSavePostSize)
Set the maximum size of a POST which will be saved by the container
during authentication.
|
void |
setParseBodyMethods(java.lang.String methods) |
void |
setPort(int port)
Set the port number on which we listen for requests.
|
boolean |
setProperty(java.lang.String name,
java.lang.String value)
Set a configured property.
|
void |
setProtocol(java.lang.String protocol)
Set the Coyote protocol which will be used by the connector.
|
void |
setProtocolHandlerClassName(java.lang.String protocolHandlerClassName)
Set the class name of the Coyote protocol handler which will be used
by the connector.
|
void |
setProxyName(java.lang.String proxyName)
Set the proxy server name for this Connector.
|
void |
setProxyPort(int proxyPort)
Set the proxy server port for this Connector.
|
void |
setRedirectPort(int redirectPort)
Set the redirect port number.
|
void |
setScheme(java.lang.String scheme)
Set the scheme that will be assigned to requests received through
this connector.
|
void |
setSecure(boolean secure)
Set the secure connection flag that will be assigned to requests
received through this connector.
|
void |
setService(Service service)
Set the
Service with which we are associated (if any). |
void |
setURIEncoding(java.lang.String URIEncoding)
Set the URI encoding to be used for the URI.
|
void |
setUseBodyEncodingForURI(boolean useBodyEncodingForURI)
Set if the entity body encoding should be used for the URI.
|
void |
setUseIPVHosts(boolean useIPVHosts)
Enable the use of IP-based virtual hosting.
|
void |
setXpoweredBy(boolean xpoweredBy)
Enables or disables the generation of an X-Powered-By header (with value
Servlet/2.5) for all servlet-generated responses returned by this
Connector.
|
protected void |
startInternal()
Begin processing requests via this Connector.
|
protected void |
stopInternal()
Terminate processing requests via this Connector.
|
java.lang.String |
toString()
Provide a useful toString() implementation as it may be used when logging
Lifecycle errors to identify the component.
|
getDomain, getObjectName, postDeregister, postRegister, preDeregister, preRegister, register, setDomain, unregister
addLifecycleListener, destroy, findLifecycleListeners, fireLifecycleEvent, getState, getStateName, init, removeLifecycleListener, setState, setState, start, stop
public static final boolean RECYCLE_FACADES
protected Service service
Service
we are associated with (if any).protected boolean allowTrace
protected long asyncTimeout
protected boolean enableLookups
protected boolean xpoweredBy
protected int port
protected java.lang.String proxyName
Host
header is used.protected int proxyPort
port
property is used.protected int redirectPort
protected java.lang.String scheme
protected boolean secure
protected static final StringManager sm
protected int maxParameterCount
protected int maxPostSize
protected int maxSavePostSize
protected java.lang.String parseBodyMethods
protected java.util.HashSet<java.lang.String> parseBodyMethodsSet
parseBodyMethods
.protected boolean useIPVHosts
protected java.lang.String protocolHandlerClassName
protected final ProtocolHandler protocolHandler
protected Adapter adapter
protected java.lang.String URIEncoding
protected java.lang.String URIEncodingLower
protected boolean useBodyEncodingForURI
protected static final java.util.HashMap<java.lang.String,java.lang.String> replacements
public Connector()
public Connector(java.lang.String protocol)
public java.lang.Object getProperty(java.lang.String name)
public boolean setProperty(java.lang.String name, java.lang.String value)
public java.lang.Object getAttribute(java.lang.String name)
public void setAttribute(java.lang.String name, java.lang.Object value)
public Service getService()
Service
with which we are associated (if any).public void setService(Service service)
Service
with which we are associated (if any).service
- The service that owns this Enginepublic boolean getAllowTrace()
public void setAllowTrace(boolean allowTrace)
allowTrace
- The new allowTrace flagpublic long getAsyncTimeout()
public void setAsyncTimeout(long asyncTimeout)
asyncTimeout
- The new timeout in ms.public boolean getEnableLookups()
public void setEnableLookups(boolean enableLookups)
enableLookups
- The new "enable DNS lookups" flag valuepublic int getMaxHeaderCount()
public void setMaxHeaderCount(int maxHeaderCount)
maxHeaderCount
- The new settingpublic int getMaxParameterCount()
public void setMaxParameterCount(int maxParameterCount)
maxParameterCount
- The new settingpublic int getMaxPostSize()
public void setMaxPostSize(int maxPostSize)
maxPostSize
- The new maximum size in bytes of a POST which will
be automatically parsed by the containerpublic int getMaxSavePostSize()
public void setMaxSavePostSize(int maxSavePostSize)
maxSavePostSize
- The new maximum size in bytes of a POST which will
be saved by the container during authentication.public java.lang.String getParseBodyMethods()
public void setParseBodyMethods(java.lang.String methods)
protected boolean isParseBodyMethod(java.lang.String method)
public int getPort()
public void setPort(int port)
port
- The new port numberpublic int getLocalPort()
getPort()
of zero is used then this method
will report the actual port bound.public java.lang.String getProtocol()
public void setProtocol(java.lang.String protocol)
protocol
- The Coyote protocol namepublic java.lang.String getProtocolHandlerClassName()
public void setProtocolHandlerClassName(java.lang.String protocolHandlerClassName)
protocolHandlerClassName
- The new class namepublic ProtocolHandler getProtocolHandler()
public java.lang.String getProxyName()
public void setProxyName(java.lang.String proxyName)
proxyName
- The new proxy server namepublic int getProxyPort()
public void setProxyPort(int proxyPort)
proxyPort
- The new proxy server portpublic int getRedirectPort()
public void setRedirectPort(int redirectPort)
redirectPort
- The redirect port number (non-SSL to SSL)public java.lang.String getScheme()
public void setScheme(java.lang.String scheme)
scheme
- The new schemepublic boolean getSecure()
public void setSecure(boolean secure)
secure
- The new secure connection flagpublic java.lang.String getURIEncoding()
public java.lang.String getURIEncodingLower()
public void setURIEncoding(java.lang.String URIEncoding)
URIEncoding
- The new URI character encoding.public boolean getUseBodyEncodingForURI()
public void setUseBodyEncodingForURI(boolean useBodyEncodingForURI)
useBodyEncodingForURI
- The new value for the flag.public boolean getXpoweredBy()
public void setXpoweredBy(boolean xpoweredBy)
xpoweredBy
- true if generation of X-Powered-By response header is
to be enabled, false otherwisepublic void setUseIPVHosts(boolean useIPVHosts)
useIPVHosts
- true
if Hosts are identified by IP,
false
if Hosts are identified by name.public boolean getUseIPVHosts()
public java.lang.String getExecutorName()
public Request createRequest()
public Response createResponse()
protected java.lang.String createObjectNameKeyProperties(java.lang.String type)
public void pause()
public void resume()
protected void initInternal() throws LifecycleException
LifecycleMBeanBase
initInternal
in class LifecycleMBeanBase
LifecycleException
protected void startInternal() throws LifecycleException
startInternal
in class LifecycleBase
LifecycleException
- if a fatal startup error occursprotected void stopInternal() throws LifecycleException
stopInternal
in class LifecycleBase
LifecycleException
- if a fatal shutdown error occursprotected void destroyInternal() throws LifecycleException
LifecycleMBeanBase
destroyInternal
in class LifecycleMBeanBase
LifecycleException
public java.lang.String toString()
toString
in class java.lang.Object
protected java.lang.String getDomainInternal()
LifecycleMBeanBase
getDomainInternal
in class LifecycleMBeanBase
protected java.lang.String getObjectNameKeyProperties()
LifecycleMBeanBase
ObjectName
that will be used to register this component.getObjectNameKeyProperties
in class LifecycleMBeanBase
ObjectName
Copyright © 2000-2018 Apache Software Foundation. All Rights Reserved.