Top Description Constructors Methods
javax.servlet.http

public Class HttpServletRequestWrapper

extends ServletRequestWrapper
implements HttpServletRequest
Class Inheritance
All Implemented Interfaces
javax.servlet.http.HttpServletRequest, javax.servlet.ServletRequest
Imports
java.io.IOException, java.util.*, javax.servlet.ServletException, .ServletRequestWrapper
Provides a convenient implementation of the HttpServletRequest interface that can be subclassed by developers wishing to adapt the request to a Servlet.

This class implements the Wrapper or Decorator pattern. Methods default to calling through to the wrapped request object.

Since
Servlet 2.3
See Also
javax.servlet.http.HttpServletRequest

Constructor Summary

AccessConstructor and Description
public
HttpServletRequestWrapper(HttpServletRequest
the HttpServletRequest to be wrapped.
request)

Constructs a request object wrapping the given request.

Method Summary

Modifier and TypeMethod and Description
private HttpServletRequest
_getHttpServletRequest()

public boolean
authenticate(HttpServletResponse
The HttpServletResponse associated with this HttpServletRequest
response)

Implements javax.servlet.http.HttpServletRequest.authenticate.

The default behavior of this method is to call authenticate on the wrapped request object.
public String
changeSessionId()

Implements javax.servlet.http.HttpServletRequest.changeSessionId.

The default behavior of this method is to return changeSessionId() on the wrapped request object.
public String
getAuthType()

Implements javax.servlet.http.HttpServletRequest.getAuthType.

The default behavior of this method is to return getAuthType() on the wrapped request object.
public String
getContextPath()

Implements javax.servlet.http.HttpServletRequest.getContextPath.

The default behavior of this method is to return getContextPath() on the wrapped request object.
public Cookie[]
getCookies()

Implements javax.servlet.http.HttpServletRequest.getCookies.

The default behavior of this method is to return getCookies() on the wrapped request object.
public long
getDateHeader(String
a String specifying the name of the header
name)

Implements javax.servlet.http.HttpServletRequest.getDateHeader.

The default behavior of this method is to return getDateHeader(String name) on the wrapped request object.
public String
getHeader(String
a String specifying the header name
name)

Implements javax.servlet.http.HttpServletRequest.getHeader.

The default behavior of this method is to return getHeader(String name) on the wrapped request object.
public Enumeration<String>
getHeaderNames()

Implements javax.servlet.http.HttpServletRequest.getHeaderNames.

The default behavior of this method is to return getHeaderNames() on the wrapped request object.
public Enumeration<String>
getHeaders(String
a String specifying the header name
name)

Implements javax.servlet.http.HttpServletRequest.getHeaders.

The default behavior of this method is to return getHeaders(String name) on the wrapped request object.
public HttpServletMapping
getHttpServletMapping()

Overrides default javax.servlet.http.HttpServletRequest.getHttpServletMapping.

The default behavior of this method is to return getServletMapping() on the wrapped request object.

public int
getIntHeader(String
a String specifying the name of a request header
name)

Implements javax.servlet.http.HttpServletRequest.getIntHeader.

The default behavior of this method is to return getIntHeader(String name) on the wrapped request object.
public String
getMethod()

Implements javax.servlet.http.HttpServletRequest.getMethod.

The default behavior of this method is to return getMethod() on the wrapped request object.
public Part
getPart(String
the name of the requested Part
name)

Implements javax.servlet.http.HttpServletRequest.getPart.

The default behavior of this method is to call getPart on the wrapped request object.
public Collection<Part>
getParts()

Implements javax.servlet.http.HttpServletRequest.getParts.

The default behavior of this method is to call getParts on the wrapped request object.
public String
getPathInfo()

Implements javax.servlet.http.HttpServletRequest.getPathInfo.

The default behavior of this method is to return getPathInfo() on the wrapped request object.
public String
getPathTranslated()

Implements javax.servlet.http.HttpServletRequest.getPathTranslated.

The default behavior of this method is to return getPathTranslated() on the wrapped request object.
public String
getQueryString()

