Package org.apache.catalina
Interface WebResource
- All Known Implementing Classes:
- AbstractArchiveResource,- AbstractResource,- AbstractSingleArchiveResource,- CachedResource,- EmptyResource,- FileResource,- JarResource,- JarResourceRoot,- JarWarResource,- VirtualResource,- WarResource
public interface WebResource
Represents a file or directory within a web application. It borrows heavily
 from 
File.- 
Method SummaryModifier and TypeMethodDescriptionbooleancanRead()booleandelete()booleanexists()byte[]longlonggetETag()Return the strong ETag if available (currently not supported) else return the weak ETag calculated from the content length and last modified.Obtain an InputStream based on the contents of this resource.longgetName()getURL()booleanbooleanisFile()booleanIndicates if this resource is required for applications to correctly scan the file structure but that does not exist in either the main or any additionalWebResourceSet.voidsetMimeType(String mimeType) Set the MIME type for this Resource.
- 
Method Details- 
getLastModifiedlong getLastModified()- Returns:
- File.lastModified().
 
- 
getLastModifiedHttpString getLastModifiedHttp()- Returns:
- the last modified time of this resource in the correct format for the HTTP Last-Modified header as specified by RFC 2616.
 
- 
existsboolean exists()- Returns:
- File.exists().
 
- 
isVirtualboolean isVirtual()Indicates if this resource is required for applications to correctly scan the file structure but that does not exist in either the main or any additionalWebResourceSet. For example, if an external directory is mapped to /WEB-INF/lib in an otherwise empty web application, /WEB-INF will be represented as a virtual resource.- Returns:
- truefor a virtual resource
 
- 
isDirectoryboolean isDirectory()- Returns:
- File.isDirectory().
 
- 
isFileboolean isFile()- Returns:
- File.isFile().
 
- 
deleteboolean delete()- Returns:
- File.delete().
 
- 
getNameString getName()- Returns:
- File.getName().
 
- 
getContentLengthlong getContentLength()- Returns:
- File.length().
 
- 
getCanonicalPathString getCanonicalPath()- Returns:
- File.getCanonicalPath().
 
- 
canReadboolean canRead()- Returns:
- File.canRead().
 
- 
getWebappPathString getWebappPath()- Returns:
- The path of this resource relative to the web application root. If the resource is a directory, the return value will end in '/'.
 
- 
getETagString getETag()Return the strong ETag if available (currently not supported) else return the weak ETag calculated from the content length and last modified.- Returns:
- The ETag for this resource
 
- 
setMimeTypeSet the MIME type for this Resource.- Parameters:
- mimeType- The mime type that will be associated with the resource
 
- 
getMimeTypeString getMimeType()- Returns:
- the MIME type for this Resource.
 
- 
getInputStreamInputStream getInputStream()Obtain an InputStream based on the contents of this resource.- Returns:
- An InputStream based on the contents of this resource or
          nullif the resource does not exist or does not represent a file
 
- 
getContentbyte[] getContent()- Returns:
- the binary content of this resource or nullif it is not available in a byte[] because, for example, it is too big.
 
- 
getCreationlong getCreation()- Returns:
- The time the file was created. If not available, the result of
 getLastModified()will be returned.
 
- 
getURLURL getURL()- Returns:
- a URL to access the resource or nullif no such URL is available or if the resource does not exist.
 
- 
getCodeBaseURL getCodeBase()- Returns:
- the code base for this resource that will be used when looking up the assigned permissions for the code base in the security policy file when running under a security manager.
 
- 
getWebResourceRootWebResourceRoot getWebResourceRoot()- Returns:
- a reference to the WebResourceRoot of which this WebResource is a part.
 
- 
getCertificatesCertificate[] getCertificates()- Returns:
- the certificates that were used to sign this resource to verify it or @null if none.
- See Also:
 
- 
getManifestManifest getManifest()- Returns:
- the manifest associated with this resource or @null if none.
- See Also:
 
 
-