|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
A Host is a Container that represents a virtual host in the Catalina servlet engine. It is useful in the following types of scenarios:
The parent Container attached to a Host is generally an Engine, but may be some other implementation, or may be omitted if it is not necessary.
The child containers attached to a Host are generally implementations of Context (representing an individual servlet context).
| Field Summary | |
static java.lang.String |
ADD_ALIAS_EVENT
The ContainerEvent event type sent when a new alias is added by addAlias(). |
static java.lang.String |
REMOVE_ALIAS_EVENT
The ContainerEvent event type sent when an old alias is removed by removeAlias(). |
| 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 |
| Method Summary | |
void |
addAlias(java.lang.String alias)
Add an alias name that should be mapped to this same Host. |
java.lang.String[] |
findAliases()
Return the set of alias names for this Host. |
java.lang.String |
getAppBase()
Return the application root for this Host. |
boolean |
getAutoDeploy()
Return the value of the auto deploy flag. |
java.lang.String |
getConfigClass()
Return the Java class name of the context configuration class for new web applications. |
boolean |
getDeployOnStartup()
Return the value of the deploy on startup flag. |
java.lang.String |
getName()
Return the canonical, fully qualified, name of the virtual host this Container represents. |
boolean |
getXmlNamespaceAware()
Get the server.xml <host> attribute's xmlNamespaceAware. |
boolean |
getXmlValidation()
Get the server.xml <host> attribute's xmlValidation. |
Context |
map(java.lang.String uri)
Return the Context that would be used to process the specified host-relative request URI, if any; otherwise return null. |
void |
removeAlias(java.lang.String alias)
Remove the specified alias name from the aliases for this Host. |
void |
setAppBase(java.lang.String appBase)
Set the application root for this Host. |
void |
setAutoDeploy(boolean autoDeploy)
Set the auto deploy flag value for this host. |
void |
setConfigClass(java.lang.String configClass)
Set the Java class name of the context configuration class for new web applications. |
void |
setDeployOnStartup(boolean deployOnStartup)
Set the deploy on startup flag value for this host. |
void |
setName(java.lang.String name)
Set the canonical, fully qualified, name of the virtual host this Container represents. |
void |
setXmlNamespaceAware(boolean xmlNamespaceAware)
Set the namespace aware feature of the XML parser used when parsing xml instances. |
void |
setXmlValidation(boolean xmlValidation)
Set the validation feature of the XML parser used when parsing xml instances. |
| Methods inherited from interface org.apache.catalina.Container |
addChild, addContainerListener, addPropertyChangeListener, backgroundProcess, findChild, findChildren, findContainerListeners, getBackgroundProcessorDelay, getCluster, getInfo, getLoader, getLogger, getManager, getMappingObject, getObjectName, getParent, getParentClassLoader, getPipeline, getRealm, getResources, invoke, removeChild, removeContainerListener, removePropertyChangeListener, setBackgroundProcessorDelay, setCluster, setLoader, setManager, setParent, setParentClassLoader, setRealm, setResources |
| Field Detail |
public static final java.lang.String ADD_ALIAS_EVENT
addAlias().
public static final java.lang.String REMOVE_ALIAS_EVENT
removeAlias().
| Method Detail |
public java.lang.String getAppBase()
public void setAppBase(java.lang.String appBase)
appBase - The new application rootpublic boolean getAutoDeploy()
public void setAutoDeploy(boolean autoDeploy)
autoDeploy - The new auto deploy flagpublic java.lang.String getConfigClass()
public void setConfigClass(java.lang.String configClass)
configClass - The new context configuration classpublic boolean getDeployOnStartup()
public void setDeployOnStartup(boolean deployOnStartup)
deployOnStartup - The new deploy on startup flagpublic java.lang.String getName()
getName in interface Containerpublic void setName(java.lang.String name)
setName in interface Containername - Virtual host name
java.lang.IllegalArgumentException - if name is nullpublic boolean getXmlNamespaceAware()
public boolean getXmlValidation()
public void setXmlValidation(boolean xmlValidation)
xmlValidation - true to enable xml instance validationpublic void setXmlNamespaceAware(boolean xmlNamespaceAware)
xmlNamespaceAware - true to enable namespace awarenesspublic void addAlias(java.lang.String alias)
alias - The alias to be addedpublic java.lang.String[] findAliases()
public Context map(java.lang.String uri)
null.
uri - Request URI to be mappedpublic void removeAlias(java.lang.String alias)
alias - Alias name to be removed
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||