|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface Execution
An execution of a client request (e.g., ServletRequest).
When a request sent from a client, the server constructs
a Execution
object to hold execution relevant info, and then serves the request
thru this execution.
A client request, e.g., HttpServletRequest, might consist of
multiple ZK request (AuRequest
).
However, these ZK requests
must target the same desktop of pages (Page
).
Because a request might come from HTTP or other protocol, Execution also serves as an isolation layer.
Page
Field Summary | |
---|---|
static int |
APPEND_PARAM
Whether to append params if both uri and params contain the same parameter. |
static int |
IGNORE_PARAM
Whether to ignore params if both uri and params contain the same parameter. |
static int |
OVERWRITE_URI
Whether to overwrite uri if both uri and params contain the same parameter. |
static int |
PASS_THRU_ATTR
Whether the specified parameters shall be passed thru the request's attribute called arg. |
Method Summary | |
---|---|
void |
addAuResponse(java.lang.String key,
AuResponse resposne)
Adds an asynchronous response ( AuResponse ) which will be
sent to client at the end of the execution. |
void |
addResponseHeader(java.lang.String name,
java.lang.String value)
Adds a response header with the give name and value. |
boolean |
containsResponseHeader(java.lang.String name)
Returns whether the named response header has already been set. |
Component |
createComponents(PageDefinition pagedef,
Component parent,
java.util.Map arg)
Creates components from the specified page definition. |
Component[] |
createComponents(PageDefinition pagedef,
java.util.Map arg)
Creates components that don't belong to any page from the specified page definition. |
Component |
createComponents(java.lang.String uri,
Component parent,
java.util.Map arg)
Creates components from a page file specified by an URI. |
Component[] |
createComponents(java.lang.String uri,
java.util.Map arg)
Creates components that don't belong to any page from a page file specified by an URI. |
Component |
createComponentsDirectly(Document content,
java.lang.String extension,
Component parent,
java.util.Map arg)
Creates components from the raw content specified by a DOM tree. |
Component[] |
createComponentsDirectly(Document content,
java.lang.String extension,
java.util.Map arg)
Creates components that don't belong to any page from the raw content specified by a DOM tree. |
Component |
createComponentsDirectly(java.io.Reader reader,
java.lang.String extension,
Component parent,
java.util.Map arg)
Creates components from the raw content read from the specified reader. |
Component[] |
createComponentsDirectly(java.io.Reader reader,
java.lang.String extension,
java.util.Map arg)
Creates components that don't belong to any page from the raw content read from the specified reader. |
Component |
createComponentsDirectly(java.lang.String content,
java.lang.String extension,
Component parent,
java.util.Map arg)
Creates components from the raw content specified by a string. |
Component[] |
createComponentsDirectly(java.lang.String content,
java.lang.String extension,
java.util.Map arg)
Creates components that don't belong to any page from the raw content specified by a string. |
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)
Evluates 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)
Evluates 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 writer,
java.lang.String page,
java.util.Map params,
int mode)
Forwards to another page. |
java.util.Map |
getArg()
Returns the parameters (aka., arg) if pushArg(java.util.Map) is called recently,
or an empty map if not available. |
java.lang.Object |
getAttribute(java.lang.String name)
Returns the value of the specified request attribute. |
java.util.Map |
getAttributes()
Returns a map of request attributes associated with this session. |
java.lang.String |
getContextPath()
Returns the portion of the request URI that indicates the context of the current execution. |
Desktop |
getDesktop()
Returns the desktop associated with this execution. |
Evaluator |
getEvaluator(Component comp,
java.lang.Class expfcls)
Returns the evaluator of the current execution. |
Evaluator |
getEvaluator(Page page,
java.lang.Class 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.util.Iterator |
getHeaderNames()
Returns all header names this request contains. |
java.util.Iterator |
getHeaders(java.lang.String name)
Returns all the values of the specified header as a Iterator
of 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 extension)
Converts the specified page content, in DOM, to a page definition. |
PageDefinition |
getPageDefinitionDirectly(java.io.Reader reader,
java.lang.String extension)
Reads the raw content from a reader and converts it into a page definition. |
PageDefinition |
getPageDefinitionDirectly(java.lang.String content,
java.lang.String extension)
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 |
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. |
Session |
getSession()
Returns the session this execution belongs to. |
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. |
void |
include(java.lang.String page)
A shortcut of include(null, page, null, 0). |
void |
include(java.io.Writer writer,
java.lang.String page,
java.util.Map params,
int mode)
Includes a page. |
boolean |
isAsyncUpdate(Page page)
Returns whether this execution is asynchronous updating the specified page (thru ZK Update Engine). |
boolean |
isBrowser()
Returns whether the client is a browser. |
boolean |
isBrowser(java.lang.String type)
Returns whether it is a browser of the specified type. |
boolean |
isExplorer()
Returns whether the client is Internet Explorer. |
boolean |
isExplorer7()
Returns whether the client is Internet Explorer 7 or later. |
boolean |
isForwarded()
Returns whether the execution is forwarded from other pages. |
boolean |
isGecko()
Returns whether the client is Gecko based, such as Mozilla, Firefox and Camino. |
boolean |
isGecko3()
Returns whether the browser is Gecko 3 based, such as Firefox 3. |
boolean |
isHilDevice()
Returns whether the client is a mobile device supporting HIL (Handset Interactive Language). |
boolean |
isIncluded()
Returns whether this execution is included by some other pages. |
boolean |
isMilDevice()
Deprecated. As of release 5.0.0, MIL is no longer supported. |
boolean |
isOpera()
Returns whether the client is Opera. |
boolean |
isRobot()
Returns whether the client is a robot (such as Web crawlers). |
boolean |
isSafari()
Returns whether the client is Safari. |
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 |
popArg()
Pops the parameters (aka., arg) that is pushed by pushArg(java.util.Map) . |
void |
postEvent(Event evt)
Queues an event to this execution. |
void |
postEvent(int priority,
Event evt)
Queues an event with the specified priority to this execution. |
void |
pushArg(java.util.Map arg)
Pushes the parameters (aka., arg) that EL could refer it by the arg variable. |
java.lang.Object |
removeAttribute(java.lang.String name)
Removes the specified request attribute. |
void |
sendRedirect(java.lang.String uri)
Sends a temporary redirect response to the client using the specified redirect location URL. |
void |
sendRedirect(java.lang.String uri,
java.lang.String target)
Sends a temporary redirect response to the client using the specified redirect location URL and redirect to the specified browser window. |
java.lang.Object |
setAttribute(java.lang.String name,
java.lang.Object value)
Sets the value of the specified request attribute. |
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. |
java.lang.String |
toAbsoluteURI(java.lang.String uri,
boolean skipInclude)
Converts the specified URI to an absolute URI, if uri is related and the current execution is not included ( isIncluded() ). |
Methods inherited from interface org.zkoss.zk.ui.ext.Scope |
---|
addScopeListener, getAttribute, hasAttribute, hasAttribute, removeAttribute, removeScopeListener, setAttribute |
Field Detail |
---|
static final int OVERWRITE_URI
static final int IGNORE_PARAM
static final int APPEND_PARAM
static final int PASS_THRU_ATTR
Method Detail |
---|
Desktop getDesktop()
Session getSession()
boolean isAsyncUpdate(Page page)
java.lang.String[] getParameterValues(java.lang.String name)
java.lang.String getParameter(java.lang.String name)
java.util.Map getParameterMap()
Evaluator getEvaluator(Page page, java.lang.Class expfcls)
Expression
or used with ExValue
.
for performance improvement.
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()
.Evaluator getEvaluator(Component comp, java.lang.Class expfcls)
comp
- the component to retrieve the page for the evaluatorexpfcls
- the implementation of ExpressionFactory
,
or null to use the default (Configuration.getExpressionFactoryClass()
.java.lang.Object evaluate(Component comp, java.lang.String expr, java.lang.Class expectedType)
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
getEvaluator(org.zkoss.zk.ui.Page, java.lang.Class)
to parse and cached the parsed expression.
ExValue
is a utility class to simply
the task.
comp
- used as the self variable and to retrieve the function
mapper. Ignored if null.getVariableResolver()
,
getEvaluator(org.zkoss.zk.ui.Page, java.lang.Class)
java.lang.Object evaluate(Page page, java.lang.String expr, java.lang.Class expectedType)
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
getEvaluator(org.zkoss.zk.ui.Page, java.lang.Class)
to parse and cached the parsed expression.
ExValue
is a utility class to simply
the task.
page
- used as the self variable and to retrieve the function
mapper. Ignored if null.getVariableResolver()
,
getEvaluator(org.zkoss.zk.ui.Page, java.lang.Class)
VariableResolver getVariableResolver()
Note: the resolver is similar to PageContext's if this execution is caused by a HTTP request.
evaluate(Component,String,Class)
void postEvent(Event evt)
The priority of the event is assumed to be 0. Refer to
postEvent(int, Event)
.
void postEvent(int priority, Event evt)
The posted events are processed from the higher priority to the lower one. If two events are posted with the same priority, the earlier the event being posted is processed earlier (first-in-first-out).
The priority posted by posted by postEvent(Event)
is
0.
Applications shall not use the priority higher than 10,000 and
lower than -10,000 since they are reserved for component
development.
priority
- the priority of the event.void include(java.io.Writer writer, java.lang.String page, java.util.Map params, int mode) throws java.io.IOException
writer
- the output to write. If null, the response's default
writer is used.page
- the page's uri; null to denote the same requestmode
- one of OVERWRITE_URI
, IGNORE_PARAM
,
APPEND_PARAM
and 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.
java.io.IOException
void include(java.lang.String page) throws java.io.IOException
java.io.IOException
void forward(java.io.Writer writer, java.lang.String page, java.util.Map params, int mode) throws java.io.IOException
Note: this method can be called only when loading a page.
Use sendRedirect(String)
instead if you want to change
to another desktop when processing a request from the client.
writer
- the output to write. If null, the response's default
writer is used.page
- the page's uri; null to denote the same requestmode
- one of OVERWRITE_URI
, IGNORE_PARAM
,
APPEND_PARAM
and 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.
java.io.IOException
void forward(java.lang.String page) throws java.io.IOException
java.io.IOException
java.lang.String locate(java.lang.String path)
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.
path
- the page path excluding servlet name. It is OK to have
the query string. It might contain "*" for current browser code and Locale.
path
, otherwiseboolean isVoided()
The common cause of being voided is the invocation of
forward(java.io.Writer, java.lang.String, java.util.Map, int)
.
void setVoided(boolean voided)
If you invoke forward(java.io.Writer, java.lang.String, java.util.Map, 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.
boolean isIncluded()
boolean isForwarded()
java.lang.String toAbsoluteURI(java.lang.String uri, boolean skipInclude)
isIncluded()
).
Note: an asynchrous update is processed by the update servlet. It is different from the servlet for rendering the ZUML page. In other words, a relative URI won't be interpreted correctly, so you have to invoke this method to convert them if necessary.
In addtions, RequestDispatcher.include doesn't handle related URI well.
skipInclude
- whether not to convert to an absolute URI if
the current page is included by another page.
If you are not sure, you might specify false.java.lang.String encodeURL(java.lang.String uri)
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.
java.security.Principal getUserPrincipal()
boolean isUserInRole(java.lang.String role)
role
- a String specifying the name of the rolejava.lang.String getRemoteUser()
java.lang.String getRemoteHost()
java.lang.String getRemoteAddr()
java.lang.String getServerName()
getLocalName()
int getServerPort()
getLocalPort()
java.lang.String getLocalName()
Note: it is the host name defined in the server. To retrieve the name
in URL, use getServerName()
.
getServerName()
java.lang.String getLocalAddr()
int getLocalPort()
getServerPort()
java.lang.String getScheme()
java.lang.String getContextPath()
If the client is not using HTTP to access, this method return "";
Page.getRequestPath()
PageDefinition getPageDefinition(java.lang.String uri)
Implemetation Notes: this method must invoke
UiFactory.getPageDefinition(org.zkoss.zk.ui.sys.RequestInfo, String)
uri
- the URI of the page file.getPageDefinitionDirectly(String, String)
,
getPageDefinitionDirectly(Document, String)
,
getPageDefinitionDirectly(Reader, String)
PageDefinition getPageDefinitionDirectly(java.lang.String content, java.lang.String extension)
Implemetation Notes: this method must invoke
UiFactory.getPageDefinitionDirectly(org.zkoss.zk.ui.sys.RequestInfo, String, String)
content
- the raw content of the page. It must be in ZUML.extension
- 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.getPageDefinitionDirectly(Document, String)
,
getPageDefinitionDirectly(Reader, String)
,
getPageDefinition(java.lang.String)
PageDefinition getPageDefinitionDirectly(Document content, java.lang.String extension)
content
- the raw content of the page in DOM.extension
- 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.getPageDefinitionDirectly(String, String)
,
getPageDefinitionDirectly(Reader, String)
,
getPageDefinition(java.lang.String)
PageDefinition getPageDefinitionDirectly(java.io.Reader reader, java.lang.String extension) throws java.io.IOException
reader
- used to input the raw content of the page. It must be in ZUML.extension
- 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.
java.io.IOException
getPageDefinitionDirectly(String, String)
,
getPageDefinitionDirectly(Document, String)
,
getPageDefinition(java.lang.String)
Component createComponents(PageDefinition pagedef, Component parent, java.util.Map arg)
pagedef
- the page definition to use. It cannot be null.parent
- the parent component, or null if you want it to be
a root component. If parent is null, the page is assumed to be
the current page, which is determined by the execution context.
In other words, the new component will be the root component
of the current page if parent is null.arg
- a map of parameters that is accessible by the arg variable
in EL, or by getArg()
.
Ignored if null.
createComponents(String, Component, Map)
Component createComponents(java.lang.String uri, Component parent, java.util.Map arg)
It loads the page definition from the specified URI (by
use getPageDefinition(java.lang.String)
), and then
invokes createComponents(PageDefinition,Component,Map)
to create components.
parent
- the parent component, or null if you want it to be
a root component. If parent is null, the page is assumed to be
the current page, which is determined by the execution context.
In other words, the new component will be the root component
of the current page if parent is null.arg
- a map of parameters that is accessible by the arg variable
in EL, or by getArg()
.
Ignored if null.createComponents(PageDefinition, Component, Map)
,
createComponentsDirectly(String, String, Component, Map)
,
createComponentsDirectly(Document, String, Component, Map)
,
createComponentsDirectly(Reader, String, Component, Map)
Component createComponentsDirectly(java.lang.String content, java.lang.String extension, Component parent, java.util.Map arg)
The raw content is parsed to a page defintion by use of
getPageDefinitionDirectly(String, String)
, and then
invokes createComponents(PageDefinition,Component,Map)
to create components.
content
- the raw content of the page. It must be in ZUML.extension
- 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.parent
- the parent component, or null if you want it to be
a root component. If parent is null, the page is assumed to be
the current page, which is determined by the execution context.
In other words, the new component will be the root component
of the current page if parent is null.arg
- a map of parameters that is accessible by the arg variable
in EL, or by getArg()
.
Ignored if null.createComponents(PageDefinition, Component, Map)
,
createComponents(String, Component, Map)
,
createComponentsDirectly(Document, String, Component, Map)
,
createComponentsDirectly(Reader, String, Component, Map)
Component createComponentsDirectly(Document content, java.lang.String extension, Component parent, java.util.Map arg)
The raw content is parsed to a page defintion by use of
getPageDefinitionDirectly(Document, String)
, and then
invokes createComponents(PageDefinition,Component,Map)
to create components.
content
- the raw content in DOM.extension
- 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.parent
- the parent component, or null if you want it to be
a root component. If parent is null, the page is assumed to be
the current page, which is determined by the execution context.
In other words, the new component will be the root component
of the current page if parent is null.arg
- a map of parameters that is accessible by the arg variable
in EL, or by getArg()
.
Ignored if null.createComponents(PageDefinition, Component, Map)
,
createComponents(String, Component, Map)
,
createComponentsDirectly(Document, String, Component, Map)
,
createComponentsDirectly(Reader, String, Component, Map)
Component createComponentsDirectly(java.io.Reader reader, java.lang.String extension, Component parent, java.util.Map arg) throws java.io.IOException
The raw content is loaded and parsed to a page defintion by use of
getPageDefinitionDirectly(Reader,String)
, and then
invokes createComponents(PageDefinition,Component,Map)
to create components.
reader
- the reader to retrieve the raw content in ZUML.extension
- 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.parent
- the parent component, or null if you want it to be
a root component. If parent is null, the page is assumed to be
the current page, which is determined by the execution context.
In other words, the new component will be the root component
of the current page if parent is null.arg
- a map of parameters that is accessible by the arg variable
in EL, or by getArg()
.
Ignored if null.
java.io.IOException
createComponents(PageDefinition, Component, Map)
,
createComponents(String, Component, Map)
,
createComponentsDirectly(Document, String, Component, Map)
,
createComponentsDirectly(String, String, Component, Map)
Component[] createComponents(PageDefinition pagedef, java.util.Map arg)
pagedef
- the page definition to use. It cannot be null.arg
- a map of parameters that is accessible by the arg variable
in EL, or by getArg()
.
Ignored if null.
createComponents(String, Map)
Component[] createComponents(java.lang.String uri, java.util.Map arg)
It loads the page definition from the specified URI (by
use getPageDefinition(java.lang.String)
), and then
invokes createComponents(PageDefinition,Map)
to create components.
arg
- a map of parameters that is accessible by the arg variable
in EL, or by getArg()
.
Ignored if null.createComponents(PageDefinition, Map)
,
createComponentsDirectly(String, String, Map)
,
createComponentsDirectly(Document, String, Map)
,
createComponentsDirectly(Reader, String, Map)
Component[] createComponentsDirectly(java.lang.String content, java.lang.String extension, java.util.Map arg)
The raw content is parsed to a page defintion by use of
getPageDefinitionDirectly(String, String)
, and then
invokes createComponents(PageDefinition,Map)
to create components.
content
- the raw content of the page. It must be in ZUML.extension
- 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.arg
- a map of parameters that is accessible by the arg variable
in EL, or by getArg()
.
Ignored if null.createComponents(PageDefinition, Map)
,
createComponents(String, Map)
,
createComponentsDirectly(Document, String, Map)
,
createComponentsDirectly(Reader, String, Map)
Component[] createComponentsDirectly(Document content, java.lang.String extension, java.util.Map arg)
The raw content is parsed to a page defintion by use of
getPageDefinitionDirectly(Document, String)
, and then
invokes createComponents(PageDefinition,Map)
to create components.
content
- the raw content in DOM.extension
- 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.arg
- a map of parameters that is accessible by the arg variable
in EL, or by getArg()
.
Ignored if null.createComponents(PageDefinition, Map)
,
createComponents(String, Map)
,
createComponentsDirectly(Document, String, Map)
,
createComponentsDirectly(Reader, String, Map)
Component[] createComponentsDirectly(java.io.Reader reader, java.lang.String extension, java.util.Map arg) throws java.io.IOException
The raw content is loaded and parsed to a page defintion by use of
getPageDefinitionDirectly(Reader,String)
, and then
invokes createComponents(PageDefinition,Map)
to create components.
reader
- the reader to retrieve the raw content in ZUML.extension
- 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.arg
- a map of parameters that is accessible by the arg variable
in EL, or by getArg()
.
Ignored if null.
java.io.IOException
createComponents(PageDefinition, Map)
,
createComponents(String, Map)
,
createComponentsDirectly(Document, String, Map)
,
createComponentsDirectly(String, String, Map)
void sendRedirect(java.lang.String uri)
It is the same as sendRedirect(url, null).
After calling this method, the caller shall end the processing immediately (by returning). All pending requests and events will be dropped.
uri
- the URI to redirect to, or null to reload the same pagevoid sendRedirect(java.lang.String uri, java.lang.String target)
After calling this method, the caller shall end the processing immediately (by returning). All pending requests and events will be dropped.
Note: if you specify target other than null and "_self", it'll fail if the browser prevent the server to popup a window.
uri
- the URI to redirect to, or null to reload the same pagetarget
- the name of the browser window that send-redirect will
load the sepcified URI, or null if the current browser window
is used.java.util.Map getArg()
pushArg(java.util.Map)
is called recently,
or an empty map if not available.
The use of parameters is application dependent.
ZK only provides the way to store (pushArg(java.util.Map)
and to
restore popArg()
. And, let the parameters being accessible in
EL by referring it as the arg variable.
Currently, createComponents(String,Component,Map)
and similar methods use this mechanism to let caller customize a page
definition.
Notice that createComponents(String,Component,Map)
pops arg after creating components, and before processing any event.
In other words, it is not aviable for event listener, including onCreate.
However, CreateEvent.getArg()
preserves
the map for its event listeners.
void pushArg(java.util.Map arg)
popArg()
in the finally clause.
getArg()
void popArg()
pushArg(java.util.Map)
.
It never throws an exception.
getArg()
void addAuResponse(java.lang.String key, AuResponse resposne)
AuResponse
) which will be
sent to client at the end of the execution.
If AuResponse.getDepends()
is not null, the response
depends on the returned componet. In other words, the response
is removed if the component is removed.
If it is null, the response is component-independent.
key
- could be anything. The second invocation of this method
in the same execution with the same key will override the previous one.
In other words, the previous one will be dropped.
If null is specified, the response is simply appended to the end
without overriding any previous one.boolean isBrowser()
boolean isBrowser(java.lang.String type)
type
- the type of the browser.
Allowed values include "robot", "ie", "ie6", "ie6-", "ie7", "ie8", "ie8-"
"ie7-", "gecko", "gecko2", "gecko3", "gecko2-", "gecko3-"
"opara", "safari",
"mil", "hil", "mil-". Otherwise, it matches whether the type exist or not.boolean isRobot()
Because there are too many robots, it returns true if the user-agent is not recognized.
boolean isExplorer()
isExplorer7()
is true.
boolean isExplorer7()
boolean isGecko()
boolean isGecko3()
boolean isSafari()
boolean isOpera()
boolean isMilDevice()
boolean isHilDevice()
Note: ZK Mobile for Android supports both MIL and HIL.
That is, both isHilDevice()
and isMilDevice()
return true.
java.lang.String getUserAgent()
Note: it doesn't return null, so it is easy to test what
the client is with String.indexOf(int)
.
java.lang.Object getNativeRequest()
The returned object depends on the Web container. If it is based Java servlet container, an instance of javax.servlet.ServletRequest is returned.
java.lang.Object getNativeResponse()
The returned object depends on the Web container. If it is based Java servlet container, an instance of javax.servlet.ServletResponse is returned.
java.lang.Object getAttribute(java.lang.String name)
getAttribute
in interface Scope
java.lang.Object setAttribute(java.lang.String name, java.lang.Object value)
setAttribute
in interface Scope
value
- the value. If null, the attribute is removed.
java.lang.Object removeAttribute(java.lang.String name)
removeAttribute
in interface Scope
java.util.Map getAttributes()
getAttributes
in interface Scope
java.lang.String getHeader(java.lang.String name)
String
,
or null if not found.
java.util.Iterator getHeaders(java.lang.String name)
Iterator
of String
objects.
If the request did not include any headers of the specified name,
this method returns an empty Iterator
.
If the container does not allow access to header information,
it returns null.
java.util.Iterator getHeaderNames()
Iterator
.
If the container does not allow access to header information,
it returns null.
void setResponseHeader(java.lang.String name, java.lang.String value)
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).containsResponseHeader(java.lang.String)
void addResponseHeader(java.lang.String name, java.lang.String value)
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).boolean containsResponseHeader(java.lang.String name)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |