Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

com.sun.jersey.api.container
Class ContainerFactory

java.lang.Object
  extended by com.sun.jersey.api.container.ContainerFactory

public final class ContainerFactory
extends java.lang.Object

Factory for creating specific HTTP-based containers.

Author:
[email protected]

Method Summary
static
<A> A
createContainer(java.lang.Class<A> type)
          Create an instance of a container according to the class requested.
static
<A> A
createContainer(java.lang.Class<A> type, java.lang.Class<?>... resourceClasses)
          Create a container according to the class requested.
static
<A> A
createContainer(java.lang.Class<A> type, ResourceConfig resourceConfig)
          Create a container according to the class requested.
static
<A> A
createContainer(java.lang.Class<A> type, ResourceConfig resourceConfig, IoCComponentProviderFactory factory)
          Create a container according to the class requested.
static
<A> A
createContainer(java.lang.Class<A> type, java.util.Set<java.lang.Class<?>> resourceClasses)
          Create a container according to the class requested.
static
<A> A
createContainer(java.lang.Class<A> type, java.lang.String... paths)
          Create an instance of a container according to the class requested.
static
<A> A
createContainer(java.lang.Class<A> type, java.lang.String packageName)
          Deprecated.  
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

createContainer

public static <A> A createContainer(java.lang.Class<A> type,
                                    java.lang.Class<?>... resourceClasses)
                         throws ContainerException,
                                java.lang.IllegalArgumentException
Create a container according to the class requested.

The list of service-provider supporting the ContainerProvider service-provider will be iterated over until one returns a non-null container instance.

Type Parameters:
A - the type of the container.
Parameters:
type - the type of the container.
resourceClasses - the list of Web resources to be managed by the Web application.
Returns:
the container.
Throws:
ContainerException - if there is an error creating the container.
java.lang.IllegalArgumentException - if no container provider supports the type.

createContainer

public static <A> A createContainer(java.lang.Class<A> type,
                                    java.util.Set<java.lang.Class<?>> resourceClasses)
                         throws ContainerException,
                                java.lang.IllegalArgumentException
Create a container according to the class requested.

The list of service-provider supporting the ContainerProvider service-provider will be iterated over until one returns a non-null container instance.

Type Parameters:
A - the type of the container.
Parameters:
type - the type of the container.
resourceClasses - the set of Web resources to be managed by the Web application.
Returns:
the container.
Throws:
ContainerException - if there is an error creating the container.
java.lang.IllegalArgumentException - if no container provider supports the type.

createContainer

public static <A> A createContainer(java.lang.Class<A> type,
                                    ResourceConfig resourceConfig)
                         throws ContainerException,
                                java.lang.IllegalArgumentException
Create a container according to the class requested.

The list of service-provider supporting the ContainerProvider service-provider will be iterated over until one returns a non-null container instance.

Type Parameters:
A - the type of the container.
Parameters:
type - the type of the container.
resourceConfig - the resource configuration containing the set of Web resources to be managed by the Web application.
Returns:
the container.
Throws:
ContainerException - if there is an error creating the container.
java.lang.IllegalArgumentException - if no container provider supports the type.

createContainer

public static <A> A createContainer(java.lang.Class<A> type,
                                    ResourceConfig resourceConfig,
                                    IoCComponentProviderFactory factory)
                         throws ContainerException,
                                java.lang.IllegalArgumentException
Create a container according to the class requested.

The list of service-provider supporting the ContainerProvider service-provider will be iterated over until one returns a non-null container instance.

Type Parameters:
A - the type of the container.
Parameters:
type - the type of the container.
resourceConfig - the resource configuration containing the set of Web resources to be managed by the Web application.
factory - the IoC component provider factory the web application delegates to for obtaining instances of resource and provider classes. May be null if the web application is responsible for instantiating resource and provider classes.
Returns:
the container.
Throws:
ContainerException - if there is an error creating the container.
java.lang.IllegalArgumentException - if no container provider supports the type.

createContainer

@Deprecated
public static <A> A createContainer(java.lang.Class<A> type,
                                               java.lang.String packageName)
                         throws ContainerException,
                                java.lang.IllegalArgumentException
Deprecated. 

Create an instance of a container according to the class requested.

Type Parameters:
A - the type of the container.
Parameters:
type - the type of the container.
packageName - the name of the package where to find the resource configuration class.
Returns:
the HTTP handler, if a handler could not be created then null is returned.
Throws:
ContainerException - if the resource configuration class could not be found and instantiated or there is an error creating the container.
java.lang.IllegalArgumentException - if no container provider supports the type.

createContainer

public static <A> A createContainer(java.lang.Class<A> type)
Create an instance of a container according to the class requested.

All java classpath will be scanned for Root Resource Classes.

Type Parameters:
A - the type of the container.
Parameters:
type - the type of the container.
Returns:
the HTTP handler, if a handler could not be created then null is returned.
Throws:
java.lang.IllegalArgumentException - if no container provider supports the type.

createContainer

public static <A> A createContainer(java.lang.Class<A> type,
                                    java.lang.String... paths)
Create an instance of a container according to the class requested.

Root Resource Classes will be scanned in paths.

Type Parameters:
A - the type of the container.
Parameters:
type - the type of the container.
paths - a list of paths to be scanned for resource classes.
Returns:
the HTTP handler, if a handler could not be created then null is returned.
Throws:
java.lang.IllegalArgumentException - if no container provider supports the type.
Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD
Copyright © 2011 Oracle Corporation. All Rights Reserved.