The end point of a Pipeline. Its inputs are SAX events. It outputs a presentation of those events. i.e. it performs the function of rendering the results of a request.

The basic Serializer turns a series of SAX events into an XML document.

Declaration

Serializers are configured in the Sitemap

<map:serializers default="html">
<map:serializer name="xml"
                 mime-type="text/xml"
                 src="org.apache.cocoon.serialization.XMLSerializer"/>
<map:serializer name="html"
                 mime-type="text/html"
                 src="org.apache.cocoon.serialization.HTMLSerializer"/>
<map:serializer name="fo2pdf"
                 mime-type="application/pdf"
                 src="org.apache.cocoon.serialization.FOPSerializer"/>
<map:serializer name="vrml"
                 mime-type="model/vrml"
                 src="org.apache.cocoon.serialization.TextSerializer"/>
<map:serializer name="text"
                 mime-type="text/plain"
                 src="org.apache.cocoon.serialization.TextSerializer"/>
...
</map:serializers>

The default attribute on the serializers element indicates the default serializer to use if a pipeline does not explicitly declare one.

Usage

Sample usage:

<map:match pattern="hello.html">
<map:generate src="docs/samples/hello-page.xml"/>
<map:transform src="stylesheets/page/simple-page2html.xsl"/>
<map:serialize type="html"/>
</map:match>

Available Implementations

Serializers are provided to produce HTML, XML, PDF, WAP, VRML, amongst others:

• HTML_Serializer – serializes XHTML into valid HTML
• XML Serializer – simply turns SAX events into an XML document
• Text Serializer – text-tags from XML
• WAP/WML Serializer – ??
• SVG Serializer – converts SVG documents (may be slightly behind REC) into JPEG or PNG images, using Batik Transcoder
• SVG/XML Serializer – ??
• VRML Serializer –
• Link Serializer –
• PDF Serializer – turns XSL:FO into PDF using FOP
• PS Serializer – turns XSL:FO into PS using FOP
• PCL Serializer – turns XSL:FO into PCS using FOP
• XLSSerializer – turns gnumeric formatted XML an ExcelGeneration
• RTF Serializer – turns XSL:FO into RTF using jfor (MS Word compatible)