Implements javax.servlet.http.HttpServletRequest.getQueryString.

The default behavior of this method is to return getQueryString() on the wrapped request object.
public String
getRemoteUser()

Implements javax.servlet.http.HttpServletRequest.getRemoteUser.

The default behavior of this method is to return getRemoteUser() on the wrapped request object.
public String
getRequestedSessionId()

Implements javax.servlet.http.HttpServletRequest.getRequestedSessionId.

The default behavior of this method is to return getRequestedSessionId() on the wrapped request object.
public String
getRequestURI()

Implements javax.servlet.http.HttpServletRequest.getRequestURI.

The default behavior of this method is to return getRequestURI() on the wrapped request object.
public StringBuffer
getRequestURL()

Implements javax.servlet.http.HttpServletRequest.getRequestURL.

The default behavior of this method is to return getRequestURL() on the wrapped request object.
public String
getServletPath()

Implements javax.servlet.http.HttpServletRequest.getServletPath.

The default behavior of this method is to return getServletPath() on the wrapped request object.
public HttpSession
getSession(boolean
true to create a new session for this request if necessary; false to return null if there's no current session
create)

Implements javax.servlet.http.HttpServletRequest.getSession.

The default behavior of this method is to return getSession(boolean create) on the wrapped request object.
public HttpSession
getSession()

Implements javax.servlet.http.HttpServletRequest.getSession.

The default behavior of this method is to return getSession() on the wrapped request object.
public Map<String, String>
getTrailerFields()

Overrides default javax.servlet.http.HttpServletRequest.getTrailerFields.

The default behavior of this method is to call getTrailerFields on the wrapped request object.
public Principal
getUserPrincipal()

Implements javax.servlet.http.HttpServletRequest.getUserPrincipal.

The default behavior of this method is to return getUserPrincipal() on the wrapped request object.
public boolean
isRequestedSessionIdFromCookie()

Implements javax.servlet.http.HttpServletRequest.isRequestedSessionIdFromCookie.

The default behavior of this method is to return isRequestedSessionIdFromCookie() on the wrapped request object.
public boolean
isRequestedSessionIdFromURL()

Implements javax.servlet.http.HttpServletRequest.isRequestedSessionIdFromURL.

The default behavior of this method is to return isRequestedSessionIdFromURL() on the wrapped request object.
public boolean
isRequestedSessionIdFromUrl()

Implements javax.servlet.http.HttpServletRequest.isRequestedSessionIdFromUrl.

Deprecated As of Version 4.0 of the Java Servlet API, use isRequestedSessionIdFromURL instead.
The default behavior of this method is to return isRequestedSessionIdFromUrl() on the wrapped request object.
public boolean
isRequestedSessionIdValid()

Implements javax.servlet.http.HttpServletRequest.isRequestedSessionIdValid.

The default behavior of this method is to return isRequestedSessionIdValid() on the wrapped request object.
public boolean
isTrailerFieldsReady()

Overrides default javax.servlet.http.HttpServletRequest.isTrailerFieldsReady.

The default behavior of this method is to call isTrailerFieldsReady on the wrapped request object.
public boolean
isUserInRole(String
a String specifying the name of the role
role)

Implements javax.servlet.http.HttpServletRequest.isUserInRole.

The default behavior of this method is to return isUserInRole(String role) on the wrapped request object.
public void
login(String
The String value corresponding to the login identifier of the user.
username, String
The password String corresponding to the identified user.
password)

Implements javax.servlet.http.HttpServletRequest.login.

The default behavior of this method is to call login on the wrapped request object.
public void
logout()

Implements javax.servlet.http.HttpServletRequest.logout.

The default behavior of this method is to call login on the wrapped request object.
public PushBuilder
newPushBuilder()

Overrides default javax.servlet.http.HttpServletRequest.newPushBuilder.

The default behavior of this method is to call newPushBuilder on the wrapped request object.
public <T extends HttpUpgradeHandler> T
upgrade(Class<T>
The HttpUpgradeHandler class used for the upgrade.
handlerClass)

