ExecutionImpl (zk 9.6.4 API)

java.lang.Object
- org.zkoss.zk.ui.impl.AbstractExecution
- - org.zkoss.zk.ui.http.ExecutionImpl

All Implemented Interfaces:

Execution, Scope, ExecutionCtrl
```
public class ExecutionImpl
extends AbstractExecution
```
An Execution implementation for HTTP request and response.

Author:

tomyeh

Field Summary
- Fields inherited from class org.zkoss.zk.ui.impl.AbstractExecution
  Add_ON_ACTIVATE, Add_ON_DEACTIVATE
- Fields inherited from interface org.zkoss.zk.ui.Execution
  APPEND_PARAM, IGNORE_PARAM, OVERWRITE_URI, PASS_THRU_ATTR

Constructor Summary

Constructors
Constructor and Description
`ExecutionImpl(javax.servlet.ServletContext ctx, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, Desktop desktop, Page creating)` Constructs an execution for the given HTTP request.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addResponseHeader(java.lang.String name, java.util.Date value)` Adds a response header with the given name and date-value.
`void`	`addResponseHeader(java.lang.String name, java.lang.String value)` Adds a response header with the give name and value.
`boolean`	`addScopeListener(ScopeListener listener)` Adds a listener to listen whether this scope is changed.
`boolean`	`containsResponseHeader(java.lang.String name)` Returns whether the named response header has already been set.
`java.lang.String`	`encodeURL(java.lang.String uri)` Encodes an URL.
`java.lang.Object`	`evaluate(Component comp, java.lang.String expr, java.lang.Class<?> expectedType)` Evaluates the specified expression with ${link #getVariableResolver} and `Page.getFunctionMapper()` of the page of the specified component.
`java.lang.Object`	`evaluate(Page page, java.lang.String expr, java.lang.Class<?> expectedType)` Evaluates the specified expression with ${link #getVariableResolver} and `Page.getFunctionMapper()` of the specified page.
`void`	`forward(java.lang.String page)` A shortcut of forward(null, page, null, 0).
`void`	`forward(java.io.Writer out, java.lang.String page, java.util.Map<java.lang.String,?> params, int mode)` Forwards to another page.
`java.lang.Object`	`getAttribute(java.lang.String name)` Returns the value of the specified request attribute.
`java.util.Map<java.lang.String,java.lang.Object>`	`getAttributes()` Returns a map of request attributes associated with this session.
`java.lang.String`	`getBrowser()` Returns the name of the browser, or null if not identifiable.
`java.lang.Double`	`getBrowser(java.lang.String name)` Returns the version of the given browser name, or null if the client is not the given browsers.
`java.lang.String`	`getContextPath()` Returns the portion of the request URI that indicates the context of the current execution.
`java.lang.String`	`getContextURI()` Returns the context uri from the current execution.
`Evaluator`	`getEvaluator(Component comp, java.lang.Class<? extends ExpressionFactory> expfcls)` Returns the evaluator of the current execution.
`Evaluator`	`getEvaluator(Page page, java.lang.Class<? extends ExpressionFactory> expfcls)` Returns the evaluator (never null).
`java.lang.String`	`getHeader(java.lang.String name)` Returns the value of the specified header as a `String`, or null if not found.
`java.lang.Iterable<java.lang.String>`	`getHeaderNames()` Returns all header names this request contains.
`java.lang.Iterable<java.lang.String>`	`getHeaders(java.lang.String name)` Returns all the values of the specified header as an iterable `String` objects.
`java.lang.String`	`getLocalAddr()` Returns the Internet Protocol (IP) address of the interface on which the request was received.
`java.lang.String`	`getLocalName()` Returns the host name of the Internet Protocol (IP) interface on which the request was received.
`int`	`getLocalPort()` Returns the Internet Protocol (IP) port number of the interface on which the request was received.
`java.lang.Object`	`getNativeRequest()` Returns the native request, or null if not available.
`java.lang.Object`	`getNativeResponse()` Returns the native response, or null if not available.
`PageDefinition`	`getPageDefinition(java.lang.String uri)` Returns the page definition from the page file specified by an URI.
`PageDefinition`	`getPageDefinitionDirectly(Document content, java.lang.String ext)` Converts the specified page content, in DOM, to a page definition.
`PageDefinition`	`getPageDefinitionDirectly(java.io.Reader reader, java.lang.String ext)` Reads the raw content from a reader and converts it into a page definition.
`PageDefinition`	`getPageDefinitionDirectly(java.lang.String content, java.lang.String ext)` Converts the specified page content to a page definition.
`java.lang.String`	`getParameter(java.lang.String name)` Returns the value of a request parameter as a String, or null if the parameter does not exist
`java.util.Map<java.lang.String,java.lang.String[]>`	`getParameterMap()` Returns a Map of the parameters of this request.
`java.lang.String[]`	`getParameterValues(java.lang.String name)` Returns an array of String objects containing all of the values the given request parameter has, or null if the parameter does not exist.
`java.lang.String`	`getRemoteAddr()` Returns the Internet Protocol (IP) address of the client or last proxy that sent the request.
`java.lang.String`	`getRemoteHost()` Returns the fully qualified name of the client or the last proxy that sent the request.
`java.lang.String`	`getRemoteUser()` Returns the login of the user making this request, if the user has been authenticated, or null if the user has not been authenticated.
`java.lang.String`	`getScheme()` Returns the name of the scheme used to make this request, for example, http, https, or ftp.
`java.lang.String`	`getServerName()` Returns the host name of the server to which the request was sent.
`int`	`getServerPort()` Returns the port number to which the request was sent.
`java.lang.String`	`getUserAgent()` Returns the user-agent header, which indicates what the client is, or an empty string if not available.
`java.security.Principal`	`getUserPrincipal()` Returns a java.security.Principal object containing the name of the current authenticated user.
`VariableResolver`	`getVariableResolver()` Returns the variable resolver for this execution, or null if not available.
`boolean`	`hasAttribute(java.lang.String name)` Returns if a custom attribute is associated with this object (scope).
`void`	`include(java.lang.String page)` A shortcut of include(null, page, null, 0).
`void`	`include(java.io.Writer out, java.lang.String page, java.util.Map<java.lang.String,?> params, int mode)` Includes a page.
`boolean`	`isBrowser()` Deprecated. As of release 6.0.0, replaced with `getBrowser(String)`.
`boolean`	`isBrowser(java.lang.String type)` Deprecated. As of release 6.0.0, replaced with `getBrowser(String)`.
`boolean`	`isExplorer()` Deprecated. As of release 6.0.0, replaced with `getBrowser(String)`.
`boolean`	`isExplorer7()` Deprecated. As of release 6.0.0, replaced with `getBrowser(String)`.
`boolean`	`isForwarded()` Returns whether the execution is forwarded from other pages.
`boolean`	`isGecko()` Deprecated. As of release 6.0.0, replaced with `getBrowser(String)`.
`boolean`	`isGecko3()` Deprecated. As of release 6.0.0, replaced with `getBrowser(String)`.
`boolean`	`isHilDevice()` Deprecated. As of release 6.0.0, replaced with `getBrowser(String)`.
`boolean`	`isIncluded()` Returns whether this execution is included by some other pages.
`boolean`	`isOpera()` Deprecated. As of release 6.0.0, replaced with `getBrowser(String)`.
`boolean`	`isRobot()` Deprecated. As of release 6.0.0, replaced with `getBrowser(String)`.
`boolean`	`isSafari()` Deprecated. As of release 6.0.0, replaced with `getBrowser(String)`.
`boolean`	`isUserInRole(java.lang.String role)` Returns a boolean indicating whether the authenticated user is included in the specified logical "role".
`boolean`	`isVoided()` Returns whether the execution is voided.
`java.lang.String`	`locate(java.lang.String path)` Locates a page based on the current Locale.
`void`	`onActivate()` Called when this execution is about to become the current execution `Executions.getCurrent()`.
`void`	`onDeactivate()` Called when this execution is about to become a non-current execution.
`java.lang.Object`	`removeAttribute(java.lang.String name)` Removes the specified request attribute.
`boolean`	`removeScopeListener(ScopeListener listener)` Removes a change listener from this scope.
`java.lang.Object`	`setAttribute(java.lang.String name, java.lang.Object value)` Sets the value of the specified request attribute.
`void`	`setContentType(java.lang.String contentType)` Sets the content type.
`void`	`setResponseHeader(java.lang.String name, java.util.Date value)` Sets a response header with the given name and date-value.
`void`	`setResponseHeader(java.lang.String name, java.lang.String value)` Sets a response header with the give name and value.
`void`	`setVoided(boolean voided)` Sets whether the execution is voided.

Methods inherited from class org.zkoss.zk.ui.impl.AbstractExecution
addAuResponse, addAuResponse, addOnActivate, addOnDeactivate, addVariableResolver, createComponents, createComponents, createComponents, createComponents, createComponents, createComponents, createComponents, createComponents, createComponentsDirectly, createComponentsDirectly, createComponentsDirectly, createComponentsDirectly, createComponentsDirectly, createComponentsDirectly, createComponentsDirectly, createComponentsDirectly, createComponentsDirectly, getArg, getAttribute, getCurrentPage, getCurrentPageDefinition, getDesktop, getExecutionInfo, getExtraXelVariable, getExtraXelVariable, getNextEvent, getRequestId, getResponses, getSession, getVisualizer, hasAttribute, hasVariableResolver, hasVariableResolver, isActivated, isAsyncUpdate, isRecovering, log, log, onBeforeDeactivate, popArg, postEvent, postEvent, postEvent, pushArg, removeAttribute, removeVariableResolver, sendRedirect, sendRedirect, sendRedirect, setAttribute, setCurrentPage, setCurrentPageDefinition, setDesktop, setExecutionInfo, setRequestId, setResponses, toAbsoluteURI, toString

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - ExecutionImpl
```
public ExecutionImpl(javax.servlet.ServletContext ctx,
                     javax.servlet.http.HttpServletRequest request,
                     javax.servlet.http.HttpServletResponse response,
                     Desktop desktop,
                     Page creating)
```
    Constructs an execution for the given HTTP request.
    
    Parameters:
    
    creating - which page is being creating for this execution, or null if none is being created.
- Method Detail
  - onActivate
```
public void onActivate()
```
    Description copied from interface: ExecutionCtrl
    
    Called when this execution is about to become the current execution Executions.getCurrent().
    Note: an execution might spread over several threads, so this method might be called several times to activate the states in each thread. Also, an execution might be activated before another is deactivate. For example, when a component includes another page, the second exec is activated to render the included page.
    It is used as callback notification.
    Note: don't throw any exception in this method.
    
    Specified by:
    
    onActivate in interface ExecutionCtrl
    
    Overrides:
    
    onActivate in class AbstractExecution
  - onDeactivate
```
public void onDeactivate()
```
    Description copied from interface: ExecutionCtrl
    
    Called when this execution is about to become a non-current execution.
    It is used as callback notification.
    Note: don't throw any exception in this method.
    
    Specified by:
    
    onDeactivate in interface ExecutionCtrl
    
    Overrides:
    
    onDeactivate in class AbstractExecution
    
    See Also:
    
    ExecutionCtrl.onActivate()
  - getParameterValues
```
public java.lang.String[] getParameterValues(java.lang.String name)
```
    Description copied from interface: Execution
    
    Returns an array of String objects containing all of the values the given request parameter has, or null if the parameter does not exist.
  - getParameter
```
public java.lang.String getParameter(java.lang.String name)
```
    Description copied from interface: Execution
    
    Returns the value of a request parameter as a String, or null if the parameter does not exist
  - getParameterMap
```
public java.util.Map<java.lang.String,java.lang.String[]> getParameterMap()
```
    Description copied from interface: Execution
    
    Returns a Map of the parameters of this request. Request parameters are extra information sent with the request.
  - getVariableResolver
```
public VariableResolver getVariableResolver()
```
    Description copied from interface: Execution
    
    Returns the variable resolver for this execution, or null if not available.
    Note: the resolver is similar to PageContext's if this execution is caused by a HTTP request.
    
    See Also:
    
    Execution.evaluate(Component,String,Class)
  - getEvaluator
```
public Evaluator getEvaluator(Page page,
                              java.lang.Class<? extends ExpressionFactory> expfcls)
