You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by as...@apache.org on 2007/09/08 22:17:47 UTC

svn commit: r573901 [20/44] - in /cocoon/site: site/ site/2.0/ site/2.0/developing/ site/2.0/faq/ site/2.0/howto/chaperon/ site/2.0/installing/ site/2.0/plan/ site/2.0/snippet/ site/2.0/tutorial/ site/2.0/userdocs/ site/2.0/userdocs/actions/ site/2.0/u...

Modified: cocoon/site/site/2.0/userdocs/actions/session-action.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/2.0/userdocs/actions/session-action.html?rev=573901&r1=573900&r2=573901&view=diff
==============================================================================
--- cocoon/site/site/2.0/userdocs/actions/session-action.html (original)
+++ cocoon/site/site/2.0/userdocs/actions/session-action.html Sat Sep  8 13:17:41 2007
@@ -1,281 +1,281 @@
-<html>
-<head>
-<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Session Action</title>
-<STYLE type="text/css">
-a.menu {
-	color: #FFFFFF;
-    text-align:left;               
-    font-size:12px;
-    font-family: Verdana, Arial, Helvetica, sans-serif;
-    font-weight:plain;
-    text-decoration:none;
-    padding-left: 14px
-}
-
-A.menu:hover {
-	color: #FFCC00
-}
-
-
-.menutitle {
-	color: #000000;
-    text-align:left;               
-    font-size:10px;
-    font-family: Verdana, Arial, Helvetica, sans-serif;
-    font-weight:bold;
-    padding-left: 8px
-}
-.menuselected {
-	color: #FFCC00;
-    text-align:left;               
-    font-size:12px;
-    font-family: Verdana, Arial, Helvetica, sans-serif;
-    font-weight:bold;
-    padding-left: 14px
-}
-</STYLE>
-</head>
-<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#cc0000" vlink="#0086b2" link="#039acc" text="#000000">
-<table border="0" cellpadding="0" cellspacing="0" width="100%">
-<tr>
-<td align="left" valign="top" rowspan="3" height="60" width="135"><img border="0" vspace="0" hspace="0" src="images/logo.gif" height="60" width="135"></td><td background="images/line.gif" rowspan="1" colSpan="2" align="left" valign="top" height="0" width="100%"></td><td align="left" valign="top" rowspan="3" height="60" width="29"><img border="0" vspace="0" hspace="0" src="images/right.gif" height="60" width="29"></td>
-</tr>
-<tr>
-<td bgcolor="#0086b2" colspan="2" align="right" valign="top" height="35" width="100%"><font color="#ffffff" face="Verdana, Arial, Helvetica, sans-serif" size="5">Session Action</font></td>
-</tr>
-<tr>
-<td background="images/bottom.gif" colspan="2" width="100%" valign="top" height="20" bgcolor="#0086b2" align="right">
-<table width="288" cellspacing="0" cellpadding="0" border="0">
-<tr>
-<td align="left" valign="top" height="20" width="96"><a target="new" href="http://xml.apache.org/"><img border="0" vspace="0" hspace="0" name="xml" src="images/button-xml-lo.gif" height="20" width="96" alt="http://xml.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.apache.org/"><img border="0" vspace="0" hspace="0" name="asf" src="images/button-asf-lo.gif" height="20" width="96" alt="http://www.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.w3.org/"><img border="0" vspace="0" hspace="0" name="w3c" src="images/button-w3c-lo.gif" height="20" width="96" alt="http://www.w3.org/"></a></td>
-</tr>
-</table>
-</td>
-</tr>
-</table>
-<table width="100%" cellspacing="0" cellpadding="0" border="0">
-<tr width="100%">
-<td align="left" valign="top" width="120">
-<table width="120" cellspacing="0" cellpadding="0" border="0" bgcolor="#a0a0a0">
-<tr>
-<td valign="top" align="left"><img width="120" vspace="0" src="images/join.gif" hspace="0" height="14" border="0"><br>
-</td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../../index.html">Main</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../index.html">User Documentation</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">Actions</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="actions.html">Overview</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="database-actions.html">Database</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">Default</span></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">Core</span></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">Optional</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">Session Action</span></td>
-</tr>
-<tr>
-<td align="left" valign="top"><img width="120" vspace="0" src="images/close.gif" hspace="0" height="14" border="0"><br>
-</td>
-</tr>
-</table>
-</td><td>
-<table cellspacing="15" cellpadding="0" border="0">
-<tr>
-<td>
- 
- 
-  <font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Session Action</font>
-<hr style="color: #0086b2" size="1">
-   
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-    The session action helps in managing the session of a user on
-    the server. It can create and terminate a session. The function
-    is controlled by a parameter named 'action'.
-   </font>
-</p>
-   
-<p>
-<font color="black" face="verdana,helvetica,sanserif">For more information on session handling and session contexts
-      have a look at the <a href="../../developing/webapps/session.html">Session Context documentation</a>.</font>
-</p>
-   
-<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>Creating a Session</b></font>
-     
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-      To create a session (if it not already exists) simply add the
-      action in your pipeline:
-     </font>
-</p>
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-
-    &lt;map:act type="session"/&gt;
-	
-</pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-     
-<p>
-<font color="black" face="verdana,helvetica,sanserif">This is the equivalent to specify the 'action' parameter
-       with the value 'create':</font>
-</p>
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-
-    &lt;map:act type="session"&gt;
-        &lt;map:parameter name="action" value="create"/&gt;
-    &lt;/map:act&gt;
-	
-</pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-   
-   
-<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>Terminating a Session</b></font>
-    
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Terminating a session is as easy as creating a session, simply
-      add the action to your pipeline and set the 'action' parameter
-      to 'terminate':</font>
-</p>
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-
-    &lt;map:act type="session"&gt;
-        &lt;map:parameter name="action" value="terminate"/&gt;
-    &lt;/map:act&gt;
-	
-</pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-     
-<p>
-<font color="black" face="verdana,helvetica,sanserif">This terminates the session immediately.</font>
-</p>
-     
-<p>
-<font color="black" face="verdana,helvetica,sanserif">You can optionally specifiy the 'mode' parameter which controlls
-        the termination of the session. You have the choice between
-        'immediately' (the default) and 'if-unsued'. If you use the
-        mode 'if-unused', the session is only terminated, if no session
-        context exists for the user:</font>
-</p>
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-
-    &lt;map:act type="session"&gt;
-        &lt;map:parameter name="action" value="terminate"/&gt;
-        &lt;map:parameter name="mode" value="if-unused"/&gt;
-    &lt;/map:act&gt;
-	
-</pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-   
-   
-   
-<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Configuration</font>
-<hr style="color: #0086b2" size="1">
-   
-<blockquote>
-<ul>
-    
-<li>
-<font face="verdana, helvetica, sans serif">Name : session</font>
-</li>
-    
-<li>
-<font face="verdana, helvetica, sans serif">Class: org.apache.cocoon.webapps.session.acting.SessionAction</font>
-</li>
-   
-</ul>
-</blockquote>
-  
- 
-
-</td>
-</tr>
-</table>
-</td>
-</tr>
-</table>
-<table width="100%" cellspacing="0" cellpadding="0" border="0">
-<tr>
-<td bgcolor="#0086b2"><img width="1" src="images/dot.gif" height="1"></td>
-</tr>
-<tr>
-<td align="center"><font size="-1" face="arial,helvetica,sanserif" color="#0086b2"><i>Copyright &copy; 1999-2002 The Apache Software Foundation. All Rights Reserved.</i></font></td>
-</tr>
-</table>
-</body>
-</html>
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Session Action</title>
+<STYLE type="text/css">
+a.menu {
+	color: #FFFFFF;
+    text-align:left;               
+    font-size:12px;
+    font-family: Verdana, Arial, Helvetica, sans-serif;
+    font-weight:plain;
+    text-decoration:none;
+    padding-left: 14px
+}
+
+A.menu:hover {
+	color: #FFCC00
+}
+
+
+.menutitle {
+	color: #000000;
+    text-align:left;               
+    font-size:10px;
+    font-family: Verdana, Arial, Helvetica, sans-serif;
+    font-weight:bold;
+    padding-left: 8px
+}
+.menuselected {
+	color: #FFCC00;
+    text-align:left;               
+    font-size:12px;
+    font-family: Verdana, Arial, Helvetica, sans-serif;
+    font-weight:bold;
+    padding-left: 14px
+}
+</STYLE>
+</head>
+<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#cc0000" vlink="#0086b2" link="#039acc" text="#000000">
+<table border="0" cellpadding="0" cellspacing="0" width="100%">
+<tr>
+<td align="left" valign="top" rowspan="3" height="60" width="135"><img border="0" vspace="0" hspace="0" src="images/logo.gif" height="60" width="135"></td><td background="images/line.gif" rowspan="1" colSpan="2" align="left" valign="top" height="0" width="100%"></td><td align="left" valign="top" rowspan="3" height="60" width="29"><img border="0" vspace="0" hspace="0" src="images/right.gif" height="60" width="29"></td>
+</tr>
+<tr>
+<td bgcolor="#0086b2" colspan="2" align="right" valign="top" height="35" width="100%"><font color="#ffffff" face="Verdana, Arial, Helvetica, sans-serif" size="5">Session Action</font></td>
+</tr>
+<tr>
+<td background="images/bottom.gif" colspan="2" width="100%" valign="top" height="20" bgcolor="#0086b2" align="right">
+<table width="288" cellspacing="0" cellpadding="0" border="0">
+<tr>
+<td align="left" valign="top" height="20" width="96"><a target="new" href="http://xml.apache.org/"><img border="0" vspace="0" hspace="0" name="xml" src="images/button-xml-lo.gif" height="20" width="96" alt="http://xml.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.apache.org/"><img border="0" vspace="0" hspace="0" name="asf" src="images/button-asf-lo.gif" height="20" width="96" alt="http://www.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.w3.org/"><img border="0" vspace="0" hspace="0" name="w3c" src="images/button-w3c-lo.gif" height="20" width="96" alt="http://www.w3.org/"></a></td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<table width="100%" cellspacing="0" cellpadding="0" border="0">
+<tr width="100%">
+<td align="left" valign="top" width="120">
+<table width="120" cellspacing="0" cellpadding="0" border="0" bgcolor="#a0a0a0">
+<tr>
+<td valign="top" align="left"><img width="120" vspace="0" src="images/join.gif" hspace="0" height="14" border="0"><br>
+</td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../../index.html">Main</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../index.html">User Documentation</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">Actions</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="actions.html">Overview</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="database-actions.html">Database</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">Default</span></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">Core</span></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">Optional</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">Session Action</span></td>
+</tr>
+<tr>
+<td align="left" valign="top"><img width="120" vspace="0" src="images/close.gif" hspace="0" height="14" border="0"><br>
+</td>
+</tr>
+</table>
+</td><td>
+<table cellspacing="15" cellpadding="0" border="0">
+<tr>
+<td>
+ 
+ 
+  <font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Session Action</font>
+<hr style="color: #0086b2" size="1">
+   
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+    The session action helps in managing the session of a user on
+    the server. It can create and terminate a session. The function
+    is controlled by a parameter named 'action'.
+   </font>
+</p>
+   
+<p>
+<font color="black" face="verdana,helvetica,sanserif">For more information on session handling and session contexts
+      have a look at the <a href="../../developing/webapps/session.html">Session Context documentation</a>.</font>
+</p>
+   
+<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>Creating a Session</b></font>
+     
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+      To create a session (if it not already exists) simply add the
+      action in your pipeline:
+     </font>
+</p>
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+
+    &lt;map:act type="session"/&gt;
+	
+</pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+     
+<p>
+<font color="black" face="verdana,helvetica,sanserif">This is the equivalent to specify the 'action' parameter
+       with the value 'create':</font>
+</p>
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+
+    &lt;map:act type="session"&gt;
+        &lt;map:parameter name="action" value="create"/&gt;
+    &lt;/map:act&gt;
+	
+</pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+   
+   
+<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>Terminating a Session</b></font>
+    
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Terminating a session is as easy as creating a session, simply
+      add the action to your pipeline and set the 'action' parameter
+      to 'terminate':</font>
+</p>
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+
+    &lt;map:act type="session"&gt;
+        &lt;map:parameter name="action" value="terminate"/&gt;
+    &lt;/map:act&gt;
+	
+</pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+     
+<p>
+<font color="black" face="verdana,helvetica,sanserif">This terminates the session immediately.</font>
+</p>
+     
+<p>
+<font color="black" face="verdana,helvetica,sanserif">You can optionally specifiy the 'mode' parameter which controlls
+        the termination of the session. You have the choice between
+        'immediately' (the default) and 'if-unsued'. If you use the
+        mode 'if-unused', the session is only terminated, if no session
+        context exists for the user:</font>
+</p>
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+
+    &lt;map:act type="session"&gt;
+        &lt;map:parameter name="action" value="terminate"/&gt;
+        &lt;map:parameter name="mode" value="if-unused"/&gt;
+    &lt;/map:act&gt;
+	
+</pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+   
+   
+   
+<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Configuration</font>
+<hr style="color: #0086b2" size="1">
+   
+<blockquote>
+<ul>
+    
+<li>
+<font face="verdana, helvetica, sans serif">Name : session</font>
+</li>
+    
+<li>
+<font face="verdana, helvetica, sans serif">Class: org.apache.cocoon.webapps.session.acting.SessionAction</font>
+</li>
+   
+</ul>
+</blockquote>
+  
+ 
+
+</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<table width="100%" cellspacing="0" cellpadding="0" border="0">
+<tr>
+<td bgcolor="#0086b2"><img width="1" src="images/dot.gif" height="1"></td>
+</tr>
+<tr>
+<td align="center"><font size="-1" face="arial,helvetica,sanserif" color="#0086b2"><i>Copyright &copy; 1999-2002 The Apache Software Foundation. All Rights Reserved.</i></font></td>
+</tr>
+</table>
+</body>
+</html>

Modified: cocoon/site/site/2.0/userdocs/concepts/actions.txt
URL: http://svn.apache.org/viewvc/cocoon/site/site/2.0/userdocs/concepts/actions.txt?rev=573901&r1=573900&r2=573901&view=diff
==============================================================================
--- cocoon/site/site/2.0/userdocs/concepts/actions.txt (original)
+++ cocoon/site/site/2.0/userdocs/concepts/actions.txt Sat Sep  8 13:17:41 2007
@@ -1,294 +1,294 @@
-WARNING: This material is subject to change at anytime and may
-never find a way into the main distribution. It could
-be removed if it has proven not to be useful for Cocoon 2.
-
-This is a proposal for a Action sitemap component. For more
-information look at the javadoc comments in the file Action.java
-in this directory. For a possible implementation look at the file
-HelloAction.java.
-
-Create a file named "actions.inc" in the root of the Cocoon 2
-repository to include this functionality and execute the command
-"build package webapp".
-
-The created cocoon.war and cocoon.jar file in build/cocoon
-directory contains the modified version which include the
-Action sitemap component and the sample HelloAction which
-is called when requesting the URL http://localhost:8080/cocoon/welcome
-
-To give you an overview of the discussion about sitemap Actions here is
-an excerpt from the cocoon-dev mailing list:
-
-------------------------------------<<>>-------------------------------------
-
-Peter Donald wrote:
->
-> At 04:15  9/9/00 +0200, you wrote:
-> >  <match type="uri" pattern="myapp/**">
-> >    <!-- the following Matcher make the overall request
-> >         analysis and makes important information available
-> >         to subsequent components through the objectModel and
-> >         a Map for substitution in src= attributes.
-> >         Maybe a Controller sitemap component would be more
-> >         appropriate
-> >    -->
-> >    <match type="myapp-controller" pattern="not really used">
-> >      <select type="myapp-action-selector">
-> >        <when test="add">
-> >          <!-- here the {1} is delivered by the matcher
-> >               "myapp-controller"
-> >          -->
-> >          <generate src="myapp/{1}/remove.xsp"/>
-> >        </when>
-> >        <when test="remove">
-> >          <generate src="myapp/{1}/remove.xsp"/>
-> >        </when>
-> >        <otherwise>
-> >          <generate src="myapp/{1}/index.xml"/>
-> >        </otherwise>
-> >      </select>
-> >      <select type="browser">
-> >        <when test="netscape">
-> >          <transform src="myapp/{1}/style-ns.xsl"/>
-> >          <serialize type="html"/>
-> >        </when>
-> >        <when test="wap">
-> >          <transform src="myapp/{1}/style-wap.xsl"/>
-> >          <serialize type="wap"/>
-> >        </when>
-> >        <otherwise>
-> >          <transform src="myapp/{1}/style-ie.xsl"/>
-> >          <serialize type="html"/>
-> >        </otherwise>
-> >      </select>
-> >    </match>
-> >  </match>
-> >  <-- here we catch all requests not handled by the match above
-> >      and redirect them to the login screen or an error page
-> >  -->
-> >  <match pattern="myapp/**">
-> >    <redirect-to uri="myapp/login"/>
-> >  </match>
-> >Well, this example might not be the best one but I think its
-> >good enough to start a discussion about it. What do you think?
->
-> I like the approach but before an implementation can be defined there is a
-> few questions that must be answered first. Namely
->
-> * What is an Action ?
-> * How will you use actions ?
->
-> What is an Action ?
-> -------------------
->
-> In the above case you have associated an Action with a resource. ie the
-> Remove action is associated with myapp/{1}/remove.xsp resource. Do actions
-> have to be associated with a resource or are they independent of resources.
-> I would say that they are independent - an Action framework should be able
-> to be used via multiple interfaces whether via cocoon, turbine, telnet,
-> mail etc. So the "ShutdownRealWorldMachine" action is accessible via the C2
-> interface, a telnet interface or via any number of other methods.
-
-The example above is probably misleading because we don't have a Action
-component in the sitemap so far. Generally speaking I think a Sitemap
-Action is an object that acts upon an application model based on data
-supplied by the environments objectModel (ie Request). It's its
-responsibility to make some data available to the Sitemap engine as
-further selection/matching criteria (a List object) as well as in the
-objectModel for other sitemap components
-
-Suppose the Interface of an Actions is like this:
-
-   public Interface Action {
-       public List act (Map objectModel);
-   }
-
-and also suppose that the nested elements of the <map:act> elements are
-skipped if the action returns a null value instead of a List.
-
- <match type="uri" pattern="myapp/**">
-   <act type="myaction">
-     <select type="action-selector">
-       <when test="remove"/>
-         <generate src="myapp/{1}/remove.xsp"/>
-       </when>
-       ...
-     </select>
-   </act>
- </match>
-
-The List object supplied by the action is used by the sitemap engine to
-replace occurrences like {1} from certain attributes like src= but this
-is optional. So the Action is not really associated to a resource. It's
-the selector which does this association.
-
-> An action is essentially a snippet of code that is executed in response to
-> a request in a certain context (or Environment in C2s case). The action can
-> add and change the context/environment data.
-
-Agreed.
-
-> How granular can actions be ?
-
-You should be able to be as granular as you want.
-
-> Does session validation count as an action ?
-
-Why not?
-
-> How about authorisation and authentication ?
-
-I still suppose to leave authentication to the container but I know
-someone will do it with a sitemap component :/
-Authorisation is more dependant on the application context and there are
-the possibilities to use AuthorisationMatchers, AuthorisationSelectors,
-AuthorisationActions or a authorisation logicsheet, what ever suit your
-needs best.
-
-> What about form validation ?
-
-Even here, it depends. If you only want to validate form data a Selector
-can be used to achieve that and in the <map:when> elements you
-regenerate the resource if validation fails or choose an action to put
-the form data into your application model and generate the next screen
-or whatever.
-
-> When I program actions I use a extremely granular approach.
-
-No problem, you should be able to do things like that
-
- <match type="uri" pattern="myapp/**">
-   <act type="session validation">
-     <act type="form-validation">
-       <select type="validation-check">
-         <when test="ok">
-           <act type="model-update"/>
-           <generate src="next-page"/>
-         </when>
-         <otherwise>
-           <generate src="this-page"/>
-         </otherwise>
-       </select>
-     </act>
-   </act>
-   <generate src="login"/>
- </match>
-
-> There is also the idea of latent actions. For instance the latent Action is
-> transmitted between end-user and cocoon until they are activated. Actions
-> may also be made latent (or deactivated) in a couple of cases. Like when
-> you try to submit form but are not logged in - it will save action/form
-> data (or put action into latent state) and then after login commit the
-> action (or re-activate action).
-
-Isn't this a matter how components play together?
-
-> How will you use actions ?
-> ---------------------------
->
-> In many cases when I program to a an actions approach each request can
-> result in many actions being executed. For instance it is not uncommon for
-> an action chain to occur like the following.
->
-> SessionValidatorAction --> RoleAssignerAction --> FormValidationAction -->
-> FormDBEntryAction
->
-> The SessionValidatorAction will check the session and if not exist then it
-> will put a magic token in environment so that after action is executed then
-> the rest of action-chain and output resource is ignored and the user is
-> redirected to a login page.
->
-> The RoleAssignerAction (lame name I know ;->) will check if the current
-> user implements a certain role and if not redirect them to appropriate
-> NoEntry.html type page.
-> ...
->
-> So when I design a sitemap for a web-application I want to somehow be able
-> to do the following.
->
-> * Anything under webapp/ must run SessionValidatorAction
-> * Anything under webapp/admin must run RoleAssignerAction and check for
-> "admin" role
-> * Then specific resources webapp/a.xml, webapp/b.xml and webapp/admin/c.xml
-> must run FormValidationAction with appropriate form schema and the
-> appropriate FormDBEntryAction
-
-Didn't get the last one? What is a FormDBEntryAction for? Probably an
-XSP page?
-
-> * A user can also arbitrarily submit an action from any page (via post
-> request or perhaps a ?action=blah tacked onto URL) that must be executed.
-
-  <match type="uri" pattern="webapp/**">
-    <act type="session-validation"/>
-    <match type="uri" pattern="webapp/admin">
-      <act type="assign-role">
-        <select type="role-selector">
-          <when test="admin">
-            <match type="uri" pattern="webapp/admin/c.xml">
-              <act type="form-validation src="admin/form-schema-c.xsd"/>
-              <!-- the following next-page action has knowledge of the
-                   sequence of pages and returns a List with the first
-element
-                   corresponding to the "next page" appropriate
-depending on
-                   values in the objectModel signaling successful
-validation by
-                   the previous action (type="form-validation"). The
-following
-                   three lines could be put into a sitemap resource
-definition
-                   and replaced by <redirect-to resource="next-page"/>
-              -->
-              <act type="next-page">
-                <generate src="{1}"/>
-              </act>
-            </match>
-          <otherwise>
-            <match type="uri-regexp" pattern="webapp/(a|b)\.xml">
-              <act type="form-validation src="form-schema-{1}.xsd"/>
-              <act type="next-page">
-                <generate src="{1}"/>
-              </act>
-            </match>
-          </when>
-        </select>
-      </act>
-    </match>
-  </match>
-
->
-> ----------------------------------------------------------------------------
-> ---------
->
-> So what would I want to see in a Cocoon-Application framework ???
->
-> Well actions are independent of resources and exist in a separate namespace.
->
-> Each request can in theory result in a action-pipeline.
->
-> Each action can add stuff to it's context (or Environment).
->
-> Each action can in theory short-cut the action pipeline and move to another
-> action-resource pipeline and also store remaining submitted actions as
-> latent actions.
->
-> An action pipeline must not necessarily be associated with a resource (it
-> should instead be able to specify a resource that it goes to post processing).
->
-> It may also be good to have an action that's sole purpose is to extract
-> explicit action requests and execute/store them (ActionExtractorAction +
-> ActionDispatcherAction ???)
-
-Please answer these question yourself after you've read my explanations.
-
-> But anyways I mean in no way to imply C2 is bad and if you want to add
-> hooks into sitemap generation to allow for this sort of stuff (or even
-> better do it yourself ;>) I would gladly switch all my development across
-> to C2 and I suspect many others would too :P.
-
-Implementing the framework to use actions like I've mentioned through
-out this mail is a matter of an hour or two. But you're right
-implementing general actions for general usage is another thing.
-
-Giacomo
+WARNING: This material is subject to change at anytime and may
+never find a way into the main distribution. It could
+be removed if it has proven not to be useful for Cocoon 2.
+
+This is a proposal for a Action sitemap component. For more
+information look at the javadoc comments in the file Action.java
+in this directory. For a possible implementation look at the file
+HelloAction.java.
+
+Create a file named "actions.inc" in the root of the Cocoon 2
+repository to include this functionality and execute the command
+"build package webapp".
+
+The created cocoon.war and cocoon.jar file in build/cocoon
+directory contains the modified version which include the
+Action sitemap component and the sample HelloAction which
+is called when requesting the URL http://localhost:8080/cocoon/welcome
+
+To give you an overview of the discussion about sitemap Actions here is
+an excerpt from the cocoon-dev mailing list:
+
+------------------------------------<<>>-------------------------------------
+
+Peter Donald wrote:
+>
+> At 04:15  9/9/00 +0200, you wrote:
+> >  <match type="uri" pattern="myapp/**">
+> >    <!-- the following Matcher make the overall request
+> >         analysis and makes important information available
+> >         to subsequent components through the objectModel and
+> >         a Map for substitution in src= attributes.
+> >         Maybe a Controller sitemap component would be more
+> >         appropriate
+> >    -->
+> >    <match type="myapp-controller" pattern="not really used">
+> >      <select type="myapp-action-selector">
+> >        <when test="add">
+> >          <!-- here the {1} is delivered by the matcher
+> >               "myapp-controller"
+> >          -->
+> >          <generate src="myapp/{1}/remove.xsp"/>
+> >        </when>
+> >        <when test="remove">
+> >          <generate src="myapp/{1}/remove.xsp"/>
+> >        </when>
+> >        <otherwise>
+> >          <generate src="myapp/{1}/index.xml"/>
+> >        </otherwise>
+> >      </select>
+> >      <select type="browser">
+> >        <when test="netscape">
+> >          <transform src="myapp/{1}/style-ns.xsl"/>
+> >          <serialize type="html"/>
+> >        </when>
+> >        <when test="wap">
+> >          <transform src="myapp/{1}/style-wap.xsl"/>
+> >          <serialize type="wap"/>
+> >        </when>
+> >        <otherwise>
+> >          <transform src="myapp/{1}/style-ie.xsl"/>
+> >          <serialize type="html"/>
+> >        </otherwise>
+> >      </select>
+> >    </match>
+> >  </match>
+> >  <-- here we catch all requests not handled by the match above
+> >      and redirect them to the login screen or an error page
+> >  -->
+> >  <match pattern="myapp/**">
+> >    <redirect-to uri="myapp/login"/>
+> >  </match>
+> >Well, this example might not be the best one but I think its
+> >good enough to start a discussion about it. What do you think?
+>
+> I like the approach but before an implementation can be defined there is a
+> few questions that must be answered first. Namely
+>
+> * What is an Action ?
+> * How will you use actions ?
+>
+> What is an Action ?
+> -------------------
+>
+> In the above case you have associated an Action with a resource. ie the
+> Remove action is associated with myapp/{1}/remove.xsp resource. Do actions
+> have to be associated with a resource or are they independent of resources.
+> I would say that they are independent - an Action framework should be able
+> to be used via multiple interfaces whether via cocoon, turbine, telnet,
+> mail etc. So the "ShutdownRealWorldMachine" action is accessible via the C2
+> interface, a telnet interface or via any number of other methods.
+
+The example above is probably misleading because we don't have a Action
+component in the sitemap so far. Generally speaking I think a Sitemap
+Action is an object that acts upon an application model based on data
+supplied by the environments objectModel (ie Request). It's its
+responsibility to make some data available to the Sitemap engine as
+further selection/matching criteria (a List object) as well as in the
+objectModel for other sitemap components
+
+Suppose the Interface of an Actions is like this:
+
+   public Interface Action {
+       public List act (Map objectModel);
+   }
+
+and also suppose that the nested elements of the <map:act> elements are
+skipped if the action returns a null value instead of a List.
+
+ <match type="uri" pattern="myapp/**">
+   <act type="myaction">
+     <select type="action-selector">
+       <when test="remove"/>
+         <generate src="myapp/{1}/remove.xsp"/>
+       </when>
+       ...
+     </select>
+   </act>
+ </match>
+
+The List object supplied by the action is used by the sitemap engine to
+replace occurrences like {1} from certain attributes like src= but this
+is optional. So the Action is not really associated to a resource. It's
+the selector which does this association.
+
+> An action is essentially a snippet of code that is executed in response to
+> a request in a certain context (or Environment in C2s case). The action can
+> add and change the context/environment data.
+
+Agreed.
+
+> How granular can actions be ?
+
+You should be able to be as granular as you want.
+
+> Does session validation count as an action ?
+
+Why not?
+
+> How about authorisation and authentication ?
+
+I still suppose to leave authentication to the container but I know
+someone will do it with a sitemap component :/
+Authorisation is more dependant on the application context and there are
+the possibilities to use AuthorisationMatchers, AuthorisationSelectors,
+AuthorisationActions or a authorisation logicsheet, what ever suit your
+needs best.
+
+> What about form validation ?
+
+Even here, it depends. If you only want to validate form data a Selector
+can be used to achieve that and in the <map:when> elements you
+regenerate the resource if validation fails or choose an action to put
+the form data into your application model and generate the next screen
+or whatever.
+
+> When I program actions I use a extremely granular approach.
+
+No problem, you should be able to do things like that
+
+ <match type="uri" pattern="myapp/**">
+   <act type="session validation">
+     <act type="form-validation">
+       <select type="validation-check">
+         <when test="ok">
+           <act type="model-update"/>
+           <generate src="next-page"/>
+         </when>
+         <otherwise>
+           <generate src="this-page"/>
+         </otherwise>
+       </select>
+     </act>
+   </act>
+   <generate src="login"/>
+ </match>
+
+> There is also the idea of latent actions. For instance the latent Action is
+> transmitted between end-user and cocoon until they are activated. Actions
+> may also be made latent (or deactivated) in a couple of cases. Like when
+> you try to submit form but are not logged in - it will save action/form
+> data (or put action into latent state) and then after login commit the
+> action (or re-activate action).
+
+Isn't this a matter how components play together?
+
+> How will you use actions ?
+> ---------------------------
+>
+> In many cases when I program to a an actions approach each request can
+> result in many actions being executed. For instance it is not uncommon for
+> an action chain to occur like the following.
+>
+> SessionValidatorAction --> RoleAssignerAction --> FormValidationAction -->
+> FormDBEntryAction
+>
+> The SessionValidatorAction will check the session and if not exist then it
+> will put a magic token in environment so that after action is executed then
+> the rest of action-chain and output resource is ignored and the user is
+> redirected to a login page.
+>
+> The RoleAssignerAction (lame name I know ;->) will check if the current
+> user implements a certain role and if not redirect them to appropriate
+> NoEntry.html type page.
+> ...
+>
+> So when I design a sitemap for a web-application I want to somehow be able
+> to do the following.
+>
+> * Anything under webapp/ must run SessionValidatorAction
+> * Anything under webapp/admin must run RoleAssignerAction and check for
+> "admin" role
+> * Then specific resources webapp/a.xml, webapp/b.xml and webapp/admin/c.xml
+> must run FormValidationAction with appropriate form schema and the
+> appropriate FormDBEntryAction
+
+Didn't get the last one? What is a FormDBEntryAction for? Probably an
+XSP page?
+
+> * A user can also arbitrarily submit an action from any page (via post
+> request or perhaps a ?action=blah tacked onto URL) that must be executed.
+
+  <match type="uri" pattern="webapp/**">
+    <act type="session-validation"/>
+    <match type="uri" pattern="webapp/admin">
+      <act type="assign-role">
+        <select type="role-selector">
+          <when test="admin">
+            <match type="uri" pattern="webapp/admin/c.xml">
+              <act type="form-validation src="admin/form-schema-c.xsd"/>
+              <!-- the following next-page action has knowledge of the
+                   sequence of pages and returns a List with the first
+element
+                   corresponding to the "next page" appropriate
+depending on
+                   values in the objectModel signaling successful
+validation by
+                   the previous action (type="form-validation"). The
+following
+                   three lines could be put into a sitemap resource
+definition
+                   and replaced by <redirect-to resource="next-page"/>
+              -->
+              <act type="next-page">
+                <generate src="{1}"/>
+              </act>
+            </match>
+          <otherwise>
+            <match type="uri-regexp" pattern="webapp/(a|b)\.xml">
+              <act type="form-validation src="form-schema-{1}.xsd"/>
+              <act type="next-page">
+                <generate src="{1}"/>
+              </act>
+            </match>
+          </when>
+        </select>
+      </act>
+    </match>
+  </match>
+
+>
+> ----------------------------------------------------------------------------
+> ---------
+>
+> So what would I want to see in a Cocoon-Application framework ???
+>
+> Well actions are independent of resources and exist in a separate namespace.
+>
+> Each request can in theory result in a action-pipeline.
+>
+> Each action can add stuff to it's context (or Environment).
+>
+> Each action can in theory short-cut the action pipeline and move to another
+> action-resource pipeline and also store remaining submitted actions as
+> latent actions.
+>
+> An action pipeline must not necessarily be associated with a resource (it
+> should instead be able to specify a resource that it goes to post processing).
+>
+> It may also be good to have an action that's sole purpose is to extract
+> explicit action requests and execute/store them (ActionExtractorAction +
+> ActionDispatcherAction ???)
+
+Please answer these question yourself after you've read my explanations.
+
+> But anyways I mean in no way to imply C2 is bad and if you want to add
+> hooks into sitemap generation to allow for this sort of stuff (or even
+> better do it yourself ;>) I would gladly switch all my development across
+> to C2 and I suspect many others would too :P.
+
+Implementing the framework to use actions like I've mentioned through
+out this mail is a matter of an hour or two. But you're right
+implementing general actions for general usage is another thing.
+
+Giacomo

Modified: cocoon/site/site/2.0/userdocs/generators/telnet.txt
URL: http://svn.apache.org/viewvc/cocoon/site/site/2.0/userdocs/generators/telnet.txt?rev=573901&r1=573900&r2=573901&view=diff
==============================================================================
--- cocoon/site/site/2.0/userdocs/generators/telnet.txt (original)
+++ cocoon/site/site/2.0/userdocs/generators/telnet.txt Sat Sep  8 13:17:41 2007
@@ -1,55 +1,55 @@
-POST /cocoon/request1 HTTP/1.1
-Content-Type: text/plain
-Content-Length:1513
-
-<?xml version="1.0"?>
-<Orders>
-	<OrderID>20259</OrderID>
-	<CustomerID>WWWWWWW</CustomerID>
-	<EmployeeID>6</EmployeeID>
-	<OrderDate>2001-05-05 00:00:00</OrderDate>
-	<RequiredDate>2001-06-05 00:00:00</RequiredDate>
-	<ShippedDate>2001-06-01 00:00:00</ShippedDate>
-	<ShipVia>1</ShipVia>
-	<Freight>11.6100</Freight>
-	<ShipName>Thoms White</ShipName>
-	<ShipAddress>Somestr. 48</ShipAddress>
-	<ShipCity>Munster</ShipCity>
-	<ShipRegion>West</ShipRegion>
-	<ShipPostalCode>00000</ShipPostalCode>
-	<ShipCountry>Germany</ShipCountry>
-	<OrderDetails>
-		<OrderID>20259</OrderID>
-		<ProductID>51</ProductID>
-		<UnitPrice>42.4000</UnitPrice>
-		<Quantity>40</Quantity>
-		<Discount>0.0</Discount>
-	</OrderDetails>
-	<OrderDetails>
-		<OrderID>20259</OrderID>
-		<ProductID>14</ProductID>
-		<UnitPrice>18.6000</UnitPrice>
-		<Quantity>9</Quantity>
-		<Discount>0.0</Discount>
-	</OrderDetails>
-	<OrderDetails>
-		<OrderID>20259</OrderID>
-		<ProductID>7</ProductID>
-		<UnitPrice>12.4000</UnitPrice>
-		<Quantity>30</Quantity>
-		<Discount>0.0</Discount>
-	</OrderDetails>
-	<Customers>
-		<CustomerID>WWWWWWW</CustomerID>
-		<CompanyName>Thomas White</CompanyName>
-		<ContactName>Karin Black</ContactName>
-		<ContactTitle>Marketing Manager</ContactTitle>
-		<Address>Somestr. 48</Address>
-		<City>Munster</City>
-		<Region>West</Region>
-		<PostalCode>00000</PostalCode>
-		<Country>Germany</Country>
-		<Phone>xxxx-yyyyyy</Phone>
-		<Fax>xxxx-yyyyyy</Fax>
-	</Customers>
-</Orders>
+POST /cocoon/request1 HTTP/1.1
+Content-Type: text/plain
+Content-Length:1513
+
+<?xml version="1.0"?>
+<Orders>
+	<OrderID>20259</OrderID>
+	<CustomerID>WWWWWWW</CustomerID>
+	<EmployeeID>6</EmployeeID>
+	<OrderDate>2001-05-05 00:00:00</OrderDate>
+	<RequiredDate>2001-06-05 00:00:00</RequiredDate>
+	<ShippedDate>2001-06-01 00:00:00</ShippedDate>
+	<ShipVia>1</ShipVia>
+	<Freight>11.6100</Freight>
+	<ShipName>Thoms White</ShipName>
+	<ShipAddress>Somestr. 48</ShipAddress>
+	<ShipCity>Munster</ShipCity>
+	<ShipRegion>West</ShipRegion>
+	<ShipPostalCode>00000</ShipPostalCode>
+	<ShipCountry>Germany</ShipCountry>
+	<OrderDetails>
+		<OrderID>20259</OrderID>
+		<ProductID>51</ProductID>
+		<UnitPrice>42.4000</UnitPrice>
+		<Quantity>40</Quantity>
+		<Discount>0.0</Discount>
+	</OrderDetails>
+	<OrderDetails>
+		<OrderID>20259</OrderID>
+		<ProductID>14</ProductID>
+		<UnitPrice>18.6000</UnitPrice>
+		<Quantity>9</Quantity>
+		<Discount>0.0</Discount>
+	</OrderDetails>
+	<OrderDetails>
+		<OrderID>20259</OrderID>
+		<ProductID>7</ProductID>
+		<UnitPrice>12.4000</UnitPrice>
+		<Quantity>30</Quantity>
+		<Discount>0.0</Discount>
+	</OrderDetails>
+	<Customers>
+		<CustomerID>WWWWWWW</CustomerID>
+		<CompanyName>Thomas White</CompanyName>
+		<ContactName>Karin Black</ContactName>
+		<ContactTitle>Marketing Manager</ContactTitle>
+		<Address>Somestr. 48</Address>
+		<City>Munster</City>
+		<Region>West</Region>
+		<PostalCode>00000</PostalCode>
+		<Country>Germany</Country>
+		<Phone>xxxx-yyyyyy</Phone>
+		<Fax>xxxx-yyyyyy</Fax>
+	</Customers>
+</Orders>

