forward"
From Documentation
Maya001122 (talk | contribs) (Created page with '== The forward Directive == <source lang="xml" > <?forward uri="..." [if="..."] [unless="..."]?> </source> It specifies the URI to forward the request to, and the condition to…') |
m (correct highlight (via JWB)) |
||
| (8 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | {{ZUMLReferencePageHeader}} | |
| − | + | __TOC__ | |
| + | |||
| + | '''Syntax:''' | ||
<?forward uri="..." [if="..."] [unless="..."]?> | <?forward uri="..." [if="..."] [unless="..."]?> | ||
| − | |||
| − | It specifies the URI to forward the request to, and the condition to decide whether to forward. If the condition is satisfied or not specified, this page won't be rendered, and the request is, instead, forwarded to the URI specified in the < | + | It specifies the URI to forward the request to, and the condition to decide whether to forward. If the condition is satisfied or not specified, this page won't be rendered, and the request is, instead, forwarded to the URI specified in the <code>uri</code> attribute. |
Notes | Notes | ||
| − | * Even if the forward is effective (i.e., ZK forwards the request to the specified URI), the initiators specified in the < | + | * Even if the forward is effective (i.e., ZK forwards the request to the specified URI), the initiators specified in the <code>init</code> directives will still be called. |
| − | * The < | + | * The <code>createComponents</code> method of the Execution interface ignores the <code>forward</code> directives. In other words, the <code>forward</code> directives are evaluated only if the ZUML page is loaded directly. |
| − | + | = uri = | |
| − | + | [Required][EL expressions allowed] | |
| − | [ | ||
| − | |||
The URI of the page/servlet to forward to. It may be another ZUML page, a JSP page or any servlet. | The URI of the page/servlet to forward to. It may be another ZUML page, a JSP page or any servlet. | ||
| Line 22: | Line 21: | ||
If an EL expression is specified and it is evaluated to an empty string, it is considered as no forwarding at all. | If an EL expression is specified and it is evaluated to an empty string, it is considered as no forwarding at all. | ||
| − | == if == | + | = if = |
| + | |||
| + | [Optional][Default: true][EL expressions allowed] | ||
| + | |||
| + | The condition to forward to the specified URI. If both <code>if</code> and <code>unless</code> are omitted, this page won't be evaluated and ZK always forwards the request to the specified URI. | ||
| + | |||
| + | = unless = | ||
| − | + | [Optional][Default: false][EL expressions allowed] | |
| − | [Optional][Default: | ||
| − | |||
| − | The condition to forward to the specified URI. If both < | + | The condition ''not'' to forward to the specified URI. If both <code>if</code> and <code>unless</code> are omitted, this page won't be evaluated and ZK always forwards the request to the specified URI. |
| − | = | + | =Version History= |
| − | + | {| border='1px' | width="100%" | |
| − | + | ! Version !! Date !! Content | |
| − | + | |- | |
| + | | | ||
| + | | | ||
| + | | | ||
| + | |} | ||
| − | + | {{ZUMLReferencePageFooter}} | |
Latest revision as of 13:27, 19 January 2022
Syntax:
<?forward uri="..." [if="..."] [unless="..."]?>
It specifies the URI to forward the request to, and the condition to decide whether to forward. If the condition is satisfied or not specified, this page won't be rendered, and the request is, instead, forwarded to the URI specified in the uri attribute.
Notes
- Even if the forward is effective (i.e., ZK forwards the request to the specified URI), the initiators specified in the
initdirectives will still be called. - The
createComponentsmethod of the Execution interface ignores theforwarddirectives. In other words, theforwarddirectives are evaluated only if the ZUML page is loaded directly.
uri
[Required][EL expressions allowed]
The URI of the page/servlet to forward to. It may be another ZUML page, a JSP page or any servlet.
If an EL expression is specified and it is evaluated to an empty string, it is considered as no forwarding at all.
if
[Optional][Default: true][EL expressions allowed]
The condition to forward to the specified URI. If both if and unless are omitted, this page won't be evaluated and ZK always forwards the request to the specified URI.
unless
[Optional][Default: false][EL expressions allowed]
The condition not to forward to the specified URI. If both if and unless are omitted, this page won't be evaluated and ZK always forwards the request to the specified URI.
Version History
| Version | Date | Content |
|---|---|---|