```
    Description copied from interface: Execution
    
    Returns the evaluator (never null). It is usually used to parse the expression into Expression or used with ExValue. for performance improvement.
    
    Parameters:
    
    page - the page that this evaluator is associated. If null, the current page and then the first page is assumed.
    
    expfcls - the implementation of ExpressionFactory, or null to use the default (Configuration.getExpressionFactoryClass().
  - getEvaluator
```
public Evaluator getEvaluator(Component comp,
                              java.lang.Class<? extends ExpressionFactory> expfcls)
```
    Description copied from interface: Execution
    
    Returns the evaluator of the current execution. It is a shortcut of getEvaluator(comp != null ? comp.getPage(): null)
    
    Parameters:
    
    comp - the component to retrieve the page for the evaluator
    
    expfcls - the implementation of ExpressionFactory, or null to use the default (Configuration.getExpressionFactoryClass().
  - evaluate
```
public java.lang.Object evaluate(Component comp,
                                 java.lang.String expr,
                                 java.lang.Class<?> expectedType)
```
    Description copied from interface: Execution
    
    Evaluates the specified expression with ${link #getVariableResolver} and Page.getFunctionMapper() of the page of the specified component.
    The function mapper is retrieved from component's page's function mapper (Page.getFunctionMapper()). If null, the current page, if any, is used to retrieve the mapper.
    For better performance, you can use the instance returned by Execution.getEvaluator(org.zkoss.zk.ui.Page, java.lang.Class<? extends org.zkoss.xel.ExpressionFactory>) to parse and cached the parsed expression. ExValue is a utility class to simply the task.
    
    Parameters:
    
    comp - used as the self variable and to retrieve the function mapper. Ignored if null.
    
    See Also:
    
    Execution.getVariableResolver(), Execution.getEvaluator(org.zkoss.zk.ui.Page, java.lang.Class<? extends org.zkoss.xel.ExpressionFactory>)
  - evaluate
```
public java.lang.Object evaluate(Page page,
                                 java.lang.String expr,
                                 java.lang.Class<?> expectedType)