Implements javax.servlet.http.HttpServletRequest.upgrade.

Create an instance of HttpUpgradeHandler for a given class and uses it for the http protocol upgrade processing.
Inherited from javax.servlet.ServletRequestWrapper:
getAsyncContextgetAttributegetAttributeNamesgetCharacterEncodinggetContentLengthgetContentLengthLonggetContentTypegetDispatcherTypegetInputStreamgetLocalAddrgetLocalegetLocalesgetLocalNamegetLocalPortgetParametergetParameterMapgetParameterNamesgetParameterValuesgetProtocolgetReadergetRealPathgetRemoteAddrgetRemoteHostgetRemotePortgetRequestgetRequestDispatchergetSchemegetServerNamegetServerPortgetServletContextisAsyncStartedisAsyncSupportedisSecureisWrapperForisWrapperForremoveAttributesetAttributesetCharacterEncodingsetRequeststartAsyncstartAsync

Constructor Detail

HttpServletRequestWrapperback to summary
public HttpServletRequestWrapper(HttpServletRequest request)

Constructs a request object wrapping the given request.

Parameters
request:HttpServletRequest

the HttpServletRequest to be wrapped.

Exceptions
IllegalArgumentException:
if the request is null

Method Detail

_getHttpServletRequestback to summary
private HttpServletRequest _getHttpServletRequest()
authenticateback to summary
public boolean authenticate(HttpServletResponse response) throws IOException, ServletException

Implements javax.servlet.http.HttpServletRequest.authenticate.

The default behavior of this method is to call authenticate on the wrapped request object.

Parameters
response:HttpServletResponse

Doc from javax.servlet.http.HttpServletRequest.authenticate.

The HttpServletResponse associated with this HttpServletRequest

Returns:boolean

Doc from javax.servlet.http.HttpServletRequest.authenticate.

true when non-null values were or have been established as the values returned by getUserPrincipal, getRemoteUser, and getAuthType. Return false if authentication is incomplete and the underlying login mechanism has committed, in the response, the message (e.g., challenge) and HTTP status code to be returned to the user.

Annotations
@Override
Exceptions
IOException:

Doc from javax.servlet.http.HttpServletRequest.authenticate.

if an input or output error occurred while reading from this request or writing to the given response

ServletException:

Doc from javax.servlet.http.HttpServletRequest.authenticate.

if the authentication failed and the caller is responsible for handling the error (i.e., the underlying login mechanism did NOT establish the message and HTTP status code to be returned to the user)

Since
Servlet 3.0
changeSessionIdback to summary
public String changeSessionId()

Implements javax.servlet.http.HttpServletRequest.changeSessionId.

The default behavior of this method is to return changeSessionId() on the wrapped request object.

Returns:String

Doc from javax.servlet.http.HttpServletRequest.changeSessionId.

the new session id

Annotations
@Override
Since
Servlet 3.1
getAuthTypeback to summary
public String getAuthType()

Implements javax.servlet.http.HttpServletRequest.getAuthType.

The default behavior of this method is to return getAuthType() on the wrapped request object.

Returns:String

Doc from javax.servlet.http.HttpServletRequest.getAuthType.

one of the static members BASIC_AUTH, FORM_AUTH, CLIENT_CERT_AUTH, DIGEST_AUTH (suitable for == comparison) or the container-specific string indicating the authentication scheme, or null if the request was not authenticated.

Annotations
@Override
getContextPathback to summary
public String getContextPath()

Implements javax.servlet.http.HttpServletRequest.getContextPath.

The default behavior of this method is to return getContextPath() on the wrapped request object.

Returns:String

Doc from javax.servlet.http.HttpServletRequest.getContextPath.

a String specifying the portion of the request URI that indicates the context of the request

Annotations
@Override
getCookiesback to summary
public Cookie[] getCookies()

Implements javax.servlet.http.HttpServletRequest.getCookies.

