com.sun.jersey.test.framework
Class WebAppDescriptor.Builder

java.lang.Object
  com.sun.jersey.test.framework.AppDescriptor.AppDescriptorBuilder<WebAppDescriptor.Builder,WebAppDescriptor>
      com.sun.jersey.test.framework.WebAppDescriptor.Builder

Enclosing class:

WebAppDescriptor

public static class WebAppDescriptor.Builder
extends AppDescriptor.AppDescriptorBuilder<WebAppDescriptor.Builder,WebAppDescriptor>

The builder for building a Web-based application descriptor.

If properties of the builder are not modified default values be utilized. The default value for initialization and context parameters is an empty map. The default value for the context and servlet path is an empty string. The default value for the servlet class is the class ServletContainer. The default value for the filter class and the servlet context listener class is null.

After the build() has been invoked the state of the builder will be reset to the default values.

initParams

protected java.util.Map<java.lang.String,java.lang.String> initParams

contextParams

protected java.util.Map<java.lang.String,java.lang.String> contextParams

servletClass

protected java.lang.Class<? extends javax.servlet.http.HttpServlet> servletClass

filters

protected java.util.List<WebAppDescriptor.FilterDescriptor> filters

listeners

protected java.util.List<java.lang.Class<? extends java.util.EventListener>> listeners

contextPath

protected java.lang.String contextPath

servletPath

protected java.lang.String servletPath

WebAppDescriptor.Builder

public WebAppDescriptor.Builder()

Create a builder.

WebAppDescriptor.Builder

public WebAppDescriptor.Builder(java.util.Map<java.lang.String,java.lang.String> initParams)
                         throws java.lang.IllegalArgumentException

Create a builder with initialization parameters.

Parameters:

initParams - a map of initialization parameters. The parameters will be copied.

Throws:

java.lang.IllegalArgumentException - if initParams is null.

WebAppDescriptor.Builder

public WebAppDescriptor.Builder(java.lang.String name,
                                java.lang.String value)

Create a builder with one initialization parameter.

Parameters:

name - the parameter name.

value - the parameter value.

WebAppDescriptor.Builder

public WebAppDescriptor.Builder(java.lang.String... packages)
                         throws java.lang.IllegalArgumentException

Create a builder with one or more package names where root resource and provider classes reside.

Parameters:

packages - one or more package names where root resource and provider classes reside.

Throws:

java.lang.IllegalArgumentException - if packages is null.

initParam

public WebAppDescriptor.Builder initParam(java.lang.String name,
                                          java.lang.String value)

Add an initialization parameter.

Parameters:

name - the parameter name.

value - the parameter value.

Returns:

this builder.

contextParam

public WebAppDescriptor.Builder contextParam(java.lang.String name,
                                             java.lang.String value)

Add a context parameter.

Parameters:

name - the parameter name.

value - the parameter value.

Returns:

this builder.

servletClass

public WebAppDescriptor.Builder servletClass(java.lang.Class<? extends javax.servlet.http.HttpServlet> servletClass)
                                      throws java.lang.IllegalArgumentException

Set the servlet class.

Setting a servlet class resets the filter class to null.

Parameters:

servletClass - the servlet class to serve the application.

Returns:

this builder.

Throws:

java.lang.IllegalArgumentException - if servletClass is null.

filterClass

public WebAppDescriptor.Builder filterClass(java.lang.Class<? extends javax.servlet.Filter> filterClass)
                                     throws java.lang.IllegalArgumentException

Set the filter class.

Setting a filter class resets the servlet class to null

Parameters:

filterClass - the filter class to serve the application.

Returns:

this builder.

Throws:

java.lang.IllegalArgumentException - if filterClass is null.

addFilter

public WebAppDescriptor.Builder addFilter(java.lang.Class<? extends javax.servlet.Filter> filterClass,
                                          java.lang.String filterName)
                                   throws java.lang.IllegalArgumentException

Adds filter class.

Adding a filter class DOES NOT reset the servlet or filter classes. Filter will be instanciated without initialization parameters.

Parameters:

filterClass - filter class. Must not be null.

filterName - filter name. Must not be null or empty string.

Returns:

this builder.

Throws:

java.lang.IllegalArgumentException - if filterClass or filterName is null.

addFilter

public WebAppDescriptor.Builder addFilter(java.lang.Class<? extends javax.servlet.Filter> filterClass,
                                          java.lang.String filterName,
                                          java.util.Map<java.lang.String,java.lang.String> initParams)
                                   throws java.lang.IllegalArgumentException