```
    Description copied from interface: Execution
    
    Evaluates the specified expression with ${link #getVariableResolver} and Page.getFunctionMapper() of the specified page.
    The function mapper is retrieved from component's page's function mapper (Page.getFunctionMapper()). If null, the current page, if any, is used to retrieve the mapper.
    For better performance, you can use the instance returned by Execution.getEvaluator(org.zkoss.zk.ui.Page, java.lang.Class<? extends org.zkoss.xel.ExpressionFactory>) to parse and cached the parsed expression. ExValue is a utility class to simply the task.
    
    Parameters:
    
    page - used as the self variable and to retrieve the function mapper. Ignored if null.
    
    See Also:
    
    Execution.getVariableResolver(), Execution.getEvaluator(org.zkoss.zk.ui.Page, java.lang.Class<? extends org.zkoss.xel.ExpressionFactory>)
  - include
```
public void include(java.io.Writer out,
                    java.lang.String page,
                    java.util.Map<java.lang.String,?> params,
                    int mode)
             throws java.io.IOException
```
    Description copied from interface: Execution
    
    Includes a page.
    
    Parameters:
    
    out - the output to write. If null, the response's default writer is used.
    
    page - the page's uri; null to denote the same request
    
    mode - one of Execution.OVERWRITE_URI, Execution.IGNORE_PARAM, Execution.APPEND_PARAM and Execution.PASS_THRU_ATTR. It defines how to handle if both uri and params contains the same parameter. mode is used only if both uri contains query string and params is not empty.
    
    Throws:
    
    java.io.IOException
  - include
```
public void include(java.lang.String page)
             throws java.io.IOException
```
    Description copied from interface: Execution
    
    A shortcut of include(null, page, null, 0).
    
    Throws:
    
    java.io.IOException
  - forward
```
public void forward(java.io.Writer out,
                    java.lang.String page,
                    java.util.Map<java.lang.String,?> params,
                    int mode)
             throws java.io.IOException
```
    Description copied from interface: Execution
    
    Forwards to another page.
    Note: this method can be called only when loading a page. Use Execution.sendRedirect(String) instead if you want to change to another desktop when processing a request from the client.
    
    Parameters:
    
    out - the output to write. If null, the response's default writer is used.
    
    page - the page's uri; null to denote the same request
    
    mode - one of Execution.OVERWRITE_URI, Execution.IGNORE_PARAM, Execution.APPEND_PARAM and Execution.PASS_THRU_ATTR. It defines how to handle if both uri and params contains the same parameter. mode is used only if both uri contains query string and params is not empty.
    
    Throws:
    
    java.io.IOException
  - forward
```
public void forward(java.lang.String page)
             throws java.io.IOException
