com.sun.enterprise.web.pwc
Class PwcWebModule

java.lang.Object
  org.apache.catalina.core.ContainerBase
      org.apache.catalina.core.StandardContext
          com.sun.enterprise.web.pwc.PwcWebModule

All Implemented Interfaces:

java.io.Serializable, javax.management.MBeanRegistration, javax.servlet.ServletContext, Container, Context, Lifecycle, Pipeline

Direct Known Subclasses:

WebModule

public abstract class PwcWebModule
extends StandardContext

Class representing a web module (servlet context).

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.catalina.core.StandardContext

StandardContext.RestrictedServletContextListener

Nested classes/interfaces inherited from class org.apache.catalina.core.ContainerBase

ContainerBase.ContainerBackgroundProcessor, ContainerBase.PrivilegedAddChild

Field Summary

protected java.lang.String	_id
protected java.lang.String	defaultCharset
protected java.lang.String	formHintField
protected WebSessionCookieConfig	webSessionCookieConfig

Fields inherited from class org.apache.catalina.core.StandardContext

allowLinking, cacheMaxSize, cacheTTL, caseSensitive, caseSensitiveMapping, context, contextListeners, directoryListing, filterRegisMap, isJsfApplication, servletRegisMap, urlEncoder

Fields inherited from class org.apache.catalina.core.ContainerBase

backgroundProcessorDelay, checkIfRequestIsSecure, children, controller, debug, domain, hasCustomPipeline, initialized, lifecycle, listeners, loader, logger, manager, mserver, name, notifyContainerListeners, oname, parent, parentClassLoader, pipeline, readLock, realm, resources, sm, started, suffix, support, type, writeLock

Fields inherited from interface org.apache.catalina.Context

RELOAD_EVENT

Fields inherited from interface org.apache.catalina.Container

ADD_CHILD_EVENT, ADD_MAPPER_EVENT, ADD_VALVE_EVENT, REMOVE_CHILD_EVENT, REMOVE_MAPPER_EVENT, REMOVE_VALVE_EVENT

Fields inherited from interface javax.servlet.ServletContext

ORDERED_LIBS, TEMPDIR

Fields inherited from interface org.apache.catalina.Lifecycle

AFTER_START_EVENT, AFTER_STOP_EVENT, BEFORE_START_EVENT, BEFORE_STOP_EVENT, INIT_EVENT, START_EVENT, STOP_EVENT

Constructor Summary

PwcWebModule()

Method Summary

Wrapper	createWrapper() Factory method to create and return a new Wrapper instance, of the Java implementation class appropriate for this Context implementation.
java.lang.String[]	getCacheControls() Gets the Cache-Control settings of this web module.
java.lang.String	getContextRoot() Gets this web module's context root.
java.lang.String	getDefaultCharset() Gets the value of the default-charset attribute of the parameter-encoding element
boolean	getEncodeCookies() return _encodeCookies property value
java.lang.String[]	getEndpointAddresses() Gets the URL addresses corresponding to the web services endpoints of this web module.
java.lang.String	getFormHintField() return parameter-encoding form-hint-field attribute value
boolean	getHasWebServices() Return the hasWebServices flag for this web module.
java.lang.String	getID() Gets this web module's identifier.
java.lang.String	getModuleName() Gets this web module's name.
boolean	getResponseCTForHeaders() return _useResponseCTForHeaders property value
javax.servlet.SessionCookieConfig	getSessionCookieConfig() Gets the session tracking cookie configuration of this ServletContext.
SessionCookieConfig	getSessionCookieConfigFromSunWebXml() Return the session cookie configuration for this web module.
int	getSTMPoolSize() Return maximum number of instances that will be allocated when a single thread model servlet is used in this web module.
abstract boolean	hasLocaleToCharsetMapping() Returns true if this web module specifies a locale-charset-map in its sun-web.xml, false otherwise.
boolean	hasWebXml()
abstract java.lang.String	mapLocalesToCharset(java.util.Enumeration locales) Matches the given request locales against the charsets specified in the locale-charset-map of this web module's sun-web.xml, and returns the first matching charset.
void	setCacheControls(java.lang.String[] cacheControls) Sets the Cache-Control configuration for this web module.
void	setContextRoot(java.lang.String contextRoot) Sets this web module's context root.
void	setEncodeCookies(boolean flag) Determines whether cookies should be encoded or not.
void	setEndpointAddresses(java.lang.String[] endpointAddresses) Sets the URL addresses corresponding to the web services endpoints of this web module.
void	setHasWebServices(boolean hasWebServices) Set the hasWebServices boolean flag for this web module.
void	setHasWebXml(boolean hasWebXml)
void	setID(java.lang.String id) Sets this web module's identifier.
void	setModuleName(java.lang.String moduleName) Sets this web module's name.
void	setResponseCTForHeaders() sets _useResponseCTForHeaders property value.
void	setSessionCookieConfigFromSunWebXml(SessionCookieConfig cookieConfig) Set the session cookie configuration for this web module.
void	setSTMPoolSize(int newPoolSize) Set the maximum number of instances that will be allocated when a single thread model servlet is used in this web module.