The default behavior of this method is to return getCookies() on the wrapped request object.

Returns:Cookie[]

Doc from javax.servlet.http.HttpServletRequest.getCookies.

an array of all the Cookies included with this request, or null if the request has no cookies

Annotations
@Override
getDateHeaderback to summary
public long getDateHeader(String name)

Implements javax.servlet.http.HttpServletRequest.getDateHeader.

The default behavior of this method is to return getDateHeader(String name) on the wrapped request object.

Parameters
name:String

Doc from javax.servlet.http.HttpServletRequest.getDateHeader.

a String specifying the name of the header

Returns:long

Doc from javax.servlet.http.HttpServletRequest.getDateHeader.

a long value representing the date specified in the header expressed as the number of milliseconds since January 1, 1970 GMT, or -1 if the named header was not included with the request

Annotations
@Override
getHeaderback to summary
public String getHeader(String name)

Implements javax.servlet.http.HttpServletRequest.getHeader.

The default behavior of this method is to return getHeader(String name) on the wrapped request object.

Parameters
name:String

Doc from javax.servlet.http.HttpServletRequest.getHeader.

a String specifying the header name

Returns:String

Doc from javax.servlet.http.HttpServletRequest.getHeader.

a String containing the value of the requested header, or null if the request does not have a header of that name

Annotations
@Override
getHeaderNamesback to summary
public Enumeration<String> getHeaderNames()

Implements javax.servlet.http.HttpServletRequest.getHeaderNames.

The default behavior of this method is to return getHeaderNames() on the wrapped request object.

Returns:Enumeration<String>

Doc from javax.servlet.http.HttpServletRequest.getHeaderNames.

an enumeration of all the header names sent with this request; if the request has no headers, an empty enumeration; if the servlet container does not allow servlets to use this method, null

Annotations
@Override
getHeadersback to summary
public Enumeration<String> getHeaders(String name)

Implements javax.servlet.http.HttpServletRequest.getHeaders.

The default behavior of this method is to return getHeaders(String name) on the wrapped request object.

Parameters
name:String

Doc from javax.servlet.http.HttpServletRequest.getHeaders.

a String specifying the header name

Returns:Enumeration<String>

Doc from javax.servlet.http.HttpServletRequest.getHeaders.

an Enumeration containing the values of the requested header. If the request does not have any headers of that name return an empty enumeration. If the container does not allow access to header information, return null

Annotations
@Override
getHttpServletMappingback to summary
public HttpServletMapping getHttpServletMapping()

Overrides default javax.servlet.http.HttpServletRequest.getHttpServletMapping.

The default behavior of this method is to return getServletMapping() on the wrapped request object.

Returns:HttpServletMapping

Doc from javax.servlet.http.HttpServletRequest.getHttpServletMapping.

An instance of HttpServletMapping describing the manner in which the current request was invoked.

Annotations
@Override
getIntHeaderback to summary
public int getIntHeader(String name)

Implements javax.servlet.http.HttpServletRequest.getIntHeader.

The default behavior of this method is to return getIntHeader(String name) on the wrapped request object.

Parameters
name:String

Doc from javax.servlet.http.HttpServletRequest.getIntHeader.

a String specifying the name of a request header

Returns:int

Doc from javax.servlet.http.HttpServletRequest.getIntHeader.

an integer expressing the value of the request header or -1 if the request doesn't have a header of this name

Annotations
@Override
getMethodback to summary
public String getMethod()

Implements javax.servlet.http.HttpServletRequest.getMethod.

The default behavior of this method is to return getMethod() on the wrapped request object.

Returns:String

Doc from javax.servlet.http.HttpServletRequest.getMethod.

a String specifying the name of the method with which this request was made

Annotations
@Override
getPartback to summary
public Part getPart(String name) throws IOException, ServletException

Implements javax.servlet.http.HttpServletRequest.getPart.

The default behavior of this method is to call getPart on the wrapped request object.

Parameters
name:String

Doc from javax.servlet.http.HttpServletRequest.getPart.

the name of the requested Part

