public class VirtualDirContext extends FileDirContext
VirtualWebappLoader.
Sample context xml configuration:<Context path="/mywebapp" docBase="/Users/theuser/mywebapp/src/main/webapp" >
<Resources className="org.apache.naming.resources.VirtualDirContext"
extraResourcePaths="/pictures=/Users/theuser/mypictures,/movies=/Users/theuser/mymovies" />
<Loader className="org.apache.catalina.loader.VirtualWebappLoader"
virtualClasspath="/Users/theuser/mywebapp/target/classes" />
<JarScanner scanAllDirectories="true" />
</Context>
FileDirContext.FileResource, FileDirContext.FileResourceAttributesabsoluteBase, allowLinking, base, BUFFER_SIZEaliases, altDirContexts, cached, cacheMaxSize, cacheObjectMaxSize, cacheTTL, docBase, env, nameParser, smADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTEAPPLET, AUTHORITATIVE, BATCHSIZE, DNS_URL, INITIAL_CONTEXT_FACTORY, LANGUAGE, OBJECT_FACTORIES, PROVIDER_URL, REFERRAL, SECURITY_AUTHENTICATION, SECURITY_CREDENTIALS, SECURITY_PRINCIPAL, SECURITY_PROTOCOL, STATE_FACTORIES, URL_PKG_PREFIXES| Constructor and Description |
|---|
VirtualDirContext() |
| Modifier and Type | Method and Description |
|---|---|
void |
allocate()
Allocate resources for this directory context.
|
protected String |
doGetRealPath(String path)
Return the real path for a given virtual path, if possible; otherwise
return
null. |
protected Object |
doLookup(String name)
Retrieves the named object.
|
protected File |
file(String name)
Return a File object representing the specified normalized
context-relative path if it exists and is readable.
|
protected File |
file(String name,
boolean mustExist)
Return a File object representing the specified normalized
context-relative path if it exists and is readable.
|
Attributes |
getAttributes(String name)
Retrieves all of the attributes associated with a named object.
|
protected List<NamingEntry> |
list(File file)
List the resources which are members of a collection.
|
void |
release()
Release any resources allocated for this directory context.
|
void |
setExtraResourcePaths(String path)
Allows to map a path of the filesystem to a path in the webapp.
|
protected File |
validate(File file,
String name,
boolean mustExist,
String absoluteBase) |
bind, createSubcontext, destroySubcontext, doGetAttributes, doListBindings, getAllowLinking, getNameInNamespace, getSchema, getSchemaClassDefinition, lookupLink, modifyAttributes, modifyAttributes, normalize, rebind, rename, search, search, search, search, setAllowLinking, setDocBase, unbind, validateaddAlias, addAltDirContext, addResourcesJar, addToEnvironment, bind, bind, bind, close, composeName, composeName, createSubcontext, createSubcontext, createSubcontext, destroySubcontext, getAliases, getAttributes, getAttributes, getAttributes, getCacheMaxSize, getCacheObjectMaxSize, getCacheTTL, getDocBase, getEnvironment, getNameParser, getNameParser, getRealPath, getSchema, getSchemaClassDefinition, isCached, list, list, listBindings, listBindings, lookup, lookup, lookupLink, modifyAttributes, modifyAttributes, rebind, rebind, rebind, removeAlias, removeFromEnvironment, rename, search, search, search, search, setAliases, setCached, setCacheMaxSize, setCacheObjectMaxSize, setCacheTTL, unbindpublic void setExtraResourcePaths(String path)
Allows to map a path of the filesystem to a path in the webapp. Multiple filesystem paths can be mapped to the same path in the webapp. Filesystem path and virtual path must be separated by an equal sign. Pairs of paths must be separated by a comma.
Example:
/=/Users/slaurent/mywebapp/src/main/webapp,/pictures=/Users/slaurent/sharedpictures
The path to the docBase must not be added here, otherwise resources would be listed twice.
path - The set of file system paths and virtual paths to map them to
in the required formatpublic void allocate()
allocate in class BaseDirContextpublic void release()
release in class FileDirContextpublic Attributes getAttributes(String name) throws NamingException
BaseDirContextgetAttributes in interface DirContextgetAttributes in class BaseDirContextname - the name of the object from which to retrieve attributesNamingException - if a naming exception is encounteredprotected File file(String name)
FileDirContextnull.file in class FileDirContextname - Normalized context-relative path (with leading '/')protected File file(String name, boolean mustExist)
FileDirContextnull.file in class FileDirContextname - Normalized context-relative path (with leading '/')mustExist - Must the specified resource exist?protected List<NamingEntry> list(File file)
FileDirContextlist in class FileDirContextfile - Collectionprotected Object doLookup(String name)
FileDirContextdoLookup in class FileDirContextname - the name of the object to look upprotected String doGetRealPath(String path)
FileDirContextnull.doGetRealPath in class FileDirContextpath - The path to the desired resourceCopyright © 2000-2021 Apache Software Foundation. All Rights Reserved.