|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.apache.catalina.connector.RequestBase
Convenience base implementation of the Request interface, which can be used for the Request implementation required by most Connectors. Only the connector-specific methods need to be implemented.
Field Summary | |
protected java.util.HashMap |
attributes
The attributes associated with this Request, keyed by attribute name. |
protected java.lang.String |
authorization
The authorization credentials sent with this Request. |
protected java.lang.String |
characterEncoding
The character encoding for this Request. |
protected Connector |
connector
The Connector through which this Request was received. |
protected int |
contentLength
The content length associated with this request. |
protected java.lang.String |
contentType
The content type associated with this request. |
protected Context |
context
The Context within which this Request is being processed. |
protected static java.util.Locale |
defaultLocale
The default Locale if none are specified. |
protected RequestFacade |
facade
The facade associated with this request. |
protected static java.lang.String |
info
Descriptive information about this Request implementation. |
protected java.io.InputStream |
input
The input stream associated with this Request. |
protected java.util.ArrayList |
locales
The preferred Locales assocaited with this Request. |
protected java.lang.String |
protocol
The protocol name and version associated with this Request. |
protected java.io.BufferedReader |
reader
The reader that has been returned by getReader , if any. |
protected java.lang.String |
remoteAddr
The remote address associated with this request. |
protected java.lang.String |
remoteHost
The fully qualified name of the remote host. |
protected Response |
response
The response with which this request is associated. |
protected java.lang.String |
scheme
The scheme associated with this Request. |
protected boolean |
secure
Was this request received on a secure connection? |
protected java.lang.String |
serverName
The server name associated with this Request. |
protected int |
serverPort
The server port associated with this Request. |
protected static StringManager |
sm
The string manager for this package. |
protected java.net.Socket |
socket
The socket through which this Request was received. |
protected javax.servlet.ServletInputStream |
stream
The ServletInputStream that has been returned by getInputStream() , if any. |
protected Wrapper |
wrapper
The Wrapper within which this Request is being processed. |
Constructor Summary | |
RequestBase()
|
Method Summary | |
void |
addLocale(java.util.Locale locale)
Add a Locale to the set of preferred Locales for this Request. |
javax.servlet.ServletInputStream |
createInputStream()
Create and return a ServletInputStream to read the content associated with this Request. |
void |
finishRequest()
Perform whatever actions are required to flush and close the input stream or reader, in a single operation. |
java.lang.Object |
getAttribute(java.lang.String name)
Return the specified request attribute if it exists; otherwise, return null . |
java.util.Enumeration |
getAttributeNames()
Return the names of all request attributes for this Request, or an empty Enumeration if there are none. |
java.lang.String |
getAuthorization()
Return the authorization credentials sent with this request. |
java.lang.String |
getCharacterEncoding()
Return the character encoding for this Request. |
Connector |
getConnector()
Return the Connector through which this Request was received. |
int |
getContentLength()
Return the content length for this Request. |
java.lang.String |
getContentType()
Return the content type for this Request. |
Context |
getContext()
Return the Context within which this Request is being processed. |
java.lang.String |
getInfo()
Return descriptive information about this Request implementation and the corresponding version number, in the format <description>/<version> . |
javax.servlet.ServletInputStream |
getInputStream()
Return the servlet input stream for this Request. |
java.util.Locale |
getLocale()
Return the preferred Locale that the client will accept content in, based on the value for the first Accept-Language header
that was encountered. |
java.util.Enumeration |
getLocales()
Return the set of preferred Locales that the client will accept content in, based on the values for any Accept-Language
headers that were encountered. |
java.lang.Object |
getNote(java.lang.String name)
Return the object bound with the specified name to the internal notes for this request, or null if no such binding exists. |
java.util.Iterator |
getNoteNames()
Return an Iterator containing the String names of all notes bindings that exist for this request. |
abstract java.lang.String |
getParameter(java.lang.String name)
Return the value of the specified request parameter, if any; otherwise, return null . |
abstract java.util.Map |
getParameterMap()
Returns a Map of the parameters of this request. |
abstract java.util.Enumeration |
getParameterNames()
Return the names of all defined request parameters for this request. |
abstract java.lang.String[] |
getParameterValues(java.lang.String name)
Return the defined values for the specified request parameter, if any; otherwise, return null . |
java.lang.String |
getProtocol()
Return the protocol and version used to make this Request. |
java.io.BufferedReader |
getReader()
Read the Reader wrapping the input stream for this Request. |
java.lang.String |
getRealPath(java.lang.String path)
Deprecated. As of version 2.1 of the Java Servlet API, use ServletContext.getRealPath() . |
java.lang.String |
getRemoteAddr()
Return the remote IP address making this Request. |
java.lang.String |
getRemoteHost()
Return the remote host name making this Request. |
javax.servlet.ServletRequest |
getRequest()
Return the ServletRequest for which this object
is the facade. |
abstract javax.servlet.RequestDispatcher |
getRequestDispatcher(java.lang.String path)
Return a RequestDispatcher that wraps the resource at the specified path, which may be interpreted as relative to the current request path. |
Response |
getResponse()
Return the Response with which this Request is associated. |
java.lang.String |
getScheme()
Return the scheme used to make this Request. |
java.lang.String |
getServerName()
Return the server name responding to this Request. |
int |
getServerPort()
Return the server port responding to this Request. |
java.net.Socket |
getSocket()
Return the Socket (if any) through which this Request was received. |
java.io.InputStream |
getStream()
Return the input stream associated with this Request. |
Wrapper |
getWrapper()
Return the Wrapper within which this Request is being processed. |
boolean |
isSecure()
Was this request received on a secure connection? |
void |
recycle()
Release all object references, and initialize instance variables, in preparation for reuse of this object. |
void |
removeAttribute(java.lang.String name)
Remove the specified request attribute if it exists. |
void |
removeNote(java.lang.String name)
Remove any object bound to the specified name in the internal notes for this request. |
void |
setAttribute(java.lang.String name,
java.lang.Object value)
Set the specified request attribute to the specified value. |
void |
setAuthorization(java.lang.String authorization)
Set the authorization credentials sent with this request. |
void |
setCharacterEncoding(java.lang.String enc)
Overrides the name of the character encoding used in the body of this request. |
void |
setConnector(Connector connector)
Set the Connector through which this Request was received. |
void |
setContentLength(int length)
Set the content length associated with this Request. |
void |
setContentType(java.lang.String type)
Set the content type (and optionally the character encoding) associated with this Request. |
void |
setContext(Context context)
Set the Context within which this Request is being processed. |
void |
setNote(java.lang.String name,
java.lang.Object value)
Bind an object to a specified name in the internal notes associated with this request, replacing any existing binding for this name. |
void |
setProtocol(java.lang.String protocol)
Set the protocol name and version associated with this Request. |
void |
setRemoteAddr(java.lang.String remoteAddr)
Set the IP address of the remote client associated with this Request. |
void |
setRemoteHost(java.lang.String remoteHost)
Set the fully qualified name of the remote client associated with this Request. |
void |
setResponse(Response response)
Set the Response with which this Request is associated. |
void |
setScheme(java.lang.String scheme)
Set the name of the scheme associated with this request. |
void |
setSecure(boolean secure)
Set the value to be returned by isSecure()
for this Request. |
void |
setServerName(java.lang.String name)
Set the name of the server (virtual host) to process this request. |
void |
setServerPort(int port)
Set the port number of the server to process this request. |
void |
setSocket(java.net.Socket socket)
Set the Socket (if any) through which this Request was received. |
void |
setStream(java.io.InputStream input)
Set the input stream associated with this Request. |
void |
setWrapper(Wrapper wrapper)
Set the Wrapper within which this Request is being processed. |
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
Field Detail |
protected java.util.HashMap attributes
protected java.lang.String authorization
protected java.lang.String characterEncoding
protected Connector connector
protected int contentLength
protected java.lang.String contentType
protected Context context
protected static java.util.Locale defaultLocale
protected RequestFacade facade
protected static final java.lang.String info
protected java.io.InputStream input
protected java.util.ArrayList locales
protected java.lang.String protocol
protected java.io.BufferedReader reader
getReader
, if any.protected java.lang.String remoteAddr
protected java.lang.String remoteHost
protected Response response
protected java.lang.String scheme
protected boolean secure
protected java.lang.String serverName
protected int serverPort
protected static StringManager sm
protected java.net.Socket socket
protected javax.servlet.ServletInputStream stream
getInputStream()
, if any.protected Wrapper wrapper
Constructor Detail |
public RequestBase()
Method Detail |
public java.lang.String getAuthorization()
public void setAuthorization(java.lang.String authorization)
authorization
- The new authorization credentialspublic Connector getConnector()
public void setConnector(Connector connector)
connector
- The new connectorpublic Context getContext()
public void setContext(Context context)
getContextPath()
,
and thus enables parsing of the request URI.context
- The newly associated Contextpublic java.lang.String getInfo()
<description>/<version>
.public javax.servlet.ServletRequest getRequest()
ServletRequest
for which this object
is the facade. This method must be implemented by a subclass.public Response getResponse()
public void setResponse(Response response)
response
- The new associated responsepublic java.net.Socket getSocket()
public void setSocket(java.net.Socket socket)
socket
- The socket through which this request was receivedpublic java.io.InputStream getStream()
public void setStream(java.io.InputStream input)
input
- The new input streampublic Wrapper getWrapper()
public void setWrapper(Wrapper wrapper)
wrapper
- The newly associated Wrapperpublic void addLocale(java.util.Locale locale)
locale
- The new preferred Localepublic javax.servlet.ServletInputStream createInputStream() throws java.io.IOException
public void finishRequest() throws java.io.IOException
public java.lang.Object getNote(java.lang.String name)
null
if no such binding exists.name
- Name of the note to be returnedpublic java.util.Iterator getNoteNames()
public void recycle()
public void removeNote(java.lang.String name)
name
- Name of the note to be removedpublic void setContentLength(int length)
length
- The new content lengthpublic void setContentType(java.lang.String type)
text/html; charset=ISO-8859-4
.type
- The new content typepublic void setNote(java.lang.String name, java.lang.Object value)
name
- Name to which the object should be boundvalue
- Object to be bound to the specified namepublic void setProtocol(java.lang.String protocol)
protocol
- Protocol name and versionpublic void setRemoteAddr(java.lang.String remoteAddr)
remoteAddr
- The remote IP addresspublic void setRemoteHost(java.lang.String remoteHost)
remoteHost
- The remote host namepublic void setScheme(java.lang.String scheme)
http
, https
, and ftp
.scheme
- The schemepublic void setSecure(boolean secure)
isSecure()
for this Request.secure
- The new isSecure valuepublic void setServerName(java.lang.String name)
name
- The server namepublic void setServerPort(int port)
port
- The server portpublic java.lang.Object getAttribute(java.lang.String name)
null
.name
- Name of the request attribute to returnpublic java.util.Enumeration getAttributeNames()
Enumeration
if there are none.public java.lang.String getCharacterEncoding()
public int getContentLength()
public java.lang.String getContentType()
public javax.servlet.ServletInputStream getInputStream() throws java.io.IOException
createInputStream()
.getReader()
has
already been called for this requestpublic java.util.Locale getLocale()
Accept-Language
header
that was encountered. If the request did not specify a preferred
language, the server's default Locale is returned.public java.util.Enumeration getLocales()
Accept-Language
headers that were encountered. If the request did not specify a
preferred language, the server's default Locale is returned.public abstract java.lang.String getParameter(java.lang.String name)
null
. If there is more than one value defined,
return only the first one.name
- Name of the desired request parameterpublic abstract java.util.Map getParameterMap()
Map
of the parameters of this request.
Request parameters are extra information sent with the request.
For HTTP servlets, parameters are contained in the query string
or posted form data.Map
containing parameter names as keys
and parameter values as map values.public abstract java.util.Enumeration getParameterNames()
public abstract java.lang.String[] getParameterValues(java.lang.String name)
null
.name
- Name of the desired request parameterpublic java.lang.String getProtocol()
public java.io.BufferedReader getReader() throws java.io.IOException
BufferedReader
around the
servlet input stream returned by createInputStream()
.getInputStream()
has already been called for this requestpublic java.lang.String getRealPath(java.lang.String path)
ServletContext.getRealPath()
.
path
- Path to be translatedpublic java.lang.String getRemoteAddr()
public java.lang.String getRemoteHost()
public abstract javax.servlet.RequestDispatcher getRequestDispatcher(java.lang.String path)
path
- Path of the resource to be wrappedpublic java.lang.String getScheme()
public java.lang.String getServerName()
public int getServerPort()
public boolean isSecure()
public void removeAttribute(java.lang.String name)
name
- Name of the request attribute to removepublic void setAttribute(java.lang.String name, java.lang.Object value)
name
- Name of the request attribute to setvalue
- The associated valuepublic void setCharacterEncoding(java.lang.String enc) throws java.io.UnsupportedEncodingException
getReader()
.enc
- The character encoding to be used
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |