Package org.apache.tomcat.util.net
Class AbstractEndpoint<S,U>
- java.lang.Object
-
- org.apache.tomcat.util.net.AbstractEndpoint<S,U>
-
- Type Parameters:
S- The type used by the socket wrapper associated with this endpoint. May be the same as U.U- The type of the underlying socket used by this endpoint. May be the same as S.
- Direct Known Subclasses:
AbstractJsseEndpoint,AprEndpoint
public abstract class AbstractEndpoint<S,U> extends Object
- Author:
- Mladen Turk, Remy Maucherat
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description protected static classAbstractEndpoint.BindStatestatic interfaceAbstractEndpoint.Handler<S>
-
Field Summary
Fields Modifier and Type Field Description protected Acceptor<U>acceptorThread used to accept new connections and pass them to worker threads.protected intacceptorThreadCountAcceptor thread count.protected intacceptorThreadPriorityPriority of the acceptor threads.protected HashMap<String,Object>attributesAttributes provide a way for configuration to be passed to sub-components without theProtocolHandlerbeing aware of the properties available on those sub-components.protected Map<U,SocketWrapperBase<S>>connectionsMap holding all current connections keyed with the sockets.protected booleaninternalExecutorAre we using an internal executorprotected List<String>negotiableProtocolsprotected booleanpausedWill be set to true whenever the endpoint is paused.protected SynchronizedStack<SocketProcessorBase<S>>processorCacheCache for SocketProcessor objectsprotected booleanrunningRunning state of the endpoint.protected static StringManagersmprotected SocketPropertiessocketPropertiesSocket propertiesprotected ConcurrentMap<String,SSLHostConfig>sslHostConfigsprotected intthreadPriorityPriority of the worker threads.
-
Constructor Summary
Constructors Constructor Description AbstractEndpoint()
-
Method Summary
All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description voidaddNegotiatedProtocol(String negotiableProtocol)voidaddSslHostConfig(SSLHostConfig sslHostConfig)Add the given SSL Host configuration.voidaddSslHostConfig(SSLHostConfig sslHostConfig, boolean replace)Add the given SSL Host configuration, optionally replacing the existing configuration for the given host.longawaitConnectionsClose(long waitMillis)Wait for the client connections to the server to close gracefully.abstract voidbind()voidcloseServerSocketGraceful()protected voidcloseSocket(U socket)Close the socket when the connection has to be immediately closed when an error occurs while configuring the accepted socket or trying to dispatch it for processing.protected longcountDownConnection()protected voidcountUpOrAwaitConnection()voidcreateExecutor()protected abstract SocketProcessorBase<S>createSocketProcessor(SocketWrapperBase<S> socketWrapper, SocketEvent event)protected abstract voidcreateSSLContext(SSLHostConfig sslHostConfig)Create the SSLContextfor the the given SSLHostConfig.voiddestroy()protected abstract voiddestroySocket(U socket)Close the socket.protected voiddestroySsl()protected abstract voiddoCloseServerSocket()Actually close the server socket but don't perform any other clean-up.SSLHostConfig[]findSslHostConfigs()intgetAcceptCount()intgetAcceptorThreadPriority()InetAddressgetAddress()ObjectgetAttribute(String key)Used by sub-components to retrieve configuration information.booleangetBindOnInit()protected AbstractEndpoint.BindStategetBindState()longgetConnectionCount()Return the current count of connections handled by this endpoint, if the connections are counted (which happens when the maximum count of connections is limited), or-1if they are not.intgetConnectionLinger()Socket linger.Set<SocketWrapperBase<S>>getConnections()Get a set with the current open connections.intgetConnectionTimeout()Socket timeout.intgetCurrentThreadCount()Return the amount of threads that are managed by the pool.intgetCurrentThreadsBusy()Return the amount of threads that are in usebooleangetDaemon()StringgetDefaultSSLHostConfigName()protected booleangetDeferAccept()StringgetDomain()ExecutorgetExecutor()longgetExecutorTerminationTimeoutMillis()AbstractEndpoint.Handler<S>getHandler()StringgetId()The default behavior is to identify connectors uniquely with address and port.intgetKeepAliveTimeout()protected abstract InetSocketAddressgetLocalAddress()Obtain the network address the server socket is bound to.intgetLocalPort()protected abstract LoggetLog()intgetMaxConnections()intgetMaxKeepAliveRequests()intgetMaxThreads()intgetMinSpareThreads()StringgetName()intgetPort()intgetPortOffset()intgetPortWithOffset()StringgetProperty(String name)SocketPropertiesgetSocketProperties()protected SSLHostConfiggetSSLHostConfig(String sniHostName)Look up the SSLHostConfig for the given host name.booleangetTcpNoDelay()Socket TCP no delay.intgetThreadPriority()booleangetUseAsyncIO()booleangetUseSendfile()ScheduledExecutorServicegetUtilityExecutor()booleanhasNegotiableProtocols()voidinit()protected LimitLatchinitializeConnectionLatch()abstract booleanisAlpnSupported()Identifies if the endpoint supports ALPN.booleanisPaused()booleanisRunning()booleanisSSLEnabled()voidpause()Pause the endpoint, which will stop it accepting new connections and unlock the acceptor.booleanprocessSocket(SocketWrapperBase<S> socketWrapper, SocketEvent event, boolean dispatch)Process the given SocketWrapper with the given status.protected voidreleaseSSLContext(SSLHostConfig sslHostConfig)Release the SSLContext, if any, associated with the SSLHostConfig.voidreloadSslHostConfig(String hostName)Re-read the configuration files for the SSL host and replace the existing SSL configuration with the updated settings.voidreloadSslHostConfigs()Re-read the configuration files for all SSL hosts and replace the existing SSL configuration with the updated settings.SSLHostConfigremoveSslHostConfig(String hostName)Removes the SSL host configuration for the given host name, if such a configuration exists.voidresume()Resume the endpoint, which will make it start accepting new connections again.protected abstract UserverSocketAccept()voidsetAcceptCount(int acceptCount)voidsetAcceptorThreadPriority(int acceptorThreadPriority)voidsetAddress(InetAddress address)voidsetAttribute(String name, Object value)Generic property setter called when a property for which a specific setter already exists within theProtocolHandlerneeds to be made available to sub-components.voidsetBindOnInit(boolean b)voidsetConnectionLinger(int connectionLinger)voidsetConnectionTimeout(int soTimeout)voidsetDaemon(boolean b)voidsetDefaultSSLHostConfigName(String defaultSSLHostConfigName)voidsetDomain(String domain)voidsetExecutor(Executor executor)voidsetExecutorTerminationTimeoutMillis(long executorTerminationTimeoutMillis)voidsetHandler(AbstractEndpoint.Handler<S> handler)voidsetKeepAliveTimeout(int keepAliveTimeout)voidsetMaxConnections(int maxCon)voidsetMaxKeepAliveRequests(int maxKeepAliveRequests)voidsetMaxThreads(int maxThreads)voidsetMinSpareThreads(int minSpareThreads)voidsetName(String name)voidsetPort(int port)voidsetPortOffset(int portOffset)booleansetProperty(String name, String value)protected abstract booleansetSocketOptions(U socket)voidsetSSLEnabled(boolean SSLEnabled)voidsetTcpNoDelay(boolean tcpNoDelay)voidsetThreadPriority(int threadPriority)voidsetUseAsyncIO(boolean useAsyncIO)voidsetUseSendfile(boolean useSendfile)voidsetUtilityExecutor(ScheduledExecutorService utilityExecutor)voidshutdownExecutor()voidstart()protected voidstartAcceptorThread()abstract voidstartInternal()voidstop()abstract voidstopInternal()static longtoTimeout(long timeout)abstract voidunbind()protected voidunlockAccept()Unlock the server socket acceptor threads using bogus connections.
-
-
-
Field Detail
-
sm
protected static final StringManager sm
-
running
protected volatile boolean running
Running state of the endpoint.
-
paused
protected volatile boolean paused
Will be set to true whenever the endpoint is paused.
-
internalExecutor
protected volatile boolean internalExecutor
Are we using an internal executor
-
socketProperties
protected final SocketProperties socketProperties
Socket properties
-
acceptor
protected Acceptor<U> acceptor
Thread used to accept new connections and pass them to worker threads.
-
processorCache
protected SynchronizedStack<SocketProcessorBase<S>> processorCache
Cache for SocketProcessor objects
-
connections
protected Map<U,SocketWrapperBase<S>> connections
Map holding all current connections keyed with the sockets.
-
sslHostConfigs
protected ConcurrentMap<String,SSLHostConfig> sslHostConfigs
-
acceptorThreadCount
protected int acceptorThreadCount
Acceptor thread count.
-
acceptorThreadPriority
protected int acceptorThreadPriority
Priority of the acceptor threads.
-
threadPriority
protected int threadPriority
Priority of the worker threads.
-
attributes
protected HashMap<String,Object> attributes
Attributes provide a way for configuration to be passed to sub-components without theProtocolHandlerbeing aware of the properties available on those sub-components.
-
-
Method Detail
-
toTimeout
public static long toTimeout(long timeout)
-
getSocketProperties
public SocketProperties getSocketProperties()
-
getConnections
public Set<SocketWrapperBase<S>> getConnections()
Get a set with the current open connections.- Returns:
- A set with the open socket wrappers
-
getDefaultSSLHostConfigName
public String getDefaultSSLHostConfigName()
- Returns:
- The host name for the default SSL configuration for this endpoint - always in lower case.
-
setDefaultSSLHostConfigName
public void setDefaultSSLHostConfigName(String defaultSSLHostConfigName)
-
addSslHostConfig
public void addSslHostConfig(SSLHostConfig sslHostConfig) throws IllegalArgumentException
Add the given SSL Host configuration.- Parameters:
sslHostConfig- The configuration to add- Throws:
IllegalArgumentException- If the host name is not valid or if a configuration has already been provided for that host
-
addSslHostConfig
public void addSslHostConfig(SSLHostConfig sslHostConfig, boolean replace) throws IllegalArgumentException
Add the given SSL Host configuration, optionally replacing the existing configuration for the given host.- Parameters:
sslHostConfig- The configuration to addreplace- Iftruereplacement 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
-
removeSslHostConfig
public SSLHostConfig removeSslHostConfig(String hostName)
Removes the SSL host configuration for the given host name, if such a configuration exists.- Parameters:
hostName- The host name associated with the SSL host configuration to remove- Returns:
- The SSL host configuration that was removed, if any
-
reloadSslHostConfig
public void reloadSslHostConfig(String hostName)
Re-read the configuration files for the SSL host and replace the existing SSL configuration with the updated settings. Note this replacement will happen even if the settings remain unchanged.- Parameters:
hostName- The SSL host for which the configuration should be reloaded. This must match a current SSL host
-
reloadSslHostConfigs
public void reloadSslHostConfigs()
Re-read the configuration files for all SSL hosts and replace the existing SSL configuration with the updated settings. Note this replacement will happen even if the settings remain unchanged.
-
findSslHostConfigs
public SSLHostConfig[] findSslHostConfigs()
-
createSSLContext
protected abstract void createSSLContext(SSLHostConfig sslHostConfig) throws Exception
Create the SSLContextfor the the given SSLHostConfig.- Parameters:
sslHostConfig- The SSLHostConfig for which the SSLContext should be created- Throws:
Exception- If the SSLContext cannot be created for the given SSLHostConfig
-
releaseSSLContext
protected void releaseSSLContext(SSLHostConfig sslHostConfig)
Release the SSLContext, if any, associated with the SSLHostConfig.- Parameters:
sslHostConfig- The SSLHostConfig for which the SSLContext should be released
-
getSSLHostConfig
protected SSLHostConfig getSSLHostConfig(String sniHostName)
Look up the SSLHostConfig for the given host name. Lookup order is:- exact match
- wild card match
- default SSLHostConfig
- Parameters:
sniHostName- Host name - must be in lower case- Returns:
- The SSLHostConfig for the given host name.
-
getUseSendfile
public boolean getUseSendfile()
-
setUseSendfile
public void setUseSendfile(boolean useSendfile)
-
getExecutorTerminationTimeoutMillis
public long getExecutorTerminationTimeoutMillis()
-
setExecutorTerminationTimeoutMillis
public void setExecutorTerminationTimeoutMillis(long executorTerminationTimeoutMillis)
-
setAcceptorThreadPriority
public void setAcceptorThreadPriority(int acceptorThreadPriority)
-
getAcceptorThreadPriority
public int getAcceptorThreadPriority()
-
setMaxConnections
public void setMaxConnections(int maxCon)
-
getMaxConnections
public int getMaxConnections()
-
getConnectionCount
public long getConnectionCount()
Return the current count of connections handled by this endpoint, if the connections are counted (which happens when the maximum count of connections is limited), or-1if they are not. This property is added here so that this value can be inspected through JMX. It is visible on "ThreadPool" MBean.The count is incremented by the Acceptor before it tries to accept a new connection. Until the limit is reached and thus the count cannot be incremented, this value is more by 1 (the count of acceptors) than the actual count of connections that are being served.
- Returns:
- The count
-
setExecutor
public void setExecutor(Executor executor)
-
getExecutor
public Executor getExecutor()
-
setUtilityExecutor
public void setUtilityExecutor(ScheduledExecutorService utilityExecutor)
-
getUtilityExecutor
public ScheduledExecutorService getUtilityExecutor()
-
getPort
public int getPort()
-
setPort
public void setPort(int port)
-
getPortOffset
public int getPortOffset()
-
setPortOffset
public void setPortOffset(int portOffset)
-
getPortWithOffset
public int getPortWithOffset()
-
getLocalPort
public final int getLocalPort()
-
getAddress
public InetAddress getAddress()
-
setAddress
public void setAddress(InetAddress address)
-
getLocalAddress
protected abstract InetSocketAddress getLocalAddress() throws IOException
Obtain the network address the server socket is bound to. This primarily exists to enable the correct address to be used when unlocking the server socket since it removes the guess-work involved if no address is specifically set.- Returns:
- The network address that the server socket is listening on or null if the server socket is not currently bound.
- Throws:
IOException- If there is a problem determining the currently bound socket
-
setAcceptCount
public void setAcceptCount(int acceptCount)
-
getAcceptCount
public int getAcceptCount()
-
getBindOnInit
public boolean getBindOnInit()
-
setBindOnInit
public void setBindOnInit(boolean b)
-
getBindState
protected AbstractEndpoint.BindState getBindState()
-
getKeepAliveTimeout
public int getKeepAliveTimeout()
-
setKeepAliveTimeout
public void setKeepAliveTimeout(int keepAliveTimeout)
-
getTcpNoDelay
public boolean getTcpNoDelay()
Socket TCP no delay.- Returns:
- The current TCP no delay setting for sockets created by this endpoint
-
setTcpNoDelay
public void setTcpNoDelay(boolean tcpNoDelay)
-
getConnectionLinger
public int getConnectionLinger()
Socket linger.- Returns:
- The current socket linger time for sockets created by this endpoint
-
setConnectionLinger
public void setConnectionLinger(int connectionLinger)
-
getConnectionTimeout
public int getConnectionTimeout()
Socket timeout.- Returns:
- The current socket timeout for sockets created by this endpoint
-
setConnectionTimeout
public void setConnectionTimeout(int soTimeout)
-
isSSLEnabled
public boolean isSSLEnabled()
-
setSSLEnabled
public void setSSLEnabled(boolean SSLEnabled)
-
isAlpnSupported
public abstract boolean isAlpnSupported()
Identifies if the endpoint supports ALPN. Note that a return value oftrueimplies thatisSSLEnabled()will also returntrue.- Returns:
trueif the endpoint supports ALPN in its current configuration, otherwisefalse.
-
setMinSpareThreads
public void setMinSpareThreads(int minSpareThreads)
-
getMinSpareThreads
public int getMinSpareThreads()
-
setMaxThreads
public void setMaxThreads(int maxThreads)
-
getMaxThreads
public int getMaxThreads()
-
setThreadPriority
public void setThreadPriority(int threadPriority)
-
getThreadPriority
public int getThreadPriority()
-
getMaxKeepAliveRequests
public int getMaxKeepAliveRequests()
-
setMaxKeepAliveRequests
public void setMaxKeepAliveRequests(int maxKeepAliveRequests)
-
setName
public void setName(String name)
-
getName
public String getName()
-
setDomain
public void setDomain(String domain)
-
getDomain
public String getDomain()
-
setDaemon
public void setDaemon(boolean b)
-
getDaemon
public boolean getDaemon()
-
setUseAsyncIO
public void setUseAsyncIO(boolean useAsyncIO)
-
getUseAsyncIO
public boolean getUseAsyncIO()
-
getDeferAccept
protected boolean getDeferAccept()
-
getId
public String 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
-
addNegotiatedProtocol
public void addNegotiatedProtocol(String negotiableProtocol)
-
hasNegotiableProtocols
public boolean hasNegotiableProtocols()
-
setHandler
public void setHandler(AbstractEndpoint.Handler<S> handler)
-
getHandler
public AbstractEndpoint.Handler<S> getHandler()
-
setAttribute
public void setAttribute(String name, Object value)
Generic property setter called when a property for which a specific setter already exists within theProtocolHandlerneeds to be made available to sub-components. The specific setter will call this method to populate the attributes.- Parameters:
name- Name of property to setvalue- The value to set the property to
-
getAttribute
public Object getAttribute(String key)
Used by sub-components to retrieve configuration information.- Parameters:
key- The name of the property for which the value should be retrieved- Returns:
- The value of the specified property
-
getCurrentThreadCount
public int getCurrentThreadCount()
Return the amount of threads that are managed by the pool.- Returns:
- the amount of threads that are managed by the pool
-
getCurrentThreadsBusy
public int getCurrentThreadsBusy()
Return the amount of threads that are in use- Returns:
- the amount of threads that are in use
-
isRunning
public boolean isRunning()
-
isPaused
public boolean isPaused()
-
createExecutor
public void createExecutor()
-
shutdownExecutor
public void shutdownExecutor()
-
unlockAccept
protected void unlockAccept()
Unlock the server socket acceptor threads using bogus connections.
-
processSocket
public boolean processSocket(SocketWrapperBase<S> socketWrapper, SocketEvent event, boolean dispatch)
Process the given SocketWrapper with the given status. Used to trigger processing as if the Poller (for those endpoints that have one) selected the socket.- Parameters:
socketWrapper- The socket wrapper to processevent- The socket event to be processeddispatch- Should the processing be performed on a new container thread- Returns:
- if processing was triggered successfully
-
createSocketProcessor
protected abstract SocketProcessorBase<S> createSocketProcessor(SocketWrapperBase<S> socketWrapper, SocketEvent event)
-
startAcceptorThread
protected void startAcceptorThread()
-
pause
public void pause()
Pause the endpoint, which will stop it accepting new connections and unlock the acceptor.
-
resume
public void resume()
Resume the endpoint, which will make it start accepting new connections again.
-
getLog
protected abstract Log getLog()
-
initializeConnectionLatch
protected LimitLatch initializeConnectionLatch()
-
countUpOrAwaitConnection
protected void countUpOrAwaitConnection() throws InterruptedException- Throws:
InterruptedException
-
countDownConnection
protected long countDownConnection()
-
closeServerSocketGraceful
public final void closeServerSocketGraceful()
Close the server socket (to prevent further connections) if the server socket was originally bound onstart()(rather than oninit()).- See Also:
getBindOnInit()
-
awaitConnectionsClose
public final 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
-
doCloseServerSocket
protected abstract void doCloseServerSocket() throws IOExceptionActually close the server socket but don't perform any other clean-up.- Throws:
IOException- If an error occurs closing the socket
-
setSocketOptions
protected abstract boolean setSocketOptions(U socket)
-
closeSocket
protected void closeSocket(U socket)
Close the socket when the connection has to be immediately closed when an error occurs while configuring the accepted socket or trying to dispatch it for processing. The wrapper associated with the socket will be used for the close.- Parameters:
socket- The newly accepted socket
-
destroySocket
protected abstract void destroySocket(U socket)
Close the socket. This is used when the connector is not in a state which allows processing the socket, or if there was an error which prevented the allocation of the socket wrapper.- Parameters:
socket- The newly accepted socket
-
-