Methods inherited from class org.apache.catalina.core.StandardContext

addAlternateDocBase, addApplicationListener, addApplicationParameter, addChild, addChild, addConstraint, addEjb, addEnvironment, addEnvironment, addErrorPage, addFilter, addFilter, addFilter, addFilterDef, addFilterDef, addFilterMap, addFilterMap, addFilterMaps, addInstanceListener, addInstanceListener, addJspMapping, addListener, addListener, addListener, addLocaleEncodingMappingParameter, addLocalEjb, addMessageDestination, addMessageDestinationRef, addMimeMapping, addParameter, addResource, addResource, addResourceEnvRef, addResourceLink, addResourceLink, addResourceParams, addRoleMapping, addSecurityRole, addServlet, addServlet, addServlet, addServlet, addServlet, addServletMapping, addServletMapping, addServletMapping, addServletMapping, addWatchedResource, addWelcomeFile, addWrapperLifecycle, addWrapperListener, adjustURLPattern, alternateResourcesStart, alternateResourcesStop, backgroundProcess, callServletContainerInitializers, contextListenerStart, create, createDynamicServletRegistrationImpl, createFilter, createFilterInstance, createListener, createListenerInstance, createLoader, createObjectInputStream, createObjectName, createObjectOutputStream, createServlet, createServletInstance, createServletRegistrationImpl, declareRoles, destroy, engineBase, filterStart, filterStop, findApplicationParameters, findEjb, findEjbs, findEnvironment, findEnvironments, findErrorPage, findErrorPage, findFilterConfig, findFilterDef, findFilterDefs, findFilterMaps, findInstanceListeners, findLocalEjb, findLocalEjbs, findMappingObject, findMessageDestination, findMessageDestinationRef, findMessageDestinationRefs, findMessageDestinations, findMimeMapping, findMimeMappings, findParameter, findParameters, findResource, findResourceEnvRef, findResourceEnvRefs, findResourceLink, findResourceLinks, findResources, findRoleMapping, findServletMapping, findServletMappings, findStaticResources, findStatusPage, findStatusPages, findWelcomeFile, findWelcomeFiles, findWrapperLifecycles, findWrapperListeners, fireRequestDestroyedEvent, fireRequestInitializedEvent, getAdHocServletName, getAllowRelativeRedirect, getAltDDName, getAlternateDocBases, getApplicationEventListeners, getAttribute, getAttributeNames, getAuditors, getAuthenticator, getAvailable, getCacheMaxSize, getCacheTTL, getCharsetMapper, getCharsetMapperClass, getClassLoader, getCompilerClasspath, getConfigFile, getConfigured, getConstraints, getContext, getContextPath, getCookies, getCrossContext, getDefaultConfigFile, getDefaultErrorPage, getDefaultSessionTrackingModes, getDefaultWebXml, getDelegate, getDisplayName, getDistributable, getDocBase, getEffectiveMajorVersion, getEffectiveMinorVersion, getEffectiveSessionTrackingModes, getEncodedPath, getEngineName, getEnvironments, getFilterRegistration, getFilterRegistrations, getHostname, getInfo, getInitParameter, getInitParameterNames, getJ2EEApplication, getJ2EEServer, getJspConfigDescriptor, getJvmRoute, getLoginConfig, getMajorVersion, getManagerChecksFrequency, getMapper, getMimeType, getMinorVersion, getNamedDispatcher, getNamingContextName, getNamingResources, getOriginalDocBase, getOverride, getParentName, getPath, getPaused, getPrivileged, getPublicId, getRealPath, getReloadable, getRequestDispatcher, getResource, getResourceAsStream, getResourceLinks, getResourceNames, getResourcePaths, getReuseSessionID, getServerInfo, getServlet, getServletContext, getServletContextName, getServletNameFilterMappings, getServletNames, getServletRegistration, getServletRegistrations, getServlets, getSessionCookieName, getSessionListeners, getSessionParameterName, getSessionTimeout, getStartTimeMillis, getStartupTime, getState, getStaticResources, getTldNamespaceAware, getTldScanTime, getTldValidation, getTypes, getUnpackWAR, getUrlPatternFilterMappings, getWatchedResources, getWelcomeFiles, getWorkDir, getWorkPath, getXmlNamespaceAware, getXmlValidation, hasAdHocPaths, hasConstraints, hasFilter, hasSecurityRole, hasServlet, hasWatchedResources, init, isAllowLinking, isCachingAllowed, isCaseSensitive, isCaseSensitiveMapping, isDirectoryListing, isEmbedded, isEnableURLRewriting, isEventProvider, isFilesystemBased, isJsfApplication, isReload, isReplaceWelcomeFiles, isSecurePagesWithPragma, isServlet22, isSessionTimeoutOveridden, isStatisticsProvider, isUseMyFaces, isUseNaming, loadListener, loadOnStartup, log, log, log, managerStart, managerStop, preDeregister, preRegister, reload, removeApplicationParameter, removeAttribute, removeChild, removeConstraints, removeEjb, removeEnvironment, removeErrorPages, removeFilterDef, removeFilterMaps, removeInstanceListener, removeLocalEjb, removeMessageDestination, removeMessageDestinationRef, removeMimeMapping, removeParameter, removePatternFromServlet, removeResource, removeResourceEnvRef, removeResourceLink, removeRoleMapping, removeSecurityRoles, removeServletMapping, removeWatchedResources, removeWelcomeFiles, removeWrapperLifecycles, removeWrapperListeners, resourcesStart, resourcesStop, restrictedSetPipeline, sessionActivatedEndEvent, sessionActivatedStartEvent, sessionCreatedEvent, sessionDestroyedEvent, sessionExpiredEvent, sessionPassivatedEndEvent, sessionPassivatedStartEvent, sessionPersistedEndEvent, sessionPersistedStartEvent, sessionRejectedEvent, setAllowLinking, setAllowRelativeRedirect, setAltDDName, setAttribute, setAuditors, setAvailable, setCacheMaxSize, setCacheTTL, setCachingAllowed, setCaseSensitive, setCaseSensitiveMapping, setCharsetMapper, setCharsetMapperClass, setCompilerClasspath, setConfigFile, setConfigured, setCookies, setCrossContext, setDefaultWebXml, setDelegate, setDirectoryListing, setDisplayName, setDistributable, setDocBase, setEffectiveMajorVersion, setEffectiveMinorVersion, setEmbedded, setEnableURLRewriting, setEngineName, setInitParameter, setJ2EEApplication, setJ2EEServer, setJspConfigDescriptor, setJvmRoute, setLoginConfig, setManagerChecksFrequency, setName, setNamingResources, setOrderedLibs, setOriginalDocBase, setOverride, setPath, setPrivileged, setPublicId, setReload, setReloadable, setReplaceWelcomeFiles, setResources, setReuseSessionID, setSecurePagesWithPragma, setServletContainerInitializerInterestList, setSessionTimeout, setSessionTrackingModes, setStartupTime, setTldNamespaceAware, setTldScanTime, setTldValidation, setUnpackWAR, setUseMyFaces, setUseNaming, setWorkDir, setXmlNamespaceAware, setXmlValidation, start, startRecursive, stop, stop, toString, updateObjectName, validateURLPattern

