Class JettyHttpContainerFactory

java.lang.Object
org.glassfish.jersey.jetty.JettyHttpContainerFactory

public final class JettyHttpContainerFactory extends Object
Factory for creating and starting Jetty server handlers. This returns a handle to the started server as Server instances, which allows the server to be stopped by invoking the AbstractLifeCycle.stop() method.

To start the server in HTTPS mode an SslContextFactory can be provided. This will be used to decrypt and encrypt information sent over the connected TCP socket channel.

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Class
    Description
    private static final class 
     
  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
    private
     
  • Method Summary

    Modifier and Type
    Method
    Description
    static org.eclipse.jetty.server.Server
    Creates a Server instance that registers an Handler.
    static org.eclipse.jetty.server.Server
    createServer(URI uri, boolean start)
    Creates a Server instance that registers an Handler.
    static org.eclipse.jetty.server.Server
    createServer(URI uri, org.eclipse.jetty.util.ssl.SslContextFactory sslContextFactory, JettyHttpContainer handler, boolean start)
    Create a Server that registers an Handler that in turn manages all root resource and provider classes found by searching the classes referenced in the java classpath.
    static org.eclipse.jetty.server.Server
    createServer(URI uri, org.eclipse.jetty.util.ssl.SslContextFactory sslContextFactory, ResourceConfig config)
    Create a Server that registers an Handler that in turn manages all root resource and provider classes declared by the resource configuration.
    static org.eclipse.jetty.server.Server
    Create a Server that registers an Handler that in turn manages all root resource and provider classes declared by the resource configuration.
    static org.eclipse.jetty.server.Server
    createServer(URI uri, ResourceConfig configuration, boolean start)
    Create a Server that registers an Handler that in turn manages all root resource and provider classes declared by the resource configuration.
    static org.eclipse.jetty.server.Server
    createServer(URI uri, ResourceConfig config, boolean start, Object parentContext)
    Create a Server that registers an Handler that in turn manages all root resource and provider classes declared by the resource configuration.
    static org.eclipse.jetty.server.Server
    createServer(URI uri, ResourceConfig config, Object parentContext)
    Create a Server that registers an Handler that in turn manages all root resource and provider classes declared by the resource configuration.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Constructor Details

    • JettyHttpContainerFactory

      private JettyHttpContainerFactory()
  • Method Details

    • createServer

      public static org.eclipse.jetty.server.Server createServer(URI uri) throws javax.ws.rs.ProcessingException
      Creates a Server instance that registers an Handler.
      Parameters:
      uri - uri on which the ApplicationHandler will be deployed. Only first path segment will be used as context path, the rest will be ignored.
      Returns:
      newly created Server.
      Throws:
      javax.ws.rs.ProcessingException - in case of any failure when creating a new Jetty Server instance.
      IllegalArgumentException - if uri is null.
    • createServer

      public static org.eclipse.jetty.server.Server createServer(URI uri, boolean start) throws javax.ws.rs.ProcessingException
      Creates a Server instance that registers an Handler.
      Parameters:
      uri - uri on which the ApplicationHandler will be deployed. Only first path segment will be used as context path, the rest will be ignored.
      start - if set to false, server will not get started, which allows to configure the underlying transport layer, see above for details.
      Returns:
      newly created Server.
      Throws:
      javax.ws.rs.ProcessingException - in case of any failure when creating a new Jetty Server instance.
      IllegalArgumentException - if uri is null.
    • createServer

      public static org.eclipse.jetty.server.Server createServer(URI uri, ResourceConfig config) throws javax.ws.rs.ProcessingException
      Create a Server that registers an Handler that in turn manages all root resource and provider classes declared by the resource configuration.

      This implementation defers to the ContainerFactory.createContainer(Class, javax.ws.rs.core.Application) method for creating an Container that manages the root resources.

      Parameters:
      uri - the URI to create the http server. The URI scheme must be equal to "http". The URI user information and host are ignored If the URI port is not present then port 80 will be used. The URI path, query and fragment components are ignored.
      config - the resource configuration.
      Returns:
      newly created Server.
      Throws:
      javax.ws.rs.ProcessingException - in case of any failure when creating a new Jetty Server instance.
      IllegalArgumentException - if uri is null.
    • createServer

      public static org.eclipse.jetty.server.Server createServer(URI uri, ResourceConfig configuration, boolean start) throws javax.ws.rs.ProcessingException
      Create a Server that registers an Handler that in turn manages all root resource and provider classes declared by the resource configuration.

      This implementation defers to the ContainerFactory.createContainer(Class, javax.ws.rs.core.Application) method for creating an Container that manages the root resources.

      Parameters:
      uri - URI on which the Jersey web application will be deployed. Only first path segment will be used as context path, the rest will be ignored.
      configuration - web application configuration.
      start - if set to false, server will not get started, which allows to configure the underlying transport layer, see above for details.
      Returns:
      newly created Server.
      Throws:
      javax.ws.rs.ProcessingException - in case of any failure when creating a new Jetty Server instance.
      IllegalArgumentException - if uri is null.
    • createServer

      public static org.eclipse.jetty.server.Server createServer(URI uri, ResourceConfig config, boolean start, Object parentContext)
      Create a Server that registers an Handler that in turn manages all root resource and provider classes declared by the resource configuration.
      Parameters:
      uri - the URI to create the http server. The URI scheme must be equal to "https". The URI user information and host are ignored If the URI port is not present then port 143 will be used. The URI path, query and fragment components are ignored.
      config - the resource configuration.
      start - if set to false, server will not get started, this allows end users to set additional properties on the underlying listener.
      parentContext - DI provider specific context with application's registered bindings.
      Returns:
      newly created Server.
      Throws:
      javax.ws.rs.ProcessingException - in case of any failure when creating a new Jetty Server instance.
      IllegalArgumentException - if uri is null.
      Since:
      2.12
      See Also:
    • createServer

      public static org.eclipse.jetty.server.Server createServer(URI uri, ResourceConfig config, Object parentContext)
      Create a Server that registers an Handler that in turn manages all root resource and provider classes declared by the resource configuration.
      Parameters:
      uri - the URI to create the http server. The URI scheme must be equal to "https". The URI user information and host are ignored If the URI port is not present then port 143 will be used. The URI path, query and fragment components are ignored.
      config - the resource configuration.
      parentContext - DI provider specific context with application's registered bindings.
      Returns:
      newly created Server.
      Throws:
      javax.ws.rs.ProcessingException - in case of any failure when creating a new Jetty Server instance.
      IllegalArgumentException - if uri is null.
      Since:
      2.12
      See Also:
    • createServer

      public static org.eclipse.jetty.server.Server createServer(URI uri, org.eclipse.jetty.util.ssl.SslContextFactory sslContextFactory, ResourceConfig config) throws javax.ws.rs.ProcessingException
      Create a Server that registers an Handler that in turn manages all root resource and provider classes declared by the resource configuration.

      This implementation defers to the ContainerFactory.createContainer(Class, javax.ws.rs.core.Application) method for creating an Container that manages the root resources.

      Parameters:
      uri - the URI to create the http server. The URI scheme must be equal to https. The URI user information and host are ignored. If the URI port is not present then port 443 will be used. The URI path, query and fragment components are ignored.
      sslContextFactory - this is the SSL context factory used to configure SSL connector
      config - the resource configuration.
      Returns:
      newly created Server.
      Throws:
      javax.ws.rs.ProcessingException - in case of any failure when creating a new Jetty Server instance.
      IllegalArgumentException - if uri is null.
    • createServer

      public static org.eclipse.jetty.server.Server createServer(URI uri, org.eclipse.jetty.util.ssl.SslContextFactory sslContextFactory, JettyHttpContainer handler, boolean start)
      Create a Server that registers an Handler that in turn manages all root resource and provider classes found by searching the classes referenced in the java classpath.
      Parameters:
      uri - the URI to create the http server. The URI scheme must be equal to https. The URI user information and host are ignored. If the URI port is not present then port 443 will be used. The URI path, query and fragment components are ignored.
      sslContextFactory - this is the SSL context factory used to configure SSL connector
      handler - the container that handles all HTTP requests
      start - if set to false, server will not get started, this allows end users to set additional properties on the underlying listener.
      Returns:
      newly created Server.
      Throws:
      javax.ws.rs.ProcessingException - in case of any failure when creating a new Jetty Server instance.
      IllegalArgumentException - if uri is null.
      See Also: