Return-Path: Delivered-To: apmail-xml-cocoon-cvs-archive@xml.apache.org Received: (qmail 80752 invoked by uid 500); 24 Jul 2001 09:51:51 -0000 Mailing-List: contact cocoon-cvs-help@xml.apache.org; run by ezmlm Precedence: bulk Reply-To: cocoon-dev@xml.apache.org list-help: list-unsubscribe: list-post: Delivered-To: mailing list cocoon-cvs@xml.apache.org Received: (qmail 80743 invoked by uid 500); 24 Jul 2001 09:51:50 -0000 Delivered-To: apmail-xml-cocoon2-cvs@apache.org Date: 24 Jul 2001 09:49:22 -0000 Message-ID: <20010724094922.24875.qmail@icarus.apache.org> From: haul@apache.org To: xml-cocoon2-cvs@apache.org Subject: cvs commit: xml-cocoon2/xdocs actions.xml faq.xml who.xml X-Spam-Rating: h31.sny.collab.net 1.6.2 0/1000/N haul 01/07/24 02:49:22 Modified: xdocs actions.xml faq.xml who.xml Log: - FAQ entry actions and listOfMaps - actions docs extended with Maps & Maps for action sets Revision Changes Path 1.7 +31 -2 xml-cocoon2/xdocs/actions.xml Index: actions.xml =================================================================== RCS file: /home/cvs/xml-cocoon2/xdocs/actions.xml,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- actions.xml 2001/07/19 13:47:19 1.6 +++ actions.xml 2001/07/24 09:49:22 1.7 @@ -9,6 +9,7 @@ + @@ -193,6 +194,23 @@ ]]> +

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.

+ + + + + + + +]]> + +

The above example shows how to access the next to last map + by prefixing the key with "../"

+ +

In addition to delivering values to the Sitemap, the Action can also control the flow. If the action returns null @@ -201,6 +219,9 @@ would return null the server page generator would not be activated.

In other words: The statements within the + map:act element are only executed if the + action returns at least an empty Map object.

@@ -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".

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".

+ So far let's have a look at at possible action set definition:

+ When I add an action to a pipeline @docname@ returns an + error. + +

Before the action was added to the pipeline it worked fine. After + the change @docname@ seems not to find the file specified in the + variable that is returned by the matcher.

+ + + + + + + +]]> + +

Please note in the above example the + "../1".

Map objects returned from matchers, actions etc. are organised + hierarchically. Therefore they are not replaced by new ones + but older ones are still accessible through a path expression. Here + "../1" references key ("variable") "1" in the next to + last Map.

+ + + How could I have my @docname@app in an URI other than <you-server>/cocoon/<my-app>? 1.5 +1 -0 xml-cocoon2/xdocs/who.xml Index: who.xml =================================================================== RCS file: /home/cvs/xml-cocoon2/xdocs/who.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- who.xml 2001/07/23 02:30:42 1.4 +++ who.xml 2001/07/24 09:49:22 1.5 @@ -56,6 +56,7 @@

Michael Anderson (mmanders@apache.org)

Sylvain Wallez (sylvain@apache.org)

Vadim Gritsenko (vgritsenko@apache.org)

Christian Haul (haul@apache.org)

---------------------------------------------------------------------- In case of troubles, e-mail: webmaster@xml.apache.org To unsubscribe, e-mail: cocoon-cvs-unsubscribe@xml.apache.org For additional commands, e-mail: cocoon-cvs-help@xml.apache.org