EAF 7.4 API

com.lutris.appserver.server.httpPresentation
Interface HttpPresentationRequest


public interface HttpPresentationRequest

Object passed to presentation objects that is used to access HTTP request data.


Method Summary
 java.lang.String getAppFileURIPath(java.lang.String file)
          Get the URI path for a file in the application.
 java.lang.String getApplicationPath()
          Returns the part of the request URI that refers to the application.
 java.lang.String getAuthType()
          Returns the authentication scheme of the request, or null if none.
 int getContentLength()
          Returns the size of the request entity data, or -1 if not known.
 java.lang.String getContentType()
          Returns the Internet Media Type of the request entity data, or null if not known.
 javax.servlet.http.Cookie[] getCookies()
          Gets the array of cookies found in this request.
 long getDateHeader(java.lang.String name)
          Returns the value of a date header field, or -1 if not found.
 java.lang.String getHeader(java.lang.String name)
          Returns the value of a header field, or null if not known.
 java.util.Enumeration getHeaderNames()
          Returns an enumeration of strings representing the header names for this request.
 javax.servlet.http.HttpServletRequest getHttpServletRequest()
          Returns the original HttpServletRequest.
 HttpPresentationInputStream getInputStream()
          Returns an input stream for reading the request body.
 int getIntHeader(java.lang.String name)
          Returns the value of an integer header field, or -1 if not found.
 java.lang.String getMethod()
          Returns the method with which the request was made.
 java.lang.String getParameter(java.lang.String name)
          Returns a string containing the lone value of the specified query parameter, or null if the parameter does not exist.
 java.util.Enumeration getParameterNames()
          Returns the parameter names for this request as an enumeration of strings, or an empty enumeration if there are no parameters.
 java.lang.String[] getParameterValues(java.lang.String name)
          Returns the values of the specified query parameter for the request as an array of strings, or a 0 length array if the named parameter does not exist.
 java.lang.String getPathInfo()
          Returns optional extra path information following the presentation path, but immediately preceding the query string.
 java.lang.String getPathTranslated()
          Returns extra path information translated to a real path.
 java.lang.String getPresentationObjectPath()
          Returns the part of the request URI that refers to the presentation object being invoked.
 java.lang.String getPresentationObjectRelativePath()
          Returns the part of the request URI after the presentation manager servlet, upto and including the presentation object .po, but not any path info.
 java.lang.String getPresentationPath()
          Deprecated. This method was named in a confusing manner; it returns the application, not presentation object path. Use getApplicationPath().
 java.lang.String getPresentationURI()
          Returns the presentation URI.
 java.lang.String getProtocol()
          Returns the protocol and version of the request as a string of the form <protocol>/<major version>.<minor version>.
 java.lang.String getQueryString()
          Returns the query string part of the presentation URI, or null if none.
 java.lang.String getRemoteAddr()
          Returns the IP address of the agent that sent the request.
 java.lang.String getRemoteHost()
          Returns the fully qualified host name of the agent that sent the request.
 java.lang.String getRemoteUser()
          Returns the name of the user making this request, or null if not known.
 java.lang.String getRequestURI()
          Returns the request URI as a URL.
 java.lang.String getScheme()
          Returns the scheme of the URL used in this request, for example "http", "https", or "ftp".
 java.lang.String getServerName()
          Returns the host name of the server that received the request.
 int getServerPort()
          Returns the port number on which this request was received.
 boolean isRequestedSessionIdFromCookie()
          Indicates whether client submitted their session id through a cookie
 boolean isRequestedSessionIdFromUrl()
          Indicates whether client submitted their sessionId through a rewritten url
 void setRequestedSessionIdFromCookie(boolean isFromCookie)
           
 void setRequestedSessionIdFromUrl(boolean isFromUrl)
           
 

Method Detail

getHttpServletRequest

javax.servlet.http.HttpServletRequest getHttpServletRequest()
Returns the original HttpServletRequest.


getContentLength

int getContentLength()
                     throws HttpPresentationException
Returns the size of the request entity data, or -1 if not known. Same as the CGI variable CONTENT_LENGTH.

