You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general-cvs@xml.apache.org by sh...@apache.org on 2002/08/22 04:39:06 UTC
cvs commit: xml-site/targets/cocoon/userdocs/xsp esql.html logicsheet-forms.html
shannon 2002/08/21 19:39:06
Modified: targets/cocoon/userdocs/actions actions.html
database-actions.html
targets/cocoon/userdocs/concepts catalog.html modules.html
sitemap.html
targets/cocoon/userdocs/generators directory-generator.html
error-generator.html extractor-generator.html
file-generator.html generators.html
html-generator.html imagedirectory-generator.html
jsp-generator.html linkstatus-generator.html
php-generator.html profile-generator.html
request-generator.html script-generator.html
search-generator.html serverpages-generator.html
status-generator.html stream-generator.html
velocity-generator.html xmldb-generator.html
xmldbcollection-generator.html
targets/cocoon/userdocs/serializers link-serializer.html
targets/cocoon/userdocs/transformers
cinclude-transformer.html
encodeurl-transformer.html
extractor-transformer.html filter-transformer.html
i18n-transformer.html ldap-transformer.html
log-transformer.html
readdomsession-transformer.html
sourcewriting-transformer.html sql-transformer.html
transformers.html writedomsession-transformer.html
xinclude-transformer.html xslt-transformer.html
xt-transformer.html
targets/cocoon/userdocs/xsp esql.html logicsheet-forms.html
Added: targets/cocoon/userdocs/actions session-action.html
targets/cocoon/userdocs/generators textparser-generator.html
targets/cocoon/userdocs/generators/images note.gif
targets/cocoon/userdocs/transformers
augment-transformer.html
textparser-transformer.html
Log:
update site
Revision Changes Path
1.7 +7 -0 xml-site/targets/cocoon/userdocs/actions/actions.html
Index: actions.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/actions/actions.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- actions.html 15 Jul 2002 13:57:04 -0000 1.6
+++ actions.html 22 Aug 2002 02:39:02 -0000 1.7
@@ -90,6 +90,9 @@
<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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="session-action.html">Session Action</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>
@@ -134,6 +137,10 @@
<li>
<font face="verdana, helvetica, sans serif"><a href="database-actions.html">Database Actions</a></font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif"><a href="session-action.html">Session Action</a></font>
</li>
</ul>
1.4 +3 -0 xml-site/targets/cocoon/userdocs/actions/database-actions.html
Index: database-actions.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/actions/database-actions.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- database-actions.html 15 Jul 2002 13:57:04 -0000 1.3
+++ database-actions.html 22 Aug 2002 02:39:02 -0000 1.4
@@ -90,6 +90,9 @@
<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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="session-action.html">Session Action</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>
1.1 xml-site/targets/cocoon/userdocs/actions/session-action.html
Index: session-action.html
===================================================================
<html xmlns:NetUtils="org.apache.cocoon.util.NetUtils">
<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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../../index.html">Main</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../index.html">User Documentation</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="actions.html">Overview</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="database-actions.html">Database</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
<map:act type="session"/>
</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>
<map:act type="session">
<map:parameter name="action" value="create"/>
</map:act>
</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>
<map:act type="session">
<map:parameter name="action" value="terminate"/>
</map:act>
</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>
<map:act type="session">
<map:parameter name="action" value="terminate"/>
<map:parameter name="mode" value="if-unused"/>
</map:act>
</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 © 1999-2002 The Apache Software Foundation. All Rights Reserved.</i></font></td>
</tr>
</table>
</body>
</html>
1.7 +6 -7 xml-site/targets/cocoon/userdocs/concepts/catalog.html
Index: catalog.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/concepts/catalog.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- catalog.html 15 Jul 2002 13:57:04 -0000 1.6
+++ catalog.html 22 Aug 2002 02:39:02 -0000 1.7
@@ -713,7 +713,7 @@
<font color="black" face="verdana,helvetica,sanserif">
A default catalog and some base entities (e.g. ISO*.pen character
entity sets) are included in the Cocoon distribution at
- <code><font face="courier, monospaced">webapp/resources/entities/</font></code>
+ <code><font face="courier, monospaced">WEB-INF/entities/</font></code>
- the default catalog is automatically loaded when Cocoon starts.
</font>
</p>
@@ -746,7 +746,7 @@
<p>
<font color="black" face="verdana,helvetica,sanserif">Parameters (properties) for the resolver component can be specified in the
- <code><font face="courier, monospaced">java/org/apache/cocoon/components/resolver/resolver.xconf</font></code>
+ <code><font face="courier, monospaced">src/webapp/WEB-INF/cocoon.xconf</font></code>
configuration file. See the detailed internal notes - here is a precis.
</font>
</p>
@@ -794,11 +794,10 @@
<p>
<font color="black" face="verdana,helvetica,sanserif">
- The build process will automatically copy the properties file from
-<code><font face="courier, monospaced">$COCOON_HOME/webapp/resources/entities/CatalogManager.properties</font></code>
- to
-<code><font face="courier, monospaced">$TOMCAT_HOME/webapps/cocoon/WEB-INF/classes/CatalogManager.properties</font></code>
- thereby making it available to the Java classpath.
+ The file is at
+<code><font face="courier, monospaced">webapp/WEB-INF/classes/CatalogManager.properties</font></code>
+ thereby making it available to the Java classpath during startup of the
+ servlet engine.
</font>
</p>
1.4 +11 -11 xml-site/targets/cocoon/userdocs/concepts/modules.html
Index: modules.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/concepts/modules.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- modules.html 15 Jul 2002 13:57:05 -0000 1.3
+++ modules.html 22 Aug 2002 02:39:02 -0000 1.4
@@ -149,17 +149,6 @@
of the underlying rationale and principles.
</font>
</p>
-
-<p>
-<table border="0" cellpadding="0" cellspacing="3" width="100%">
-<tr>
-<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>
- To use modules, Apache Cocoon needs to have been build to include
- scratchpad components.
- </i></font></td>
-</tr>
-</table>
-</p>
<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Types of Modules</font>
@@ -351,6 +340,17 @@
declared above allows to override the skin with a request parameter
named "skin".
</font>
+</p>
+
+<p>
+<table border="0" cellpadding="0" cellspacing="3" width="100%">
+<tr>
+<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>
+ The above sitemap syntax is only available with the 2.1-dev version
+ of Apache Cocoon.
+ </i></font></td>
+</tr>
+</table>
</p>
<div align="center">
1.7 +56 -105 xml-site/targets/cocoon/userdocs/concepts/sitemap.html
Index: sitemap.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/concepts/sitemap.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- sitemap.html 15 Jul 2002 13:57:05 -0000 1.6
+++ sitemap.html 22 Aug 2002 02:39:02 -0000 1.7
@@ -270,7 +270,6 @@
<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><?xml version="1.0"?>
-
<map:sitemap
xmlns:map="http://apache.org/cocoon/sitemap/1.0">
<map:components/>
@@ -278,7 +277,7 @@
<map:resources/>
<map:action-sets/>
<map:pipelines/>
- </map:sitemap></pre>
+ </map:sitemap> </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>
@@ -299,7 +298,7 @@
<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><map:sitemap
- xmlns:map="http://apache.org/cocoon/sitemap/1.0"></pre>
+ xmlns:map="http://apache.org/cocoon/sitemap/1.0"> </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>
@@ -340,18 +339,15 @@
<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>
-
-<map:components>
- <map:generators/>
- <map:transformers/>
- <map:serializers/>
- <map:readers/>
- <map:selectors/>
- <map:matchers/>
- <map:actions/>
-</map:components>
-
- </pre>
+ <map:components>
+ <map:generators/>
+ <map:transformers/>
+ <map:serializers/>
+ <map:readers/>
+ <map:selectors/>
+ <map:matchers/>
+ <map:actions/>
+ </map:components> </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>
@@ -415,9 +411,7 @@
<!-- This is a parameter to the transformer component -->
<use-request-parameters>false</use-request-parameters>
</map:transformer>
-</map:components>
-
- </pre>
+</map:components> </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>
@@ -461,9 +455,7 @@
src="org.apache.cocoon.generation.ServerPagesGenerator">
...
</map:generator>
-</map:generators>
-
- </pre>
+</map:generators> </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>
@@ -509,9 +501,7 @@
</map:transformer>
<map:transformer name="xinclude"
src="org.apache.cocoon.transformation.XIncludeTransformer"/>
-</map:transformers>
-
- </pre>
+</map:transformers> </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>
@@ -579,9 +569,7 @@
<map:serializer name="svg2png" mime-type="image/png"
src="org.apache.cocoon.serialization.SVGSerializer">
</map:serializer>
-</map:serializers>
-
- </pre>
+</map:serializers> </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>
@@ -640,9 +628,7 @@
<browser name="netscape" useragent="Mozilla"/>
...
</map:selection>
-</map:selection>
-
- </pre>
+</map:selection> </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>
@@ -689,9 +675,7 @@
src="org.apache.cocoon.matching.RegexpURIMatcher">
...
</map:matcher>
-</map:matchers>
-
- </pre>
+</map:matchers> </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>
@@ -741,9 +725,7 @@
src="org.apache.cocoon.acting.RequestParamAction"/>
<map:action name="form-validator"
src="org.apache.cocoon.acting.FormValidatorAction"/>
-</map:actions>
-
- </pre>
+</map:actions> </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>
@@ -785,9 +767,7 @@
<map:view name="links" from-position="last">
<map:serialize type="links"/>
</map:view>
-</map:views>
-
- </pre>
+</map:views> </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>
@@ -822,9 +802,7 @@
<map:transform src="./stylesheets/general-browser.xsl"/>
<map:serialize status-code="401"/>
</map:resource>
-</map:resources>
-
- </pre>
+</map:resources> </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>
@@ -861,9 +839,7 @@
<map:act type="upd-employee" action="Update"/>
<map:act type="sel-employee" action="Select"/>
</map:action-set>
-</map:action-sets>
-
- </pre>
+</map:action-sets> </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>
@@ -1105,8 +1081,7 @@
<pre>
<map:aggregate element="the-aggregated-content">
<!-- define your map:parts here -->
-</map:aggregate>
- </pre>
+</map:aggregate> </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>
@@ -1226,8 +1201,7 @@
<map:part src="cocoon:/book-{1}.xml"/>
<map:part src="cocoon:/body-{1}.xml"/>
</map:aggregate>
- ...
- </pre>
+ ... </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>
@@ -1259,8 +1233,7 @@
<!-- content of body xml -->
...
</document>
-</site>
- </pre>
+</site> </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>
@@ -1353,8 +1326,7 @@
<map:transform type="i18n"/>
<map:serialize/>
</map:error-handler>
-</map:pipeline>
- </pre>
+</map:pipeline> </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>
@@ -1421,8 +1393,7 @@
</map:match>
<map:match pattern="welcome">
...
-</map:pipeline>
- </pre>
+</map:pipeline> </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>
@@ -1472,8 +1443,7 @@
<map:parameter name="target" value="target-1"/>
</map:call>
...
-</map:pipeline>
- </pre>
+</map:pipeline> </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>
@@ -1484,7 +1454,10 @@
<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>Mounting sitemaps</b></font>
- <font face="verdana, helvetica, sans serif" size="+1" color="#0086b2">Introduction</font>
+
+<br>
+
+<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2">Introduction</font>
<p>
<font color="black" face="verdana,helvetica,sanserif">
@@ -1514,9 +1487,7 @@
<map:match pattern="faq/*">
<map:mount uri-prefix="faq" check-reload="no"
src="faq/sitemap.xmap"/>
-</map:match>
-
- </pre>
+</map:match> </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>
@@ -1653,9 +1624,7 @@
</map:pipeline>
</map:pipelines>
-</map:sitemap>
-
- </pre>
+</map:sitemap> </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>
@@ -1684,9 +1653,7 @@
<map:match pattern="faq/*">
<map:mount uri-prefix="faq/" check-reload="no"
src="faq/sitemap.xmap" reload-method="asynchron"/>
-</map:match>
-
- </pre>
+</map:match> </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>
@@ -1852,9 +1819,7 @@
*/
public void setConsumer(XMLConsumer consumer);
-}
-
- </pre>
+} </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>
@@ -1891,9 +1856,7 @@
public interface XMLConsumer extends ContentHandler,
LexicalHandler {
-}
-
- </pre>
+} </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>
@@ -1930,9 +1893,7 @@
public interface XMLPipe extends XMLConsumer , XMLProducer {
-}
-
- </pre>
+} </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>
@@ -1973,9 +1934,7 @@
void setup(SourceResolver resolver, Map objectModel,
String src, Parameters par)
throws ProcessingException, SAXException, IOException;
-}
-
- </pre>
+} </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>
@@ -2024,9 +1983,7 @@
* Test if the component wants to set the content length
*/
boolean shouldSetContentLength();
-}
-
- </pre>
+} </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>
@@ -2064,9 +2021,7 @@
public void generate()
throws IOException, SAXException, ProcessingException;
-}
-
- </pre>
+} </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>
@@ -2102,9 +2057,7 @@
String ROLE = "org.apache.cocoon.transformation.Transformer";
-}
-
- </pre>
+} </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>
@@ -2140,9 +2093,7 @@
String ROLE = "org.apache.cocoon.serialization.Serializer";
-}
-
- </pre>
+} </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>
@@ -2191,9 +2142,7 @@
*/
boolean select (String expression, Map objectModel,
Parameters parameters);
-}
-
- </pre>
+} </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>
@@ -2244,9 +2193,7 @@
* If the return value is null there was no match.
*/
Map match (String pattern, Map objectModel, Parameters parameters);
-}
-
- </pre>
+} </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>
@@ -2311,9 +2258,7 @@
Map act(Redirector redirector, SourceResolver resolver,
Map objectModel, String source, Parameters par)
throws Exception;
-}
-
- </pre>
+} </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>
@@ -2325,14 +2270,20 @@
-<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Additional information</font>
+<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Additional resources</font>
<hr style="color: #0086b2" size="1">
-
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+Learn more about advanced Sitemap features by downloading the free chapter, <a href="http://www.newriders.com/books/product.asp?product_id={C3C05052-BE3B-4E06-A60A-13FB40AF58F6}">A User's Look at the Cocoon architecture,</a> from Langham and Ziegler's <i>Cocoon: Building XML Applications</i> available at the New Riders web site.
+ </font>
+</p>
+
<p>
<font color="black" face="verdana,helvetica,sanserif">
- Also there is a draft XML Schema <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-cocoon2/src/documentation/xdocs/drafts/sitemap-2.1-draft.xsd?rev=HEAD&content-type=text/plain">grammar for the Cocoon sitemap</a>, and some <a href="http://outerthought.net/sitemap/">external documentation</a>
- generated from this Schema. There you will also find a poster diagram of
- the sitemap structure.
+ Check out a draft XML Schema <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-cocoon2/src/documentation/xdocs/drafts/sitemap-2.1-draft.xsd?rev=HEAD&content-type=text/plain">grammar for the Cocoon sitemap</a>, and some <a href="http://outerthought.net/sitemap/">external documentation</a>
+ generated from this Schema. A poster diagram of
+ the sitemap structure is also available.
</font>
</p>
1.7 +3 -0 xml-site/targets/cocoon/userdocs/generators/directory-generator.html
Index: directory-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/directory-generator.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- directory-generator.html 15 Jul 2002 13:57:05 -0000 1.6
+++ directory-generator.html 22 Aug 2002 02:39:02 -0000 1.7
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +3 -0 xml-site/targets/cocoon/userdocs/generators/error-generator.html
Index: error-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/error-generator.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- error-generator.html 15 Jul 2002 13:57:05 -0000 1.6
+++ error-generator.html 22 Aug 2002 02:39:02 -0000 1.7
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +3 -0 xml-site/targets/cocoon/userdocs/generators/extractor-generator.html
Index: extractor-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/extractor-generator.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- extractor-generator.html 15 Jul 2002 13:57:05 -0000 1.6
+++ extractor-generator.html 22 Aug 2002 02:39:02 -0000 1.7
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +3 -0 xml-site/targets/cocoon/userdocs/generators/file-generator.html
Index: file-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/file-generator.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- file-generator.html 15 Jul 2002 13:57:05 -0000 1.6
+++ file-generator.html 22 Aug 2002 02:39:02 -0000 1.7
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +7 -0 xml-site/targets/cocoon/userdocs/generators/generators.html
Index: generators.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/generators.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- generators.html 15 Jul 2002 13:57:05 -0000 1.6
+++ generators.html 22 Aug 2002 02:39:02 -0000 1.7
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
@@ -265,6 +268,10 @@
<li>
<font face="verdana, helvetica, sans serif"><a href="xmldbcollection-generator.html">XML:DB Collection Generator</a> (optional)</font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif"><a href="textparser-generator.html">Text Parser Generator</a></font>
</li>
</ul>
1.7 +3 -0 xml-site/targets/cocoon/userdocs/generators/html-generator.html
Index: html-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/html-generator.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- html-generator.html 15 Jul 2002 13:57:05 -0000 1.6
+++ html-generator.html 22 Aug 2002 02:39:02 -0000 1.7
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +3 -0 xml-site/targets/cocoon/userdocs/generators/imagedirectory-generator.html
Index: imagedirectory-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/imagedirectory-generator.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- imagedirectory-generator.html 15 Jul 2002 13:57:05 -0000 1.6
+++ imagedirectory-generator.html 22 Aug 2002 02:39:03 -0000 1.7
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +3 -0 xml-site/targets/cocoon/userdocs/generators/jsp-generator.html
Index: jsp-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/jsp-generator.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- jsp-generator.html 15 Jul 2002 13:57:05 -0000 1.6
+++ jsp-generator.html 22 Aug 2002 02:39:03 -0000 1.7
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.2 +3 -0 xml-site/targets/cocoon/userdocs/generators/linkstatus-generator.html
Index: linkstatus-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/linkstatus-generator.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- linkstatus-generator.html 15 Jul 2002 14:01:30 -0000 1.1
+++ linkstatus-generator.html 22 Aug 2002 02:39:03 -0000 1.2
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">LinkStatus Generator</span></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +3 -0 xml-site/targets/cocoon/userdocs/generators/php-generator.html
Index: php-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/php-generator.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- php-generator.html 15 Jul 2002 13:57:05 -0000 1.6
+++ php-generator.html 22 Aug 2002 02:39:03 -0000 1.7
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.6 +3 -0 xml-site/targets/cocoon/userdocs/generators/profile-generator.html
Index: profile-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/profile-generator.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- profile-generator.html 15 Jul 2002 13:57:05 -0000 1.5
+++ profile-generator.html 22 Aug 2002 02:39:03 -0000 1.6
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +56 -0 xml-site/targets/cocoon/userdocs/generators/request-generator.html
Index: request-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/request-generator.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- request-generator.html 15 Jul 2002 13:57:05 -0000 1.6
+++ request-generator.html 22 Aug 2002 02:39:03 -0000 1.7
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
@@ -206,6 +209,7 @@
<code><font face="courier, monospaced">http://xml.apache.org/cocoon/requestgenerator/2.0</font></code></font>
</p>
+
<div align="center">
<table border="0" cellpadding="0" cellspacing="4">
<tr>
@@ -244,6 +248,16 @@
</parameter>
</requestParameters>
+ <!-- All request attributes; see below the note on generate-attributes parameter.
+ (This feature is available startign with version 2.1 -->
+ <requestAttributes>
+ <!-- Create an attribute element for each attribute -->
+ <attribute name="errorMessage">
+ <!-- Create a value element for the attribute value -->
+ <value>I was put here by an earlier action.</value>
+ </attribute>
+ </requestAttributes>
+
<!-- All configuration parameters: -->
<configurationParameters>
<!-- Create a parameter element for each parameter specified
@@ -252,6 +266,48 @@
</configurationParameters>
</request>
+</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>
+<table border="0" cellpadding="0" cellspacing="3" width="100%">
+<tr>
+<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>If you want request attributes to be generated, you must specify <code><font face="courier, monospaced">generate-attributes</font></code> parameter at generator definition or invocation in the sitemap.</i></font></td>
+</tr>
+</table>
+</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>
+<!-- This will turn on attribute generation on by default -->
+<map:generator name="request" src="org.apache.cocoon.generation.RequestGenerator">
+ <map:parameter name="generate-attributes" value="true"/>
+</map:generator>
+
+<!-- or -->
+
+ <!-- This will turn on attribute generation for this invocation only. -->
+ <map:match pattern="request">
+ <map:generate type="request">
+ <map:parameter name="generate-attributes" value="true"/>
+ </map:generate>
+ </map:match>
+
+
</pre>
</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
</tr>
1.7 +3 -0 xml-site/targets/cocoon/userdocs/generators/script-generator.html
Index: script-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/script-generator.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- script-generator.html 15 Jul 2002 13:57:05 -0000 1.6
+++ script-generator.html 22 Aug 2002 02:39:03 -0000 1.7
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.6 +3 -0 xml-site/targets/cocoon/userdocs/generators/search-generator.html
Index: search-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/search-generator.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- search-generator.html 15 Jul 2002 13:57:05 -0000 1.5
+++ search-generator.html 22 Aug 2002 02:39:03 -0000 1.6
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +3 -0 xml-site/targets/cocoon/userdocs/generators/serverpages-generator.html
Index: serverpages-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/serverpages-generator.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- serverpages-generator.html 15 Jul 2002 13:57:05 -0000 1.6
+++ serverpages-generator.html 22 Aug 2002 02:39:03 -0000 1.7
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +3 -0 xml-site/targets/cocoon/userdocs/generators/status-generator.html
Index: status-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/status-generator.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- status-generator.html 15 Jul 2002 13:57:05 -0000 1.6
+++ status-generator.html 22 Aug 2002 02:39:03 -0000 1.7
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +3 -0 xml-site/targets/cocoon/userdocs/generators/stream-generator.html
Index: stream-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/stream-generator.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- stream-generator.html 15 Jul 2002 13:57:05 -0000 1.6
+++ stream-generator.html 22 Aug 2002 02:39:03 -0000 1.7
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +3 -0 xml-site/targets/cocoon/userdocs/generators/velocity-generator.html
Index: velocity-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/velocity-generator.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- velocity-generator.html 15 Jul 2002 13:57:06 -0000 1.6
+++ velocity-generator.html 22 Aug 2002 02:39:03 -0000 1.7
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.6 +3 -0 xml-site/targets/cocoon/userdocs/generators/xmldb-generator.html
Index: xmldb-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/xmldb-generator.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- xmldb-generator.html 15 Jul 2002 13:57:06 -0000 1.5
+++ xmldb-generator.html 22 Aug 2002 02:39:03 -0000 1.6
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.6 +3 -0 xml-site/targets/cocoon/userdocs/generators/xmldbcollection-generator.html
Index: xmldbcollection-generator.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/generators/xmldbcollection-generator.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- xmldbcollection-generator.html 15 Jul 2002 13:57:06 -0000 1.5
+++ xmldbcollection-generator.html 22 Aug 2002 02:39:03 -0000 1.6
@@ -132,6 +132,9 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-generator.html">Text Parser Generator</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.1 xml-site/targets/cocoon/userdocs/generators/textparser-generator.html
Index: textparser-generator.html
===================================================================
<html xmlns:NetUtils="org.apache.cocoon.util.NetUtils">
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Text Parser Generator</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">Text Parser Generator</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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../../index.html">Main</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../index.html">User Documentation</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
<span class="menutitle">Generators</span></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="generators.html">Overview</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="file-generator.html">File Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="html-generator.html">HTML Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="directory-generator.html">Directory Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="imagedirectory-generator.html">Image Directory Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="extractor-generator.html">Fragment Extractor Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="jsp-generator.html">JSP Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="script-generator.html">Script Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="serverpages-generator.html">Server Pages Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="velocity-generator.html">Velocity Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="request-generator.html">Request Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="status-generator.html">Status Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="stream-generator.html">Stream Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="profile-generator.html">Profile Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="error-generator.html">Error Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="search-generator.html">Search Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="linkstatus-generator.html">LinkStatus Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">Text Parser Generator</span></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="php-generator.html">Php Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="xmldb-generator.html">XML:DB Generator</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="xmldbcollection-generator.html">XML:DB Collection Generator</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">Text Parser Generator</font>
<hr style="color: #0086b2" size="1">
<p>
<font color="black" face="verdana,helvetica,sanserif">The text parser generator parser a text file, which an specified grammar, and
generates a XML file from it.</font>
</p>
<blockquote>
<ul>
<li>
<font face="verdana, helvetica, sans serif">Name : textparser</font>
</li>
<li>
<font face="verdana, helvetica, sans serif">Class: org.apache.cocoon.generation.TextParserGenerator</font>
</li>
<li>
<font face="verdana, helvetica, sans serif">Cacheable: yes - uses the last modification date of the text document and of the grammar file
for validation.</font>
</li>
</ul>
</blockquote>
<p>
<font color="black" face="verdana,helvetica,sanserif">The location of the source xml document is specified in
the pipeline by the src attribute.</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>
<map:generate src="example.txt" type="textparser">
<map:parameter name="grammar" value="example.grm"/>
<map:parameter name="includeignorabletokens" value="false"/>
</map:generate>
</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">The parameter to specify the grammar must be declared. The second paramter tells the parser
if it should include all obsolete tokens, and must not specified.</font>
</p>
<p>
<font color="black" face="verdana,helvetica,sanserif">The explanation of function and the grammar format can be found at the <a href="../../howto/chaperon/howto-chaperon-intro.html">howto section</a></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 © 1999-2002 The Apache Software Foundation. All Rights Reserved.</i></font></td>
</tr>
</table>
</body>
</html>
1.1 xml-site/targets/cocoon/userdocs/generators/images/note.gif
<<Binary file>>
1.7 +56 -9 xml-site/targets/cocoon/userdocs/serializers/link-serializer.html
Index: link-serializer.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/serializers/link-serializer.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- link-serializer.html 15 Jul 2002 13:57:06 -0000 1.6
+++ link-serializer.html 22 Aug 2002 02:39:04 -0000 1.7
@@ -142,29 +142,76 @@
<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Link Serializer</font>
<hr style="color: #0086b2" size="1">
-
+
<p>
-<font color="black" face="verdana,helvetica,sanserif">????.</font>
+<font color="black" face="verdana,helvetica,sanserif">The link serializer generates a list of links
+ using <a href="http://www.w3.org/TR/xlink/">XLink</a>
+ from the sax events.
+ Most <a href="http://www.w3.org/MarkUp/">XHTML</a>
+ attributes are also supported (href, src, longdesc,
+ background). The mime-type of the output is
+ <code><font face="courier, monospaced">application/x-cocoon-links</font></code>. This serializer is
+ required by the link status generator and the command line
+ mode to follow links.</font>
</p>
-
+
<blockquote>
<ul>
-
+
<li>
-<font face="verdana, helvetica, sans serif">Name : links</font>
+<font face="verdana, helvetica, sans serif">Name: links</font>
</li>
-
+
<li>
<font face="verdana, helvetica, sans serif">Class: org.apache.cocoon.serialization.LinkSerializer</font>
</li>
-
+
<li>
-<font face="verdana, helvetica, sans serif">Cacheable: ????.</font>
+<font face="verdana, helvetica, sans serif">Cacheable: no</font>
</li>
-
+
</ul>
</blockquote>
+
+<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Usage</font>
+<hr style="color: #0086b2" size="1">
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">To use the link serializer for the command-line or the
+ link status generator, you need the following entries in
+ your sitemap:</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>
+<map:components>
+ <map:serializers>
+ <map:serializer logger="sitemap.serializer.links" name="links"
+ src="org.apache.cocoon.serialization.LinkSerializer" />
+ </map:serializers>
+</map:components>
+
+<map:views>
+ <map:view from-position="last" name="links">
+ <map:serialize type="links" />
+ </map:view>
+</map:views>
+</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>
+
</td>
1.7 +6 -0 xml-site/targets/cocoon/userdocs/transformers/cinclude-transformer.html
Index: cinclude-transformer.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/cinclude-transformer.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- cinclude-transformer.html 15 Jul 2002 13:57:07 -0000 1.6
+++ cinclude-transformer.html 22 Aug 2002 02:39:04 -0000 1.7
@@ -120,6 +120,12 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.2 +6 -0 xml-site/targets/cocoon/userdocs/transformers/encodeurl-transformer.html
Index: encodeurl-transformer.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/encodeurl-transformer.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- encodeurl-transformer.html 15 Jul 2002 14:01:30 -0000 1.1
+++ encodeurl-transformer.html 22 Aug 2002 02:39:04 -0000 1.2
@@ -120,6 +120,12 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +6 -0 xml-site/targets/cocoon/userdocs/transformers/extractor-transformer.html
Index: extractor-transformer.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/extractor-transformer.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- extractor-transformer.html 15 Jul 2002 13:57:07 -0000 1.6
+++ extractor-transformer.html 22 Aug 2002 02:39:04 -0000 1.7
@@ -120,6 +120,12 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +6 -0 xml-site/targets/cocoon/userdocs/transformers/filter-transformer.html
Index: filter-transformer.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/filter-transformer.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- filter-transformer.html 15 Jul 2002 13:57:07 -0000 1.6
+++ filter-transformer.html 22 Aug 2002 02:39:04 -0000 1.7
@@ -120,6 +120,12 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +6 -0 xml-site/targets/cocoon/userdocs/transformers/i18n-transformer.html
Index: i18n-transformer.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/i18n-transformer.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- i18n-transformer.html 15 Jul 2002 13:57:07 -0000 1.6
+++ i18n-transformer.html 22 Aug 2002 02:39:04 -0000 1.7
@@ -120,6 +120,12 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +6 -0 xml-site/targets/cocoon/userdocs/transformers/ldap-transformer.html
Index: ldap-transformer.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/ldap-transformer.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- ldap-transformer.html 15 Jul 2002 13:57:07 -0000 1.6
+++ ldap-transformer.html 22 Aug 2002 02:39:04 -0000 1.7
@@ -120,6 +120,12 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +7 -1 xml-site/targets/cocoon/userdocs/transformers/log-transformer.html
Index: log-transformer.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/log-transformer.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- log-transformer.html 15 Jul 2002 13:57:07 -0000 1.6
+++ log-transformer.html 22 Aug 2002 02:39:05 -0000 1.7
@@ -120,6 +120,12 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
@@ -167,7 +173,7 @@
<map:transform type="log">
<map:parameter name="logfile" value="logfile.log"/>
<map:parameter name="append" value="no"/>
- </map:transform>>
+ </map:transform>
</pre>
</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
</tr>
1.7 +6 -0 xml-site/targets/cocoon/userdocs/transformers/readdomsession-transformer.html
Index: readdomsession-transformer.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/readdomsession-transformer.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- readdomsession-transformer.html 15 Jul 2002 13:57:07 -0000 1.6
+++ readdomsession-transformer.html 22 Aug 2002 02:39:05 -0000 1.7
@@ -120,6 +120,12 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.2 +6 -0 xml-site/targets/cocoon/userdocs/transformers/sourcewriting-transformer.html
Index: sourcewriting-transformer.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/sourcewriting-transformer.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- sourcewriting-transformer.html 15 Jul 2002 14:01:30 -0000 1.1
+++ sourcewriting-transformer.html 22 Aug 2002 02:39:05 -0000 1.2
@@ -120,6 +120,12 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">SourceWriting Transformer</span></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +6 -0 xml-site/targets/cocoon/userdocs/transformers/sql-transformer.html
Index: sql-transformer.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/sql-transformer.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- sql-transformer.html 15 Jul 2002 13:57:07 -0000 1.6
+++ sql-transformer.html 22 Aug 2002 02:39:05 -0000 1.7
@@ -120,6 +120,12 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +14 -0 xml-site/targets/cocoon/userdocs/transformers/transformers.html
Index: transformers.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/transformers.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- transformers.html 15 Jul 2002 13:57:07 -0000 1.6
+++ transformers.html 22 Aug 2002 02:39:05 -0000 1.7
@@ -120,6 +120,12 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
@@ -224,6 +230,10 @@
<li>
<font face="verdana, helvetica, sans serif"><a href="sourcewriting-transformer.html">SourceWriting Transformer</a></font>
</li>
+
+<li>
+<font face="verdana, helvetica, sans serif"><a href="augment-transformer.html">Augment Transformer</a></font>
+</li>
<li>
<font face="verdana, helvetica, sans serif"><a href="xt-transformer.html">XT Transformer</a> (optional)</font>
@@ -231,6 +241,10 @@
<li>
<font face="verdana, helvetica, sans serif"><a href="ldap-transformer.html">LDAP Transformer</a> (optional)</font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif"><a href="textparser-transformer.html">Text Parser Transformer</a></font>
</li>
</ul>
1.7 +6 -0 xml-site/targets/cocoon/userdocs/transformers/writedomsession-transformer.html
Index: writedomsession-transformer.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/writedomsession-transformer.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- writedomsession-transformer.html 15 Jul 2002 13:57:07 -0000 1.6
+++ writedomsession-transformer.html 22 Aug 2002 02:39:05 -0000 1.7
@@ -120,6 +120,12 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +6 -0 xml-site/targets/cocoon/userdocs/transformers/xinclude-transformer.html
Index: xinclude-transformer.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/xinclude-transformer.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- xinclude-transformer.html 15 Jul 2002 13:57:07 -0000 1.6
+++ xinclude-transformer.html 22 Aug 2002 02:39:05 -0000 1.7
@@ -120,6 +120,12 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.7 +7 -1 xml-site/targets/cocoon/userdocs/transformers/xslt-transformer.html
Index: xslt-transformer.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/xslt-transformer.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- xslt-transformer.html 15 Jul 2002 13:57:07 -0000 1.6
+++ xslt-transformer.html 22 Aug 2002 02:39:05 -0000 1.7
@@ -120,6 +120,12 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
@@ -271,7 +277,7 @@
<p>
<font color="black" face="verdana,helvetica,sanserif">In addition all other parameters to the transformer are
- available in the stylesheet as xsl:variables (These values
+ available in the stylesheet as <xsl:param/>s (These values
are also used in the caching algorithm.)</font>
</p>
1.7 +6 -0 xml-site/targets/cocoon/userdocs/transformers/xt-transformer.html
Index: xt-transformer.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/transformers/xt-transformer.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- xt-transformer.html 15 Jul 2002 13:57:07 -0000 1.6
+++ xt-transformer.html 22 Aug 2002 02:39:05 -0000 1.7
@@ -120,6 +120,12 @@
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
+</tr>
+<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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>
1.1 xml-site/targets/cocoon/userdocs/transformers/augment-transformer.html
Index: augment-transformer.html
===================================================================
<html xmlns:NetUtils="org.apache.cocoon.util.NetUtils">
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Augment Transformer</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">Augment Transformer</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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../../index.html">Main</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../index.html">User Documentation</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
<span class="menutitle">Transformers</span></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="transformers.html">Overview</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="xslt-transformer.html">XSLT Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="extractor-transformer.html">Fragment Extractor Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="i18n-transformer.html">I18n Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="log-transformer.html">Log Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sql-transformer.html">SQL Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="filter-transformer.html">Filter Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="readdomsession-transformer.html">Read DOM Session Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="writedomsession-transformer.html">Write DOM Session Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="xinclude-transformer.html">XInclude Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="cinclude-transformer.html">CInclude Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="encodeurl-transformer.html">EncodeURL Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">Augment Transformer</span></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="textparser-transformer.html">Text Parser Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="xt-transformer.html">XT Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="ldap-transformer.html">LDAP Transformer</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">Augment Transformer</font>
<hr style="color: #0086b2" size="1">
<p>
<font color="black" face="verdana,helvetica,sanserif">
The AugmentTransformer
augments all <code><font face="courier, monospaced">href</font></code> attributes with the full path to the request.
If a <code><font face="courier, monospaced">href</font></code> is already a full HTTP URL, or HTTPS URL the value of
href is not changed.
</font>
</p>
<p>
<font color="black" face="verdana,helvetica,sanserif">
The AugmentTransformer has serveral configuration options. These options
may be specified by each request.
</font>
</p>
<blockquote>
<font face="verdana, helvetica, sans serif">
<dl>
<dt>
<strong>mount</strong> - </dt>
<dd>If this request parameter is specified it defines the URI relative
to the servlet's context-path. If no mount parameter is specified the
resolution is calculated relative to the request URI.
</dd>
</dl>
</font>
</blockquote>
<blockquote>
<ul>
<li>
<font face="verdana, helvetica, sans serif">Name : augment</font>
</li>
<li>
<font face="verdana, helvetica, sans serif">Class: org.apache.cocoon.transformation.AugmentTransformer</font>
</li>
<li>
<font face="verdana, helvetica, sans serif">Cacheable: no.</font>
</li>
</ul>
</blockquote>
<p>
<font color="black" face="verdana,helvetica,sanserif">
A simple example might help to use the AugmentTransformer effectivly:
</font>
</p>
<p>
<font color="black" face="verdana,helvetica,sanserif">
Add the AugmentTransformer to the components in your sitemap.xmap
</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>
...
<map:components>
...
<map:transformers default="xslt">
...
<map:transformer name="augment"
src="org.apache.cocoon.transformation.AugmentTransformer">
</map:transformer>
...
</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">
Next define in your pipeline to use the AugmentTransformer
</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>
<map:match pattern="**book-**.xml">
<map:generate src="docs/{1}book.xml"/>
<map:transform type="augment">
<map:parameter name="mount" value="samples/flow/"/>
</map:transform>
...
</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">
In the example above all href attributes which do not start with <code><font face="courier, monospaced">http</font></code>, or
<code><font face="courier, monospaced">https</font></code> are augmented.
</font>
</p>
<p>
<font color="black" face="verdana,helvetica,sanserif">
Assuming Cocoon is deployed at <code><font face="courier, monospaced">http://localhost:8080/cocoon</font></code> a
href <code><font face="courier, monospaced">href="overview.html"</font></code> is augmented
to <code><font face="courier, monospaced">href="http://localhost:8080/cocoon/samples/flow/overview.html"</font></code>.
</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 © 1999-2002 The Apache Software Foundation. All Rights Reserved.</i></font></td>
</tr>
</table>
</body>
</html>
1.1 xml-site/targets/cocoon/userdocs/transformers/textparser-transformer.html
Index: textparser-transformer.html
===================================================================
<html xmlns:NetUtils="org.apache.cocoon.util.NetUtils">
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Text Parser Transformer</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">Text Parser Transformer</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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../../index.html">Main</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../index.html">User Documentation</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
<span class="menutitle">Transformers</span></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="transformers.html">Overview</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="xslt-transformer.html">XSLT Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="extractor-transformer.html">Fragment Extractor Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="i18n-transformer.html">I18n Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="log-transformer.html">Log Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sql-transformer.html">SQL Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="filter-transformer.html">Filter Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="readdomsession-transformer.html">Read DOM Session Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="writedomsession-transformer.html">Write DOM Session Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="xinclude-transformer.html">XInclude Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="cinclude-transformer.html">CInclude Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="encodeurl-transformer.html">EncodeURL Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="sourcewriting-transformer.html">SourceWriting Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="augment-transformer.html">Augment Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">Text Parser Transformer</span></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<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 xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="xt-transformer.html">XT Transformer</a></td>
</tr>
<tr xmlns:NetUtils="http://xml.apache.org/xslt/java/org.apache.cocoon.util.NetUtils">
<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="ldap-transformer.html">LDAP Transformer</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">Text Parser Transformer</font>
<hr style="color: #0086b2" size="1">
<p>
<font color="black" face="verdana,helvetica,sanserif">The text parser transformer parse the content of special marked element of a SAX stream, by using
a grammar file.</font>
</p>
<blockquote>
<ul>
<li>
<font face="verdana, helvetica, sans serif">Name : textparser</font>
</li>
<li>
<font face="verdana, helvetica, sans serif">Class: org.apache.cocoon.transformation.TextFragmentParserTransformer</font>
</li>
<li>
<font face="verdana, helvetica, sans serif">Cacheable: yes - uses the last modification date of the grammar document for validation.</font>
</li>
</ul>
</blockquote>
<p>
<font color="black" face="verdana,helvetica,sanserif">The parser parse following elements from the SAX stream, and replace them through
generated documents.</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>
<tf:textfragment xmlns:tf="http://chaperon.sourceforge.net/schema/textfragment/1.0">
[Text, which should be parsed]
</tf:textfragment>
</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">The parameter to specify the grammar must be declared. The second parameter tells the parser
if it should include all obsolete tokens, and must not specified.</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>
<map:transform type="textparser">
<map:parameter name="grammar" value="example.grm"/>
<map:parameter name="includeignorabletokens" value="false"/>
</map:transform>
</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">The explanation of function and the grammar format can be found at the <a href="../../howto/chaperon/howto-chaperon-intro.html">howto section</a></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 © 1999-2002 The Apache Software Foundation. All Rights Reserved.</i></font></td>
</tr>
</table>
</body>
</html>
1.7 +57 -4 xml-site/targets/cocoon/userdocs/xsp/esql.html
Index: esql.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/xsp/esql.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- esql.html 15 Jul 2002 13:57:08 -0000 1.6
+++ esql.html 22 Aug 2002 02:39:05 -0000 1.7
@@ -232,6 +232,57 @@
</tr>
</table>
</div>
+
+
+<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>Connection</b></font>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Esql can use connection pools configured in <code><font face="courier, monospaced">cocoon.xconf</font></code> or
+ individually set up connections.</font>
+</p>
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif"><code><font face="courier, monospaced">esql:pool</font></code> gives the name of the connection pool to use.</font>
+</p>
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Individually configured connections use the <code><font face="courier, monospaced">esql:driver,
+ esql:dburl, esql:username, esql:password</font></code> tags. Their meaning
+ should be obvious.</font>
+</p>
+
+
+<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2">Connection Options</font>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Per default, esql will try to switch a connection to <i>autocommit</i>
+ mode. This is because it prevents hanging transactions that hold locks and
+ disturb further database accesses. Esql can be forced to not use
+ autocommit, by giving the
+ <code><font face="courier, monospaced"><esql:autocommit>false</esql:autocommit></font></code> nested
+ element to <code><font face="courier, monospaced">esql:connection</font></code>.</font>
+</p>
+
+
+<p>
+<table border="0" cellpadding="0" cellspacing="3" width="100%">
+<tr>
+<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>Even if a connection is configured with autocommit off in
+ <code><font face="courier, monospaced">cocoon.xconf</font></code>, esql will switch autocommit on if not
+ instructed to do otherwise.</i></font></td>
+</tr>
+</table>
+</p>
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Other options like limiting the size of the resultset are discussed
+ below.</font>
+</p>
+
+
@@ -608,10 +659,12 @@
<p>
<font color="black" face="verdana,helvetica,sanserif">Parameters for a stored procedure call may be of
- <code><font face="courier, monospaced">direction="in|out|inout"</font></code> with the usual JDBC meaning. In
- addition a <code><font face="courier, monospaced">type</font></code> needs to be supplied as well. This would be
- the same "XXX" as used in a <code><font face="courier, monospaced">get-XXX</font></code> JDBC-method call.</font>
-</p>
+ <code><font face="courier, monospaced">direction="in|out|inout"</font></code> with the usual JDBC meaning. In
+ addition a <code><font face="courier, monospaced">type</font></code> needs to be supplied for "out" and "inout"
+ parameters. This would be the same "XXX" as used in a <code><font face="courier, monospaced">get-XXX</font></code>
+ JDBC-method call. Alternatively, you can use a fully qualified field name,
+ e.g. "java.sql.Types.CHAR"</font>
+</p>
<p>
1.7 +453 -164 xml-site/targets/cocoon/userdocs/xsp/logicsheet-forms.html
Index: logicsheet-forms.html
===================================================================
RCS file: /home/cvs/xml-site/targets/cocoon/userdocs/xsp/logicsheet-forms.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- logicsheet-forms.html 15 Jul 2002 13:57:08 -0000 1.6
+++ logicsheet-forms.html 22 Aug 2002 02:39:06 -0000 1.7
@@ -112,49 +112,56 @@
<table cellspacing="15" cellpadding="0" border="0">
<tr>
<td>
-
-
- <font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Introduction</font>
+
+
+ <font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Introduction</font>
<hr style="color: #0086b2" size="1">
+
<p>
<font color="black" face="verdana,helvetica,sanserif">
- For most web applications input is essential. Apache Cocoon provides a
- variety of modules to support basic interaction like simple syntax
- checking of input data or writing input data to databases.
+ For most web applications input is essential. Apache Cocoon provides a
+ variety of modules to support basic interaction like simple syntax checking
+ of input data or writing input data to databases.
</font>
</p>
+
<p>
<font color="black" face="verdana,helvetica,sanserif">
- This is about syntax checking. See
- org.apache.cocoon.acting.DatabaseAbstractAction (in javadocs) for
- details on database interaction.
+ Two different packages deal with validating user input:<a href="../../howto/xmlform-wizard/howto-xmlform-wizard.html">XMLForm</a>
+ which tries to stay as close as possible with the <a href="www.w3.org">W3C</a> <a href="http://www.w3.org/MarkUp/Forms/">XForms</a> working draft.
+ Another, simpler and older implementation is the validation using the
+ <code><font face="courier, monospaced">FormValidatorAction</font></code>, which is described here.
</font>
</p>
-
+
+
<p>
<font color="black" face="verdana,helvetica,sanserif">
- FormValidatorAction communicates to the application a verbose
- error status through an request attribute. In addition a taglib
- allows easy access to the results. On top of that this taglib
- gives access to the attributes for parameters declared in those
- sections in descriptor.xml relevant to the validation process.
- </font>
+ To validate user input, an action, the <code><font face="courier, monospaced">FormValidatorAction</font></code>, is
+ placed in your pipeline. Together with a descriptor file, that specifies
+ the allowed input, this action validates the request parameters. Based on
+ the result, a different page can be displayed and feedback can be given to
+ the user either using XSP and the <code><font face="courier, monospaced">formval</font></code> logicsheet or the
+ <code><font face="courier, monospaced">SimpleFormTransformer</font></code>.
+ </font>
</p>
-
-<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>The Descriptor File</b></font>
+
+
+<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>Sitemap Usage</b></font>
<p>
<font color="black" face="verdana,helvetica,sanserif">
- For details on the syntax of the descriptor file see
- javadocs. Basically it consists of two sections, a list of
- parameters and their properties and a list of constraints or
- constraint sets. The file syntax is set up so that it can be
- shared with the database actions.
+ To take advantage of the form validator action, create two pages. One for
+ the input form and one indicating the acceptance of the reservation.
+ Create a pipeline in your sitemap so that the confirmation page is only
+ shown when the action completed successfully and the input form is
+ returned otherwise.
</font>
</p>
-
+
+
<div align="center">
<table border="0" cellpadding="0" cellspacing="4">
<tr>
@@ -165,22 +172,21 @@
<pre>
<?xml version="1.0"?>
-<root>
-
- <parameter name="persons" type="long" min="1" default="4" nullable="no"/>
- <parameter name="deposit" type="double" min="10.0" max="999.99"/>
- <parameter name="email" type="string" max-len="50"
- matches-regex="^[\d\w][\d\w\-_\.]*@([\d\w\-_]+\.)\w\w\w?$">
-
- <constraint-set name="car-reservation">
- <validate name="persons"/>
- <validate name="deposit" min="50.0"/>
- <validate name="email"/>
- </constraint-set>
-
-</root>
+ <map:match pattern="car-reservation">
+ <map:act type="form-validator">
+ <!-- add you favourite database action here -->
+ <map:parameter name="descriptor" value="descriptor.xml"/>
+ <map:parameter name="validate-set" value="car-reservation"/>
+ <map:generate type="serverpages" src="OK.xsp"/>
+ <map:transform src="stylesheets/dynamic-page2html.xsl"/>
+ <map:serialize/>
+ </map:act>
+ <map:generate type="serverpages" src="test/ERROR.xsp"/>
+ <map:transform src="stylesheets/dynamic-page2html.xsl"/>
+ <map:serialize/>
+ </map:match>
- </pre>
+ </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>
@@ -188,28 +194,26 @@
</tr>
</table>
</div>
+
<p>
<font color="black" face="verdana,helvetica,sanserif">
- The above could for example describe expected input from a reservation
- form. Specifications in a constraint set take precedence over
- the general ones.
+ Note here that you may not use a redirection to point to the pages if you
+ would like to access the validation results e.g. on the error page. A
+ redirection would create a new request object and thus discard the
+ validation results.
</font>
</p>
-
-
-<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>Sitemap Usage</b></font>
+
<p>
<font color="black" face="verdana,helvetica,sanserif">
- To take advantage of the form validator action create two
- pages. One for the input form and one indicating the acceptance of
- the reservation. Create a pipeline in your sitemap so that the
- confirmation page is only shown when the action completed
- successfully and the input form is returned otherwise.
+ A different example, that does not need serverpages but the
+ <code><font face="courier, monospaced">SimpleFormTransformer</font></code>:
</font>
</p>
-
+
+
<div align="center">
<table border="0" cellpadding="0" cellspacing="4">
<tr>
@@ -221,20 +225,26 @@
<?xml version="1.0"?>
<map:match pattern="car-reservation">
- <map:act type="form-validator">
- <!-- add you favourite database action here -->
- <map:parameter name="descriptor" value="descriptor.xml"/>
- <map:parameter name="validate-set" value="car-reservation"/>
- <map:generate type="serverpages" src="OK.xsp"/>
- <map:transform src="stylesheets/dynamic-page2html.xsl"/>
- <map:serialize/>
+ <map:act type="req-params">
+ <map:parameter name="parameters" value="order"/>
+
+ <map:act type="form-validator">
+ <map:parameter name="descriptor" value="descriptor.xml"/>
+ <map:parameter name="validate-set" value="car-reservation"/>
+ <!-- add you favourite database action here -->
+
+ <map:generate type="file" src="OK.xml"/>
+ <map:transform src="stylesheets/dynamic-page2html.xsl"/>
+ <map:serialize/>
+ </map:act>
</map:act>
- <map:generate type="serverpages" src="test/ERROR.xsp"/>
+ <map:generate type="file" src="test/ERROR.xml"/>
<map:transform src="stylesheets/dynamic-page2html.xsl"/>
+ <map:transform type="simple-form"/>
<map:serialize/>
</map:match>
- </pre>
+ </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>
@@ -242,33 +252,209 @@
</tr>
</table>
</div>
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Although this looks more complicated at first, it has advantages if you
+ don't want to or cannot use XSP. For example, if the form is stored as
+ XHTML in a database, XSP could not be used to fill the form with values
+ from request parameters or to display detailed error messages.
+ </font>
+</p>
+
+<p>
+<table border="0" cellpadding="0" cellspacing="3" width="100%">
+<tr>
+<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>
+ Keep in mind that files, here the descriptor file, could be specified
+ using the <code><font face="courier, monospaced">cocoon:</font></code> pseudo-protocol. Thus the file could be
+ generated dynamically from another pipeline!
+ </i></font></td>
+</tr>
+</table>
+</p>
+
+
+
+
+<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>The Descriptor File</b></font>
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ For details on the syntax of the descriptor file see javadocs. Basically
+ it consists of two sections, a list of parameters and their properties and
+ a list of constraints or constraint sets. The file syntax is set up so
+ that it can be shared with the database actions.
+ </font>
+</p>
+
+
+<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2">The types recognized by validator and their attributes</font>
+
+<table cellpadding="2" cellspacing="2" border="0" width="100%">
+<caption>
+<font face="verdana,helvetica,sanserif"></font>
+</caption>
+
+<tr>
+
+<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">string</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">nullable="yes|no" default="str"</font></td>
+
+</tr>
+
+<tr>
+
+<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">long</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">nullable="yes|no" default="123123"</font></td>
+</tr>
+
+<tr>
+
+<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">double</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">nullable="yes|no" default="0.5"</font></td>
+
+</tr>
+
+</table>
+
+
<p>
<font color="black" face="verdana,helvetica,sanserif">
- Note here that you may not use a redirection to point to the
- pages if you would like to access the validation results e.g. on
- the error page. A redirection would create a new request object
- and thus discard the validation results.
- </font>
+ Default value takes place only when specified parameter is nullable and
+ really is null or empty. Long numbers may be specified in decimal, hex or
+ octal values as accepted by java.Lang.decode (String s).
+ </font>
</p>
+
+<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2">Constraints</font>
+<table cellpadding="2" cellspacing="2" border="0" width="100%">
+<caption>
+<font face="verdana,helvetica,sanserif"></font>
+</caption>
+
+<tr>
+
+<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">matches-regex</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">POSIX regular expression</font></td>
+
+</tr>
+
+<tr>
+
+<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">one-of</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">List of strings, enclosed and separated by <code><font face="courier, monospaced">|</font></code></font></td>
+
+</tr>
+
+<tr>
+
+<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">min-len</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">positive integer</font></td>
+
+</tr>
+
+<tr>
+
+<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">max-len</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">positive integer</font></td>
+
+</tr>
+
+<tr>
+
+<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">min</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">Double / Long</font></td>
+
+</tr>
+
+<tr>
+
+<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">max</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">Double / Long</font></td>
+
+</tr>
+
+</table>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Constraints can be defined globally for a parameter and can be overridden
+ by redefinition in a constraint-set. Thus if e.g. a database field can take
+ at maximum 200 character, this property can be set globally.
+ </font>
+</p>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Values in parameter arrays are validated individually and the worst
+ error is reported back.
+ </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>
+
+<?xml version="1.0"?>
+<root>
+
+ <parameter name="persons" type="long" min="1" default="4" nullable="no"/>
+ <parameter name="deposit" type="double" min="10.0" max="999.99"/>
+ <parameter name="email" type="string" max-len="50"
+ matches-regex="^[\d\w][\d\w\-_\.]*@([\d\w\-_]+\.)\w\w\w?$"/>
+ <parameter name="colour" type="string" one-of="|red|green|blue|white|"/>
+
+ <constraint-set name="car-reservation">
+ <validate name="persons"/>
+ <validate name="deposit" min="50.0"/>
+ <validate name="email"/>
+ </constraint-set>
+
+</root>
+
+ </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">
+ The above could for example describe expected input from a reservation
+ form. Specifications in a constraint set take precedence over the general
+ ones.
+ </font>
+</p>
+
+
+
+
+
<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>XSP Usage</b></font>
+
<p>
<font color="black" face="verdana,helvetica,sanserif">
- To give the user some feedback why her/his submitted data was rejected
- there is a special taglib "xsp-formval". Declare its name space as
- usual.
+ To give the user some feedback why her/his submitted data was rejected
+ there is a special taglib "xsp-formval". Declare its name space as usual.
</font>
</p>
+
<p>
<font color="black" face="verdana,helvetica,sanserif">
- If only interested in validation results, just:
+ If only interested in validation results, just:
</font>
</p>
-
+
+
<div align="center">
<table border="0" cellpadding="0" cellspacing="4">
<tr>
@@ -282,7 +468,7 @@
<myapp:error>(ERROR)</myapp:error>
</xsp-formval:on-ok>
- </pre>
+ </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>
@@ -290,14 +476,16 @@
</tr>
</table>
</div>
-
+
+
<p>
<font color="black" face="verdana,helvetica,sanserif">
- Alternatively, if you just want a boolean value from the logicsheet
- if a test is successful, use this method:
- </font>
+ Alternatively, if you just want a boolean value from the logicsheet if a
+ test is successful, use this method:
+ </font>
</p>
-
+
+
<div align="center">
<table border="0" cellpadding="0" cellspacing="4">
<tr>
@@ -308,12 +496,12 @@
<pre>
<xsp:logic>
- if (!<xsp-formval:is-ok name="persons"/>) {
- <myapp:error>(ERROR)</myapp:error>
+ if (!<xsp-formval:is-ok name="persons"/>) {
+ <myapp:error>(ERROR)</myapp:error>
};
</xsp:logic>
- </pre>
+ </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>
@@ -321,115 +509,105 @@
</tr>
</table>
</div>
-
+
+
<p>
<font color="black" face="verdana,helvetica,sanserif">
- Internationalization issues are a separate concern and are not
- discussed here.
- </font>
+ Internationalization issues are a separate concern and are not discussed
+ here.
+ </font>
</p>
-
+
<p>
<font color="black" face="verdana,helvetica,sanserif">
Currently the following validation result codes are supported:
- </font>
+ </font>
</p>
-
+
+
<table cellpadding="2" cellspacing="2" border="0" width="100%">
<caption>
<font face="verdana,helvetica,sanserif"></font>
</caption>
-
+
<tr>
<td align="center" valign="center" rowspan="1" colspan="1" bgcolor="#039acc"><font face="verdana,helvetica,sanserif" size="-1" color="white"><b>tag</b></font></td><td align="center" valign="center" rowspan="1" colspan="1" bgcolor="#039acc"><font face="verdana,helvetica,sanserif" size="-1" color="white"><b>Meaning</b></font></td>
</tr>
-
+
<tr>
-<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-ok</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">no error occurred,
- parameter successfully
- checked</font></td>
+<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-ok</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">no error occurred, parameter
+ successfully checked</font></td>
</tr>
-
+
<tr>
-<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-error</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">some error occurred,
- this is a result that
- is never set but serves
- as a comparison target
- </font></td>
+<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-error</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">some error occurred, this is a result
+ that is never set but serves as a comparison target
+ </font></td>
</tr>
-
+
<tr>
<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-null</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">the parameter is null but
- isn't allowed to</font></td>
+ isn't allowed to</font></td>
</tr>
-
+
<tr>
-<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-toosmall</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">either value or
- length in case of a
- string is less than
- the specified
- minimum</font></td>
+<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-toosmall</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">either value or length in case of
+ a string is less than the specified minimum</font></td>
</tr>
-
+
<tr>
-<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-toolarge</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">either value or
- length in case of a
- string is greater
- than the specified
- maximum</font></td>
-</tr>
-
+<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-toolarge</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">either value or length in case of
+ a string is greater than the specified maximum</font></td>
+</tr>
+
<tr>
-<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-nomatch</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">a string parameter's
- value is not matched
- by the specified
- regular expression</font></td>
+<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-nomatch</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">a string parameter's value is not
+ matched by the specified regular expression</font></td>
</tr>
-
+
<tr>
-<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-notpresent</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">this is returned
- when the result of
- a validation is
- requested but no
- such result is
- found in the
- request attribute </font></td>
+<td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">xsp-formval:is-notpresent</font></td><td align="left" valign="top" rowspan="1" colspan="1" bgcolor="#a0ddf0"><font face="verdana,helvetica,sanserif" size="-1" color="black">this is returned when the result
+ of a validation is requested but no such result is found in the request
+ attribute </font></td>
</tr>
-
+
</table>
-
+
+
<p>
<font color="black" face="verdana,helvetica,sanserif">
- For debugging purposes or if you would like to iterate over the
- validation results, <code><font face="courier, monospaced">xsp-formval:results</font></code> returns a
+ For debugging purposes or if you would like to iterate over the validation
+ results, <code><font face="courier, monospaced">xsp-formval:results</font></code> returns a
<code><font face="courier, monospaced">java.util.Map</font></code> containing them all.
- </font>
+ </font>
</p>
-
+
+
<p>
<font color="black" face="verdana,helvetica,sanserif">
- If you would like to be more specific what went wrong, you can
- query the descriptor file for attributes.
- </font>
+ If you would like to be more specific what went wrong, you can query the
+ descriptor file for attributes.
+ </font>
</p>
-
+
+
<p>
<font color="black" face="verdana,helvetica,sanserif">
- First set the url of the file or resource that contains the
- parameter descriptions and constraint sets. This needs to be an
- ancestor to all other tags (of this taglib). Multiple use of this
- tag is allowed (although probably not necessary).
- </font>
+ First set the url of the file or resource that contains the parameter
+ descriptions and constraint sets. This needs to be an ancestor to all
+ other tags (of this taglib). Multiple use of this tag is allowed (although
+ probably not necessary).
+ </font>
</p>
-
+
+
<p>
-<font color="black" face="verdana,helvetica,sanserif">
- You need to do this only if you plan to query the
- descriptor file or if you'd like to use the shorthand
- below.
- </font>
+<font color="black" face="verdana,helvetica,sanserif"> You need to do this only if you plan to query the descriptor file or if
+ you'd like to use the shorthand below.
+ </font>
</p>
-
+
+
<div align="center">
<table border="0" cellpadding="0" cellspacing="4">
<tr>
@@ -444,7 +622,7 @@
<xsp-formval:get-attribute parameter="deposit" name="min"/>
</xsp-formval:descriptor>
- </pre>
+ </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>
@@ -452,26 +630,28 @@
</tr>
</table>
</div>
-
+
+
<p>
<font color="black" face="verdana,helvetica,sanserif">
- If you need to use one parameter a lot, there's a short hand. Use
- this e.g. if you'd like to set up the properties of an input tag
- according to the information from the descriptor file or if you'd
- like to give detailed error messages.
- </font>
+ If you need to use one parameter a lot, there's a short hand. Use this
+ e.g. if you'd like to set up the properties of an input tag according to
+ the information from the descriptor file or if you'd like to give detailed
+ error messages.
+ </font>
</p>
-
+
+
<p>
<font color="black" face="verdana,helvetica,sanserif">
- Note that you can specify additional attributes in the
- description file that are not understood (and therefore ignored)
- by the FormValidatorAction but that could be queried here. This
- might be e.g. the size of the input field which might be
- different from the max-len a parameter can take.
- </font>
+ Note that you can specify additional attributes in the description file
+ that are not understood (and therefore ignored) by the FormValidatorAction
+ but that could be queried here. This might be e.g. the size of the input
+ field which might be different from the max-len a parameter can take.
+ </font>
</p>
-
+
+
<div align="center">
<table border="0" cellpadding="0" cellspacing="4">
<tr>
@@ -501,7 +681,7 @@
</xsp-formval:validate>
</xsp-formval:descriptor>
- </pre>
+ </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>
@@ -509,8 +689,117 @@
</tr>
</table>
</div>
-
+
+
+
+<font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>SimpleFormTransformer</b></font>
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ An alternative solution to using the <code><font face="courier, monospaced">formval</font></code> logicsheet and
+ XSP is to use the <code><font face="courier, monospaced">SimpleFormTransformer</font></code>. If fills the form
+ with values obtained from request parameters, overwriting existing
+ values. Hence the data entered by the user is not discarded when it does
+ not validate successfully.
+ </font>
+</p>
+
+
+<p>
+<table border="0" cellpadding="0" cellspacing="3" width="100%">
+<tr>
+<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>
+ Beware when using the <code><font face="courier, monospaced">SimpleFormTransformer</font></code> together with
+ XSP: The observer behaviour can be very confusing when trying to set a
+ value from XSP and it is silently overwritten by the transformer!
+ </i></font></td>
+</tr>
+</table>
+</p>
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ When a form element carries the attribute <code><font face="courier, monospaced">fixed="true"</font></code>, the
+ transformer does not replace the value.
+ </font>
+</p>
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Feedback can be given to the user through <code><font face="courier, monospaced"><error/></font></code>
+ tags. Error tags need to have a name attribute identical to the input
+ element they refer to. Multiple error elements may be present for any
+ input element. The <code><font face="courier, monospaced">FormValidatorAction</font></code> sets a special field
+ <code><font face="courier, monospaced">*</font></code> that indicates whether all parameters were validated
+ successfully or not.
+ </font>
+</p>
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ An error element is omitted together with all contents whenever the
+ specified condition is not met. Conditions are either exact or greater
+ equal constraints indicated by the attribute <code><font face="courier, monospaced">when</font></code> or
+ <code><font face="courier, monospaced">when-ge</font></code> respectively.
+ </font>
+</p>
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Allowed values for error conditions are: <code><font face="courier, monospaced">ok, not-present, error,
+ is-null, too-small, too-large, no-match </font></code>
+ </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>
+
+ <input name="email" type="text"/><error name="email" when-ge="error">*</error>
+ <!-- ... -->
+ <error name="email" when="is-null">Please enter your email address.</errro>
+ <error name="email" when="no-match">Please enter a <em>syntacticly</em> correct
+ email address.</errro>
+
+ </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>Other Validations</b></font>
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ In addition to validating form input, other actions exists that validate
+ values from different sources using the same techniques and syntax. For
+ example, the <code><font face="courier, monospaced">SessionValidatorAction</font></code> operates on session
+ attributes.
+ </font>
+</p>
+
+
+
+
+
</td>
---------------------------------------------------------------------
To unsubscribe, e-mail: general-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: general-cvs-help@xml.apache.org