Returns:Part

Doc from javax.servlet.http.HttpServletRequest.getPart.

The Part with the given name, or null if this request is of type multipart/form-data, but does not contain the requested Part

Annotations
@Override
Exceptions
IOException:

Doc from javax.servlet.http.HttpServletRequest.getPart.

if an I/O error occurred during the retrieval of the requested Part

ServletException:

Doc from javax.servlet.http.HttpServletRequest.getPart.

if this request is not of type multipart/form-data

Since
Servlet 3.0
getPartsback to summary
public Collection<Part> getParts() throws IOException, ServletException

Implements javax.servlet.http.HttpServletRequest.getParts.

The default behavior of this method is to call getParts on the wrapped request object.

Any changes to the returned Collection must not affect this HttpServletRequestWrapper.

Returns:Collection<Part>

Doc from javax.servlet.http.HttpServletRequest.getParts.

a (possibly empty) Collection of the Part components of this request

Annotations
@Override
Exceptions
IOException:

Doc from javax.servlet.http.HttpServletRequest.getParts.

if an I/O error occurred during the retrieval of the Part components of this request

ServletException:

Doc from javax.servlet.http.HttpServletRequest.getParts.

if this request is not of type multipart/form-data

Since
Servlet 3.0
getPathInfoback to summary
public String getPathInfo()

Implements javax.servlet.http.HttpServletRequest.getPathInfo.

The default behavior of this method is to return getPathInfo() on the wrapped request object.

Returns:String

Doc from javax.servlet.http.HttpServletRequest.getPathInfo.

a String, decoded by the web container, specifying extra path information that comes after the servlet path but before the query string in the request URL; or null if the URL does not have any extra path information

Annotations
@Override
getPathTranslatedback to summary
public String getPathTranslated()

Implements javax.servlet.http.HttpServletRequest.getPathTranslated.

The default behavior of this method is to return getPathTranslated() on the wrapped request object.

Returns:String

Doc from javax.servlet.http.HttpServletRequest.getPathTranslated.

a String specifying the real path, or null if the URL does not have any extra path information

Annotations
@Override
getQueryStringback to summary
public String getQueryString()

Implements javax.servlet.http.HttpServletRequest.getQueryString.

The default behavior of this method is to return getQueryString() on the wrapped request object.

Returns:String

Doc from javax.servlet.http.HttpServletRequest.getQueryString.

a String containing the query string or null if the URL contains no query string. The value is not decoded by the container.

Annotations
@Override
getRemoteUserback to summary
public String getRemoteUser()

Implements javax.servlet.http.HttpServletRequest.getRemoteUser.

The default behavior of this method is to return getRemoteUser() on the wrapped request object.

Returns:String

Doc from javax.servlet.http.HttpServletRequest.getRemoteUser.

a String specifying the login of the user making this request, or null if the user login is not known

Annotations
@Override
getRequestedSessionIdback to summary
public String getRequestedSessionId()

Implements javax.servlet.http.HttpServletRequest.getRequestedSessionId.

The default behavior of this method is to return getRequestedSessionId() on the wrapped request object.

Returns:String

Doc from javax.servlet.http.HttpServletRequest.getRequestedSessionId.

a String specifying the session ID, or null if the request did not specify a session ID

Annotations
@Override
getRequestURIback to summary
public String getRequestURI()

Implements javax.servlet.http.HttpServletRequest.getRequestURI.

The default behavior of this method is to return getRequestURI() on the wrapped request object.

Returns:String

Doc from javax.servlet.http.HttpServletRequest.getRequestURI.

a String containing the part of the URL from the protocol name up to the query string

Annotations
@Override
getRequestURLback to summary
public StringBuffer getRequestURL()

Implements javax.servlet.http.HttpServletRequest.getRequestURL.

The default behavior of this method is to return getRequestURL() on the wrapped request object.

Returns:StringBuffer

Doc from javax.servlet.http.HttpServletRequest.getRequestURL.

a StringBuffer object containing the reconstructed URL