Throws:
HttpPresentationException

getContentType

java.lang.String getContentType()
                                throws HttpPresentationException
Returns the Internet Media Type of the request entity data, or null if not known. Same as the CGI variable CONTENT_TYPE.

Throws:
HttpPresentationException

getProtocol

java.lang.String getProtocol()
                             throws HttpPresentationException
Returns the protocol and version of the request as a string of the form <protocol>/<major version>.<minor version>. Same as the CGI variable SERVER_PROTOCOL.

Throws:
HttpPresentationException

getScheme

java.lang.String getScheme()
Returns the scheme of the URL used in this request, for example "http", "https", or "ftp". Different schemes have different rules for constructing URLs, as noted in RFC 1738. The URL used to create a request may be reconstructed using this scheme, the server name and port, and additional information such as URIs.


getServerName

java.lang.String getServerName()
Returns the host name of the server that received the request. Same as the CGI variable SERVER_NAME.


getServerPort

int getServerPort()
Returns the port number on which this request was received. Same as the CGI variable SERVER_PORT.


getRemoteAddr

java.lang.String getRemoteAddr()
                               throws HttpPresentationException
Returns the IP address of the agent that sent the request. Same as the CGI variable REMOTE_ADDR.

Throws:
HttpPresentationException

getRemoteHost

java.lang.String getRemoteHost()
                               throws HttpPresentationException
Returns the fully qualified host name of the agent that sent the request. Same as the CGI variable REMOTE_HOST.

Throws:
HttpPresentationException

getInputStream

HttpPresentationInputStream getInputStream()
                                           throws HttpPresentationException
Returns an input stream for reading the request body.

Throws:
HttpPresentationException

getParameter

java.lang.String getParameter(java.lang.String name)
                              throws HttpPresentationException
Returns a string containing the lone value of the specified query parameter, or null if the parameter does not exist. Presentation writers should use this method only when they are sure that there is only one value for the parameter. If the parameter has (or could have) multiple values, then use getParameterValues. If a multiple valued parameter name is passed as an argument, the return value is implementation dependent.

Parameters:
name - the name of the parameter whose value is required.
Throws:
HttpPresentationException
See Also:
getParameterValues(java.lang.String)

getParameterValues

java.lang.String[] getParameterValues(java.lang.String name)
                                      throws HttpPresentationException
Returns the values of the specified query parameter for the request as an array of strings, or a 0 length array if the named parameter does not exist.

Parameters:
name - the name of the parameter whose value is required.
Throws:
HttpPresentationException

getParameterNames

java.util.Enumeration getParameterNames()
                                        throws HttpPresentationException
Returns the parameter names for this request as an enumeration of strings, or an empty enumeration if there are no parameters.

Throws:
HttpPresentationException

getMethod

java.lang.String getMethod()
                           throws HttpPresentationException
Returns the method with which the request was made. The returned value can be "GET", "HEAD", "POST", or an extension method. Same as the CGI variable REQUEST_METHOD.

Throws:
HttpPresentationException

getRequestURI

java.lang.String getRequestURI()
                               throws HttpPresentationException
Returns the request URI as a URL.

Throws:
HttpPresentationException

getPresentationURI

java.lang.String getPresentationURI()
                                    throws HttpPresentationException
Returns the presentation URI.

Throws:
HttpPresentationException

getPresentationPath

java.lang.String getPresentationPath()
                                     throws HttpPresentationException
Deprecated. This method was named in a confusing manner; it returns the application, not presentation object path. Use getApplicationPath().

Returns the part of the request URI that refers to the application object being invoked. Analogous to the CGI variable SCRIPT_NAME.

Throws:
HttpPresentationException

getPresentationObjectPath

java.lang.String getPresentationObjectPath()
                                           throws HttpPresentationException
Returns the part of the request URI that refers to the presentation object being invoked.

Throws:
HttpPresentationException

getPresentationObjectRelativePath

java.lang.String getPresentationObjectRelativePath()
                                                   throws HttpPresentationException
Returns the part of the request URI after the presentation manager servlet, upto and including the presentation object .po, but not any path info.

Throws:
HttpPresentationException