Modified: cocoon/site/site/2.0/userdocs/index.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/2.0/userdocs/index.html?rev=573901&r1=573900&r2=573901&view=diff
==============================================================================
--- cocoon/site/site/2.0/userdocs/index.html (original)
+++ cocoon/site/site/2.0/userdocs/index.html Sat Sep  8 13:17:41 2007
@@ -1,165 +1,165 @@
-<html>
-<head>
-<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>User Documentation</title>
-<STYLE type="text/css">
-a.menu {
-	color: #FFFFFF;
-    text-align:left;               
-    font-size:12px;
-    font-family: Verdana, Arial, Helvetica, sans-serif;
-    font-weight:plain;
-    text-decoration:none;
-    padding-left: 14px
-}
-
-A.menu:hover {
-	color: #FFCC00
-}
-
-
-.menutitle {
-	color: #000000;
-    text-align:left;               
-    font-size:10px;
-    font-family: Verdana, Arial, Helvetica, sans-serif;
-    font-weight:bold;
-    padding-left: 8px
-}
-.menuselected {
-	color: #FFCC00;
-    text-align:left;               
-    font-size:12px;
-    font-family: Verdana, Arial, Helvetica, sans-serif;
-    font-weight:bold;
-    padding-left: 14px
-}
-</STYLE>
-</head>
-<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#cc0000" vlink="#0086b2" link="#039acc" text="#000000">
-<table border="0" cellpadding="0" cellspacing="0" width="100%">
-<tr>
-<td align="left" valign="top" rowspan="3" height="60" width="135"><img border="0" vspace="0" hspace="0" src="images/logo.gif" height="60" width="135"></td><td background="images/line.gif" rowspan="1" colSpan="2" align="left" valign="top" height="0" width="100%"></td><td align="left" valign="top" rowspan="3" height="60" width="29"><img border="0" vspace="0" hspace="0" src="images/right.gif" height="60" width="29"></td>
-</tr>
-<tr>
-<td bgcolor="#0086b2" colspan="2" align="right" valign="top" height="35" width="100%"><font color="#ffffff" face="Verdana, Arial, Helvetica, sans-serif" size="5">User Documentation</font></td>
-</tr>
-<tr>
-<td background="images/bottom.gif" colspan="2" width="100%" valign="top" height="20" bgcolor="#0086b2" align="right">
-<table width="288" cellspacing="0" cellpadding="0" border="0">
-<tr>
-<td align="left" valign="top" height="20" width="96"><a target="new" href="http://xml.apache.org/"><img border="0" vspace="0" hspace="0" name="xml" src="images/button-xml-lo.gif" height="20" width="96" alt="http://xml.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.apache.org/"><img border="0" vspace="0" hspace="0" name="asf" src="images/button-asf-lo.gif" height="20" width="96" alt="http://www.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.w3.org/"><img border="0" vspace="0" hspace="0" name="w3c" src="images/button-w3c-lo.gif" height="20" width="96" alt="http://www.w3.org/"></a></td>
-</tr>
-</table>
-</td>
-</tr>
-</table>
-<table width="100%" cellspacing="0" cellpadding="0" border="0">
-<tr width="100%">
-<td align="left" valign="top" width="120">
-<table width="120" cellspacing="0" cellpadding="0" border="0" bgcolor="#a0a0a0">
-<tr>
-<td valign="top" align="left"><img width="120" vspace="0" src="images/join.gif" hspace="0" height="14" border="0"><br>
-</td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../index.html">Main</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">User Documentation</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="concepts/index.html">Concepts</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">Sitemap Components</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="generators/generators.html">Generators</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="transformers/transformers.html">Transformers</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="serializers/serializers.html">Serializers</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="matchers/matchers.html">Matchers</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="selectors/selectors.html">Selectors</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="actions/actions.html">Actions</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="readers/readers.html">Readers</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="xsp/index.html">XSP</a></td>
-</tr>
-<tr>
-<td align="left" valign="top"><img width="120" vspace="0" src="images/close.gif" hspace="0" height="14" border="0"><br>
-</td>
-</tr>
-</table>
-</td><td>
-<table cellspacing="15" cellpadding="0" border="0">
-<tr>
-<td>
- 
-
- 
- <font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Overview</font>
-<hr style="color: #0086b2" size="1">
-
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">In getting started with Cocoon, one must learn not only a number of
-  concepts, but a number of details as well.  Read the Introduction and ensure that you
-  understand concepts such as the sitemap, generators, transformers, serializers
-  and actions.  This guide will fill in the details, such as "So how do I turn
-  this query into XML data".
-  </font>
-</p>
-   
-<p>
-<font color="black" face="verdana,helvetica,sanserif">If you are interested in developing real-world web-applications requiring
-    form handling, authentication or even developing your own portal, have a 
-    look at the <a href="../developing/webapps/index.html">web application documentation</a>.</font>
-</p>
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-  Come back often...this guide is being updated regularly.
-  </font>
-</p>
-
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">The actual user documentation is available from the side-panel.
-  </font>
-</p>
-
- 
-
- 
-
-</td>
-</tr>
-</table>
-</td>
-</tr>
-</table>
-<table width="100%" cellspacing="0" cellpadding="0" border="0">
-<tr>
-<td bgcolor="#0086b2"><img width="1" src="images/dot.gif" height="1"></td>
-</tr>
-<tr>
-<td align="center"><font size="-1" face="arial,helvetica,sanserif" color="#0086b2"><i>Copyright &copy; 1999-2002 The Apache Software Foundation. All Rights Reserved.</i></font></td>
-</tr>
-</table>
-</body>
-</html>
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>User Documentation</title>
+<STYLE type="text/css">
+a.menu {
+	color: #FFFFFF;
+    text-align:left;               
+    font-size:12px;
+    font-family: Verdana, Arial, Helvetica, sans-serif;
+    font-weight:plain;
+    text-decoration:none;
+    padding-left: 14px
+}
+
+A.menu:hover {
+	color: #FFCC00
+}
+
+
+.menutitle {
+	color: #000000;
+    text-align:left;               
+    font-size:10px;
+    font-family: Verdana, Arial, Helvetica, sans-serif;
+    font-weight:bold;
+    padding-left: 8px
+}
+.menuselected {
+	color: #FFCC00;
+    text-align:left;               
+    font-size:12px;
+    font-family: Verdana, Arial, Helvetica, sans-serif;
+    font-weight:bold;
+    padding-left: 14px
+}
+</STYLE>
+</head>
+<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#cc0000" vlink="#0086b2" link="#039acc" text="#000000">
+<table border="0" cellpadding="0" cellspacing="0" width="100%">
+<tr>
+<td align="left" valign="top" rowspan="3" height="60" width="135"><img border="0" vspace="0" hspace="0" src="images/logo.gif" height="60" width="135"></td><td background="images/line.gif" rowspan="1" colSpan="2" align="left" valign="top" height="0" width="100%"></td><td align="left" valign="top" rowspan="3" height="60" width="29"><img border="0" vspace="0" hspace="0" src="images/right.gif" height="60" width="29"></td>
+</tr>
+<tr>
+<td bgcolor="#0086b2" colspan="2" align="right" valign="top" height="35" width="100%"><font color="#ffffff" face="Verdana, Arial, Helvetica, sans-serif" size="5">User Documentation</font></td>
+</tr>
+<tr>
+<td background="images/bottom.gif" colspan="2" width="100%" valign="top" height="20" bgcolor="#0086b2" align="right">
+<table width="288" cellspacing="0" cellpadding="0" border="0">
+<tr>
+<td align="left" valign="top" height="20" width="96"><a target="new" href="http://xml.apache.org/"><img border="0" vspace="0" hspace="0" name="xml" src="images/button-xml-lo.gif" height="20" width="96" alt="http://xml.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.apache.org/"><img border="0" vspace="0" hspace="0" name="asf" src="images/button-asf-lo.gif" height="20" width="96" alt="http://www.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.w3.org/"><img border="0" vspace="0" hspace="0" name="w3c" src="images/button-w3c-lo.gif" height="20" width="96" alt="http://www.w3.org/"></a></td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<table width="100%" cellspacing="0" cellpadding="0" border="0">
+<tr width="100%">
+<td align="left" valign="top" width="120">
+<table width="120" cellspacing="0" cellpadding="0" border="0" bgcolor="#a0a0a0">
+<tr>
+<td valign="top" align="left"><img width="120" vspace="0" src="images/join.gif" hspace="0" height="14" border="0"><br>
+</td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../index.html">Main</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">User Documentation</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="concepts/index.html">Concepts</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">Sitemap Components</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="generators/generators.html">Generators</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="transformers/transformers.html">Transformers</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="serializers/serializers.html">Serializers</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="matchers/matchers.html">Matchers</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="selectors/selectors.html">Selectors</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="actions/actions.html">Actions</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="readers/readers.html">Readers</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="xsp/index.html">XSP</a></td>
+</tr>
+<tr>
+<td align="left" valign="top"><img width="120" vspace="0" src="images/close.gif" hspace="0" height="14" border="0"><br>
+</td>
+</tr>
+</table>
+</td><td>
+<table cellspacing="15" cellpadding="0" border="0">
+<tr>
+<td>
+ 
+
+ 
+ <font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Overview</font>
+<hr style="color: #0086b2" size="1">
+
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">In getting started with Cocoon, one must learn not only a number of
+  concepts, but a number of details as well.  Read the Introduction and ensure that you
+  understand concepts such as the sitemap, generators, transformers, serializers
+  and actions.  This guide will fill in the details, such as "So how do I turn
+  this query into XML data".
+  </font>
+</p>
+   
+<p>
+<font color="black" face="verdana,helvetica,sanserif">If you are interested in developing real-world web-applications requiring
+    form handling, authentication or even developing your own portal, have a 
+    look at the <a href="../developing/webapps/index.html">web application documentation</a>.</font>
+</p>
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+  Come back often...this guide is being updated regularly.
+  </font>
+</p>
+
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">The actual user documentation is available from the side-panel.
+  </font>
+</p>
+
+ 
+
+ 
+
+</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<table width="100%" cellspacing="0" cellpadding="0" border="0">
+<tr>
+<td bgcolor="#0086b2"><img width="1" src="images/dot.gif" height="1"></td>
+</tr>
+<tr>
+<td align="center"><font size="-1" face="arial,helvetica,sanserif" color="#0086b2"><i>Copyright &copy; 1999-2002 The Apache Software Foundation. All Rights Reserved.</i></font></td>
+</tr>
+</table>
+</body>
+</html>