Package org.apache.catalina
Interface WebResourceSet
- All Superinterfaces:
- Lifecycle
- All Known Implementing Classes:
- AbstractArchiveResourceSet,- AbstractFileResourceSet,- AbstractResourceSet,- AbstractSingleArchiveResourceSet,- DirResourceSet,- EmptyResourceSet,- FileResourceSet,- JarResourceSet,- JarWarResourceSet,- WarResourceSet
Represents a set of resources that are part of a web application. Examples
 include a directory structure, a resources JAR and a WAR file.
- 
Nested Class SummaryNested classes/interfaces inherited from interface org.apache.catalina.LifecycleLifecycle.SingleUse
- 
Field SummaryFields inherited from interface org.apache.catalina.LifecycleAFTER_DESTROY_EVENT, AFTER_INIT_EVENT, AFTER_START_EVENT, AFTER_STOP_EVENT, BEFORE_DESTROY_EVENT, BEFORE_INIT_EVENT, BEFORE_START_EVENT, BEFORE_STOP_EVENT, CONFIGURE_START_EVENT, CONFIGURE_STOP_EVENT, PERIODIC_EVENT, START_EVENT, STOP_EVENT
- 
Method SummaryModifier and TypeMethodDescriptionvoidgc()Implementations may cache some information to improve performance.Obtain the base URL for this set of resources.booleanShould resources returned by this resource set only be included in any results when the lookup is explicitly looking for class loader resources.getResource(String path) Obtain the object that represents the resource at the given path.booleanShould resources returned by this resource set only be included in any results when the lookup is explicitly looking for static (non-class loader) resources. i.e. should these resources be excluded from look ups that are explicitly looking for class loader resources.booleanObtains the current value of the read-only setting for this set of resources.String[]Obtain the list of the names of all of the files and directories located in the specified directory.listWebAppPaths(String path) Obtain the Set of the web applications pathnames of all of the files and directories located in the specified directory.booleanCreate a new directory at the given path.voidsetClassLoaderOnly(boolean classLoaderOnly) voidsetReadOnly(boolean readOnly) Configures whether or not this set of resources is read-only.voidsetRoot(WebResourceRoot root) voidsetStaticOnly(boolean staticOnly) booleanwrite(String path, InputStream is, boolean overwrite) Create a new resource at the requested path using the provided InputStream.Methods inherited from interface org.apache.catalina.LifecycleaddLifecycleListener, destroy, findLifecycleListeners, getState, getStateName, init, removeLifecycleListener, start, stop
- 
Method Details- 
getResourceObtain the object that represents the resource at the given path. Note the resource at that path may not exist.- Parameters:
- path- The path for the resource of interest relative to the root of the web application. It must start with '/'.
- Returns:
- The object that represents the resource at the given path
 
- 
listObtain the list of the names of all of the files and directories located in the specified directory.- Parameters:
- path- The path for the resource of interest relative to the root of the web application. It must start with '/'.
- Returns:
- The list of resources. If path does not refer to a directory then a zero length array will be returned.
 
- 
listWebAppPathsObtain the Set of the web applications pathnames of all of the files and directories located in the specified directory. Paths representing directories will end with a "/" character.- Parameters:
- path- The path for the resource of interest relative to the root of the web application. It must start with '/'.
- Returns:
- The Set of resources. If path does not refer to a directory then an empty set will be returned.
 
- 
mkdirCreate a new directory at the given path.- Parameters:
- path- The path for the new resource to create relative to the root of the web application. It must start with '/'.
- Returns:
- trueif the directory was created, otherwise- false
 
- 
writeCreate a new resource at the requested path using the provided InputStream.- Parameters:
- path- The path to be used for the new Resource. It is relative to the root of the web application and must start with '/'.
- is- The InputStream that will provide the content for the new Resource.
- overwrite- If- trueand the resource already exists it will be overwritten. If- falseand the resource already exists the write will fail.
- Returns:
- trueif and only if the new Resource is written
 
- 
setRoot
- 
getClassLoaderOnlyboolean getClassLoaderOnly()Should resources returned by this resource set only be included in any results when the lookup is explicitly looking for class loader resources. i.e. should these resources be excluded from look ups that are explicitly looking for static (non-class loader) resources.- Returns:
- trueif these resources should only be used for class loader resource lookups, otherwise- false
 
- 
setClassLoaderOnlyvoid setClassLoaderOnly(boolean classLoaderOnly) 
- 
getStaticOnlyboolean getStaticOnly()Should resources returned by this resource set only be included in any results when the lookup is explicitly looking for static (non-class loader) resources. i.e. should these resources be excluded from look ups that are explicitly looking for class loader resources.- Returns:
- trueif these resources should only be used for static (non-class loader) resource lookups, otherwise- false
 
- 
setStaticOnlyvoid setStaticOnly(boolean staticOnly) 
- 
getBaseUrlURL getBaseUrl()Obtain the base URL for this set of resources. One of the uses of this is to grant read permissions to the resources when running under a security manager.- Returns:
- The base URL for this set of resources
 
- 
setReadOnlyvoid setReadOnly(boolean readOnly) Configures whether or not this set of resources is read-only.- Parameters:
- readOnly-- trueif this set of resources should be configured to be read-only
- Throws:
- IllegalArgumentException- if an attempt is made to configure a- WebResourceSetthat is hard-coded to be read-only as writable
 
- 
isReadOnlyboolean isReadOnly()Obtains the current value of the read-only setting for this set of resources.- Returns:
- trueif this set of resources is configured to be read-only, otherwise- false
 
- 
gcvoid gc()Implementations may cache some information to improve performance. This method triggers the clean-up of those resources.
 
-