Package org.eclipse.jetty.server

Class Server

  • All Implemented Interfaces:
    Handler, HandlerContainer, org.eclipse.jetty.util.Attributes, org.eclipse.jetty.util.component.Container, org.eclipse.jetty.util.component.Destroyable, org.eclipse.jetty.util.component.Dumpable, org.eclipse.jetty.util.component.Dumpable.DumpableContainer, org.eclipse.jetty.util.component.LifeCycle
    @ManagedObject("Jetty HTTP Servlet server")
public class Server
extends HandlerWrapper
implements org.eclipse.jetty.util.Attributes
    Jetty HTTP Servlet Server. This class is the main class for the Jetty HTTP Servlet server. It aggregates Connectors (HTTP request receivers) and request Handlers. The server is itself a handler and a ThreadPool. Connectors use the ThreadPool methods to run jobs that will eventually call the handle method.

    • Constructor Detail

      • Server

        public Server()

      • Server

        public Server​(@Name("port")
              int port)
        Convenience constructor Creates server and a ServerConnector at the passed port.
        Parameters:
        port - The port of a network HTTP connector (or 0 for a randomly allocated port).
        See Also:
        NetworkConnector.getLocalPort()

      • Server

        public Server​(@Name("address")
              java.net.InetSocketAddress addr)
        Convenience constructor

        Creates server and a ServerConnector at the passed address.

        Parameters:
        addr - the inet socket address to create the connector from

      • Server

        public Server​(@Name("threadpool")
              org.eclipse.jetty.util.thread.ThreadPool pool)

    • Method Detail

      • getRequestLog

        public RequestLog getRequestLog()

      • setRequestLog

        public void setRequestLog​(RequestLog requestLog)

      • setErrorHandler

        public void setErrorHandler​(ErrorHandler errorHandler)

      • getVersion

        @ManagedAttribute("version of this server")
public static java.lang.String getVersion()

      • getStopAtShutdown

        public boolean getStopAtShutdown()

      • setStopTimeout

        public void setStopTimeout​(long stopTimeout)
        Set a graceful stop time. The StatisticsHandler must be configured so that open connections can be tracked for a graceful shutdown.
        Overrides:
        setStopTimeout in class org.eclipse.jetty.util.component.ContainerLifeCycle
        See Also:
        ContainerLifeCycle.setStopTimeout(long)

      • setStopAtShutdown

        public void setStopAtShutdown​(boolean stop)
        Set stop server at shutdown behaviour.
        Parameters:
        stop - If true, this server instance will be explicitly stopped when the JVM is shutdown. Otherwise the JVM is stopped with the server running.
        See Also:
        Runtime.addShutdownHook(Thread), ShutdownThread

      • getConnectors

        @ManagedAttribute(value="connectors for this server",
                  readonly=true)
public Connector[] getConnectors()
        Returns:
        Returns the connectors.

      • addConnector

        public void addConnector​(Connector connector)

      • setConnectors

        public void setConnectors​(Connector[] connectors)
        Set the connectors for this server. Each connector has this server set as it's ThreadPool and its Handler.
        Parameters:
        connectors - The connectors to set.

      • addBeanToAllConnectors

        public void addBeanToAllConnectors​(java.lang.Object bean)
        Add a bean to all connectors on the server. If the bean is an instance of Connection.Listener it will also be registered as a listener on all connections accepted by the connectors.
        Parameters:
        bean - the bean to be added.

      • getThreadPool

        @ManagedAttribute("the server thread pool")
public org.eclipse.jetty.util.thread.ThreadPool getThreadPool()
        Returns:
        Returns the threadPool.

      • isDumpAfterStart

        @ManagedAttribute("dump state to stderr after start")
public boolean isDumpAfterStart()
        Returns:
        true if ContainerLifeCycle.dumpStdErr() is called after starting

      • setDumpAfterStart

        public void setDumpAfterStart​(boolean dumpAfterStart)
        Parameters:
        dumpAfterStart - true if ContainerLifeCycle.dumpStdErr() is called after starting

      • isDumpBeforeStop

        @ManagedAttribute("dump state to stderr before stop")
public boolean isDumpBeforeStop()
        Returns:
        true if ContainerLifeCycle.dumpStdErr() is called before stopping

      • setDumpBeforeStop

        public void setDumpBeforeStop​(boolean dumpBeforeStop)
        Parameters:
        dumpBeforeStop - true if ContainerLifeCycle.dumpStdErr() is called before stopping

      • getDateField

        public HttpField getDateField()

      • doStart

        protected void doStart()
                throws java.lang.Exception
        Overrides:
        doStart in class AbstractHandler
        Throws:
        java.lang.Exception

      • start

        protected void start​(org.eclipse.jetty.util.component.LifeCycle l)
              throws java.lang.Exception
        Overrides:
        start in class org.eclipse.jetty.util.component.ContainerLifeCycle
        Throws:
        java.lang.Exception

      • doStop

        protected void doStop()
               throws java.lang.Exception
        Overrides:
        doStop in class AbstractHandler
        Throws:
        java.lang.Exception

      • handle

        public void handle​(HttpChannel channel)
            throws java.io.IOException,
                   javax.servlet.ServletException
        Throws:
        java.io.IOException
        javax.servlet.ServletException

      • handleOptions

        protected void handleOptions​(Request request,
                             Response response)
                      throws java.io.IOException
        Throws:
        java.io.IOException

      • handleAsync

        public void handleAsync​(HttpChannel channel)
                 throws java.io.IOException,
                        javax.servlet.ServletException
        Throws:
        java.io.IOException
        javax.servlet.ServletException

      • join

        public void join()
          throws java.lang.InterruptedException
        Throws:
        java.lang.InterruptedException

      • getSessionIdManager

        public SessionIdManager getSessionIdManager()
        Returns:
        Returns the sessionIdManager.

      • setSessionIdManager

        public void setSessionIdManager​(SessionIdManager sessionIdManager)
        Parameters:
        sessionIdManager - The sessionIdManager to set.

      • clearAttributes

        public void clearAttributes()
        Specified by:
        clearAttributes in interface org.eclipse.jetty.util.Attributes

      • getAttribute

        public java.lang.Object getAttribute​(java.lang.String name)
        Specified by:
        getAttribute in interface org.eclipse.jetty.util.Attributes

      • getAttributeNames

        public java.util.Enumeration<java.lang.String> getAttributeNames()
        Specified by:
        getAttributeNames in interface org.eclipse.jetty.util.Attributes

      • getAttributeNameSet

        public java.util.Set<java.lang.String> getAttributeNameSet()
        Specified by:
        getAttributeNameSet in interface org.eclipse.jetty.util.Attributes

      • removeAttribute

        public void removeAttribute​(java.lang.String name)
        Specified by:
        removeAttribute in interface org.eclipse.jetty.util.Attributes

      • setAttribute

        public void setAttribute​(java.lang.String name,
                         java.lang.Object attribute)
        Specified by:
        setAttribute in interface org.eclipse.jetty.util.Attributes

      • toString

        public java.lang.String toString()
        Overrides:
        toString in class org.eclipse.jetty.util.component.AbstractLifeCycle

      • dump

        public void dump​(java.lang.Appendable out,
                 java.lang.String indent)
          throws java.io.IOException
        Specified by:
        dump in interface org.eclipse.jetty.util.component.Dumpable
        Overrides:
        dump in class org.eclipse.jetty.util.component.ContainerLifeCycle
        Throws:
        java.io.IOException

      • main

        public static void main​(java.lang.String... args)
                 throws java.lang.Exception
        Throws:
        java.lang.Exception