Class ServerConnector

  • All Implemented Interfaces:
    java.io.Closeable, java.lang.AutoCloseable, Connector, NetworkConnector, Container, Destroyable, Dumpable, Dumpable.DumpableContainer, Graceful, LifeCycle
    Direct Known Subclasses:
    NetworkTrafficServerConnector

    @ManagedObject("HTTP connector using NIO ByteChannels and Selectors")
    public class ServerConnector
    extends AbstractNetworkConnector
    This Connector implementation is the primary connector for the Jetty server over TCP/IP. By the use of various ConnectionFactory instances it is able to accept connections for HTTP, HTTP/2 and WebSocket, either directly or over SSL.

    The connector is a fully asynchronous NIO based implementation that by default will use all the commons services (eg Executor, Scheduler) of the passed Server instance, but all services may also be constructor injected into the connector so that it may operate with dedicated or otherwise shared services.

    Connection Factories

    Various convenience constructors are provided to assist with common configurations of ConnectionFactories, whose generic use is described in AbstractConnector. If no connection factories are passed, then the connector will default to use a HttpConnectionFactory. If an non null SslContextFactory instance is passed, then this used to instantiate a SslConnectionFactory which is prepended to the other passed or default factories.

    Selectors

    The default number of selectors is equal to half of the number of processors available to the JVM, which should allow optimal performance even if all the connections used are performing significant non-blocking work in the callback tasks.

    • Constructor Detail

      • ServerConnector

        public ServerConnector​(@Name("server")
                               Server server)

        Construct a ServerConnector with a private instance of HttpConnectionFactory as the only factory.

        Parameters:
        server - The Server this connector will accept connection for.
      • ServerConnector

        public ServerConnector​(@Name("server")
                               Server server,
                               @Name("acceptors")
                               int acceptors,
                               @Name("selectors")
                               int selectors)

        Construct a ServerConnector with a private instance of HttpConnectionFactory as the only factory.

        Parameters:
        server - The Server this connector will accept connection for.
        acceptors - the number of acceptor threads to use, or -1 for a default value. Acceptors accept new TCP/IP connections. If 0, then the selector threads are used to accept connections.
        selectors - the number of selector threads, or <=0 for a default value. Selectors notice and schedule established connection that can make IO progress.
      • ServerConnector

        public ServerConnector​(@Name("server")
                               Server server,
                               @Name("acceptors")
                               int acceptors,
                               @Name("selectors")
                               int selectors,
                               @Name("factories")
                               ConnectionFactory... factories)

        Construct a ServerConnector with a private instance of HttpConnectionFactory as the only factory.

        Parameters:
        server - The Server this connector will accept connection for.
        acceptors - the number of acceptor threads to use, or -1 for a default value. Acceptors accept new TCP/IP connections. If 0, then the selector threads are used to accept connections.
        selectors - the number of selector threads, or <=0 for a default value. Selectors notice and schedule established connection that can make IO progress.
        factories - Zero or more ConnectionFactory instances used to create and configure connections.
      • ServerConnector

        public ServerConnector​(@Name("server")
                               Server server,
                               @Name("factories")
                               ConnectionFactory... factories)

        Construct a Server Connector with the passed Connection factories.

        Parameters:
        server - The Server this connector will accept connection for.
        factories - Zero or more ConnectionFactory instances used to create and configure connections.
      • ServerConnector

        public ServerConnector​(@Name("server")
                               Server server,
                               @Name("sslContextFactory")
                               SslContextFactory sslContextFactory)

        Construct a ServerConnector with a private instance of HttpConnectionFactory as the primary protocol

        .
        Parameters:
        server - The Server this connector will accept connection for.
        sslContextFactory - If non null, then a SslConnectionFactory is instantiated and prepended to the list of HTTP Connection Factory.
      • ServerConnector

        public ServerConnector​(@Name("server")
                               Server server,
                               @Name("acceptors")
                               int acceptors,
                               @Name("selectors")
                               int selectors,
                               @Name("sslContextFactory")
                               SslContextFactory sslContextFactory)

        Construct a ServerConnector with a private instance of HttpConnectionFactory as the primary protocol

        .
        Parameters:
        server - The Server this connector will accept connection for.
        sslContextFactory - If non null, then a SslConnectionFactory is instantiated and prepended to the list of HTTP Connection Factory.
        acceptors - the number of acceptor threads to use, or -1 for a default value. Acceptors accept new TCP/IP connections. If 0, then the selector threads are used to accept connections.
        selectors - the number of selector threads, or <=0 for a default value. Selectors notice and schedule established connection that can make IO progress.
      • ServerConnector

        public ServerConnector​(@Name("server")
                               Server server,
                               @Name("sslContextFactory")
                               SslContextFactory sslContextFactory,
                               @Name("factories")
                               ConnectionFactory... factories)
        Parameters:
        server - The Server this connector will accept connection for.
        sslContextFactory - If non null, then a SslConnectionFactory is instantiated and prepended to the list of ConnectionFactories, with the first factory being the default protocol for the SslConnectionFactory.
        factories - Zero or more ConnectionFactory instances used to create and configure connections.
      • ServerConnector

        public ServerConnector​(@Name("server")
                               Server server,
                               @Name("executor")
                               java.util.concurrent.Executor executor,
                               @Name("scheduler")
                               Scheduler scheduler,
                               @Name("bufferPool")
                               ByteBufferPool bufferPool,
                               @Name("acceptors")
                               int acceptors,
                               @Name("selectors")
                               int selectors,
                               @Name("factories")
                               ConnectionFactory... factories)
        Parameters:
        server - The server this connector will be accept connection for.
        executor - An executor used to run tasks for handling requests, acceptors and selectors. If null then use the servers executor
        scheduler - A scheduler used to schedule timeouts. If null then use the servers scheduler
        bufferPool - A ByteBuffer pool used to allocate buffers. If null then create a private pool with default configuration.
        acceptors - the number of acceptor threads to use, or -1 for a default value. Acceptors accept new TCP/IP connections. If 0, then the selector threads are used to accept connections.
        selectors - the number of selector threads, or <=0 for a default value. Selectors notice and schedule established connection that can make IO progress.
        factories - Zero or more ConnectionFactory instances used to create and configure connections.
    • Method Detail

      • newSelectorManager

        protected SelectorManager newSelectorManager​(java.util.concurrent.Executor executor,
                                                     Scheduler scheduler,
                                                     int selectors)
      • doStart

        protected void doStart()
                        throws java.lang.Exception
        Description copied from class: ContainerLifeCycle
        Starts the managed lifecycle beans in the order they were added.
        Overrides:
        doStart in class AbstractNetworkConnector
        Throws:
        java.lang.Exception
      • doStop

        protected void doStop()
                       throws java.lang.Exception
        Description copied from class: ContainerLifeCycle
        Stops the managed lifecycle beans in the reverse order they were added.
        Overrides:
        doStop in class AbstractNetworkConnector
        Throws:
        java.lang.Exception
      • isOpen

        public boolean isOpen()
        Description copied from interface: NetworkConnector
        A Connector may be opened and not started (to reserve a port) or closed and running (to allow graceful shutdown of existing connections)
        Returns:
        True if the connector is Open.
      • isInheritChannel

        public boolean isInheritChannel()
        Returns:
        whether this connector uses a channel inherited from the JVM.
        See Also:
        System.inheritedChannel()
      • setInheritChannel

        public void setInheritChannel​(boolean inheritChannel)

        Sets whether this connector uses a channel inherited from the JVM.

        If true, the connector first tries to inherit from a channel provided by the system. If there is no inherited channel available, or if the inherited channel is not usable, then it will fall back using ServerSocketChannel.

        Use it with xinetd/inetd, to launch an instance of Jetty on demand. The port used to access pages on the Jetty instance is the same as the port used to launch Jetty.

        Parameters:
        inheritChannel - whether this connector uses a channel inherited from the JVM.
        See Also:
        openAcceptChannel()
      • open

        public void open​(java.nio.channels.ServerSocketChannel acceptChannel)
                  throws java.io.IOException
        Open the connector using the passed ServerSocketChannel. This open method can be called before starting the connector to pass it a ServerSocketChannel that will be used instead of one returned from openAcceptChannel()
        Parameters:
        acceptChannel - the channel to use
        Throws:
        java.io.IOException - if the server channel is not bound
      • openAcceptChannel

        protected java.nio.channels.ServerSocketChannel openAcceptChannel()
                                                                   throws java.io.IOException
        Called by open() to obtain the accepting channel.
        Returns:
        ServerSocketChannel used to accept connections.
        Throws:
        java.io.IOException - if unable to obtain or configure the server channel
      • close

        public void close()
        Description copied from interface: NetworkConnector

        Performs the activities needed to close the network communication (for example, to stop accepting network connections).

        Once a connector has been closed, it cannot be opened again without first calling LifeCycle.stop() and it will not be active again until a subsequent call to LifeCycle.start()
        Specified by:
        close in interface java.lang.AutoCloseable
        Specified by:
        close in interface java.io.Closeable
        Specified by:
        close in interface NetworkConnector
        Overrides:
        close in class AbstractNetworkConnector
      • accept

        public void accept​(int acceptorID)
                    throws java.io.IOException
        Specified by:
        accept in class AbstractConnector
        Throws:
        java.io.IOException
      • configure

        protected void configure​(java.net.Socket socket)
      • getTransport

        public java.lang.Object getTransport()
        Returns:
        the underlying socket, channel, buffer etc. for the connector.
      • newEndPoint

        protected ChannelEndPoint newEndPoint​(java.nio.channels.SocketChannel channel,
                                              ManagedSelector selectSet,
                                              java.nio.channels.SelectionKey key)
                                       throws java.io.IOException
        Throws:
        java.io.IOException
      • getSoLingerTime

        @ManagedAttribute(value="Socket close linger time. Deprecated, always returns -1",
                          readonly=true)
        @Deprecated
        public int getSoLingerTime()
        Deprecated.
        don't use as socket close linger time has undefined behavior for non-blocking sockets
        Returns the socket close linger time.
        Returns:
        -1 as the socket close linger time is always disabled.
        See Also:
        StandardSocketOptions.SO_LINGER
      • setSoLingerTime

        @Deprecated
        public void setSoLingerTime​(int lingerTime)
        Deprecated.
        don't use as socket close linger time has undefined behavior for non-blocking sockets
        Parameters:
        lingerTime - the socket close linger time; use -1 to disable.
        See Also:
        StandardSocketOptions.SO_LINGER
      • getAcceptQueueSize

        @ManagedAttribute("Accept Queue size")
        public int getAcceptQueueSize()
        Returns:
        the accept queue size
      • setAcceptQueueSize

        public void setAcceptQueueSize​(int acceptQueueSize)
        Parameters:
        acceptQueueSize - the accept queue size (also known as accept backlog)
      • getReuseAddress

        @ManagedAttribute("Server Socket SO_REUSEADDR")
        public boolean getReuseAddress()
        Returns:
        whether the server socket reuses addresses
        See Also:
        ServerSocket.getReuseAddress()
      • setReuseAddress

        public void setReuseAddress​(boolean reuseAddress)
        Parameters:
        reuseAddress - whether the server socket reuses addresses
        See Also:
        ServerSocket.setReuseAddress(boolean)
      • getAcceptedTcpNoDelay

        @ManagedAttribute("Accepted Socket TCP_NODELAY")
        public boolean getAcceptedTcpNoDelay()
        Returns:
        whether the accepted socket gets TCP_NODELAY enabled.
        See Also:
        Socket.getTcpNoDelay()
      • setAcceptedTcpNoDelay

        public void setAcceptedTcpNoDelay​(boolean tcpNoDelay)
        Parameters:
        tcpNoDelay - whether TCP_NODELAY gets enabled on the the accepted socket.
        See Also:
        Socket.setTcpNoDelay(boolean)
      • getAcceptedReceiveBufferSize

        @ManagedAttribute("Accepted Socket SO_RCVBUF")
        public int getAcceptedReceiveBufferSize()
        Returns:
        the SO_RCVBUF size to set onto the accepted socket. A value of -1 indicates that it is left to its default value.
        See Also:
        Socket.getReceiveBufferSize()
      • setAcceptedReceiveBufferSize

        public void setAcceptedReceiveBufferSize​(int receiveBufferSize)
        Parameters:
        receiveBufferSize - the SO_RCVBUF size to set onto the accepted socket. A value of -1 indicates that it is left to its default value.
        See Also:
        Socket.setReceiveBufferSize(int)
      • getAcceptedSendBufferSize

        @ManagedAttribute("Accepted Socket SO_SNDBUF")
        public int getAcceptedSendBufferSize()
        Returns:
        the SO_SNDBUF size to set onto the accepted socket. A value of -1 indicates that it is left to its default value.
        See Also:
        Socket.getSendBufferSize()
      • setAcceptedSendBufferSize

        public void setAcceptedSendBufferSize​(int sendBufferSize)
        Parameters:
        sendBufferSize - the SO_SNDBUF size to set onto the accepted socket. A value of -1 indicates that it is left to its default value.
        See Also:
        Socket.setSendBufferSize(int)