```
    Description copied from interface: Execution
    
    A shortcut of forward(null, page, null, 0).
    
    Throws:
    
    java.io.IOException
  - isIncluded
```
public boolean isIncluded()
```
    Description copied from interface: Execution
    
    Returns whether this execution is included by some other pages.
  - isForwarded
```
public boolean isForwarded()
```
    Description copied from interface: Execution
    
    Returns whether the execution is forwarded from other pages.
  - locate
```
public java.lang.String locate(java.lang.String path)
```
    Description copied from interface: Execution
    
    Locates a page based on the current Locale. It never returns null.
    If an URI contains "*", it will be replaced with a proper Locale. For example, if the current Locale is zh_TW and the resource is named "ab*.cd", then it searches "ab_zh_TW.cd", "ab_zh.cd" and then "ab.cd", until any of them is found.
    Note: "*" must be right before ".", or the last character. For example, "ab*.cd" and "ab*" are both correct, while "ab*cd" and "ab*\/cd" are ignored.
    
    If an URI contains two "*", the first "*" will be replaced with a browser code and the second with a proper locale. The browser code depends on what browser the user are used to visit the web site. Currently, the code for Internet Explorer is "ie", Safari is "saf", Opera is "opr" and all others are "moz". Thus, in the above example, if the resource is named "ab**.cd" and Firefox is used, then it searches "abmoz_zh_TW.cd", "abmoz_zh.cd" and then "abmoz.cd", until any of them is found.
    Note: it assumes the path as name_lang_cn_var.ext where ".ext" is optional. Example, my_zh_tw.html.jsp.
    If an URI starting with "~./", it assumes the resource is from the class path.
    
    Parameters:
    
    path - the page path excluding servlet name. It is OK to have the query string. It might contain "*" for current browser code and Locale.
    
    Returns:
    
    the path that matches the wildcard; path, otherwise
  - isVoided
```
public boolean isVoided()
```
    Description copied from interface: Execution
    
    Returns whether the execution is voided. By void we mean ZK Loader shall stop evaluation of a ZUML document, since the request will be taken charged by other servlet or redirect to another page. The execution shall not do anything more. In other words, the execution is avoided and won't generate any output.
    The common cause of being voided is the invocation of Execution.forward(java.io.Writer, java.lang.String, java.util.Map<java.lang.String, ?>, int).
  - setVoided
```
public void setVoided(boolean voided)
```
    Description copied from interface: Execution
    
    Sets whether the execution is voided. By void we mean ZK Loader shall stop evaluation of a ZUML document, since the request will be taken charged by other servlet or redirect to another page.
    If you invoke Execution.forward(java.io.Writer, java.lang.String, java.util.Map<java.lang.String, ?>, int), this method is called automatically with true. Thus, you rarely need to invoke this method, unless you forward to other servlet by use javax.servlet.RequestDispatcher directly.
    The other case to invoke this method is if you'd like to redirect to another (by specifying the refresh header).
    If the ZK page has already been created, this method throws an IllegalStateException, i.e. you cannot invoke this method in Composer.doAfterCompose(Component). (@since 6.5.5)
  - encodeURL
```
public java.lang.String encodeURL(java.lang.String uri)
```
    Description copied from interface: Execution
    
    Encodes an URL.
    It resolves "*" contained in URI, if any, to the proper Locale, and the browser code. Refer to Servlets.locate(ServletContext, ServletRequest, String, Locator) for details.
  - getUserPrincipal
```
public java.security.Principal getUserPrincipal()
```
    Description copied from interface: Execution
    
    Returns a java.security.Principal object containing the name of the current authenticated user. If the user has not been authenticated, the method returns null.
  - isUserInRole
```
public boolean isUserInRole(java.lang.String role)
```
    Description copied from interface: Execution
    
    Returns a boolean indicating whether the authenticated user is included in the specified logical "role". Roles and role membership can be defined using deployment descriptors. If the user has not been authenticated, the method returns false.
    
    Parameters:
    
    role - a String specifying the name of the role
  - getRemoteUser
```
public java.lang.String getRemoteUser()
```
    Description copied from interface: Execution
    
    Returns the login of the user making this request, if the user has been authenticated, or null if the user has not been authenticated. Whether the user name is sent with each subsequent request depends on the browser and type of authentication.
  - getRemoteHost
```
public java.lang.String getRemoteHost()
```
    Description copied from interface: Execution
    
    Returns the fully qualified name of the client or the last proxy that sent the request. If the engine cannot or chooses not to resolve the hostname (to improve performance), this method returns the dotted-string form of the IP address.
  - getRemoteAddr
```
public java.lang.String getRemoteAddr()
```
    Description copied from interface: Execution
    
    Returns the Internet Protocol (IP) address of the client or last proxy that sent the request.
  - getServerName
```
public java.lang.String getServerName()
```
    Description copied from interface: Execution
    
    Returns the host name of the server to which the request was sent. It is the value of the part before ":" in the Host header value, if any, or the resolved server name, or the server IP address.
    
    See Also:
    
    Execution.getLocalName()
  - getServerPort
```
public int getServerPort()
```
    Description copied from interface: Execution
    
    Returns the port number to which the request was sent. It is the value of the part after ":" in the Host header value, if any, or the server port where the client connection was accepted on.
    
    See Also:
    
    Execution.getLocalPort()
  - getLocalName
```
public java.lang.String getLocalName()
```
    Description copied from interface: Execution
    
    Returns the host name of the Internet Protocol (IP) interface on which the request was received.
    Note: it is the host name defined in the server. To retrieve the name in URL, use Execution.getServerName().
    
    See Also:
    
    Execution.getServerName()
  - getLocalAddr
```
public java.lang.String getLocalAddr()
```
    Description copied from interface: Execution
    
    Returns the Internet Protocol (IP) address of the interface on which the request was received.
  - getLocalPort
```
public int getLocalPort()
```
    Description copied from interface: Execution
    
    Returns the Internet Protocol (IP) port number of the interface on which the request was received.
    
    See Also:
    
    Execution.getServerPort()
  - getContextPath
```
public java.lang.String getContextPath()
```
    Description copied from interface: Execution
    
    Returns the portion of the request URI that indicates the context of the current execution. The path starts with a "/" character but does not end with a "/" character. For servlets in the default (root) context, this method returns "".
    If the client is not using HTTP to access, this method return "";
    
    See Also:
    
    Page.getRequestPath()
  - getScheme
```
public java.lang.String getScheme()
```
    Description copied from interface: Execution
    
    Returns the name of the scheme used to make this request, for example, http, https, or ftp. Different schemes have different rules for constructing URLs, as noted in RFC 1738.
  - getPageDefinition
```
public PageDefinition getPageDefinition(java.lang.String uri)
```
    Description copied from interface: Execution
    
    Returns the page definition from the page file specified by an URI.
    Implementation Notes: this method must invoke UiFactory.getPageDefinition(org.zkoss.zk.ui.sys.RequestInfo, String)
    
    Parameters:
    
    uri - the URI of the page file.
    
    See Also:
    
    Execution.getPageDefinitionDirectly(String, String), Execution.getPageDefinitionDirectly(Document, String), Execution.getPageDefinitionDirectly(Reader, String)
  - getPageDefinitionDirectly
```
public PageDefinition getPageDefinitionDirectly(java.lang.String content,
                                                java.lang.String ext)
