Interface HttpServletRequest

All Superinterfaces:
ServletRequest
All Known Subinterfaces:
WebApplicationRequest
All Known Implementing Classes:
AsyncHttpDispatchWrapper, DefaultWebApplicationRequest, EmbeddedRequest, HttpServletRequestWrapper, HttpWebApplicationRequest, NanoRequest, RealtimeHttpServletRequestWrapper, WeldHttpServletRequest

public interface HttpServletRequest extends ServletRequest
The HttpServletRequest API.
Author:
Manfred Riem ([email protected])
  • Field Details

  • Method Details

    • authenticate

      boolean authenticate(HttpServletResponse response) throws IOException, ServletException
      Authenticate the request.
      Parameters:
      response - the response.
      Returns:
      true if authenticated, false otherwise.
      Throws:
      IOException - when an I/O error occurs.
      ServletException - when a Servlet error occurs.
    • changeSessionId

      String changeSessionId()
      Change the session id.
      Returns:
      the new session id.
    • getAuthType

      String getAuthType()
      Returns the auth type.
      Returns:
      the auth type
    • getContextPath

      String getContextPath()
      Returns the context path.
      Returns:
      the context path
    • getCookies

      Cookie[] getCookies()
      Get the cookies.
      Returns:
      the cookies, or null if none.
    • getDateHeader

      long getDateHeader(String name)
      Get the date header.
      Parameters:
      name - the name.
      Returns:
      the date, or -1 if not found.
    • getHeader

      String getHeader(String name)
      Get the header.
      Parameters:
      name - the name.
      Returns:
      the header, or null if not found.
    • getHeaders

      Enumeration<String> getHeaders(String name)
      Returns the headers.
      Parameters:
      name - the name.
      Returns:
      the headers
    • getHeaderNames

      Enumeration<String> getHeaderNames()
      Returns the header names.
      Returns:
      the header names
    • getHttpServletMapping

      default HttpServletMapping getHttpServletMapping()
      Returns the HTTP servlet mapping.
      Returns:
      the HTTP servlet mapping
    • getIntHeader

      int getIntHeader(String name)
      Get the int header.
      Parameters:
      name - the name.
      Returns:
      the header, or -1 if not found.
    • getMethod

      String getMethod()
      Returns the HTTP method.
      Returns:
      the HTTP method
    • getPart

      Part getPart(String name) throws IOException, ServletException
      Get the part.
      Parameters:
      name - the name.
      Returns:
      the part, or null if not found.
      Throws:
      IOException - when an I/O error occurs.
      ServletException - when a Servlet error occurs.
    • getParts

      Get the parts.
      Returns:
      the parts.
      Throws:
      IOException - when an I/O error occurs.
      ServletException - when a Servlet error occurs.
    • getPathInfo

      String getPathInfo()
      Returns the path info.
      Returns:
      the path info
    • getPathTranslated

      String getPathTranslated()
      Returns the path translated.
      Returns:
      the path translated
    • getQueryString

      String getQueryString()
      Get the query string.
      Returns:
      the query string, or null if not found.
    • getRemoteUser

      String getRemoteUser()
      Get the remote user.
      Returns:
      the remote user, or null if not found.
    • getRequestURI

      String getRequestURI()
      Returns the request URI.
      Returns:
      the request URI
    • getRequestURL

      StringBuffer getRequestURL()
      Returns the request URL.
      Returns:
      the request URL
    • getRequestedSessionId

      String getRequestedSessionId()
      Returns the requested session id.
      Returns:
      the requested session id
    • getServletPath

      String getServletPath()
      Returns the servlet path.
      Returns:
      the servlet path
    • getSession

      HttpSession getSession(boolean create)
      Get the HTTP session.
      Parameters:
      create - the create flag.
      Returns:
      the HTTP session, or null if not found and create flag is false.
    • getSession

      HttpSession getSession()
      Returns the HTTP session.
      Returns:
      the HTTP session
    • getTrailerFields

      default Map<String,​String> getTrailerFields()
      Returns the trailer fields.
      Returns:
      the trailer fields
    • getUserPrincipal

      Principal getUserPrincipal()
      Returns the user principal.
      Returns:
      the user principal
    • isRequestedSessionIdFromCookie

      boolean isRequestedSessionIdFromCookie()
      Is the requested session id from a cookie.
      Returns:
      true if it is, false otherwise.
    • isRequestedSessionIdFromURL

      boolean isRequestedSessionIdFromURL()
      Is the requested session id from a URL.
      Returns:
      true if it is, false otherwise.
    • isRequestedSessionIdFromUrl

      @Deprecated boolean isRequestedSessionIdFromUrl()
      Deprecated.
      Is the requested session id from a URL.
      Returns:
      true if it is, false otherwise.
    • isRequestedSessionIdValid

      boolean isRequestedSessionIdValid()
      Is the requested session id valid.
      Returns:
      true if it is, false otherwise.
    • isTrailerFieldsReady

      default boolean isTrailerFieldsReady()
      Is trailer fields ready.
      Returns:
      true if fields are ready, false otherwise.
    • isUserInRole

      boolean isUserInRole(String role)
      Is the user in the specified role.
      Parameters:
      role - the role.
      Returns:
      true if the user is in the specified role, false otherwise.
    • login

      void login(String username, String password) throws ServletException
      Login.
      Parameters:
      username - the username.
      password - the password.
      Throws:
      ServletException - when a Servlet error occurs.
    • logout

      void logout() throws ServletException
      Logout.
      Throws:
      ServletException - when a Servlet error occurs.
    • newPushBuilder

      default PushBuilder newPushBuilder()
      Create a new push builder.
      Returns:
      the push builder.
    • upgrade

      <T extends HttpUpgradeHandler> T upgrade(Class<T> handlerClass) throws IOException, ServletException
      Upgrade the request.
      Type Parameters:
      T - the type of HTTP upgrade handler.
      Parameters:
      handlerClass - the handler class.
      Returns:
      the HTTP upgrade handler.
      Throws:
      IOException - when an I/O error occurs.
      ServletException - when a Servlet error occurs.