getAttribute(String name) Returns the servlet container attribute with the given name,
or null if there is no attribute by that name.
An attribute allows a servlet container to give the
servlet additional information not
already provided by this interface.
getInitParameter(String s) Returns a String containing the value of the named
context-wide initialization parameter, or null if the
parameter does not exist.
This method can make available configuration information useful
to an entire "web application".
getInitParameterNames() Returns the names of the context's initialization parameters as an
Enumeration of String objects, or an
empty Enumeration if the context has no initialization
parameters.
public int
getMajorVersion() Returns the major version of the Java Servlet API that this
Web server supports.
getRequestDispatcher(String urlpath) Returns a
RequestDispatcher object that acts
as a wrapper for the resource located at the given path.
A RequestDispatcher object can be used to forward
a request to the resource or to include the resource in a response.
The resource can be dynamic or static.
The pathname must begin with a "/" and is interpreted as relative
to the current context root.
getResourceAsFile(String path) Attempts to load a resource from the underlying file system
and return a file handle to it.
It first treats the path as an absolute path.
Returns the servlet container attribute with the given name,
or null if there is no attribute by that name.
An attribute allows a servlet container to give the
servlet additional information not
already provided by this interface. See your
server documentation for information about its attributes.
A list of supported attributes can be retrieved using
getAttributeNames.
The attribute is returned as a java.lang.Object
or some subclass.
Attribute names should follow the same convention as package
names. The Java Servlet API specification reserves names
matching java.*, javax.*,
and sun.*.
Parameters: name - a String specifying the nameof the attribute an Object containing the valueof the attribute, or nullif no attribute exists matching the givenname See Also:ServletContext.getAttributeNames
Returns a String containing the value of the named
context-wide initialization parameter, or null if the
parameter does not exist.
This method can make available configuration information useful
to an entire "web application". For example, it can provide a
webmaster's email address or the name of a system that holds
critical data.
Parameters: s - a String containing the name of theparameter whose value is requested a String containing at least theservlet container name and version number See Also:javax.servlet.ServletConfig.getInitParameter
Returns the names of the context's initialization parameters as an
Enumeration of String objects, or an
empty Enumeration if the context has no initialization
parameters.
an Enumeration of Stringobjects containing the names of the context'sinitialization parameters See Also:javax.servlet.ServletConfig.getInitParameter
Returns the major version of the Java Servlet API that this
Web server supports. All implementations that comply
with Version 2.3 must have this method
return the integer 2.
2
Returns the minor version of the Servlet API that this
Web server supports. All implementations that comply
with Version 2.3 must have this method
return the integer 1.
3
Returns a
RequestDispatcher object that acts
as a wrapper for the resource located at the given path.
A RequestDispatcher object can be used to forward
a request to the resource or to include the resource in a response.
The resource can be dynamic or static.
The pathname must begin with a "/" and is interpreted as relative
to the current context root. Use getContext to obtain
a RequestDispatcher for resources in foreign contexts.
This method returns null if the ServletContext
cannot return a RequestDispatcher.
Parameters: urlpath - a String specifying the pathnameto the resource a RequestDispatcher objectthat acts as a wrapper for the resourceat the specified path See Also:RequestDispatcher See Also:ServletContext.getContext
Returns the mock RequestDispatcher object used in this test.
The RequestDispatcherSimulator contains forwarding information
that can be used in test validation.
Attempts to load a resource from the underlying file system
and return a file handle to it.
It first treats the path as an absolute path. If no file is found,
it attempts to treat the path as relative to the context directory.
If no file is found, it attempts to treat the path as relative to
the current directory.
If all these options fail, the returned file will return false()
to calls to File.exists().
Parameters: path - the relative or context-relative path to the file the refernce to the file (which may or may not exist)
Returns the resource located at the named path as
an InputStream object.
The data in the InputStream can be
of any type or length. The path must be specified according
to the rules given in getResource.
This method returns null if no resource exists at
the specified path.
Meta-information such as content length and content type
that is available via getResource
method is lost when using this method.
The servlet container must implement the URL handlers
and URLConnection objects necessary to access
the resource.
In this mock implementation, this method first looks for
the supplied pathname in the underlying filesystem; if it
does not exist there, the default Java classloader is used.
Parameters: path - a String specifying the pathto the resource the InputStream returned to theservlet, or null if no resourceexists at the specified path
Returns the name and version of the servlet container on which
the servlet is running.
The form of the returned string is
servername/versionnumber.
For example, the JavaServer Web Development Kit may return the string
JavaServer Web Dev Kit/1.0.
The servlet container may return other optional information
after the primary string in parentheses, for example,
JavaServer Web Dev Kit/1.0 (JDK 1.1.6; Windows NT 4.0 x86).
a String containing at least theservlet container name and version number
Writes the specified message to a servlet log file, which is usually
an event log. The message provides explanatory information about
an exception or error or an action the servlet engine takes. The name
and type of the servlet log file is specific to the servlet engine.
Parameters: msg - a String specifying the explanatorymessage to be written to the log file
Writes the stack trace and an explanatory message
for a given Throwable exception
to the servlet log file. The name and type of the servlet log
file is specific to the servlet engine, but it is usually an event log.
Parameters: message - a String thatdescribes the error or exception Parameters: throwable - the Throwable erroror exception
Removes the attribute with the given name from
the servlet context. After removal, subsequent calls to
ServletContextSimulator.getAttribute to retrieve the attribute's value
will return null.
If listeners are configured on the ServletContext the
container notifies them accordingly.
Parameters: name - a String specifying the nameof the attribute to be removed
Binds an object to a given attribute name in this servlet context. If
the name specified is already used for an attribute, this
method will replace the attribute with the new to the new attribute.
If listeners are configured on the ServletContext the
container notifies them accordingly.
If a null value is passed, the effect is the same as calling
removeAttribute().
Attribute names should follow the same convention as package
names. The Java Servlet API specification reserves names
matching java.*, javax.*, and
sun.*.
Parameters: name - a String specifying the nameof the attribute Parameters: object - an Object representing theattribute to be bound
setContextDirectory
public void setContextDirectory(File contextDirectory)(Code)
Sets the absolute context directory to be used in the getRealPath() method.
Parameters: contextDirectory - the absolute path of the root context directory for this application.
Sets a named initialization parameter with the supplied
String value.
Parameters: key - a String specifying the nameof the initialization parameter Parameters: value - a String value for this initializationparameter