Methods inherited from class org.apache.catalina.core.ContainerBase

addContainerListener, addLifecycleListener, addPropertyChangeListener, addValve, addValve, findChild, findChildren, findContainerListeners, findLifecycleListeners, fireContainerEvent, getBackgroundProcessorDelay, getBasic, getChildren, getContainerSuffix, getDebug, getDomain, getJmxName, getJSR77Suffix, getLoader, getLogger, getManager, getMappingObject, getName, getObjectName, getParent, getParentClassLoader, getPipeline, getRealm, getResources, getType, getValveObjectNames, getValves, hasCustomPipeline, hasNonBasicValves, invoke, isCheckIfRequestIsSecure, logName, postDeregister, postRegister, removeContainerListener, removeLifecycleListener, removeLifecycleListeners, removePropertyChangeListener, removeValve, setBackgroundProcessorDelay, setBasic, setCheckIfRequestIsSecure, setDebug, setDomain, setLoader, setLogger, setManager, setParent, setParentClassLoader, setRealm, startChildren, threadStart, threadStop

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.catalina.Container

addContainerListener, addPropertyChangeListener, findChild, findChildren, findContainerListeners, fireContainerEvent, getBackgroundProcessorDelay, getLoader, getLogger, getManager, getMappingObject, getName, getParent, getParentClassLoader, getPipeline, getRealm, getResources, hasCustomPipeline, invoke, isCheckIfRequestIsSecure, removeContainerListener, removePropertyChangeListener, setBackgroundProcessorDelay, setCheckIfRequestIsSecure, setLoader, setLogger, setManager, setParent, setParentClassLoader, setRealm

