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)
  • No labels