Interface Context
-
- All Known Implementing Classes:
ContextImpl
,PageTesterContext
public interface Context
An API agnostic version ofServletContext
, used to bridge the gaps between the Servlet API and the Portlet API.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description java.lang.Object
getAttribute(java.lang.String name)
Returns an attribute previously stored into the context with the given name.java.util.List<java.lang.String>
getAttributeNames()
Returns the names of all attributes of the context, sorted alphabetically.java.lang.String
getInitParameter(java.lang.String name)
Returns an initial parameter value defined by servlet.java.lang.String
getMimeType(java.lang.String file)
Returns the MIME content type of the specified file, or null if no content type is known.java.io.File
getRealFile(java.lang.String path)
Attempts to find the actual file, on the file system, that would be provided by the servlet container for the given path (which must start with a leading slash).java.net.URL
getResource(java.lang.String path)
Returns a URL to a resource stored within the context.java.util.List<java.lang.String>
getResourcePaths(java.lang.String path)
Looks for resources within the web application within the supplied path.
-
-
-
Method Detail
-
getResource
java.net.URL getResource(java.lang.String path)
Returns a URL to a resource stored within the context. The path should start with a leading slash.- Parameters:
path
- to the resource (with a leading slash)- Returns:
- the URL for the path, or null if the path does not correspond to a file.
-
getRealFile
java.io.File getRealFile(java.lang.String path)
Attempts to find the actual file, on the file system, that would be provided by the servlet container for the given path (which must start with a leading slash). This may return null if no such file exists, or if the resource in question is packaged inside a WAR. If packaged inside a WAR, the contents may be accessed viagetResource(String)
.- Parameters:
path
- to the resource (with a leading slash)- Returns:
- the underlying File, or null if no such file
-
getInitParameter
java.lang.String getInitParameter(java.lang.String name)
Returns an initial parameter value defined by servlet.
-
getResourcePaths
java.util.List<java.lang.String> getResourcePaths(java.lang.String path)
Looks for resources within the web application within the supplied path. The list will be recurively expanded, as necessary. The path must start with a leading slash, and usually ends with a slash as well.- Parameters:
path
- to search for (should start with a leading slash)- Returns:
- the matches, sorted alphabetically
-
getAttribute
java.lang.Object getAttribute(java.lang.String name)
Returns an attribute previously stored into the context with the given name.- Parameters:
name
- used to retrieve the attribute- Returns:
- the attribute, or null if not found
-
getAttributeNames
java.util.List<java.lang.String> getAttributeNames()
Returns the names of all attributes of the context, sorted alphabetically.
-
getMimeType
java.lang.String getMimeType(java.lang.String file)
Returns the MIME content type of the specified file, or null if no content type is known. MIME types are built-in to servlet containers and may be futher specified via the web application deployment descriptor.- Parameters:
file
- name of file- Returns:
- the presumed MIME content type, or null if not known
- Since:
- 5.1.0.0
-
-