Adds filter class.

Adding a filter class DOES NOT reset the servlet or filter classes

Parameters:

filterClass - filter class. Must not be null.

filterName - filter name. Must not be null or empty string.

initParams - filter init parameters. Must not be null.

Returns:

this builder.

Throws:

java.lang.IllegalArgumentException - if filterClass, filterName or initParams is null.

contextPath

public WebAppDescriptor.Builder contextPath(java.lang.String contextPath)

Set the context path.

Parameters:

contextPath - the context path to the application. (See Servlet specification for definition of contextPath)

Returns:

this builder.

Throws:

java.lang.IllegalArgumentException - if contextPath is null.

servletPath

public WebAppDescriptor.Builder servletPath(java.lang.String servletPath)

Set the servlet path.

Parameters:

servletPath - the servlet path to the application. (See Servlet specification for definition of servletPath)

Returns:

this builder.

Throws:

java.lang.IllegalArgumentException - if servletPath is null.

contextListenerClass

public WebAppDescriptor.Builder contextListenerClass(java.lang.Class<? extends javax.servlet.ServletContextListener> contextListenerClass)

Set a ServletContextListener class

Parameters:

contextListenerClass - the servlet context listener class.

Returns:

this builder.

Throws:

java.lang.IllegalArgumentException - if contextListenerClass is null.

contextAttributeListenerClass

public WebAppDescriptor.Builder contextAttributeListenerClass(java.lang.Class<? extends javax.servlet.ServletContextAttributeListener> contextAttributeListenerClass)

Set a ServletContextListener class

Parameters:

contextAttributeListenerClass - the servlet context listener class.

Returns:

this builder.

Throws:

java.lang.IllegalArgumentException - if contextListenerClass is null.

requestListenerClass

public WebAppDescriptor.Builder requestListenerClass(java.lang.Class<? extends javax.servlet.ServletRequestListener> requestListenerClass)

Set a ServletRequestListener class

Parameters:

requestListenerClass - the servlet request listener class.

Returns:

this builder.

Throws:

java.lang.IllegalArgumentException - if requestListenerClass is null.

requestAttributeListenerClass

public WebAppDescriptor.Builder requestAttributeListenerClass(java.lang.Class<? extends javax.servlet.ServletRequestAttributeListener> requestAttributeListenerClass)

Set a ServletRequestAttributeListener class

Parameters:

requestAttributeListenerClass - the servlet request attribute listener class.

Returns:

this builder.

Throws:

java.lang.IllegalArgumentException - if requestAttributeListenerClass is null.

httpSessionListenerClass

public WebAppDescriptor.Builder httpSessionListenerClass(java.lang.Class<? extends javax.servlet.http.HttpSessionListener> httpSessionListenerClass)

Set a HttpSessionListener class

Parameters:

httpSessionListenerClass - the HTTP Session Listener class.

Returns:

this builder.

Throws:

java.lang.IllegalArgumentException - if httpSessionListenerClass is null.

httpSessionActivationListenerClass

public WebAppDescriptor.Builder httpSessionActivationListenerClass(java.lang.Class<? extends javax.servlet.http.HttpSessionActivationListener> httpSessionActivationListenerClass)

Set a HttpSessionActivationListener class

Parameters:

httpSessionActivationListenerClass - the HTTP Session Activation Listener class.

Returns:

this builder.

Throws:

java.lang.IllegalArgumentException - if httpSessionActivationListenerClass is null.

httpSessionAttributeListenerClass

public WebAppDescriptor.Builder httpSessionAttributeListenerClass(java.lang.Class<? extends javax.servlet.http.HttpSessionAttributeListener> httpSessionAttributeListenerClass)

Set a HttpSessionAttributeListener class

Parameters:

httpSessionAttributeListenerClass - the HTTPSessionAttributeListener class.

Returns:

this builder.

Throws:

java.lang.IllegalArgumentException - if httpSessionAttributeListenerClass is null.

build

public WebAppDescriptor build()

Build the Web-based application descriptor. .

Specified by:

build in class AppDescriptor.AppDescriptorBuilder<WebAppDescriptor.Builder,WebAppDescriptor>

Returns:

the Web-based application descriptor.

reset

protected void reset()

Overrides:

reset in class AppDescriptor.AppDescriptorBuilder<WebAppDescriptor.Builder,WebAppDescriptor>