getApplicationPath

java.lang.String getApplicationPath()
                                    throws HttpPresentationException
Returns the part of the request URI that refers to the application. Analogous to the CGI variable SCRIPT_NAME.

Throws:
HttpPresentationException

getPathInfo

java.lang.String getPathInfo()
                             throws HttpPresentationException
Returns optional extra path information following the presentation path, but immediately preceding the query string. Returns null if not specified. Same as the CGI variable PATH_INFO.

Throws:
HttpPresentationException

getPathTranslated

java.lang.String getPathTranslated()
                                   throws HttpPresentationException
Returns extra path information translated to a real path. Returns null if no extra path information specified. Same as the CGI variable PATH_TRANSLATED.

Throws:
HttpPresentationException

getQueryString

java.lang.String getQueryString()
                                throws HttpPresentationException
Returns the query string part of the presentation URI, or null if none. Same as the CGI variable QUERY_STRING.

Throws:
HttpPresentationException

getRemoteUser

java.lang.String getRemoteUser()
                               throws HttpPresentationException
Returns the name of the user making this request, or null if not known. The user name is set with HTTP authentication. Whether the user name will continue to be sent with each subsequent communication is browser-dependent. Same as the CGI variable REMOTE_USER.

Throws:
HttpPresentationException

getAuthType

java.lang.String getAuthType()
                             throws HttpPresentationException
Returns the authentication scheme of the request, or null if none. Same as the CGI variable AUTH_TYPE.

Throws:
HttpPresentationException

getCookies

javax.servlet.http.Cookie[] getCookies()
                                       throws HttpPresentationException
Gets the array of cookies found in this request.

Returns:
The array of cookies found in this request.
Throws:
HttpPresentationException

isRequestedSessionIdFromCookie

boolean isRequestedSessionIdFromCookie()
                                       throws HttpPresentationException
Indicates whether client submitted their session id through a cookie

Returns:
true if client submitted their sessionId via a cookie, false otherwise
Throws:
HttpPresentationException

setRequestedSessionIdFromCookie

void setRequestedSessionIdFromCookie(boolean isFromCookie)
                                     throws HttpPresentationException
Throws:
HttpPresentationException

isRequestedSessionIdFromUrl

boolean isRequestedSessionIdFromUrl()
                                    throws HttpPresentationException
Indicates whether client submitted their sessionId through a rewritten url

Returns:
true if client submitted their sessionId via a rewritten url, false otherwise
Throws:
HttpPresentationException

setRequestedSessionIdFromUrl

void setRequestedSessionIdFromUrl(boolean isFromUrl)
                                  throws HttpPresentationException
Throws:
HttpPresentationException

getHeader

java.lang.String getHeader(java.lang.String name)
                           throws HttpPresentationException
Returns the value of a header field, or null if not known. The case of the header field name is ignored.

Parameters:
name - the case-insensitive header field name
Throws:
HttpPresentationException

getIntHeader

int getIntHeader(java.lang.String name)
                 throws HttpPresentationException
Returns the value of an integer header field, or -1 if not found. The case of the header field name is ignored.

Parameters:
name - the case-insensitive header field name
Throws:
HttpPresentationException

getDateHeader

long getDateHeader(java.lang.String name)
                   throws HttpPresentationException
Returns the value of a date header field, or -1 if not found. The case of the header field name is ignored.

Parameters:
name - the case-insensitive header field name
Throws:
HttpPresentationException

getHeaderNames

java.util.Enumeration getHeaderNames()
                                     throws HttpPresentationException
Returns an enumeration of strings representing the header names for this request. Some server implementations do not allow headers to be accessed in this way, in which case this method will return null.

Throws:
HttpPresentationException

getAppFileURIPath

java.lang.String getAppFileURIPath(java.lang.String file)
                                   throws HttpPresentationException
Get the URI path for a file in the application. This converts a path to the file part of the URL. It adds in the reference to application servlet.

Parameters:
file - File with in the application. Currently this must be a path relative to the presentation prefix.
Returns:
The file path portion of the URL, starting with a /.
Throws:
HttpPresentationException

EAF 7.4 API