Mailing-List: contact docs-help@cocoon.apache.org; run by ezmlm
Precedence: bulk
Reply-To: docs@cocoon.apache.org
Content-Type: text/plain; charset="iso-8859-1"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
From: docs@cocoon.apache.org
To: docs@cocoon.apache.org
Subject: =?iso-8859-1?q?=5BCocoon_Wiki=5D_New=3A__ResponseHeaderTransformer?=
Date: Thu, 12 Aug 2004 12:00:46 -0000
Message-ID: <20040812120046.87961.87147@minotaur.apache.org>

   Date: 2004-08-12T05:00:46
   Editor: NicoVerwer <nverwer@email.com>
   Wiki: Cocoon Wiki
   Page: ResponseHeaderTransformer
   URL: http://wiki.apache.org/cocoon/ResponseHeaderTransformer

   no comment

New Page:

=3D=3D  ResponseHeaderTransformer =3D=3D
- TARGET-AUDIENCE: '''*beginner*''' advanced expert[[BR]]
- COCOON-RELEASES: 2.0.3, 2.0.4[[BR]]
- DOCUMENT-STATUS: '''*draft*''' reviewed released[[BR]]
----

This is a simple transformer that allows you to set HTTP response headers f=
rom the content of the XML that flows through the pipeline.

Other ways to set response headers are:
 *  HttpHeaderAction, which takes headers from the sitemap:
{{{
  <map:act type=3D"header">
    <map:parameter name=3D"Cache-Control" value=3D"no-cache" />
  </map:act>
}}}
 *  From Flow, which takes the header from a Flowscript:
{{{
  cocoon.response.setHeader("Cache-Control", "no-cache")
}}}

The ResponseHeaderTransformer is different from either of these methods, be=
cause it takes the header names and values from the XML that is processed b=
y the pipeline.

'''Declaration in sitemap:'''

{{{
  <map:transformers default=3D"xslt">
    <map:transformer name=3D"response-headers" src=3D"org.apache.cocoon.tra=
nsformation.ResponseHeaderTransformer"/>
  </map:transformers>
}}}

'''Usage in pipeline:'''

{{{
  <map:transform type=3D"response-headers"/>
}}}

The transformer will look for elements in the "http://apache.org/cocoon/res=
ponseHeader/1.0" namespace: =


{{{
<header:set name=3D"Cache-Control" value=3D"no-cache"
  xmlns:header=3D"http://apache.org/cocoon/responseHeader/1.0"/>
}}}

These elements are removed from the XML, and the header (Cache-Control) is =
set (to "no-cache").