com.sun.jersey.api.container.httpserver
Class HttpServerFactory

java.lang.Object
  com.sun.jersey.api.container.httpserver.HttpServerFactory

public final class HttpServerFactory
extends java.lang.Object

Factory for creating HttpServer instances.

The HttpServer executor will be configued with instance returned from Executors.newCachedThreadPool(). This behaviour may be overridden before HttpServer#start() is called.

Author:

Paul.Sandoz@Sun.Com

Method Summary

static HttpServer	create(java.lang.String u) Create a HttpServer that registers a HttpHandler that in turn manages all root resource classes found by searching the classes referenced in the java classpath.
static HttpServer	create(java.lang.String u, HttpHandler handler) Create a HttpServer that registers a HttpHandler that in turn manages all root resource classes found by searching the classes referenced in the java classath.
static HttpServer	create(java.net.URI u) Create a HttpServer that registers a HttpHandler that in turn manages all root resource classes found by searching the classes referenced in the java classath.
static HttpServer	create(java.net.URI u, HttpHandler handler) Create a HttpServer that registers a HttpHandler that in turn manages all root resource classes found by searching the classes referenced in the java classath.

Methods inherited from class java.lang.Object

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

Method Detail

create

public static HttpServer create(java.lang.String u)
                         throws java.io.IOException,
                                java.lang.IllegalArgumentException

Create a HttpServer that registers a HttpHandler that in turn manages all root resource classes found by searching the classes referenced in the java classpath.

This implementation defers to the ContainerFactory.createContainer(Class) method for creating an HttpHandler that manages the root resources.

Parameters:

u - the URI to create the http server. The URI scheme must be equal to "http" or "https". The URI user information and host are ignored If the URI port is not present then port 80 will be used. The URI path must not be null or an empty string, and must not absolute (start with a '/' character). The URI path is used as the context of the HTTP handler (and corresponds to the base path). The URI query and fragment components are ignored.

Returns:

the http server

Throws:

java.io.IOException - if an error occurs creating the container.

java.lang.IllegalArgumentException - if u is null

create

public static HttpServer create(java.net.URI u)
                         throws java.io.IOException,
                                java.lang.IllegalArgumentException

Create a HttpServer that registers a HttpHandler that in turn manages all root resource classes found by searching the classes referenced in the java classath.

This implementation defers to the ContainerFactory.createContainer(Class) method for creating an HttpHandler that manages the root resources.

Parameters:

u - the URI to create the http server. The URI scheme must be equal to "http" or "https". The URI user information and host are ignored If the URI port is not present then port 80 will be used. The URI path must not be null or an empty string, and must not absolute (start with a '/' character). The URI path is used as the context of the HTTP handler (and corresponds to the base path). The URI query and fragment components are ignored.

Returns:

the http server

Throws:

java.io.IOException - if an error occurs creating the container.

java.lang.IllegalArgumentException - if u is null

create

public static HttpServer create(java.lang.String u,
                                HttpHandler handler)
                         throws java.io.IOException,
                                java.lang.IllegalArgumentException

Create a HttpServer that registers a HttpHandler that in turn manages all root resource classes found by searching the classes referenced in the java classath.

Parameters:

u - the URI to create the http server. The URI scheme must be equal to "http" or "https". The URI user information and host are ignored If the URI port is not present then port 80 will be used. The URI path must not be null or an empty string, and must not absolute (start with a '/' character). The URI path is used as the context of the HTTP handler (and corresponds to the base path). The URI query and fragment components are ignored.

handler - the HTTP handler

Returns:

the http server

Throws:

java.io.IOException - if an error occurs creating the container.

java.lang.IllegalArgumentException - if u is null

create

public static HttpServer create(java.net.URI u,
                                HttpHandler handler)
                         throws java.io.IOException,
                                java.lang.IllegalArgumentException

Create a HttpServer that registers a HttpHandler that in turn manages all root resource classes found by searching the classes referenced in the java classath.

Parameters:

u - the URI to create the http server. The URI scheme must be equal to "http" or "https". The URI user information and host are ignored If the URI port is not present then port 80 will be used. The URI path must not be null or an empty string, and must not absolute (start with a '/' character). The URI path is used as the context of the HTTP handler (and corresponds to the base path). The URI query and fragment components are ignored.

handler - the HTTP handler

Returns:

the http server

Throws:

java.io.IOException - if an error occurs creating the container.

java.lang.IllegalArgumentException - if u is null