Modified: cocoon/site/site/2.1/userdocs/concepts/errorhandling.html URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/userdocs/concepts/errorhandling.html?view=diff&r1=159368&r2=159369 ============================================================================== --- cocoon/site/site/2.1/userdocs/concepts/errorhandling.html (original) +++ cocoon/site/site/2.1/userdocs/concepts/errorhandling.html Tue Mar 29 05:47:29 2005 @@ -2,14 +2,18 @@ <html> <head> <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<meta content="Apache Forrest" name="Generator"> +<meta name="Forrest-version" content="0.6"> +<meta name="Forrest-skin-name" content="forrest-site"> <title>Error Handling</title> <link type="text/css" href="../../skin/page.css" rel="stylesheet"> +<link rel="shortcut icon" href="../../"> </head> <body text="#000000" bgcolor="#FFFFFF"> <!--================= start Navigation Path ==================--> <table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td> +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><a href="http://www.apache.org/";>apache</a> > <a href="http://cocoon.apache.org/";>cocoon</a><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td> </tr> <tr> <td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> @@ -20,9 +24,9 @@ <table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> <!--================= start Group Logo ==================--> -<td bgcolor="#294563"><a href="http://cocoon.apache.org/";><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/cocoon-project-logo.png"></a></td> +<td bgcolor="#294563"><a href="http://cocoon.apache.org/";><img class="logoImage" alt="Apache Cocoon" src="../../images/cocoon-project-logo.png"></a></td> <!--================= end Group Logo ==================--> -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/";><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td> +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/";><img class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif" title="Apache Cocoon"></a></td> <!--================= end Project Logo ==================--> <!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563"> <form target="_blank" action="http://www.google.com/search"; method="get"> @@ -31,13 +35,13 @@ <td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> </tr> <tr> -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit"> +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="as_sitesearch" type="hidden"><input size="15" name="as_q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit"> <br> <font face="Arial, Helvetica, Sans-serif" size="2" color="white"> - the Apache Cocoon site - - - </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> + the Apache Cocoon site + + + </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> </tr> <tr> <td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td> @@ -45,7 +49,7 @@ </table> </form> </td> -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> +<!--================= end Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> </tr> <tr> <td valign="bottom" bgcolor="#294563" colspan="2"> @@ -64,10 +68,10 @@ </table> </div> <!--================= end Tabs ==================--> -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td> +</td><td bgcolor="#294563"></td> </tr> <tr> -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> +<td height="10" bgcolor="#4C6C8F" colspan="4"></td> </tr> </table> <!--================= end Banner ==================--> @@ -226,28 +230,8 @@ <tr> <td valign="middle"> <h1>Error Handling</h1> -</td><script language="Javascript" type="text/javascript"> -function printit() { -if (window.print) { - window.print() ; -} else { - var WebBrowser = '<OBJECT ID="WebBrowser1" WIDTH="0" HEIGHT="0" CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2"></OBJECT>'; -document.body.insertAdjacentHTML('beforeEnd', WebBrowser); - WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box WebBrowser1.outerHTML = ""; -} -} -</script><script language="Javascript" type="text/javascript"> -var NS = (navigator.appName == "Netscape"); -var VERSION = parseInt(navigator.appVersion); -if (VERSION > 3) { - document.write('<td nowrap="nowrap" width="40" align="center">'); - document.write(' <a class="dida" href="javascript:printit()">'); - document.write(' <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>'); - document.write(' print</a>'); - document.write('</td>'); -} -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="errorhandling.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br> - PDF</a></td> +</td><td nowrap="nowrap" width="40" align="center"><a class="dida" href="errorhandling.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br> + PDF</a></td> </tr> </table> <ul class="minitoc"> @@ -266,284 +250,284 @@ </ul> </li> </ul> - + <a name="N10014"></a><a name="Error+Handling"></a> <h3>Error Handling</h3> <div style="margin-left: 0 ; border: 2px"> <p> - During the execution of a Cocoon pipeline exceptions may occur within the involved components like generators, transformers etc. There are two possibilities to deal with them: The one would be not to handle them explicitly in the sitemap, which causes them to be logged and a default Cocoon error page to be displayed in the browser. The second is to define an error handling by using the sitemap tag <map:handle-errors>. Therein you are able to define any pipeline, that is executed in case of an exception occurred and displays an appropriate page. - </p> + During the execution of a Cocoon pipeline exceptions may occur within the involved components like generators, transformers etc. There are two possibilities to deal with them: The one would be not to handle them explicitly in the sitemap, which causes them to be logged and a default Cocoon error page to be displayed in the browser. The second is to define an error handling by using the sitemap tag <map:handle-errors>. Therein you are able to define any pipeline, that is executed in case of an exception occurred and displays an appropriate page. + </p> <a name="N1001C"></a><a name="ExceptionSelector"></a> <h4>ExceptionSelector</h4> <div style="margin-left: 0 ; border: 2px"> <p> - The ExceptionSelector allows to realize conditional error handling within <map:handle-errors>-tags depending on the type of the occurred exception. Each exception is configured centrally at the selector in the sitemap by associating a symbolic name to its class. - </p> + The ExceptionSelector allows to realize conditional error handling within <map:handle-errors>-tags depending on the type of the occurred exception. Each exception is configured centrally at the selector in the sitemap by associating a symbolic name to its class. + </p> <p> - Furthermore it is possible to define, what exceptions are to be "unrolled". This means, that if an exception has been rethrown embedded in another exception, this original exception can be considered for choosing the correct error handling. - </p> + Furthermore it is possible to define, what exceptions are to be "unrolled". This means, that if an exception has been rethrown embedded in another exception, this original exception can be considered for choosing the correct error handling. + </p> <p> - Example: - </p> + Example: + </p> <pre class="code"> - + <map:selector name="exception" src="org.apache.cocoon.selection.ExceptionSelector"> - <exception name="processing" class="ProcessingException" unroll="true"/> - <exception name="sax" class="SAXException"/> - <exception name="application" class="ApplicationException"/> + <exception name="processing" class="ProcessingException" unroll="true"/> + <exception name="sax" class="SAXException"/> + <exception name="application" class="ApplicationException"/> </map:selector> ... <map:pipeline> - <map:match pattern="resource"> - ... - </map:match> - <map:handle-errors> - <map:select type="exception"> - <map:when test="processing">...</map:when> - <map:when test="sax">...</map:when> - <map:when test="application">...</map:when> - </map:select> - </map:handle-errors> + <map:match pattern="resource"> + ... + </map:match> + <map:handle-errors> + <map:select type="exception"> + <map:when test="processing">...</map:when> + <map:when test="sax">...</map:when> + <map:when test="application">...</map:when> + </map:select> + </map:handle-errors> </map:pipeline> - - </pre> + + </pre> <p> - Let's consider the following nested exceptions to occur: - </p> + Let's consider the following nested exceptions to occur: + </p> <ol> - + <li> - ProcessingException ( ApplicationException ): The ProcessingException is unrolled, so the error pipeline for "application" will be executed. - </li> - -<li> - ProcessingException ( ValidationException ): Since ValidationException is not configured at all and therefore unknown, the ProcessingException is not unrolled even if unrolling is enabled. Therefore the pipeline for "processing" will be executed. - </li> - -<li> - SAXException ( ApplicationException ): The unrolling is not enabled for SAXException, so the pipeline for "sax" will be executed. - </li> - + ProcessingException ( ApplicationException ): The ProcessingException is unrolled, so the error pipeline for "application" will be executed. + </li> + +<li> + ProcessingException ( ValidationException ): Since ValidationException is not configured at all and therefore unknown, the ProcessingException is not unrolled even if unrolling is enabled. Therefore the pipeline for "processing" will be executed. + </li> + +<li> + SAXException ( ApplicationException ): The unrolling is not enabled for SAXException, so the pipeline for "sax" will be executed. + </li> + </ol> <p> - Please notice that the selector configuration is processed from top to bottom and stops at the first matching exception. Therefore the most specific classes must be configured first. This behaviour is the same as with Java catch statements. - </p> + Please notice that the selector configuration is processed from top to bottom and stops at the first matching exception. Therefore the most specific classes must be configured first. This behaviour is the same as with Java catch statements. + </p> </div> -<a name="N10042"></a><a name="XPathExceptionSelector"></a> +<a name="N10041"></a><a name="XPathExceptionSelector"></a> <h4>XPathExceptionSelector</h4> <div style="margin-left: 0 ; border: 2px"> <p> - The XPathExceptionSelector is an extension to the standard selector described above. It adds the possibility to configure additional conditions for each exception type by using JXPath expressions, that operate on the exception object. This configuration is also done centrally at the selector in the sitemap, where symbolic names are defined for all specific error situations. - </p> + The XPathExceptionSelector is an extension to the standard selector described above. It adds the possibility to configure additional conditions for each exception type by using JXPath expressions, that operate on the exception object. This configuration is also done centrally at the selector in the sitemap, where symbolic names are defined for all specific error situations. + </p> <p> - Example: - </p> + Example: + </p> <pre class="code"> - + <map:selector name="exception" src="org.apache.cocoon.selection.XPathExceptionSelector"> - <exception name="Denied" class="AuthenticationFailure"> - <xpath name="PasswordWrong" test="authCode=10"/> - <xpath name="PasswordExpired" test="errorCode=11"/> - <xpath name="AccessForbidden" test="errorCode&gt;11"/> - </exception> + <exception name="Denied" class="AuthenticationFailure"> + <xpath name="PasswordWrong" test="authCode=10"/> + <xpath name="PasswordExpired" test="errorCode=11"/> + <xpath name="AccessForbidden" test="errorCode&gt;11"/> + </exception> </map:selector> ... <map:pipeline> - <map:match pattern="login"> - ... - </map:match> - <map:handle-errors> - <map:select type="exception"> - <map:when test="PasswordWrong">...</map:when> - <map:when test="PasswordExpired">...</map:when> - <map:when test="AccessForbidden">...</map:when> - <map:when test="Denied">...</map:when> - <map:otherwise>...</map:otherwise> - </map:select> - </map:handle-errors> + <map:match pattern="login"> + ... + </map:match> + <map:handle-errors> + <map:select type="exception"> + <map:when test="PasswordWrong">...</map:when> + <map:when test="PasswordExpired">...</map:when> + <map:when test="AccessForbidden">...</map:when> + <map:when test="Denied">...</map:when> + <map:otherwise>...</map:otherwise> + </map:select> + </map:handle-errors> </map:pipeline> - - </pre> + + </pre> <p> - In this example the exception AuthenticationFailure is configured under name "Denied". Additionally three further conditions "PasswordWrong", "PasswordExpired" and "AccessForbidden" are defined by using JXPath expressions. Therefore instances of AuthenticationFailure are expected to have methods getAuthCode() and getErrorCode(). Now the error handler defined for resource "login" has five branches: If situation "PasswordWrong" occurs, which means that an AuthenticationFailure exception with auth code 10 has been thrown, the first error pipeline is executed. If the error code equals to 11 the second pipeline is executed, if it is greater that 11 the third one and all other AuthenticationFailure errors are handled by the fourth one. In any other error situation the fifth branch would be chosen. - </p> + In this example the exception AuthenticationFailure is configured under name "Denied". Additionally three further conditions "PasswordWrong", "PasswordExpired" and "AccessForbidden" are defined by using JXPath expressions. Therefore instances of AuthenticationFailure are expected to have methods getAuthCode() and getErrorCode(). Now the error handler defined for resource "login" has five branches: If situation "PasswordWrong" occurs, which means that an AuthenticationFailure exception with auth code 10 has been thrown, the first error pipeline is executed. If the error code equals to 11 the second pipeline is executed, if it is greater that 11 the third one and all other AuthenticationFailure errors are handled by the fourth one. In any other error situation the fifth branch would be chosen. + </p> <p> - Please notice that the selector stops when it finds the first JXPath expression in the configuration that matches: - </p> + Please notice that the selector stops when it finds the first JXPath expression in the configuration that matches: + </p> <p> - Example: - </p> + Example: + </p> <pre class="code"> - - <map:selector name="exception" src="org.apache.cocoon.selection.XPathExceptionSelector"> - <exception name="application" class="ApplicationException"> - <xpath name="error3" test="errorCode&gt;3"/> - <xpath name="error6" test="errorCode&gt;6"/> - </exception> - </map:selector> - ... - <map:pipeline> - <map:match pattern="processForm"> - ... - </map:match> - <map:handle-errors> - <map:select type="exception"> - <map:when test="error6">...</map:when> <!-- handler 1 --> - <map:when test="error3">...</map:when> <!-- handler 2 --> - </map:select> - </map:handle-errors> - </map:pipeline> - - </pre> + + <map:selector name="exception" src="org.apache.cocoon.selection.XPathExceptionSelector"> + <exception name="application" class="ApplicationException"> + <xpath name="error3" test="errorCode&gt;3"/> + <xpath name="error6" test="errorCode&gt;6"/> + </exception> + </map:selector> + ... + <map:pipeline> + <map:match pattern="processForm"> + ... + </map:match> + <map:handle-errors> + <map:select type="exception"> + <map:when test="error6">...</map:when> <!-- handler 1 --> + <map:when test="error3">...</map:when> <!-- handler 2 --> + </map:select> + </map:handle-errors> + </map:pipeline> + + </pre> <p> - If an ApplicationException with error code 9 occurs, handler 2 is executed since error situation "error3" is configured before "error6" at the selector even if the expression for "error6" also evaluates to "true". - </p> + If an ApplicationException with error code 9 occurs, handler 2 is executed since error situation "error3" is configured before "error6" at the selector even if the expression for "error6" also evaluates to "true". + </p> </div> -<a name="N10064"></a><a name="Error+Handler+Hierarchy"></a> +<a name="N10061"></a><a name="Error+Handler+Hierarchy"></a> <h4>Error Handler Hierarchy</h4> <div style="margin-left: 0 ; border: 2px"> <p> - The tag <map:handle-errors> may be attached to any <map:pipeline> or the <map:pipelines> tag of the root sitemap or a subsitemap. Therefore it is possible to define two kinds of error handlers: A default handler may be defined within <map:pipelines> for applying to all resources of a sitemap. Alternatively individual handlers may be configured for sets of resources within <map:pipeline>. - </p> + The tag <map:handle-errors> may be attached to any <map:pipeline> or the <map:pipelines> tag of the root sitemap or a subsitemap. Therefore it is possible to define two kinds of error handlers: A default handler may be defined within <map:pipelines> for applying to all resources of a sitemap. Alternatively individual handlers may be configured for sets of resources within <map:pipeline>. + </p> <p> - Example: - </p> + Example: + </p> <pre class="code"> - + <map:pipelines> - <map:pipeline name="pipe1"> - <map:match pattern="res1"> - ... - </map:match> - <map:handle-errors> - <!-- this is an individual handler for pipe1 --> - </map:handle-errors> - </map:pipeline> - <map:pipeline name="pipe2"> - <map:match pattern="res2"> - ... - </map:match> - </map:pipeline> - <map:pipeline name="pipe3"> - <map:match pattern="res3"> - ... - </map:match> - </map:pipeline> - <map:handle-errors> - <!-- this is the default handler for the whole sitemap --> - </map:handle-errors> + <map:pipeline name="pipe1"> + <map:match pattern="res1"> + ... + </map:match> + <map:handle-errors> + <!-- this is an individual handler for pipe1 --> + </map:handle-errors> + </map:pipeline> + <map:pipeline name="pipe2"> + <map:match pattern="res2"> + ... + </map:match> + </map:pipeline> + <map:pipeline name="pipe3"> + <map:match pattern="res3"> + ... + </map:match> + </map:pipeline> + <map:handle-errors> + <!-- this is the default handler for the whole sitemap --> + </map:handle-errors> </map:pipelines> - - </pre> + + </pre> <p> - In conjunction with the ExceptionSelector resp. the XPathExceptionSelector it is possible to define a hierarchy of error handlers for an application. The behaviour then is the following: If an error occurs within a pipeline, Cocoon at first checks if an individual handler for this pipeline is defined. If so and it is able to handle the error due to its selection the processing terminates. Otherwise Cocoon looks for a default handler of the current sitemap. If one is found it is called. Now there is the same behaviour as above: If it can handle the exception the processing terminates otherwise the searching proceeds within the pipeline where the subsitemap is mounted. This goes on until the default handler of the root sitemap has been considered. If an error could not be handled at all, it is processed by the Cocoon engine in the end. - </p> + In conjunction with the ExceptionSelector resp. the XPathExceptionSelector it is possible to define a hierarchy of error handlers for an application. The behaviour then is the following: If an error occurs within a pipeline, Cocoon at first checks if an individual handler for this pipeline is defined. If so and it is able to handle the error due to its selection the processing terminates. Otherwise Cocoon looks for a default handler of the current sitemap. If one is found it is called. Now there is the same behaviour as above: If it can handle the exception the processing terminates otherwise the searching proceeds within the pipeline where the subsitemap is mounted. This goes on until the default handler of the root sitemap has been considered. If an error could not be handled at all, it is processed by the Cocoon engine in the end. + </p> <p> - Please notice that a <map:otherwise> breaks the hierarchy since all errors will be handled on this level. Therefore all levels above will be called never. - </p> + Please notice that a <map:otherwise> breaks the hierarchy since all errors will be handled on this level. Therefore all levels above will be called never. + </p> <p> - Example: - </p> + Example: + </p> <pre class="code"> - + Root sitemap: <map:pipelines> - <map:pipeline> - <map:mount uri-prefix="sub" src="sub/"/> - <map:handle-errors> - <map:select type="exception"> - <map:when test="resourceNotFound">...</map:when> - </map:select> - </map:handle-errors> - </map:pipeline> - <map:handle-errors> - <map:generate src="generalerror.htm"/> - <map:serialize/> - </map:handle-errors> + <map:pipeline> + <map:mount uri-prefix="sub" src="sub/"/> + <map:handle-errors> + <map:select type="exception"> + <map:when test="resourceNotFound">...</map:when> + </map:select> + </map:handle-errors> + </map:pipeline> + <map:handle-errors> + <map:generate src="generalerror.htm"/> + <map:serialize/> + </map:handle-errors> </map:pipelines> Subsitemap: <map:pipelines> - <map:pipeline> - <map:match pattern="processForm"> - ... - </map:match> - <map:handle-errors> - <map:select type="exception"> - <map:when test="validation">...</map:when> - </map:select> - </map:handle-errors> - </map:pipeline> - <map:handle-errors> - <map:select type="exception"> - <map:when test="application">...</map:when> - </map:select> - </map:handle-errors> + <map:pipeline> + <map:match pattern="processForm"> + ... + </map:match> + <map:handle-errors> + <map:select type="exception"> + <map:when test="validation">...</map:when> + </map:select> + </map:handle-errors> + </map:pipeline> + <map:handle-errors> + <map:select type="exception"> + <map:when test="application">...</map:when> + </map:select> + </map:handle-errors> </map:pipelines> - - </pre> + + </pre> <p> - Let's consider four situations concerning the above example: - </p> + Let's consider four situations concerning the above example: + </p> <ol> - + <li> - A ValidationException occurs, because for instance the user entered an invalid value: The defined pipeline's handler is called. Since it has a matching <map:when>-section it is able to handle such an exception and therefore the processing is finished. - </li> - -<li> - An ApplicationException occurs, because for instance a database connection has failed: The pipeline's handler is not able to handle the exception, so next the subsitemap's default handler is called. It has a matching <map:when>-section and is therefore able to handle the exception. - </li> - -<li> - A ResourceNotFoundException occurs, because for instance some file is missing. Both the pipeline's and the subsitemaps' handlers are not able to handle it. Now Cocoon proceeds after the mount point of the subsitemap and finds its pipeline's handler next. It is able to handle a ResourceNotFoundException and therefore produces the output in this case. - </li> - -<li> - A NullPointerException occurs, because something went completely wrong in the application: All handlers are not configured for such an exception and so the root sitemaps default handler will apply to it showing a general error page. - </li> - + A ValidationException occurs, because for instance the user entered an invalid value: The defined pipeline's handler is called. Since it has a matching <map:when>-section it is able to handle such an exception and therefore the processing is finished. + </li> + +<li> + An ApplicationException occurs, because for instance a database connection has failed: The pipeline's handler is not able to handle the exception, so next the subsitemap's default handler is called. It has a matching <map:when>-section and is therefore able to handle the exception. + </li> + +<li> + A ResourceNotFoundException occurs, because for instance some file is missing. Both the pipeline's and the subsitemaps' handlers are not able to handle it. Now Cocoon proceeds after the mount point of the subsitemap and finds its pipeline's handler next. It is able to handle a ResourceNotFoundException and therefore produces the output in this case. + </li> + +<li> + A NullPointerException occurs, because something went completely wrong in the application: All handlers are not configured for such an exception and so the root sitemaps default handler will apply to it showing a general error page. + </li> + </ol> <p> - When handling exceptions in error handlers one has to take care about recursion when working with redirects. Consider the following sitemap: - </p> + When handling exceptions in error handlers one has to take care about recursion when working with redirects. Consider the following sitemap: + </p> <p> - Example: - </p> + Example: + </p> <pre class="code"> - + <map:pipelines> - <map:pipeline> - <map:match pattern="resource"> - ... - <map:transformer type="foo"/> - ... - </map:match> - <map:match pattern="error"> - ... - <map:transformer type="foo"/> - ... - </map:match> - <map:handle-errors> - <map:select type="exception"> - <map:when test="connection"> - <map:act type="redirect" src="cocoon:/error"/> - </map:when> - </map:select> - </map:handle-errors> - </map:pipeline> + <map:pipeline> + <map:match pattern="resource"> + ... + <map:transformer type="foo"/> + ... + </map:match> + <map:match pattern="error"> + ... + <map:transformer type="foo"/> + ... + </map:match> + <map:handle-errors> + <map:select type="exception"> + <map:when test="connection"> + <map:act type="redirect" src="cocoon:/error"/> + </map:when> + </map:select> + </map:handle-errors> + </map:pipeline> </map:pipelines> - - </pre> + + </pre> <p> - This configuration may lead to an infinite loop: Imagine to call "resource" where the FooTransformer throws a ConnectionException, because the connection to a backend system has broken. The defined error handler will handle it and the used action internally redirects to resource "error". This resource itself uses the FooTransformer to get some data from the backend, which of cause also causes a ConnectionException. This is handled by the error handler, which redirects to resource "error" and so on. Such an infinite loop may also occur when using several "nested" redirects, i.e. the error handler redirects to a resource, which redirects to another resource, which might produce the original exception. - </p> + This configuration may lead to an infinite loop: Imagine to call "resource" where the FooTransformer throws a ConnectionException, because the connection to a backend system has broken. The defined error handler will handle it and the used action internally redirects to resource "error". This resource itself uses the FooTransformer to get some data from the backend, which of cause also causes a ConnectionException. This is handled by the error handler, which redirects to resource "error" and so on. Such an infinite loop may also occur when using several "nested" redirects, i.e. the error handler redirects to a resource, which redirects to another resource, which might produce the original exception. + </p> <p> - When defining error handlers for an application such situation must be avoided. An easy rule would be: An error handling routine must never redirect to a resource for which the routine itself is responsible and which might produce the same error as just handled. - </p> + When defining error handlers for an application such situation must be avoided. An easy rule would be: An error handling routine must never redirect to a resource for which the routine itself is responsible and which might produce the same error as just handled. + </p> </div> </div> - + <div class="attribution">by Björn Lütkemeier</div> </div> </td><td width="10"><img width="10" height="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> @@ -557,11 +541,14 @@ <!--================= start Footer ==================--> <table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0"> <tr> -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="/favicon.ico"></a></td> +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a></td> </tr> <tr> -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright © - 1999-2004 The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!-- +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif"><a href="http://www.apache.org/licenses/";> + Copyright © 1999-2005 + The Apache Software Foundation.</a> + All rights reserved. + <script type="text/javascript" language="JavaScript"><!-- document.write(" - "+"Last Published: " + document.lastModified); // --></script></font></td> </tr>
Modified: cocoon/site/site/2.1/userdocs/concepts/errorhandling.pdf URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/userdocs/concepts/errorhandling.pdf?view=diff&r1=159368&r2=159369 ============================================================================== Binary files - no diff available. Modified: cocoon/site/site/2.1/userdocs/concepts/index.html URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/userdocs/concepts/index.html?view=diff&r1=159368&r2=159369 ============================================================================== --- cocoon/site/site/2.1/userdocs/concepts/index.html (original) +++ cocoon/site/site/2.1/userdocs/concepts/index.html Tue Mar 29 05:47:29 2005 @@ -2,14 +2,18 @@ <html> <head> <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<meta content="Apache Forrest" name="Generator"> +<meta name="Forrest-version" content="0.6"> +<meta name="Forrest-skin-name" content="forrest-site"> <title>Understanding Apache Cocoon</title> <link type="text/css" href="../../skin/page.css" rel="stylesheet"> +<link rel="shortcut icon" href="../../"> </head> <body text="#000000" bgcolor="#FFFFFF"> <!--================= start Navigation Path ==================--> <table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td> +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><a href="http://www.apache.org/";>apache</a> > <a href="http://cocoon.apache.org/";>cocoon</a><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td> </tr> <tr> <td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> @@ -20,9 +24,9 @@ <table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> <!--================= start Group Logo ==================--> -<td bgcolor="#294563"><a href="http://cocoon.apache.org/";><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/cocoon-project-logo.png"></a></td> +<td bgcolor="#294563"><a href="http://cocoon.apache.org/";><img class="logoImage" alt="Apache Cocoon" src="../../images/cocoon-project-logo.png"></a></td> <!--================= end Group Logo ==================--> -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/";><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td> +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/";><img class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif" title="Apache Cocoon"></a></td> <!--================= end Project Logo ==================--> <!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563"> <form target="_blank" action="http://www.google.com/search"; method="get"> @@ -31,13 +35,13 @@ <td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> </tr> <tr> -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit"> +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="as_sitesearch" type="hidden"><input size="15" name="as_q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit"> <br> <font face="Arial, Helvetica, Sans-serif" size="2" color="white"> - the Apache Cocoon site - - - </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> + the Apache Cocoon site + + + </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> </tr> <tr> <td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td> @@ -45,7 +49,7 @@ </table> </form> </td> -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> +<!--================= end Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> </tr> <tr> <td valign="bottom" bgcolor="#294563" colspan="2"> @@ -64,10 +68,10 @@ </table> </div> <!--================= end Tabs ==================--> -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td> +</td><td bgcolor="#294563"></td> </tr> <tr> -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> +<td height="10" bgcolor="#4C6C8F" colspan="4"></td> </tr> </table> <!--================= end Banner ==================--> @@ -204,28 +208,8 @@ <tr> <td valign="middle"> <h1>Understanding Apache Cocoon</h1> -</td><script language="Javascript" type="text/javascript"> -function printit() { -if (window.print) { - window.print() ; -} else { - var WebBrowser = '<OBJECT ID="WebBrowser1" WIDTH="0" HEIGHT="0" CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2"></OBJECT>'; -document.body.insertAdjacentHTML('beforeEnd', WebBrowser); - WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box WebBrowser1.outerHTML = ""; -} -} -</script><script language="Javascript" type="text/javascript"> -var NS = (navigator.appName == "Netscape"); -var VERSION = parseInt(navigator.appVersion); -if (VERSION > 3) { - document.write('<td nowrap="nowrap" width="40" align="center">'); - document.write(' <a class="dida" href="javascript:printit()">'); - document.write(' <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>'); - document.write(' print</a>'); - document.write('</td>'); -} -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="index.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br> - PDF</a></td> +</td><td nowrap="nowrap" width="40" align="center"><a class="dida" href="index.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br> + PDF</a></td> </tr> </table> <ul class="minitoc"> @@ -293,6 +277,17 @@ </li> <li> <a href="#Ways+of+Creating+XSPs">Ways of Creating XSPs</a> +<ul class="minitoc"> +<li> +<a href="#Embedded+Logic">Embedded Logic</a> +</li> +<li> +<a href="#Included+Logicsheet">Included Logicsheet</a> +</li> +<li> +<a href="#Logicsheet+as+tag+library">Logicsheet as tag library</a> +</li> +</ul> </li> <li> <a href="#Sitemap">Sitemap</a> @@ -639,7 +634,7 @@ </pre> <p>An XSP page is used by a generator to generate XML document.</p> </div> -<a name="N101BC"></a><a name="XSP+Processing+%28Code+Generation%29"></a> +<a name="N101BB"></a><a name="XSP+Processing+%28Code+Generation%29"></a> <h4>XSP Processing (Code Generation)</h4> <div style="margin-left: 0 ; border: 2px"> <pre class="code"> @@ -668,10 +663,10 @@ } </pre> </div> -<a name="N101C7"></a><a name="Ways+of+Creating+XSPs"></a> +<a name="N101C5"></a><a name="Ways+of+Creating+XSPs"></a> <h4>Ways of Creating XSPs</h4> <div style="margin-left: 0 ; border: 2px"> -<a name="N101CC"></a><a name="Embedded+Logic"></a> +<a name="N101CA"></a><a name="Embedded+Logic"></a> <h5>Embedded Logic</h5> <div style="margin-left: 0 ; border: 2px"> <ul> @@ -686,7 +681,7 @@ <div align="center"> <img class="figure" alt="ways of creating xsp's" src="images/xsp-way.gif" height="384" width="323"></div> </div> -<a name="N101E4"></a><a name="Included+Logicsheet"></a> +<a name="N101E2"></a><a name="Included+Logicsheet"></a> <h5>Included Logicsheet</h5> <div style="margin-left: 0 ; border: 2px"> <ul> @@ -701,7 +696,7 @@ <div align="center"> <img class="figure" alt="ways of creating xsp's" src="images/xsp-way2.gif" height="403" width="318"></div> </div> -<a name="N101FC"></a><a name="Logicsheet+as+tag+library"></a> +<a name="N101FA"></a><a name="Logicsheet+as+tag+library"></a> <h5>Logicsheet as tag library</h5> <div style="margin-left: 0 ; border: 2px"> <ul> @@ -717,7 +712,7 @@ <img class="figure" alt="ways of creating xsp's" src="images/xsp-way3.gif" height="409" width="344"></div> </div> </div> -<a name="N10218"></a><a name="Sitemap"></a> +<a name="N10216"></a><a name="Sitemap"></a> <h4>Sitemap</h4> <div style="margin-left: 0 ; border: 2px"> <pre class="code"> @@ -767,7 +762,7 @@ <p>Sitemap can be edited to add new elements.</p> <p>Sitemap is generated into a program and is compiled into an executable unit.</p> </div> -<a name="N1024A"></a><a name="Matchers"></a> +<a name="N10247"></a><a name="Matchers"></a> <h4>Matchers</h4> <div style="margin-left: 0 ; border: 2px"> <p>A Matcher attempts to match an URI with a specified pattern for dispatching the request to a specific processing pipeline.</p> @@ -798,7 +793,7 @@ </map:match </pre> </div> -<a name="N10275"></a><a name="Generators"></a> +<a name="N10270"></a><a name="Generators"></a> <h4>Generators</h4> <div style="margin-left: 0 ; border: 2px"> <p>A Generator is used to create an XML structure from an input source (file, directory, stream ...)</p> @@ -850,7 +845,7 @@ <p>An XSP generator applies all the logicsheets specified in the source XML file before generating the program.</p> <p>Generators cache the compiled programs for better runtime efficiency.</p> </div> -<a name="N102B8"></a><a name="Transformers"></a> +<a name="N102B1"></a><a name="Transformers"></a> <h4>Transformers</h4> <div style="margin-left: 0 ; border: 2px"> <p>A Transformer is used to map an input XML structure into another XML structure.</p> @@ -891,7 +886,7 @@ </map:match> </pre> </div> -<a name="N102EC"></a><a name="Serializers"></a> +<a name="N102E3"></a><a name="Serializers"></a> <h4>Serializers</h4> <div style="margin-left: 0 ; border: 2px"> <p>A Serializer is used to render an input XML structure into some other format (not necessarily XML)</p> @@ -937,7 +932,7 @@ </map:match> </pre> </div> -<a name="N1031D"></a><a name="Pipeline+Processing-N10312"></a> +<a name="N10312"></a><a name="Pipeline+Processing-N10312"></a> <h4>Pipeline Processing</h4> <div style="margin-left: 0 ; border: 2px"> <p>The sitemap configuration allows dynamic setup of processing pipelines consisting of a generator, multiple transformers and a serializer.</p> @@ -946,7 +941,7 @@ <div align="center"> <img class="figure" alt="Pipeline Entry" src="images/pipeline2.gif" height="341" width="379"></div> </div> -<a name="N10338"></a><a name="Logicsheets"></a> +<a name="N1032D"></a><a name="Logicsheets"></a> <h4>Logicsheets</h4> <div style="margin-left: 0 ; border: 2px"> <p>Logicsheets are XSL files with an associated namespace.</p> @@ -1009,7 +1004,7 @@ </div> <a name="cocoon-configuration"></a> - <a name="N10379"></a><a name="Apache+Cocoon+Configuration."></a> + <a name="N1036C"></a><a name="Apache+Cocoon+Configuration."></a> <h3>Apache Cocoon Configuration.</h3> <div style="margin-left: 0 ; border: 2px"> <p>Cocoon is highly configurable. Main configuration files, assuming Cocoon deployment as a servlet in a servlet container, are (directory locations assume Tomcat servlet container):</p> @@ -1031,7 +1026,7 @@ </div> <a name="work-area"></a> - <a name="N103A5"></a><a name="Apache+Cocoon+Work+Area"></a> + <a name="N10398"></a><a name="Apache+Cocoon+Work+Area"></a> <h3>Apache Cocoon Work Area</h3> <div style="margin-left: 0 ; border: 2px"> <p>Cocoon produces execution log entries for debugging/auditing.</p> @@ -1054,7 +1049,7 @@ </div> <a name="use-with-tomcat"></a> - <a name="N103CE"></a><a name="Use+with+Tomcat"></a> + <a name="N103C1"></a><a name="Use+with+Tomcat"></a> <h3>Use with Tomcat</h3> <div style="margin-left: 0 ; border: 2px"> <p>Download Tomcat from Apache site.</p> @@ -1084,18 +1079,21 @@ <!--================= start Footer ==================--> <table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0"> <tr> -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="/favicon.ico"></a></td> +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a></td> </tr> <tr> -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright © - 1999-2004 The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!-- +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif"><a href="http://www.apache.org/licenses/";> + Copyright © 1999-2005 + The Apache Software Foundation.</a> + All rights reserved. + <script type="text/javascript" language="JavaScript"><!-- document.write(" - "+"Last Published: " + document.lastModified); // --></script></font></td> </tr> <tr> <td colspan="2" align="left" bgcolor="#CFDCED" class="logos"> <div> -<a href="http://validator.w3.org/check/referer";><img width="88" height="31" alt="Valid HTML 4.01!" src="../../skin/images/valid-html401.png" class="logoImage"></a><a href="http://jigsaw.w3.org/css-validator/";><img width="88" height="31" alt="Valid CSS!" src="../../skin/images/vcss.png" class="logoImage"></a><img alt="" height="1" width="10" src="../../skin/images/spacer.gif"><a href="http://xml.apache.org/forrest/";><img border="0" alt="Built with Apache Forrest logo" src="../../images/built-with-forrest-button.png" width="88" height="31"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"></a> +<a href="http://validator.w3.org/check/referer";><img border="0" width="88" height="31" title="Valid HTML 4.01!" alt="Valid HTML 4.01!" src="../../skin/images/valid-html401.png" class="logoImage"></a><a href="http://jigsaw.w3.org/css-validator/";><img border="0" width="88" height="31" title="Valid CSS!" alt="Valid CSS!" src="../../skin/images/vcss.png" class="logoImage"></a><img alt="" height="1" width="10" src="../../skin/images/spacer.gif"><a href="http://forrest.apache.org/";><img border="0" alt="Built with Apache Forrest logo" src="../../images/built-with-forrest-button.png" width="88" height="31"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"></a> </div> </td> </tr> Modified: cocoon/site/site/2.1/userdocs/concepts/index.pdf URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/userdocs/concepts/index.pdf?view=diff&r1=159368&r2=159369 ============================================================================== Binary files - no diff available. Modified: cocoon/site/site/2.1/userdocs/concepts/matchers_selectors.html URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/userdocs/concepts/matchers_selectors.html?view=diff&r1=159368&r2=159369 ============================================================================== --- cocoon/site/site/2.1/userdocs/concepts/matchers_selectors.html (original) +++ cocoon/site/site/2.1/userdocs/concepts/matchers_selectors.html Tue Mar 29 05:47:29 2005 @@ -2,14 +2,18 @@ <html> <head> <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<meta content="Apache Forrest" name="Generator"> +<meta name="Forrest-version" content="0.6"> +<meta name="Forrest-skin-name" content="forrest-site"> <title>Using and Implementing Matchers and Selectors</title> <link type="text/css" href="../../skin/page.css" rel="stylesheet"> +<link rel="shortcut icon" href="../../"> </head> <body text="#000000" bgcolor="#FFFFFF"> <!--================= start Navigation Path ==================--> <table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td> +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><a href="http://www.apache.org/";>apache</a> > <a href="http://cocoon.apache.org/";>cocoon</a><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td> </tr> <tr> <td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> @@ -20,9 +24,9 @@ <table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> <!--================= start Group Logo ==================--> -<td bgcolor="#294563"><a href="http://cocoon.apache.org/";><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/cocoon-project-logo.png"></a></td> +<td bgcolor="#294563"><a href="http://cocoon.apache.org/";><img class="logoImage" alt="Apache Cocoon" src="../../images/cocoon-project-logo.png"></a></td> <!--================= end Group Logo ==================--> -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/";><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td> +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/";><img class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif" title="Apache Cocoon"></a></td> <!--================= end Project Logo ==================--> <!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563"> <form target="_blank" action="http://www.google.com/search"; method="get"> @@ -31,13 +35,13 @@ <td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> </tr> <tr> -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit"> +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="as_sitesearch" type="hidden"><input size="15" name="as_q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit"> <br> <font face="Arial, Helvetica, Sans-serif" size="2" color="white"> - the Apache Cocoon site - - - </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> + the Apache Cocoon site + + + </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> </tr> <tr> <td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td> @@ -45,7 +49,7 @@ </table> </form> </td> -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> +<!--================= end Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> </tr> <tr> <td valign="bottom" bgcolor="#294563" colspan="2"> @@ -64,10 +68,10 @@ </table> </div> <!--================= end Tabs ==================--> -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td> +</td><td bgcolor="#294563"></td> </tr> <tr> -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> +<td height="10" bgcolor="#4C6C8F" colspan="4"></td> </tr> </table> <!--================= end Banner ==================--> @@ -226,28 +230,8 @@ <tr> <td valign="middle"> <h1>Using and Implementing Matchers and Selectors</h1> -</td><script language="Javascript" type="text/javascript"> -function printit() { -if (window.print) { - window.print() ; -} else { - var WebBrowser = '<OBJECT ID="WebBrowser1" WIDTH="0" HEIGHT="0" CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2"></OBJECT>'; -document.body.insertAdjacentHTML('beforeEnd', WebBrowser); - WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box WebBrowser1.outerHTML = ""; -} -} -</script><script language="Javascript" type="text/javascript"> -var NS = (navigator.appName == "Netscape"); -var VERSION = parseInt(navigator.appVersion); -if (VERSION > 3) { - document.write('<td nowrap="nowrap" width="40" align="center">'); - document.write(' <a class="dida" href="javascript:printit()">'); - document.write(' <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>'); - document.write(' print</a>'); - document.write('</td>'); -} -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="matchers_selectors.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br> - PDF</a></td> +</td><td nowrap="nowrap" width="40" align="center"><a class="dida" href="matchers_selectors.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br> + PDF</a></td> </tr> </table> <p class="type">Type: Overview document</p> @@ -373,7 +357,7 @@ not affected by the result of the action. </p> </div> -<a name="N1006F"></a><a name="Using+Matchers"></a> +<a name="N1006D"></a><a name="Using+Matchers"></a> <h3>Using Matchers</h3> <div style="margin-left: 0 ; border: 2px"> <p> @@ -457,7 +441,7 @@ </pre> </div> -<a name="N10093"></a><a name="Using+Selectors"></a> +<a name="N1008E"></a><a name="Using+Selectors"></a> <h3>Using Selectors</h3> <div style="margin-left: 0 ; border: 2px"> <p> @@ -536,10 +520,10 @@ </p> </div> -<a name="N100AC"></a><a name="Write+Your+Own+Matchers+and+Selectors"></a> +<a name="N100A5"></a><a name="Write+Your+Own+Matchers+and+Selectors"></a> <h3>Write Your Own Matchers and Selectors</h3> <div style="margin-left: 0 ; border: 2px"> -<a name="N100B1"></a><a name="Matchers"></a> +<a name="N100AA"></a><a name="Matchers"></a> <h4>Matchers</h4> <div style="margin-left: 0 ; border: 2px"> <p> @@ -573,7 +557,7 @@ getMatchString method with your own. </p> </div> -<a name="N100CE"></a><a name="Selectors"></a> +<a name="N100C7"></a><a name="Selectors"></a> <h4>Selectors</h4> <div style="margin-left: 0 ; border: 2px"> <p> @@ -603,11 +587,14 @@ <!--================= start Footer ==================--> <table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0"> <tr> -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="/favicon.ico"></a></td> +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a></td> </tr> <tr> -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright © - 1999-2004 The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!-- +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif"><a href="http://www.apache.org/licenses/";> + Copyright © 1999-2005 + The Apache Software Foundation.</a> + All rights reserved. + <script type="text/javascript" language="JavaScript"><!-- document.write(" - "+"Last Published: " + document.lastModified); // --></script></font></td> </tr> Modified: cocoon/site/site/2.1/userdocs/concepts/matchers_selectors.pdf URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/userdocs/concepts/matchers_selectors.pdf?view=diff&r1=159368&r2=159369 ============================================================================== Binary files - no diff available. Modified: cocoon/site/site/2.1/userdocs/concepts/modules-ref.html URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/userdocs/concepts/modules-ref.html?view=diff&r1=159368&r2=159369 ============================================================================== --- cocoon/site/site/2.1/userdocs/concepts/modules-ref.html (original) +++ cocoon/site/site/2.1/userdocs/concepts/modules-ref.html Tue Mar 29 05:47:29 2005 @@ -2,14 +2,18 @@ <html> <head> <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<meta content="Apache Forrest" name="Generator"> +<meta name="Forrest-version" content="0.6"> +<meta name="Forrest-skin-name" content="forrest-site"> <title>Input Modules Reference</title> <link type="text/css" href="../../skin/page.css" rel="stylesheet"> +<link rel="shortcut icon" href="../../"> </head> <body text="#000000" bgcolor="#FFFFFF"> <!--================= start Navigation Path ==================--> <table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td> +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><a href="http://www.apache.org/";>apache</a> > <a href="http://cocoon.apache.org/";>cocoon</a><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td> </tr> <tr> <td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> @@ -20,9 +24,9 @@ <table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> <!--================= start Group Logo ==================--> -<td bgcolor="#294563"><a href="http://cocoon.apache.org/";><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/cocoon-project-logo.png"></a></td> +<td bgcolor="#294563"><a href="http://cocoon.apache.org/";><img class="logoImage" alt="Apache Cocoon" src="../../images/cocoon-project-logo.png"></a></td> <!--================= end Group Logo ==================--> -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/";><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td> +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/";><img class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif" title="Apache Cocoon"></a></td> <!--================= end Project Logo ==================--> <!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563"> <form target="_blank" action="http://www.google.com/search"; method="get"> @@ -31,13 +35,13 @@ <td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> </tr> <tr> -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit"> +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="as_sitesearch" type="hidden"><input size="15" name="as_q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit"> <br> <font face="Arial, Helvetica, Sans-serif" size="2" color="white"> - the Apache Cocoon site - - - </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> + the Apache Cocoon site + + + </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> </tr> <tr> <td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td> @@ -45,7 +49,7 @@ </table> </form> </td> -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> +<!--================= end Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> </tr> <tr> <td valign="bottom" bgcolor="#294563" colspan="2"> @@ -64,10 +68,10 @@ </table> </div> <!--================= end Tabs ==================--> -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td> +</td><td bgcolor="#294563"></td> </tr> <tr> -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> +<td height="10" bgcolor="#4C6C8F" colspan="4"></td> </tr> </table> <!--================= end Banner ==================--> @@ -226,28 +230,8 @@ <tr> <td valign="middle"> <h1>Input Modules Reference</h1> -</td><script language="Javascript" type="text/javascript"> -function printit() { -if (window.print) { - window.print() ; -} else { - var WebBrowser = '<OBJECT ID="WebBrowser1" WIDTH="0" HEIGHT="0" CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2"></OBJECT>'; -document.body.insertAdjacentHTML('beforeEnd', WebBrowser); - WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box WebBrowser1.outerHTML = ""; -} -} -</script><script language="Javascript" type="text/javascript"> -var NS = (navigator.appName == "Netscape"); -var VERSION = parseInt(navigator.appVersion); -if (VERSION > 3) { - document.write('<td nowrap="nowrap" width="40" align="center">'); - document.write(' <a class="dida" href="javascript:printit()">'); - document.write(' <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>'); - document.write(' print</a>'); - document.write('</td>'); -} -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="modules-ref.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br> - PDF</a></td> +</td><td nowrap="nowrap" width="40" align="center"><a class="dida" href="modules-ref.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br> + PDF</a></td> </tr> </table> <p>A concise reference to Cocoon's InputModules.</p> @@ -338,14 +322,14 @@ would create a new java.util.Date object.</p> <pre class="code"><package name="java.util" prefix="util"/></pre> </div> -<a name="N10056"></a><a name="AbstractMetaModule"></a> +<a name="N10054"></a><a name="AbstractMetaModule"></a> <h4>AbstractMetaModule</h4> <div style="margin-left: 0 ; border: 2px"> <p>AbstractMetaModule gives you the infrastructure for easily deploying more "meta" InputModules i.e. InputModules that are composed of other InputModules. In order to get at the Logger, use getLogger().</p> </div> -<a name="N10060"></a><a name="CollectionMetaModule"></a> +<a name="N1005E"></a><a name="CollectionMetaModule"></a> <h4>CollectionMetaModule</h4> <div style="margin-left: 0 ; border: 2px"> <p>Constructs an array of values suitable for a JDBC collection type from @@ -361,7 +345,7 @@ <div class="content">Finish the reference for this Module.</div> </div> </div> -<a name="N10072"></a><a name="DateInputModule"></a> +<a name="N10070"></a><a name="DateInputModule"></a> <h4>DateInputModule</h4> <div style="margin-left: 0 ; border: 2px"> <p>This module returns the current date, optionally formated @@ -380,7 +364,7 @@ Date Format</a>.</div> </div> </div> -<a name="N10089"></a><a name="GlobalInputModule"></a> +<a name="N10087"></a><a name="GlobalInputModule"></a> <h4>GlobalInputModule</h4> <div style="margin-left: 0 ; border: 2px"> <p>This module allows you to access "global" variables which are defined in @@ -419,7 +403,7 @@ </map:match> </pre> </div> -<a name="raw-request-parameter-module"></a><a name="N100B1"></a><a name="RawRequestParameterModule"></a> +<a name="raw-request-parameter-module"></a><a name="N100AC"></a><a name="RawRequestParameterModule"></a> <h4>RawRequestParameterModule</h4> <div style="margin-left: 0 ; border: 2px"> <p>This module allows access to "raw" request parameters and their @@ -463,7 +447,7 @@ requires spaces and other special characters to be correctly encoded. </p> </div> -<a name="request-parameter-module"></a><a name="N100E4"></a><a name="RequestParameterModule"></a> +<a name="request-parameter-module"></a><a name="N100DD"></a><a name="RequestParameterModule"></a> <h4>RequestParameterModule</h4> <div style="margin-left: 0 ; border: 2px"> <p>This module allows access to request parameters. Values returned are @@ -511,7 +495,7 @@ </div> </div> </div> -<a name="N10110"></a><a name="RequestURIModule"></a> +<a name="N10107"></a><a name="RequestURIModule"></a> <h4>RequestURIModule</h4> <div style="margin-left: 0 ; border: 2px"> <p>Returns the URI of the request.</p> @@ -562,11 +546,14 @@ <!--================= start Footer ==================--> <table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0"> <tr> -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="/favicon.ico"></a></td> +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a></td> </tr> <tr> -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright © - 1999-2004 The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!-- +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif"><a href="http://www.apache.org/licenses/";> + Copyright © 1999-2005 + The Apache Software Foundation.</a> + All rights reserved. + <script type="text/javascript" language="JavaScript"><!-- document.write(" - "+"Last Published: " + document.lastModified); // --></script></font></td> </tr> Modified: cocoon/site/site/2.1/userdocs/concepts/modules-ref.pdf URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/userdocs/concepts/modules-ref.pdf?view=diff&r1=159368&r2=159369 ============================================================================== Binary files - no diff available. Modified: cocoon/site/site/2.1/userdocs/concepts/modules.html URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/userdocs/concepts/modules.html?view=diff&r1=159368&r2=159369 ============================================================================== --- cocoon/site/site/2.1/userdocs/concepts/modules.html (original) +++ cocoon/site/site/2.1/userdocs/concepts/modules.html Tue Mar 29 05:47:29 2005 @@ -2,14 +2,18 @@ <html> <head> <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<meta content="Apache Forrest" name="Generator"> +<meta name="Forrest-version" content="0.6"> +<meta name="Forrest-skin-name" content="forrest-site"> <title>Modules</title> <link type="text/css" href="../../skin/page.css" rel="stylesheet"> +<link rel="shortcut icon" href="../../"> </head> <body text="#000000" bgcolor="#FFFFFF"> <!--================= start Navigation Path ==================--> <table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> -<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td> +<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><a href="http://www.apache.org/";>apache</a> > <a href="http://cocoon.apache.org/";>cocoon</a><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td> </tr> <tr> <td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> @@ -20,9 +24,9 @@ <table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> <!--================= start Group Logo ==================--> -<td bgcolor="#294563"><a href="http://cocoon.apache.org/";><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/cocoon-project-logo.png"></a></td> +<td bgcolor="#294563"><a href="http://cocoon.apache.org/";><img class="logoImage" alt="Apache Cocoon" src="../../images/cocoon-project-logo.png"></a></td> <!--================= end Group Logo ==================--> -<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/";><img border="0" class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif"></a></td> +<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://cocoon.apache.org/";><img class="logoImage" alt="Apache Cocoon" src="../../images/project-logo.gif" title="Apache Cocoon"></a></td> <!--================= end Project Logo ==================--> <!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563"> <form target="_blank" action="http://www.google.com/search"; method="get"> @@ -31,13 +35,13 @@ <td colspan="3"><img height="10" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> </tr> <tr> -<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit"> +<td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org" name="as_sitesearch" type="hidden"><input size="15" name="as_q" id="query" type="text"><img height="1" width="5" alt="" src="../../skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit"> <br> <font face="Arial, Helvetica, Sans-serif" size="2" color="white"> - the Apache Cocoon site - - - </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> + the Apache Cocoon site + + + </font></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> </tr> <tr> <td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="../../skin/images/search-right.gif"></td> @@ -45,7 +49,7 @@ </table> </form> </td> -<!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> +<!--================= end Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> </tr> <tr> <td valign="bottom" bgcolor="#294563" colspan="2"> @@ -64,10 +68,10 @@ </table> </div> <!--================= end Tabs ==================--> -</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../../skin/images/spacer.gif" class="spacer"></td> +</td><td bgcolor="#294563"></td> </tr> <tr> -<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="../../skin/images/spacer.gif" class="spacer"></td> +<td height="10" bgcolor="#4C6C8F" colspan="4"></td> </tr> </table> <!--================= end Banner ==================--> @@ -226,28 +230,8 @@ <tr> <td valign="middle"> <h1>Modules</h1> -</td><script language="Javascript" type="text/javascript"> -function printit() { -if (window.print) { - window.print() ; -} else { - var WebBrowser = '<OBJECT ID="WebBrowser1" WIDTH="0" HEIGHT="0" CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2"></OBJECT>'; -document.body.insertAdjacentHTML('beforeEnd', WebBrowser); - WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box WebBrowser1.outerHTML = ""; -} -} -</script><script language="Javascript" type="text/javascript"> -var NS = (navigator.appName == "Netscape"); -var VERSION = parseInt(navigator.appVersion); -if (VERSION > 3) { - document.write('<td nowrap="nowrap" width="40" align="center">'); - document.write(' <a class="dida" href="javascript:printit()">'); - document.write(' <img alt="Print this Page" src="../../skin/images/printer.gif" class="skin"><br>'); - document.write(' print</a>'); - document.write('</td>'); -} -</script><td nowrap="nowrap" width="40" align="center"><a class="dida" href="modules.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br> - PDF</a></td> +</td><td nowrap="nowrap" width="40" align="center"><a class="dida" href="modules.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br> + PDF</a></td> </tr> </table> <ul class="minitoc"> @@ -265,6 +249,17 @@ </li> <li> <a href="#Step+2%3A+Use+it">Step 2: Use it</a> +<ul class="minitoc"> +<li> +<a href="#Step+2a%3A+Use+it+as+sitemap+variable">Step 2a: Use it as sitemap variable</a> +</li> +<li> +<a href="#Step+2b%3A+Use+it+on+an+XSP">Step 2b: Use it on an XSP</a> +</li> +<li> +<a href="#Step+2c%3A+Have+sitemap+components+use+a+module">Step 2c: Have sitemap components use a module</a> +</li> +</ul> </li> </ul> </li> @@ -415,13 +410,13 @@ which one to use. </p> </div> -<a name="N1005E"></a><a name="Step+2%3A+Use+it"></a> +<a name="N1005D"></a><a name="Step+2%3A+Use+it"></a> <h4>Step 2: Use it</h4> <div style="margin-left: 0 ; border: 2px"> <p> The following alternatives for using modules exist: </p> -<a name="N10066"></a><a name="Step+2a%3A+Use+it+as+sitemap+variable"></a> +<a name="N10065"></a><a name="Step+2a%3A+Use+it+as+sitemap+variable"></a> <h5>Step 2a: Use it as sitemap variable</h5> <div style="margin-left: 0 ; border: 2px"> <p> @@ -456,9 +451,9 @@ <map:parameter name="users-home-base" value="{system-property:substring-before(user.home, user.name)}"/> - </pre> + </pre> </div> -<a name="N1008A"></a><a name="Step+2b%3A+Use+it+on+an+XSP"></a> +<a name="N10086"></a><a name="Step+2b%3A+Use+it+on+an+XSP"></a> <h5>Step 2b: Use it on an XSP</h5> <div style="margin-left: 0 ; border: 2px"> <p> @@ -490,7 +485,7 @@ </xsp:page> </pre> </div> -<a name="N10098"></a><a name="Step+2c%3A+Have+sitemap+components+use+a+module"></a> +<a name="N10093"></a><a name="Step+2c%3A+Have+sitemap+components+use+a+module"></a> <h5>Step 2c: Have sitemap components use a module</h5> <div style="margin-left: 0 ; border: 2px"> <p> @@ -529,11 +524,14 @@ <!--================= start Footer ==================--> <table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0"> <tr> -<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="/favicon.ico"></a></td> +<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif" class="spacer"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a></td> </tr> <tr> -<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright © - 1999-2004 The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!-- +<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif"><a href="http://www.apache.org/licenses/";> + Copyright © 1999-2005 + The Apache Software Foundation.</a> + All rights reserved. + <script type="text/javascript" language="JavaScript"><!-- document.write(" - "+"Last Published: " + document.lastModified); // --></script></font></td> </tr> Modified: cocoon/site/site/2.1/userdocs/concepts/modules.pdf URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/userdocs/concepts/modules.pdf?view=diff&r1=159368&r2=159369 ============================================================================== Binary files - no diff available.
