forward"

From Documentation
(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:
== The forward Directive ==
+
{{ZUMLReferencePageHeader}}
  
<source lang="xml" >
+
__TOC__
 +
 
 +
'''Syntax:'''
 
  <?forward uri="..." [if="..."] [unless="..."]?>
 
  <?forward uri="..." [if="..."] [unless="..."]?>
</source>
 
  
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 <tt>uri</tt> attribute.
+
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 <tt>init</tt> directives will be called.
+
* 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 <tt>createComponents</tt> method of the Execution interface ignores the <tt>forward</tt> directives. In other words, the <tt>forward</tt> directives are evaluated only if the ZUML page is loaded directly.
+
* 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 ==
+
= uri =
  
<source lang="bash" >
+
[Required][EL expressions allowed]
[required][EL expressions allowed]
 
</source>
 
  
 
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 =
  
<source lang="bash" >
+
[Optional][Default: false][EL expressions allowed]
[Optional][Default: true][EL expressions allowed]
 
</source>
 
  
The condition to forward to the specified URI. If both <tt>if</tt> and <tt>unless</tt> are omitted, this page won't be evaluated and ZK always forwards the request to the specified URI.
+
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.
  
== unless ==
+
=Version History=
  
<source lang="bash" >
+
{| border='1px' | width="100%"
[Optional][Default: false][EL expressions allowed]
+
! Version !! Date !! Content
</source>
+
|-
 +
| &nbsp;
 +
| &nbsp;
 +
| &nbsp;
 +
|}
  
The condition ''not'' to forward to the specified URI. If both <tt>if</tt> and <tt>unless</tt> are omitted, this page won't be evaluated and ZK always forwards the request to the specified URI.
+
{{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 init directives will still be called.
  • The createComponents method of the Execution interface ignores the forward directives. In other words, the forward 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.

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
     



Last Update : 2022/01/19

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.