org.glassfish.jersey.jetty

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.

Author:

Arul Dhesiaseelan (aruld@acm.org)

Method Summary

Methods

Modifier and Type	Method and Description
static org.eclipse.jetty.server.Server	createServer(URI uri) Creates a Server instance that registers an Handler.
static org.eclipse.jetty.server.Server	createServer(URI uri, ApplicationHandler appHandler) 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, ApplicationHandler appHandler, 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, boolean start) Creates a Server instance that registers an Handler.
static org.eclipse.jetty.server.Server	createServer(URI uri, 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	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, org.eclipse.jetty.util.ssl.SslContextFactory sslContextFactory, ApplicationHandler appHandler) 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, 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.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

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

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

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 - Thrown when problems during server creation

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

IllegalArgumentException - if uri is null

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 143 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 - Thrown when problems during server creation

IllegalArgumentException - if uri is null

createServer

public static org.eclipse.jetty.server.Server createServer(URI uri,
                                           ApplicationHandler appHandler)
                                                    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.

Parameters:

uri - URI on which the Jersey web application will be deployed.

appHandler - web application handler.

Returns:

newly created Server.

Throws:

javax.ws.rs.ProcessingException - Thrown when problems during server creation

IllegalArgumentException - if uri is null

createServer

public static org.eclipse.jetty.server.Server createServer(URI uri,
                                           ApplicationHandler appHandler,
                                           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.

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.

appHandler - web application handler.

start - if set to false, server will not get started, which allows to configure the underlying transport, see above for details.

Returns:

newly created Server.

Throws:

javax.ws.rs.ProcessingException

IllegalArgumentException - if uri is null

createServer

public static org.eclipse.jetty.server.Server createServer(URI uri,
                                           org.eclipse.jetty.util.ssl.SslContextFactory sslContextFactory,
                                           ApplicationHandler appHandler)
                                                    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.

Parameters:

uri - URI on which the Jersey web application will be deployed.

sslContextFactory - this is the SSL context factory used to configure SSL connector

appHandler - web application handler.

Returns:

newly created Server.

Throws:

javax.ws.rs.ProcessingException - Thrown when problems during server creation

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)
                                                    throws javax.ws.rs.ProcessingException

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 143 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 - Thrown when problems during server creation

IllegalArgumentException - if uri is null

See Also:

JettyHttpContainer