```
    Description copied from interface: Execution
    
    Converts the specified page content to a page definition.
    Implementation Notes: this method must invoke UiFactory.getPageDefinitionDirectly(org.zkoss.zk.ui.sys.RequestInfo, String, String)
    
    Parameters:
    
    content - the raw content of the page. It must be in ZUML.
    
    ext - the default extension if the content doesn't specify an language. In other words, if the content doesn't specify an language, LanguageDefinition.getByExtension(java.lang.String) is called. If extension is null and the content doesn't specify a language, the language called "xul/html" is assumed.
    
    See Also:
    
    Execution.getPageDefinitionDirectly(Document, String), Execution.getPageDefinitionDirectly(Reader, String), Execution.getPageDefinition(java.lang.String)
  - getPageDefinitionDirectly
```
public PageDefinition getPageDefinitionDirectly(Document content,
                                                java.lang.String ext)
```
    Description copied from interface: Execution
    
    Converts the specified page content, in DOM, to a page definition.
    
    Parameters:
    
    content - the raw content of the page in DOM.
    
    ext - the default extension if the content doesn't specify an language. In other words, if the content doesn't specify an language, LanguageDefinition.getByExtension(java.lang.String) is called. If extension is null and the content doesn't specify a language, the language called "xul/html" is assumed.
    
    See Also:
    
    Execution.getPageDefinitionDirectly(String, String), Execution.getPageDefinitionDirectly(Reader, String), Execution.getPageDefinition(java.lang.String)
  - getPageDefinitionDirectly
```
public PageDefinition getPageDefinitionDirectly(java.io.Reader reader,
                                                java.lang.String ext)
                                         throws java.io.IOException