Annotations
@Override
getServletPathback to summary
public String getServletPath()

Implements javax.servlet.http.HttpServletRequest.getServletPath.

The default behavior of this method is to return getServletPath() on the wrapped request object.

Returns:String

Doc from javax.servlet.http.HttpServletRequest.getServletPath.

a String containing the name or path of the servlet being called, as specified in the request URL, decoded, or an empty string if the servlet used to process the request is matched using the "/*" pattern.

Annotations
@Override
getSessionback to summary
public HttpSession getSession(boolean create)

Implements javax.servlet.http.HttpServletRequest.getSession.

The default behavior of this method is to return getSession(boolean create) on the wrapped request object.

Parameters
create:boolean

Doc from javax.servlet.http.HttpServletRequest.getSession.

true to create a new session for this request if necessary; false to return null if there's no current session

Returns:HttpSession

Doc from javax.servlet.http.HttpServletRequest.getSession.

the HttpSession associated with this request or null if create is false and the request has no valid session

Annotations
@Override
getSessionback to summary
public HttpSession getSession()

Implements javax.servlet.http.HttpServletRequest.getSession.

The default behavior of this method is to return getSession() on the wrapped request object.

Returns:HttpSession

Doc from javax.servlet.http.HttpServletRequest.getSession.

the HttpSession associated with this request

Annotations
@Override
getTrailerFieldsback to summary
public Map<String, String> getTrailerFields()

Overrides default javax.servlet.http.HttpServletRequest.getTrailerFields.

The default behavior of this method is to call getTrailerFields on the wrapped request object.

Returns:Map<String, String>

Doc from javax.servlet.http.HttpServletRequest.getTrailerFields.

A map of trailer fields in which all the keys are in lowercase, regardless of the case they had at the protocol level. If there are no trailer fields, yet isTrailerFieldsReady is returning true, the empty map is returned.

Annotations
@Override
Since
Servlet 4.0
getUserPrincipalback to summary
public Principal getUserPrincipal()

Implements javax.servlet.http.HttpServletRequest.getUserPrincipal.

The default behavior of this method is to return getUserPrincipal() on the wrapped request object.

Returns:Principal

Doc from javax.servlet.http.HttpServletRequest.getUserPrincipal.

a java.security.Principal containing the name of the user making this request; null if the user has not been authenticated

Annotations
@Override
isRequestedSessionIdFromCookieback to summary
public boolean isRequestedSessionIdFromCookie()

Implements javax.servlet.http.HttpServletRequest.isRequestedSessionIdFromCookie.

The default behavior of this method is to return isRequestedSessionIdFromCookie() on the wrapped request object.

Returns:boolean

Doc from javax.servlet.http.HttpServletRequest.isRequestedSessionIdFromCookie.

true if the session ID was conveyed to the server an an HTTP cookie; otherwise, false

Annotations
@Override
isRequestedSessionIdFromURLback to summary
public boolean isRequestedSessionIdFromURL()

Implements javax.servlet.http.HttpServletRequest.isRequestedSessionIdFromURL.

The default behavior of this method is to return isRequestedSessionIdFromURL() on the wrapped request object.

Returns:boolean

Doc from javax.servlet.http.HttpServletRequest.isRequestedSessionIdFromURL.

true if the session ID was conveyed to the server as part of a URL; otherwise, false

Annotations
@Override
isRequestedSessionIdFromUrlback to summary
public boolean isRequestedSessionIdFromUrl()

Implements javax.servlet.http.HttpServletRequest.isRequestedSessionIdFromUrl.

Deprecated

As of Version 4.0 of the Java Servlet API, use isRequestedSessionIdFromURL instead.

The default behavior of this method is to return isRequestedSessionIdFromUrl() on the wrapped request object.

Returns:boolean

Doc from javax.servlet.http.HttpServletRequest.isRequestedSessionIdFromUrl.

true if the session ID was conveyed to the server as part of a URL; otherwise, false

Annotations
@Deprecated
@Override
isRequestedSessionIdValidback to summary
public boolean isRequestedSessionIdValid()

