haul 01/07/24 02:53:49
Modified: xdocs Tag: cocoon_20_branch actions.xml
Log:
- FAQ entry actions and listOfMaps
- extended actions docs to include Maps & Maps for action sets
Revision Changes Path
No revision
No revision
1.2.2.5 +31 -2 xml-cocoon2/xdocs/actions.xml
Index: actions.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/xdocs/actions.xml,v
retrieving revision 1.2.2.4
retrieving revision 1.2.2.5
diff -u -r1.2.2.4 -r1.2.2.5
--- actions.xml 2001/07/19 13:46:58 1.2.2.4
+++ actions.xml 2001/07/24 09:53:48 1.2.2.5
@@ -9,6 +9,7 @@
<person name="Berin Loritsch" email="[EMAIL PROTECTED]"/>
<person name="Giacomo Pati" email="[EMAIL PROTECTED]"/>
<person name="Carsten Ziegeler" email="[EMAIL PROTECTED]"/>
+ <person name="Christian Haul" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
@@ -193,6 +194,23 @@
</map:match>
]]>
</source>
+ <p>This Map object does not replace the previous Map object put
+ is stacked on top of it. The other Map objects are still
+ accessible through a path expression.</p>
+<source>
+<![CDATA[
+<map:match pattern="*">
+ <map:act type="validate-session">
+ <map:generate type="serverpages" src="{../1}.xsp"/>
+ </map:act>
+ <map:serialize/>
+</map:match>
+]]>
+</source>
+ <p>The above example shows how to access the next to last map
+ by prefixing the key with "<code>../</code>"</p>
+ </s2>
+ <s2 title="Flow Control">
<p>
In addition to delivering values to the Sitemap, the Action can
also control the flow. If the action returns <code>null</code>
@@ -201,6 +219,9 @@
would return <code>null</code> the server page generator
would not be activated.
</p>
+ <p> In other words: The statements within the
+ <code>map:act</code> element are <em>only</em> executed if the
+ action returns at least an empty Map object.</p>
</s2>
</s1>
<s1 title="Action Sets">
@@ -212,8 +233,16 @@
a String identical to the value supplied with an action attribute.
In the current implementation of the HttpEnvironment the value
returned by the getAction method is determined by a http parameter
- called "cocoon-action". So far let's have a look at at possible
- action set definition:
+ called "cocoon-action".</p>
+ <p> Above we have seen that a successfully executed action
+ returns a Map object that can be used to communicate with the
+ sitemap. In case of an action set this is similar. With action
+ sets all returned Map objects are merged into a single Map. Of
+ course a Map can contain only one value per key so that if
+ multiple actions within an action set use the same key to
+ communicate to the sitemap, only the last one "survives".</p>
+ <p>
+ So far let's have a look at at possible action set definition:
</p>
<source>
<![CDATA[
----------------------------------------------------------------------
In case of troubles, e-mail: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