Field Detail

_id

protected java.lang.String _id

formHintField

protected java.lang.String formHintField

defaultCharset

protected java.lang.String defaultCharset

webSessionCookieConfig

protected WebSessionCookieConfig webSessionCookieConfig

Constructor Detail

PwcWebModule

public PwcWebModule()

Method Detail

getID

public java.lang.String getID()

Gets this web module's identifier.

Returns:

Web module identifier

setID

public void setID(java.lang.String id)

Sets this web module's identifier.

Parameters:

id - Web module identifier

getSessionCookieConfig

public javax.servlet.SessionCookieConfig getSessionCookieConfig()

Gets the session tracking cookie configuration of this ServletContext.

Specified by:

getSessionCookieConfig in interface javax.servlet.ServletContext

Specified by:

getSessionCookieConfig in interface Context

Overrides:

getSessionCookieConfig in class StandardContext

getSessionCookieConfigFromSunWebXml

public SessionCookieConfig getSessionCookieConfigFromSunWebXml()

Return the session cookie configuration for this web module.

setSessionCookieConfigFromSunWebXml

public void setSessionCookieConfigFromSunWebXml(SessionCookieConfig cookieConfig)

Set the session cookie configuration for this web module.

Parameters:

cookieConfig - The new session cookie configuration

getFormHintField

public java.lang.String getFormHintField()

return parameter-encoding form-hint-field attribute value

getDefaultCharset

public java.lang.String getDefaultCharset()

Gets the value of the default-charset attribute of the parameter-encoding element

Returns:

Value of the default-charset attribute of the parameter-encoding element, or null if not present

setResponseCTForHeaders

