org.apache.tiles.request
Interface Request

Package class diagram package Request
All Known Subinterfaces:
DispatchRequest, RequestWrapper
All Known Implementing Classes:
AbstractClientRequest, AbstractRequest, AbstractViewRequest, ActionPortletRequest, DefaultRequestWrapper, DispatchRequestWrapper, EventPortletRequest, FreemarkerRequest, JspRequest, PortletRequest, RenderPortletRequest, ResourcePortletRequest, ServletRequest, VelocityRequest

public interface Request

Encapsulation of request information.

Version:
$Rev: 1332134 $ $Date: 2012-04-30 05:23:19 -0400 (Mon, 30 Apr 2012) $

Method Summary
 ApplicationContext getApplicationContext()
          Returns the associated application context.
 List<String> getAvailableScopes()
          Returns all available scopes, that are the ones returned by #getNativeScopes() plus derivative scopes (e.g.
 Map<String,Object> getContext(String scope)
          Returns a context map, given the scope name.
 Map<String,String> getHeader()
          Return an immutable Map that maps header names to the first (or only) header value (as a String).
 Map<String,String[]> getHeaderValues()
          Return an immutable Map that maps header names to the set of all values specified in the request (as a String array).
 OutputStream getOutputStream()
          Returns an output stream to be used to write directly in the response.
 Map<String,String> getParam()
          Return an immutable Map that maps request parameter names to the first (or only) value (as a String).
 Map<String,String[]> getParamValues()
          Return an immutable Map that maps request parameter names to the set of all values (as a String array).
 PrintWriter getPrintWriter()
          Returns a print writer to be used to write directly in the response.
 Locale getRequestLocale()
          Return the preferred Locale in which the client will accept content.
 Addable<String> getResponseHeaders()
          Return an Addable object that can be used to write headers to the response.
 Writer getWriter()
          Returns a writer to be used to write directly in the response.
 boolean isResponseCommitted()
          Checks if the response has been committed.
 boolean isUserInRole(String role)
          Determine whether or not the specified user is in the given role.
 

Method Detail

getHeader

Map<String,String> getHeader()
Return an immutable Map that maps header names to the first (or only) header value (as a String).

Returns:
The header map.

getHeaderValues

Map<String,String[]> getHeaderValues()
Return an immutable Map that maps header names to the set of all values specified in the request (as a String array). Header names must be matched in a case-insensitive manner.

Returns:
The header values map.

getResponseHeaders

Addable<String> getResponseHeaders()
Return an Addable object that can be used to write headers to the response.

Returns:
An Addable object.

getContext

Map<String,Object> getContext(String scope)
Returns a context map, given the scope name.

Parameters:
scope - The name of the scope.
Returns:
The context.

getAvailableScopes

List<String> getAvailableScopes()
Returns all available scopes, that are the ones returned by #getNativeScopes() plus derivative scopes (e.g. flash scope).

Returns:
All the available scopes.

getApplicationContext

ApplicationContext getApplicationContext()
Returns the associated application context.

Returns:
The application context associated to this request.

getOutputStream

OutputStream getOutputStream()
                             throws IOException
Returns an output stream to be used to write directly in the response.

Returns:
The output stream that writes in the response.
Throws:
IOException - If something goes wrong when getting the output stream.

getWriter

Writer getWriter()
                 throws IOException
Returns a writer to be used to write directly in the response.

Returns:
The writer that writes in the response.
Throws:
IOException - If something goes wrong when getting the writer.

getPrintWriter

PrintWriter getPrintWriter()
                           throws IOException
Returns a print writer to be used to write directly in the response.

Returns:
The print writer that writes in the response.
Throws:
IOException - If something goes wrong when getting the print writer.

isResponseCommitted

boolean isResponseCommitted()
Checks if the response has been committed.

Returns:
true only if the response has been committed.

getParam

Map<String,String> getParam()
Return an immutable Map that maps request parameter names to the first (or only) value (as a String).

Returns:
The parameter map.

getParamValues

Map<String,String[]> getParamValues()
Return an immutable Map that maps request parameter names to the set of all values (as a String array).

Returns:
The parameter values map.

getRequestLocale

Locale getRequestLocale()
Return the preferred Locale in which the client will accept content.

Returns:
The current request locale. It is the locale of the request object itself and it is NOT the locale that the user wants to use. See org.apache.tiles.locale.LocaleResolver to implement strategies to resolve locales.

isUserInRole

boolean isUserInRole(String role)
Determine whether or not the specified user is in the given role.

Parameters:
role - the role to check against.
Returns:
true if the user is in the given role.


Copyright © 2001-2012 Apache Software Foundation. All Rights Reserved.