Implements javax.servlet.http.HttpServletRequest.isRequestedSessionIdValid.

The default behavior of this method is to return isRequestedSessionIdValid() on the wrapped request object.

Returns:boolean

Doc from javax.servlet.http.HttpServletRequest.isRequestedSessionIdValid.

true if this request has an id for a valid session in the current session context; false otherwise

Annotations
@Override
isTrailerFieldsReadyback to summary
public boolean isTrailerFieldsReady()

Overrides default javax.servlet.http.HttpServletRequest.isTrailerFieldsReady.

The default behavior of this method is to call isTrailerFieldsReady on the wrapped request object.

Returns:boolean

Doc from javax.servlet.http.HttpServletRequest.isTrailerFieldsReady.

a boolean whether trailer fields are ready to read

Annotations
@Override
Since
Servlet 4.0
isUserInRoleback to summary
public boolean isUserInRole(String role)

Implements javax.servlet.http.HttpServletRequest.isUserInRole.

The default behavior of this method is to return isUserInRole(String role) on the wrapped request object.

Parameters
role:String

Doc from javax.servlet.http.HttpServletRequest.isUserInRole.

a String specifying the name of the role

Returns:boolean

Doc from javax.servlet.http.HttpServletRequest.isUserInRole.

a boolean indicating whether the user making this request belongs to a given role; false if the user has not been authenticated

Annotations
@Override
loginback to summary
public void login(String username, String password) throws ServletException

Implements javax.servlet.http.HttpServletRequest.login.

The default behavior of this method is to call login on the wrapped request object.

Parameters
username:String

Doc from javax.servlet.http.HttpServletRequest.login.

The String value corresponding to the login identifier of the user.

password:String

Doc from javax.servlet.http.HttpServletRequest.login.

The password String corresponding to the identified user.

Annotations
@Override
Exceptions
ServletException:

Doc from javax.servlet.http.HttpServletRequest.login.

if the configured login mechanism does not support username password authentication, or if a non-null caller identity had already been established (prior to the call to login), or if validation of the provided username and password fails.

Since
Servlet 3.0
logoutback to summary
public void logout() throws ServletException

Implements javax.servlet.http.HttpServletRequest.logout.

The default behavior of this method is to call login on the wrapped request object.

Annotations
@Override
Exceptions
ServletException:

Doc from javax.servlet.http.HttpServletRequest.logout.

if logout fails

Since
Servlet 3.0
newPushBuilderback to summary
public PushBuilder newPushBuilder()

Overrides default javax.servlet.http.HttpServletRequest.newPushBuilder.

The default behavior of this method is to call newPushBuilder on the wrapped request object.

Returns:PushBuilder

Doc from javax.servlet.http.HttpServletRequest.newPushBuilder.

a PushBuilder for issuing server push responses from the current request, or null if push is not supported

Annotations
@Override
Since
Servlet 4.0
upgradeback to summary
public <T extends HttpUpgradeHandler> T upgrade(Class<T> handlerClass) throws IOException, ServletException

Implements javax.servlet.http.HttpServletRequest.upgrade.

Create an instance of HttpUpgradeHandler for a given class and uses it for the http protocol upgrade processing.

Parameters
<T>

Doc from javax.servlet.http.HttpServletRequest.upgrade. The Class, which extends HttpUpgradeHandler, of the handlerClass.

handlerClass:Class<T>

Doc from javax.servlet.http.HttpServletRequest.upgrade.

The HttpUpgradeHandler class used for the upgrade.

Returns:T

Doc from javax.servlet.http.HttpServletRequest.upgrade.

an instance of the HttpUpgradeHandler

Annotations
@Override
Exceptions
IOException:

Doc from javax.servlet.http.HttpServletRequest.upgrade.

if an I/O error occurred during the upgrade

ServletException:

Doc from javax.servlet.http.HttpServletRequest.upgrade.

if the given handlerClass fails to be instantiated

Since
Servlet 3.1