public void setResponseCTForHeaders()

sets _useResponseCTForHeaders property value. When _useResponseCTForHeaders is set to true, it means that we send the response header in the same encoding of the response charset instead of UTF-8, (see the method sendHeaders in com.sun.enterprise.web.connector.nsapi.nsapiNSAPIResponse)

setEncodeCookies

public void setEncodeCookies(boolean flag)

Determines whether cookies should be encoded or not. If the property encodeCookies is set to false in sun-web.xml, cookies will not be URL encoded. The default behaviuor is that we always encode the cookies unless the property encodeCookies is set to false in sun-web.xml.

getResponseCTForHeaders

public boolean getResponseCTForHeaders()

return _useResponseCTForHeaders property value

getEncodeCookies

public boolean getEncodeCookies()

return _encodeCookies property value

getSTMPoolSize

public int getSTMPoolSize()

Return maximum number of instances that will be allocated when a single thread model servlet is used in this web module.

setSTMPoolSize

public void setSTMPoolSize(int newPoolSize)

Set the maximum number of instances that will be allocated when a single thread model servlet is used in this web module.

Parameters:

newPoolSize - New value of SingleThreadModel servlet pool size

createWrapper

public Wrapper createWrapper()

Factory method to create and return a new Wrapper instance, of the Java implementation class appropriate for this Context implementation. The constructor of the instantiated Wrapper will have been called, but no properties will have been set.

Specified by:

createWrapper in interface Context

Overrides:

createWrapper in class StandardContext

getHasWebServices

public boolean getHasWebServices()

Return the hasWebServices flag for this web module.

setHasWebServices

public void setHasWebServices(boolean hasWebServices)

Set the hasWebServices boolean flag for this web module.

Parameters:

hasWebServices - boolean flag hasWebServices for this web module

getEndpointAddresses

public java.lang.String[] getEndpointAddresses()

Gets the URL addresses corresponding to the web services endpoints of this web module.

Returns:

Array of URL addresses corresponding to the web services endpoints of this web module

setEndpointAddresses

public void setEndpointAddresses(java.lang.String[] endpointAddresses)

Sets the URL addresses corresponding to the web services endpoints of this web module.

Parameters:

endpointAddresses - Array of URL addresses corresponding to the web services endpoints of this web module

getContextRoot

public java.lang.String getContextRoot()

Gets this web module's context root.

Returns:

Web module context root

setContextRoot

public void setContextRoot(java.lang.String contextRoot)

Sets this web module's context root.

Parameters:

contextRoot - Web module context root

setHasWebXml

public void setHasWebXml(boolean hasWebXml)

hasWebXml

public boolean hasWebXml()

setModuleName

public void setModuleName(java.lang.String moduleName)

Sets this web module's name.

Parameters:

moduleName - Web module name

getModuleName

public java.lang.String getModuleName()

Gets this web module's name.

Returns:

Web module name

setCacheControls

public void setCacheControls(java.lang.String[] cacheControls)

Sets the Cache-Control configuration for this web module.

Parameters:

cacheControls - Cache-Control configuration settings for this web module

getCacheControls

public java.lang.String[] getCacheControls()

Gets the Cache-Control settings of this web module.

Returns:

Cache-Control settings of this web module, or null if no such settings exist for this web module.

hasLocaleToCharsetMapping

public abstract boolean hasLocaleToCharsetMapping()

Returns true if this web module specifies a locale-charset-map in its sun-web.xml, false otherwise.

Returns:

true if this web module specifies a locale-charset-map in its sun-web.xml, false otherwise

mapLocalesToCharset

public abstract java.lang.String mapLocalesToCharset(java.util.Enumeration locales)

Matches the given request locales against the charsets specified in the locale-charset-map of this web module's sun-web.xml, and returns the first matching charset.

Parameters:

locales - Request locales

Returns:

First matching charset, or null if this web module does not specify any locale-charset-map in its sun-web.xml, or no match was found