org.glassfish.grizzly.servlet

Class ServletRegistration

java.lang.Object

org.glassfish.grizzly.servlet.Registration

org.glassfish.grizzly.servlet.ServletRegistration

All Implemented Interfaces:

java.lang.Comparable<ServletRegistration>, javax.servlet.Registration, javax.servlet.Registration.Dynamic, javax.servlet.ServletRegistration, javax.servlet.ServletRegistration.Dynamic

public class ServletRegistration
extends Registration
implements javax.servlet.ServletRegistration.Dynamic, java.lang.Comparable<ServletRegistration>

Allows customization of a Servlet registered with the WebappContext.

Since:

2.2

Nested Class Summary

Nested classes/interfaces inherited from interface javax.servlet.ServletRegistration

javax.servlet.ServletRegistration.Dynamic

Field Summary

Fields

Modifier and Type	Field and Description
protected ExpectationHandler	expectationHandler
protected boolean	isAsyncSupported
protected int	loadOnStartup
protected javax.servlet.Servlet	servlet
protected java.lang.Class<? extends javax.servlet.Servlet>	servletClass
protected ArraySet<java.lang.String>	urlPatterns

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

className, ctx, initParameters, name

Constructor Summary

Constructors

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

Method Summary

Methods

Modifier and Type	Method and Description
java.util.Set<java.lang.String>	addMapping(java.lang.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").
java.util.Collection<java.lang.String>	getMappings() Gets the currently available mappings of the Servlet represented by this ServletRegistration.
java.lang.String	getRunAsRole()
void	setAsyncSupported(boolean isAsyncSupported)
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.
void	setMultipartConfig(javax.servlet.MultipartConfigElement multipartConfig)
void	setRunAsRole(java.lang.String roleName)
java.util.Set<java.lang.String>	setServletSecurity(javax.servlet.ServletSecurityElement constraint)
java.lang.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

Methods inherited from interface javax.servlet.Registration

getClassName, getInitParameter, getInitParameters, getName, setInitParameter, setInitParameters

Field Detail

servletClass

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

urlPatterns

protected ArraySet<java.lang.String> urlPatterns

servlet

protected javax.servlet.Servlet servlet

loadOnStartup

protected int loadOnStartup

expectationHandler

protected ExpectationHandler expectationHandler

isAsyncSupported

protected boolean isAsyncSupported

Constructor Detail

ServletRegistration

protected ServletRegistration(WebappContext ctx,
                   java.lang.String name,
                   java.lang.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,
                   java.lang.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,
                   java.lang.String name,
                   java.lang.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 java.util.Set<java.lang.String> addMapping(java.lang.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.

Specified by:

addMapping in interface javax.servlet.ServletRegistration

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:

java.lang.IllegalArgumentException - if urlPatterns is null or empty

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

getMappings

public java.util.Collection<java.lang.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.

Specified by:

getMappings in interface javax.servlet.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.

Specified by:

setLoadOnStartup in interface javax.servlet.ServletRegistration.Dynamic

Parameters:

loadOnStartup - the initialization priority of the Servlet

Throws:

java.lang.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").

setServletSecurity

public java.util.Set<java.lang.String> setServletSecurity(javax.servlet.ServletSecurityElement constraint)

Specified by:

setServletSecurity in interface javax.servlet.ServletRegistration.Dynamic

setMultipartConfig

public void setMultipartConfig(javax.servlet.MultipartConfigElement multipartConfig)

Specified by:

setMultipartConfig in interface javax.servlet.ServletRegistration.Dynamic

getRunAsRole

public java.lang.String getRunAsRole()

Specified by:

getRunAsRole in interface javax.servlet.ServletRegistration

setRunAsRole

public void setRunAsRole(java.lang.String roleName)

Specified by:

setRunAsRole in interface javax.servlet.ServletRegistration.Dynamic

setAsyncSupported

public void setAsyncSupported(boolean isAsyncSupported)

Specified by:

setAsyncSupported in interface javax.servlet.Registration.Dynamic

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 java.lang.String toString()

Overrides:

toString in class java.lang.Object

compareTo

public int compareTo(ServletRegistration o)

Specified by:

compareTo in interface java.lang.Comparable<ServletRegistration>