org.glassfish.grizzly.servlet
Class ServletRegistration

java.lang.Object
  org.glassfish.grizzly.servlet.Registration
      org.glassfish.grizzly.servlet.ServletRegistration

All Implemented Interfaces:

Comparable<ServletRegistration>

public class ServletRegistration
extends Registration
implements Comparable<ServletRegistration>

Allows customization of a Servlet registered with the WebappContext.

Since:

2.2

Field Summary

protected ExpectationHandler	expectationHandler
protected int	loadOnStartup
protected javax.servlet.Servlet	servlet
protected Class<? extends javax.servlet.Servlet>	servletClass
protected ArraySet<String>	urlPatterns

Fields inherited from class org.glassfish.grizzly.servlet.Registration

className, ctx, initParameters, name

Constructor Summary

protected	ServletRegistration(WebappContext ctx, String name, Class<? extends javax.servlet.Servlet> servletClass) Creates a new ServletRegistration associated with the specified WebappContext.
protected	ServletRegistration(WebappContext ctx, String name, javax.servlet.Servlet servlet) Creates a new ServletRegistration associated with the specified WebappContext.
protected	ServletRegistration(WebappContext ctx, String name, String servletClassName) Creates a new ServletRegistration associated with the specified WebappContext.

Method Summary

Set<String>	addMapping(String... urlPatterns) Adds a servlet mapping with the given URL patterns for the Servlet represented by this ServletRegistration.
int	compareTo(ServletRegistration o)
ExpectationHandler	getExpectationHandler() Get the ExpectationHandler responsible for processing Expect: header (for example "Expect: 100-Continue").
Collection<String>	getMappings() Gets the currently available mappings of the Servlet represented by this ServletRegistration.
void	setExpectationHandler(ExpectationHandler expectationHandler) Set the ExpectationHandler responsible for processing Expect: header (for example "Expect: 100-Continue").
void	setLoadOnStartup(int loadOnStartup) Sets the loadOnStartup priority on the Servlet represented by this dynamic ServletRegistration.
String	toString()

Methods inherited from class org.glassfish.grizzly.servlet.Registration

equals, getClassName, getInitParameter, getInitParameters, getName, hashCode, setInitParameter, setInitParameters

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

servletClass

protected Class<? extends javax.servlet.Servlet> servletClass

urlPatterns

protected ArraySet<String> urlPatterns

servlet

protected javax.servlet.Servlet servlet

loadOnStartup

protected int loadOnStartup

expectationHandler

protected ExpectationHandler expectationHandler

Constructor Detail

ServletRegistration

protected ServletRegistration(WebappContext ctx,
                              String name,
                              String servletClassName)

Creates a new ServletRegistration associated with the specified WebappContext.

Parameters:

ctx - the owning WebappContext.

name - the name of the Filter.

servletClassName - the fully qualified class name of the Servlet implementation.

ServletRegistration

protected ServletRegistration(WebappContext ctx,
                              String name,
                              javax.servlet.Servlet servlet)

Creates a new ServletRegistration associated with the specified WebappContext.

Parameters:

ctx - the owning WebappContext.

name - the name of the Filter.

servlet - the Servlet instance.

ServletRegistration

protected ServletRegistration(WebappContext ctx,
                              String name,
                              Class<? extends javax.servlet.Servlet> servletClass)

Creates a new ServletRegistration associated with the specified WebappContext.

Parameters:

ctx - the owning WebappContext.

name - the name of the Filter.

servletClass - the class of the Servlet implementation.

Method Detail

addMapping

public Set<String> addMapping(String... urlPatterns)

Adds a servlet mapping with the given URL patterns for the Servlet represented by this ServletRegistration.

If any of the specified URL patterns are already mapped to a different Servlet, no updates will be performed.

If this method is called multiple times, each successive call adds to the effects of the former.

Parameters:

urlPatterns - the URL patterns of the servlet mapping

Returns:

the (possibly empty) Set of URL patterns that are already mapped to a different Servlet

Throws:

IllegalArgumentException - if urlPatterns is null or empty

IllegalStateException - if the ServletContext from which this ServletRegistration was obtained has already been initialized

getMappings

public Collection<String> getMappings()

Gets the currently available mappings of the Servlet represented by this ServletRegistration.

If permitted, any changes to the returned Collection must not affect this ServletRegistration.

Returns:

a (possibly empty) Collection of the currently available mappings of the Servlet represented by this ServletRegistration

setLoadOnStartup

public void setLoadOnStartup(int loadOnStartup)

Sets the loadOnStartup priority on the Servlet represented by this dynamic ServletRegistration.

A loadOnStartup value of greater than or equal to zero indicates to the container the initialization priority of the Servlet. In this case, the container must instantiate and initialize the Servlet during the initialization phase of the WebappContext, that is, after it has invoked all of the ServletContextListener objects configured for the WebappContext at their ServletContextListener.contextInitialized(javax.servlet.ServletContextEvent) method.

If loadOnStartup is a negative integer, the container is free to instantiate and initialize the Servlet lazily.

The default value for loadOnStartup is -1.

A call to this method overrides any previous setting.

Parameters:

loadOnStartup - the initialization priority of the Servlet

Throws:

IllegalStateException - if the ServletContext from which this ServletRegistration was obtained has already been initialized

getExpectationHandler

public ExpectationHandler getExpectationHandler()

Get the ExpectationHandler responsible for processing Expect: header (for example "Expect: 100-Continue").

Returns:

the ExpectationHandler responsible for processing Expect: header (for example "Expect: 100-Continue").

setExpectationHandler

public void setExpectationHandler(ExpectationHandler expectationHandler)

Set the ExpectationHandler responsible for processing Expect: header (for example "Expect: 100-Continue").

Parameters:

expectationHandler - the ExpectationHandler responsible for processing Expect: header (for example "Expect: 100-Continue").

toString

public String toString()

Overrides:

toString in class Object

compareTo

public int compareTo(ServletRegistration o)

Specified by:

compareTo in interface Comparable<ServletRegistration>