|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.apache.catalina.core.ContainerBase | +--org.apache.catalina.core.StandardHost
Standard implementation of the Host interface. Each child container must be a Context implementation to process the requests directed to a particular web application.
Fields inherited from class org.apache.catalina.core.ContainerBase |
children,
cluster,
debug,
lifecycle,
listeners,
loader,
logger,
manager,
mapper,
mapperClass,
mappers,
name,
parent,
parentClassLoader,
pipeline,
realm,
resources,
sm,
started,
support |
Fields inherited from interface org.apache.catalina.Deployer |
INSTALL_EVENT,
REMOVE_EVENT |
Fields inherited from interface org.apache.catalina.Host |
ADD_ALIAS_EVENT,
REMOVE_ALIAS_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 org.apache.catalina.Container |
ADD_CHILD_EVENT,
ADD_MAPPER_EVENT,
ADD_VALVE_EVENT,
REMOVE_CHILD_EVENT,
REMOVE_MAPPER_EVENT,
REMOVE_VALVE_EVENT |
Constructor Summary | |
StandardHost()
Create a new StandardHost component with the default basic Valve. |
Method Summary | |
void |
addAlias(java.lang.String alias)
Add an alias name that should be mapped to this same Host. |
void |
addChild(Container child)
Add a child Container, only if the proposed child is an implementation of Context. |
void |
addDefaultContext(DefaultContext defaultContext)
Set the DefaultContext for new web applications. |
protected void |
addDefaultMapper(java.lang.String mapperClass)
Add a default Mapper implementation if none have been configured explicitly. |
protected void |
expand(java.io.InputStream input,
java.io.File docBase,
java.lang.String name)
Expand the specified input stream into the specified directory, creating a file named from the specified relative path. |
protected java.lang.String |
expand(java.net.URL war)
Expand the WAR file found at the specified URL into an unpacked directory structure, and return the absolute pathname to the expanded directory. |
java.lang.String[] |
findAliases()
Return the set of alias names for this Host. |
Context |
findDeployedApp(java.lang.String contextPath)
Return the Context for the deployed application that is associated with the specified context path (if any); otherwise return null . |
java.lang.String[] |
findDeployedApps()
Return the context paths of all deployed web applications in this Container. |
java.lang.String |
getAppBase()
Return the application root for this Host. |
java.lang.String |
getConfigClass()
Return the Java class name of the context configuration class for new web applications. |
java.lang.String |
getContextClass()
Return the Java class name of the Context implementation class for new web applications. |
java.lang.String |
getErrorReportValveClass()
Return the Java class name of the error report valve class for new web applications. |
java.lang.String |
getInfo()
Return descriptive information about this Container implementation and the corresponding version number, in the format <description>/<version> . |
java.lang.String |
getMapperClass()
Return the default Mapper class name. |
java.lang.String |
getName()
Return the canonical, fully qualified, name of the virtual host this Container represents. |
java.lang.String |
getWorkDir()
Host work directory base. |
void |
importDefaultContext(Context context)
Import the DefaultContext config into a web application context. |
void |
install(java.lang.String contextPath,
java.net.URL war)
Install a new web application, whose web application archive is at the specified URL, into this container with the specified context path. |
boolean |
isUnpackWARs()
Unpack WARs flag accessor. |
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 . |
protected void |
remove(java.io.File dir)
Remove the specified directory and all of its contents. |
void |
remove(java.lang.String contextPath)
Remove an existing web application, attached to the specified context path. |
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 |
setConfigClass(java.lang.String configClass)
Set the Java class name of the context configuration class for new web applications. |
void |
setContextClass(java.lang.String contextClass)
Set the Java class name of the Context implementation class for new web applications. |
void |
setErrorReportValveClass(java.lang.String errorReportValveClass)
Set the Java class name of the error report valve class for new web applications. |
void |
setMapperClass(java.lang.String mapperClass)
Set the default Mapper class name. |
void |
setName(java.lang.String name)
Set the canonical, fully qualified, name of the virtual host this Container represents. |
void |
setUnpackWARs(boolean unpackWARs)
Unpack WARs flag mutator. |
void |
setWorkDir(java.lang.String workDir)
Host work directory base. |
void |
start()
Start this host. |
void |
start(java.lang.String contextPath)
Start an existing web application, attached to the specified context path. |
void |
stop(java.lang.String contextPath)
Stop an existing web application, attached to the specified context path. |
java.lang.String |
toString()
Return a String representation of this component. |
Methods inherited from class org.apache.catalina.core.ContainerBase |
addContainerListener,
addLifecycleListener,
addMapper,
addPropertyChangeListener,
addValve,
findChild,
findChildren,
findMapper,
findMappers,
fireContainerEvent,
getBasic,
getCluster,
getDebug,
getLoader,
getLogger,
getManager,
getParent,
getParentClassLoader,
getPipeline,
getRealm,
getResources,
getValves,
invoke,
log,
log,
logName,
map,
removeChild,
removeContainerListener,
removeLifecycleListener,
removeMapper,
removePropertyChangeListener,
removeValve,
setBasic,
setCluster,
setDebug,
setLoader,
setLogger,
setManager,
setParent,
setParentClassLoader,
setRealm,
setResources,
stop |
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
wait,
wait,
wait |
Constructor Detail |
public StandardHost()
Method Detail |
public java.lang.String getAppBase()
public void setAppBase(java.lang.String appBase)
appBase
- The new application rootpublic java.lang.String getConfigClass()
public void setConfigClass(java.lang.String configClass)
configClass
- The new context configuration classpublic void addDefaultContext(DefaultContext defaultContext)
defaultContext
- The new DefaultContextpublic java.lang.String getContextClass()
public void setContextClass(java.lang.String contextClass)
contextClass
- The new context implementation classpublic java.lang.String getMapperClass()
public void setMapperClass(java.lang.String mapperClass)
mapperClass
- The new default Mapper class namepublic java.lang.String getErrorReportValveClass()
public void setErrorReportValveClass(java.lang.String errorReportValveClass)
errorReportValveClass
- The new error report valve classpublic java.lang.String getName()
public void setName(java.lang.String name)
name
- Virtual host namepublic boolean isUnpackWARs()
public void setUnpackWARs(boolean unpackWARs)
public java.lang.String getWorkDir()
public void setWorkDir(java.lang.String workDir)
public void importDefaultContext(Context context)
context
- web application context to import default contextpublic void addAlias(java.lang.String alias)
alias
- The alias to be addedpublic void addChild(Container child)
child
- Child container to be addedpublic java.lang.String[] findAliases()
public java.lang.String getInfo()
<description>/<version>
.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 removedpublic java.lang.String toString()
public void start() throws LifecycleException
public void install(java.lang.String contextPath, java.net.URL war) throws java.io.IOException
If this application is successfully installed, a ContainerEvent of type
INSTALL_EVENT
will be sent to all registered listeners,
with the newly created Context
as an argument.
contextPath
- The context path to which this application should
be installed (must be unique)war
- A URL of type "jar:" that points to a WAR file, or type
"file:" that points to an unpacked directory structure containing
the web application to be installedpublic Context findDeployedApp(java.lang.String contextPath)
null
.contextPath
- The context path of the requested web applicationpublic java.lang.String[] findDeployedApps()
public void remove(java.lang.String contextPath) throws java.io.IOException
REMOVE_EVENT
will be sent to all
registered listeners, with the removed Context
as
an argument.contextPath
- The context path of the application to be removedpublic void start(java.lang.String contextPath) throws java.io.IOException
contextPath
- The context path of the application to be startedpublic void stop(java.lang.String contextPath) throws java.io.IOException
contextPath
- The context path of the application to be stoppedprotected void addDefaultMapper(java.lang.String mapperClass)
mapperClass
- Java class name of the default Mapperprotected java.lang.String expand(java.net.URL war) throws java.io.IOException
war
- URL of the web application archive to be expanded
(must start with "jar:")protected void expand(java.io.InputStream input, java.io.File docBase, java.lang.String name) throws java.io.IOException
input
- InputStream to be copieddocBase
- Document base directory into which we are expandingname
- Relative pathname of the file to be createdprotected void remove(java.io.File dir) throws java.io.IOException
dir
- Directory to be removed
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |