Package org.apache.coyote
Interface ProtocolHandler
- All Known Implementing Classes:
AbstractAjpProtocol
,AbstractHttp11JsseProtocol
,AbstractHttp11Protocol
,AbstractProtocol
,AjpAprProtocol
,AjpNio2Protocol
,AjpNioProtocol
,Http11AprProtocol
,Http11Nio2Protocol
,Http11NioProtocol
public interface ProtocolHandler
Abstract the protocol implementation, including threading, etc. This is the main interface to be implemented by a
coyote protocol. Adapter is the main interface to be implemented by a coyote servlet container.
- Author:
- Remy Maucherat, Costin Manolache
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionvoid
addSslHostConfig
(SSLHostConfig sslHostConfig) Add a new SSL configuration for a virtual host.void
addSslHostConfig
(SSLHostConfig sslHostConfig, boolean replace) Add a new SSL configuration for a virtual host.void
addUpgradeProtocol
(UpgradeProtocol upgradeProtocol) Add a new protocol for used by HTTP/1.1 upgrade or ALPN.long
awaitConnectionsClose
(long waitMillis) Wait for the client connections to the server to close gracefully.void
static ProtocolHandler
Create a new ProtocolHandler for the given protocol.void
destroy()
Destroy the protocol (optional).Find all configured SSL virtual host configurations which will be used by SNI.Return all configured upgrade protocols.Return the adapter associated with the protocol handler.default int
Some protocols, like AJP, have a packet length that shouldn't be exceeded, and this can be used to adjust the buffering used by the application layer.The executor, provide access to the underlying thread pool.default String
getId()
The default behavior is to identify connectors uniquely with address and port.Get the utility executor that should be used by the protocol handler.void
init()
Initialise the protocol.boolean
Deprecated.This method will be removed in Tomcat 10.1.x onwardsboolean
Does this ProtocolHandler support sendfile?void
pause()
Pause the protocol (optional).void
resume()
Resume the protocol (optional).void
setAdapter
(Adapter adapter) The adapter, used to call the connector.void
setExecutor
(Executor executor) Set the optional executor that will be used by the connector.void
setUtilityExecutor
(ScheduledExecutorService utilityExecutor) Set the utility executor that should be used by the protocol handler.void
start()
Start the protocol.void
stop()
Stop the protocol.
-
Method Details
-
getAdapter
Adapter getAdapter()Return the adapter associated with the protocol handler.- Returns:
- the adapter
-
setAdapter
The adapter, used to call the connector.- Parameters:
adapter
- The adapter to associate
-
getExecutor
Executor getExecutor()The executor, provide access to the underlying thread pool.- Returns:
- The executor used to process requests
-
setExecutor
Set the optional executor that will be used by the connector.- Parameters:
executor
- the executor
-
getUtilityExecutor
ScheduledExecutorService getUtilityExecutor()Get the utility executor that should be used by the protocol handler.- Returns:
- the executor
-
setUtilityExecutor
Set the utility executor that should be used by the protocol handler.- Parameters:
utilityExecutor
- the executor
-
init
Initialise the protocol.- Throws:
Exception
- If the protocol handler fails to initialise
-
start
Start the protocol.- Throws:
Exception
- If the protocol handler fails to start
-
pause
Pause the protocol (optional).- Throws:
Exception
- If the protocol handler fails to pause
-
resume
Resume the protocol (optional).- Throws:
Exception
- If the protocol handler fails to resume
-
stop
Stop the protocol.- Throws:
Exception
- If the protocol handler fails to stop
-
destroy
Destroy the protocol (optional).- Throws:
Exception
- If the protocol handler fails to destroy
-
closeServerSocketGraceful
void closeServerSocketGraceful() -
awaitConnectionsClose
long awaitConnectionsClose(long waitMillis) Wait for the client connections to the server to close gracefully. The method will return when all of the client connections have closed or the method has been waiting forwaitTimeMillis
.- Parameters:
waitMillis
- The maximum time to wait in milliseconds for the client connections to close.- Returns:
- The wait time, if any remaining when the method returned
-
isAprRequired
Deprecated.This method will be removed in Tomcat 10.1.x onwardsRequires APR/native library- Returns:
true
if this Protocol Handler requires the APR/native library, otherwisefalse
-
isSendfileSupported
boolean isSendfileSupported()Does this ProtocolHandler support sendfile?- Returns:
true
if this Protocol Handler supports sendfile, otherwisefalse
-
addSslHostConfig
Add a new SSL configuration for a virtual host.- Parameters:
sslHostConfig
- the configuration
-
addSslHostConfig
Add a new SSL configuration for a virtual host.- Parameters:
sslHostConfig
- the configurationreplace
- Iftrue
replacement of an existing configuration is permitted, otherwise any such attempted replacement will trigger an exception- Throws:
IllegalArgumentException
- If the host name is not valid or if a configuration has already been provided for that host and replacement is not allowed
-
findSslHostConfigs
SSLHostConfig[] findSslHostConfigs()Find all configured SSL virtual host configurations which will be used by SNI.- Returns:
- the configurations
-
addUpgradeProtocol
Add a new protocol for used by HTTP/1.1 upgrade or ALPN.- Parameters:
upgradeProtocol
- the protocol
-
findUpgradeProtocols
UpgradeProtocol[] findUpgradeProtocols()Return all configured upgrade protocols.- Returns:
- the protocols
-
getDesiredBufferSize
default int getDesiredBufferSize()Some protocols, like AJP, have a packet length that shouldn't be exceeded, and this can be used to adjust the buffering used by the application layer.- Returns:
- the desired buffer size, or -1 if not relevant
-
getId
The default behavior is to identify connectors uniquely with address and port. However, certain connectors are not using that and need some other identifier, which then can be used as a replacement.- Returns:
- the id
-
create
static ProtocolHandler create(String protocol, boolean apr) throws ClassNotFoundException, InstantiationException, IllegalAccessException, IllegalArgumentException, InvocationTargetException, NoSuchMethodException, SecurityException Create a new ProtocolHandler for the given protocol.- Parameters:
protocol
- the protocolapr
- iftrue
the APR protcol handler will be used- Returns:
- the newly instantiated protocol handler
- Throws:
ClassNotFoundException
- Specified protocol was not foundInstantiationException
- Specified protocol could not be instantiatedIllegalAccessException
- Exception occurredIllegalArgumentException
- Exception occurredInvocationTargetException
- Exception occurredNoSuchMethodException
- Exception occurredSecurityException
- Exception occurred
-