```
    Description copied from interface: Execution
    
    Reads the raw content from a reader and converts it into a page definition.
    
    Parameters:
    
    reader - used to input the raw content of the page. It must be in ZUML.
    
    ext - the default extension if the content doesn't specify an language. In other words, if the content doesn't specify an language, LanguageDefinition.getByExtension(java.lang.String) is called. If extension is null and the content doesn't specify a language, the language called "xul/html" is assumed.
    
    Throws:
    
    java.io.IOException
    
    See Also:
    
    Execution.getPageDefinitionDirectly(String, String), Execution.getPageDefinitionDirectly(Document, String), Execution.getPageDefinition(java.lang.String)
  - setContentType
```
public void setContentType(java.lang.String contentType)
```
    Description copied from interface: ExecutionCtrl
    
    Sets the content type.
  - isBrowser
```
public boolean isBrowser()
```
    Deprecated. As of release 6.0.0, replaced with getBrowser(String).
    
    Description copied from interface: Execution
    
    Returns whether the client is a browser. No matter the client is Ajax, MIL or whatever, it returns true. It returns false only if this is a 'fake' execution (aka., request).
  - isBrowser
```
public boolean isBrowser(java.lang.String type)
```
    Deprecated. As of release 6.0.0, replaced with getBrowser(String).
    
    Description copied from interface: Execution
    
    Returns whether it is a browser of the specified type.
    
    Parameters:
    
    type - the type of the browser. The syntax: <browser-name>[<version-number>][-].
    For example, ie9, ios and ie6-. And, ie9 means Internet Explorer 9 and later, while ie6- means Internet Explorer 6 (not prior, nor later).
  - isRobot
```
public boolean isRobot()
```
    Deprecated. As of release 6.0.0, replaced with getBrowser(String).
    
    Description copied from interface: Execution
    
    Returns whether the client is a robot (such as Web crawlers).
    Because there are too many robots, it returns true if the user-agent is not recognized.
  - isExplorer
```
public boolean isExplorer()
```
    Deprecated. As of release 6.0.0, replaced with getBrowser(String).
    
    Description copied from interface: Execution
    
    Returns whether the client is Internet Explorer. If true, it also implies Execution.isExplorer7() is true.
  - isExplorer7
```
public boolean isExplorer7()
```
    Deprecated. As of release 6.0.0, replaced with getBrowser(String).
    
    Description copied from interface: Execution
    
    Returns whether the client is Internet Explorer 7 or later.
  - isGecko
```
public boolean isGecko()
```
    Deprecated. As of release 6.0.0, replaced with getBrowser(String).
    
    Description copied from interface: Execution
    
    Returns whether the client is Gecko based, such as Mozilla, Firefox and Camino.
  - isGecko3
```
public boolean isGecko3()
```
    Deprecated. As of release 6.0.0, replaced with getBrowser(String).
    
    Description copied from interface: Execution
    
    Returns whether the browser is Gecko 3 based, such as Firefox 3.
  - isOpera
```
public boolean isOpera()
```
    Deprecated. As of release 6.0.0, replaced with getBrowser(String).
    
    Description copied from interface: Execution
    
    Returns whether the client is Opera.
  - isSafari
```
public boolean isSafari()
```
    Deprecated. As of release 6.0.0, replaced with getBrowser(String).
    
    Description copied from interface: Execution
    
    Returns whether the client is Safari.
  - isHilDevice
```
public boolean isHilDevice()
```
    Deprecated. As of release 6.0.0, replaced with getBrowser(String).
    
    Description copied from interface: Execution
    
    Returns whether the client is a mobile device supporting HIL (Handset Interactive Language).
  - getBrowser
```
public java.lang.Double getBrowser(java.lang.String name)
```
    Description copied from interface: Execution
    
    Returns the version of the given browser name, or null if the client is not the given browsers.
    Notice that, after this method is called, an attribute named zk will be stored to the request, such that you can retrieve the browser information by use of EL, such as ${zk.ie > 7}.
    
    Parameters:
    
    name - the browser's name. It includes "ie", "ff", "gecko", "webkit", "safari" and "opera". And, "ff" is the same as "gecko", and "webit" is the same as "safari".
  - getBrowser
```
public java.lang.String getBrowser()
```
    Description copied from interface: Execution
    
    Returns the name of the browser, or null if not identifiable.
  - getUserAgent
```
public java.lang.String getUserAgent()
```
    Description copied from interface: Execution
    
    Returns the user-agent header, which indicates what the client is, or an empty string if not available.
    Note: it doesn't return null, so it is easy to test what the client is with String.indexOf(int).
  - getNativeRequest
```
public java.lang.Object getNativeRequest()
```
    Description copied from interface: Execution
    
    Returns the native request, or null if not available.
    The returned object depends on the Web container. If it is based Java servlet container, an instance of javax.servlet.ServletRequest is returned.
  - getNativeResponse
```
public java.lang.Object getNativeResponse()
```
    Description copied from interface: Execution
    
    Returns the native response, or null if not available.
    The returned object depends on the Web container. If it is based Java servlet container, an instance of javax.servlet.ServletResponse is returned.
  - getAttribute
```
public java.lang.Object getAttribute(java.lang.String name)
```
    Description copied from interface: Execution
    
    Returns the value of the specified request attribute.
  - hasAttribute
```
public boolean hasAttribute(java.lang.String name)
```
    Description copied from interface: Scope
    
    Returns if a custom attribute is associated with this object (scope).
    Notice that null is a valid value, so you can tell if an attribute is associated by examining the return value of Scope.getAttribute(java.lang.String).
  - setAttribute
```
public java.lang.Object setAttribute(java.lang.String name,
                                     java.lang.Object value)
