org.glassfish.jersey.simple
Class SimpleContainerFactory

java.lang.Object
  org.glassfish.jersey.simple.SimpleContainerFactory

public final class SimpleContainerFactory
extends Object

Factory for creating and starting Simple server containers. This returns a handle to the started server as Closeable instances, which allows the server to be stopped by invoking the Closeable.close() method.

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

Author:

Paul Sandoz (paul.sandoz at oracle.com), Arul Dhesiaseelan (aruld at acm.org)

Method Summary

static Closeable	create(URI uri, ApplicationHandler appHandler) Creates HttpServer instance.
static Closeable	create(URI uri, ApplicationHandler appHandler, int count, int select) Creates HttpServer instance.
static Closeable	create(URI address, ResourceConfig config) Create a Closeable that registers an Container that in turn manages all root resource and provider classes declared by the resource configuration.
static Closeable	create(URI address, ResourceConfig config, int count, int select) Create a Closeable that registers an Container that in turn manages all root resource and provider classes declared by the resource configuration.
static Closeable	create(URI uri, SSLContext context, ApplicationHandler appHandler) Creates HttpServer instance.
static Closeable	create(URI uri, SSLContext context, ApplicationHandler appHandler, int count, int select) Creates HttpServer instance.
static Closeable	create(URI address, SSLContext context, ResourceConfig config) Create a Closeable that registers an Container that in turn manages all root resource and provider classes declared by the resource configuration.
static Closeable	create(URI address, SSLContext context, ResourceConfig config, int count, int select) Create a Closeable that registers an Container that in turn manages all root resource and provider classes declared by the resource configuration.
static Closeable	create(URI address, SSLContext context, SimpleContainer container) Create a Closeable that registers an Container that in turn manages all root resource and provider classes found by searching the classes referenced in the java classpath.
static Closeable	create(URI address, SSLContext context, SimpleContainer container, int count, int select) Create a Closeable that registers an Container that in turn manages all root resource and provider classes found by searching the classes referenced in the java classpath.

Methods inherited from class java.lang.Object

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

Method Detail

create

public static Closeable create(URI address,
                               ResourceConfig config)
                        throws javax.ws.rs.ProcessingException

Create a Closeable that registers an Container 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:

address - 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:

the closeable connection, with the endpoint started

Throws:

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

IllegalArgumentException - if address is null

create

public static Closeable create(URI address,
                               ResourceConfig config,
                               int count,
                               int select)
                        throws javax.ws.rs.ProcessingException

Create a Closeable that registers an Container 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:

address - 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.

count - this is the number of threads to be used

select - this is the number of selector threads to use

Returns:

the closeable connection, with the endpoint started

Throws:

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

IllegalArgumentException - if address is null

create

public static Closeable create(URI address,
                               SSLContext context,
                               ResourceConfig config)
                        throws javax.ws.rs.ProcessingException

Create a Closeable that registers an Container 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:

address - 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.

context - this is the SSL context used for SSL connections

config - the resource configuration.

Returns:

the closeable connection, with the endpoint started

Throws:

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

IllegalArgumentException - if address is null

create

public static Closeable create(URI address,
                               SSLContext context,
                               ResourceConfig config,
                               int count,
                               int select)
                        throws javax.ws.rs.ProcessingException

Create a Closeable that registers an Container 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:

address - 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.

context - this is the SSL context used for SSL connections

config - the resource configuration.

count - this is the number of threads to be used

select - this is the number of selector threads to use

Returns:

the closeable connection, with the endpoint started

Throws:

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

IllegalArgumentException - if address is null

create

public static Closeable create(URI uri,
                               ApplicationHandler appHandler)
                        throws javax.ws.rs.ProcessingException

Creates HttpServer instance.

Parameters:

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

appHandler - web application handler.

Returns:

the closeable connection, with the endpoint started

Throws:

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

create

public static Closeable create(URI uri,
                               ApplicationHandler appHandler,
                               int count,
                               int select)
                        throws javax.ws.rs.ProcessingException

Creates HttpServer instance.

Parameters:

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

appHandler - web application handler.

count - this is the number of threads to be used

select - this is the number of selector threads to use

Returns:

the closeable connection, with the endpoint started

Throws:

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

create

public static Closeable create(URI uri,
                               SSLContext context,
                               ApplicationHandler appHandler)
                        throws javax.ws.rs.ProcessingException

Creates HttpServer instance.

Parameters:

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

context - this is the SSL context used for SSL connections

appHandler - web application handler.

Returns:

the closeable connection, with the endpoint started

Throws:

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

create

public static Closeable create(URI uri,
                               SSLContext context,
                               ApplicationHandler appHandler,
                               int count,
                               int select)
                        throws javax.ws.rs.ProcessingException

Creates HttpServer instance.

Parameters:

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

context - this is the SSL context used for SSL connections

appHandler - web application handler.

count - this is the number of threads to be used

select - this is the number of selector threads to use

Returns:

the closeable connection, with the endpoint started

Throws:

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

create

public static Closeable create(URI address,
                               SSLContext context,
                               SimpleContainer container)
                        throws javax.ws.rs.ProcessingException

Create a Closeable that registers an Container that in turn manages all root resource and provider classes found by searching the classes referenced in the java classpath.

Parameters:

address - 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.

context - this is the SSL context used for SSL connections

container - the container that handles all HTTP requests

Returns:

the closeable connection, with the endpoint started

Throws:

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

create

public static Closeable create(URI address,
                               SSLContext context,
                               SimpleContainer container,
                               int count,
                               int select)
                        throws javax.ws.rs.ProcessingException

Create a Closeable that registers an Container that in turn manages all root resource and provider classes found by searching the classes referenced in the java classpath.

Parameters:

address - 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.

context - this is the SSL context used for SSL connections

container - the container that handles all HTTP requests

count - this is the number of threads to be used

select - this is the number of selector threads to use

Returns:

the closeable connection, with the endpoint started

Throws:

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