Return-Path: 
 <docs-return-1720-apmail-cocoon-docs-archive=cocoon.apache.org@cocoon.apache.org>
Delivered-To: apmail-cocoon-docs-archive@cocoon.apache.org
Received: (qmail 85973 invoked by uid 500); 30 Jul 2003 20:59:59 -0000
Mailing-List: contact docs-help@cocoon.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:docs-help@cocoon.apache.org>
list-unsubscribe: <mailto:docs-unsubscribe@cocoon.apache.org>
list-post: <mailto:docs@cocoon.apache.org>
Reply-To: docs@cocoon.apache.org
Delivered-To: mailing list docs@cocoon.apache.org
Received: (qmail 85960 invoked from network); 30 Jul 2003 20:59:59 -0000
Received: from dobit2.ugent.be (HELO dobit2.rug.ac.be) (157.193.42.8)
  by daedalus.apache.org with SMTP; 30 Jul 2003 20:59:59 -0000
Received: from allserv.UGent.be (allserv.ugent.be [157.193.40.42])
	by dobit2.rug.ac.be (8.12.8/8.12.8) with ESMTP id h6UL04RQ014291
	for <docs@cocoon.apache.org>; Wed, 30 Jul 2003 23:00:04 +0200 (MEST)
Received: from otsrv1.iic.rug.ac.be (otsrv1.iic.ugent.be [157.193.121.51])
	by allserv.UGent.be (8.12.8/8.12.8) with ESMTP id h6UL03Sg006830
	for <docs@cocoon.apache.org>; Wed, 30 Jul 2003 23:00:03 +0200 (MEST)
Received: from otsrv1.iic.rug.ac.be (localhost [127.0.0.1])
	by otsrv1.iic.rug.ac.be (8.11.6/8.11.6) with ESMTP id h6UL03x22077
	for <docs@cocoon.apache.org>; Wed, 30 Jul 2003 23:00:03 +0200
Date: Wed, 30 Jul 2003 23:00:03 +0200
Message-Id: <200307302100.h6UL03x22077@otsrv1.iic.rug.ac.be>
From: stevenn@outerthought.org
To: docs@cocoon.apache.org
Subject: [WIKI-UPDATE] InputModules Wed Jul 30 23:00:03 2003
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N

Page: http://wiki.cocoondev.org/Wiki.jsp?page=InputModules , version: 20 on Wed Jul 30 20:18:07 2003 by TonyCollen

- 
+ ----
+ !!RequestParameterModule
+ 
+ This module allows access to request parameters.
+ 
+ __cocoon.xconf usage__:
+ {{{
+ <input-modules>
+   ...
+   <component-instance class="org.apache.cocoon.components.modules.input.RequestParameterModule" logger="core.modules.input" name="request-param"/>
+   ...
+ </input-modules>
+ }}}
+ 
+ __Example Pipeline Fragment__:
+ {{{
+ <map:match pattern="bar">
+    <map:generate type="file" src="documents/{request-param:file}"/>
+    <map:transform src="stylesheets/{request-param:stylesheet}"/>
+    <map:serialize/>
+ </map:match>
+ }}}
+ This pipeline will match a request for "bar" and pass the request parameters "file" and "stylesheet" to the generator and transformer, respectively.  (e.g. ''http://localhost:8080/cocoon/bar?file=doc.xml&stylesheet=main.xsl'').
+ 
+ __Note that directly passing request parameters for file access can be dangerous.__  Remember to follow basic webapp safety rules when designing your pipelines.
+