```
    Description copied from interface: Execution
    
    Sets the value of the specified request attribute.
    
    value - the value. If null, the attribute is removed.
    
    Returns:
    
    the previous value if any (since ZK5)
  - removeAttribute
```
public java.lang.Object removeAttribute(java.lang.String name)
```
    Description copied from interface: Execution
    
    Removes the specified request attribute.
    
    Returns:
    
    the previous value if any (since ZK5)
  - getAttributes
```
public java.util.Map<java.lang.String,java.lang.Object> getAttributes()
```
    Description copied from interface: Execution
    
    Returns a map of request attributes associated with this session.
  - addScopeListener
```
public boolean addScopeListener(ScopeListener listener)
```
    Description copied from interface: Scope
    
    Adds a listener to listen whether this scope is changed. The listener is called when a custom attribute is added, removed, or the parent is changed.
    
    Returns:
    
    weather the listener is added successfully. Note: if the resolver was added before, it won't be added again and this method returns false.
  - removeScopeListener
```
public boolean removeScopeListener(ScopeListener listener)
```
    Description copied from interface: Scope
    
    Removes a change listener from this scope.
    
    Returns:
    
    false if listener is not added before.
  - getHeader
```
public java.lang.String getHeader(java.lang.String name)
```
    Description copied from interface: Execution
    
    Returns the value of the specified header as a String, or null if not found.
  - getHeaders
```
public java.lang.Iterable<java.lang.String> getHeaders(java.lang.String name)
```
    Description copied from interface: Execution
    
    Returns all the values of the specified header as an iterable String objects.
    If the request did not include any headers of the specified name, this method returns an empty iterable. If the container does not allow access to header information, it returns null.
  - getHeaderNames
```
public java.lang.Iterable<java.lang.String> getHeaderNames()
```
    Description copied from interface: Execution
    
    Returns all header names this request contains. If the request has no headers, this method returns an empty iterable. If the container does not allow access to header information, it returns null.
  - setResponseHeader
```
public void setResponseHeader(java.lang.String name,
                              java.lang.String value)
```
    Description copied from interface: Execution
    
    Sets a response header with the give name and value. If the header had already been set, the new value overwrites the previous one.
    
    value - the additional header value If it contains octet string, it should be encoded according to RFC 2047 (http://www.ietf.org/rfc/rfc2047.txt).
    
    See Also:
    
    Execution.containsResponseHeader(java.lang.String)
  - setResponseHeader
```
public void setResponseHeader(java.lang.String name,
                              java.util.Date value)
```
    Description copied from interface: Execution
    
    Sets a response header with the given name and date-value.
  - addResponseHeader
```
public void addResponseHeader(java.lang.String name,
                              java.lang.String value)
```
    Description copied from interface: Execution
    
    Adds a response header with the give name and value. This method allows response headers to have multiple values.
    
    value - the additional header value If it contains octet string, it should be encoded according to RFC 2047 (http://www.ietf.org/rfc/rfc2047.txt).
  - addResponseHeader
```
public void addResponseHeader(java.lang.String name,
                              java.util.Date value)
```
    Description copied from interface: Execution
    
    Adds a response header with the given name and date-value.
  - containsResponseHeader
```
public boolean containsResponseHeader(java.lang.String name)
```
    Description copied from interface: Execution
    
    Returns whether the named response header has already been set.
  - getContextURI
```
public java.lang.String getContextURI()
```
    Description copied from interface: Execution
    
    Returns the context uri from the current execution.

Class ExecutionImpl

Field Summary

Fields inherited from class org.zkoss.zk.ui.impl.AbstractExecution

Fields inherited from interface org.zkoss.zk.ui.Execution

Constructor Summary

Method Summary

Methods inherited from class org.zkoss.zk.ui.impl.AbstractExecution

Methods inherited from class java.lang.Object

Constructor Detail

ExecutionImpl

Method Detail

onActivate

onDeactivate

getParameterValues

getParameter

getParameterMap

getVariableResolver

getEvaluator

getEvaluator

evaluate

evaluate

include

include

forward

forward

isIncluded

isForwarded

locate

isVoided

setVoided

encodeURL

getUserPrincipal

isUserInRole

getRemoteUser

getRemoteHost

getRemoteAddr

getServerName

getServerPort

getLocalName

getLocalAddr

getLocalPort

getContextPath

getScheme

getPageDefinition

getPageDefinitionDirectly

getPageDefinitionDirectly

getPageDefinitionDirectly

setContentType

isBrowser

isBrowser

isRobot

isExplorer

isExplorer7

isGecko

isGecko3

isOpera

isSafari

isHilDevice

getBrowser

getBrowser

getUserAgent

getNativeRequest

getNativeResponse

getAttribute

hasAttribute

setAttribute

removeAttribute

getAttributes

addScopeListener

removeScopeListener

getHeader

getHeaders

getHeaderNames

setResponseHeader

setResponseHeader

addResponseHeader

addResponseHeader

containsResponseHeader

getContextURI