Transformers

Transformers take the pipeline data as a DOM document, transform it into another DOM and output back into the pipeline. There can be as many transformer as taste and performance will allow (I think that the maximum I ever had in a Cocoon pipeline was 12, and all of them necessary — honest).

TRAXTransformer — allows processing of the DOM according to a specified XSLT file.
PageHitTransformer — inserts the number of page hits for the page that is being processed.
GalleryTransformer — manages a photo gallery system.
I18nTransformer — supports internationalisation.
SourceWritingTransformer — allows the pipeline XML to be diverted to an external file.
FilterTransformer — allows restricted numbers of named tags to be passed.
SQLTransformer — allows queries to be made to a SQL database.
XIncludeTransformer — allows external documents (or parts of documents) to be melded into the document traversing the pipeline.
EntityTransformer — translates user and standard entities embedded within the document.
ModuleWriteTransformer — updates the module variables from within the data stream.
PasswordTransformer — provides a simple password encoding (based on md5).
LogTransformer — provides a simple method of logging XML fragments from within the pipeline.
Variable Transformer — translates embedded Paloose variables, such as globals.
String to XML Transformer — converts simple string into a DOM.

Component Declarations

Transformers are defined in the component declaration part of the Sitemap. For example

<map:transformers default="xslt"> <map:transformer name="xslt" src="resource://lib/transforming/TRAXTransformer"> <map:use-request-parameters>true</map:use-request-parameters> </map:transformer> <map:transformer name="pageHit" src="resource://lib/transforming/PageHitTransformer"> <map:parameter name="file" value="context://logs/PageHit.cnt"/> <map:parameter name="unique" value="false"/> <map:parameter name="cookie-name" value="PalooseTextHit"/> <map:parameter name="ignore" value="127.0.0.1"/> </map:transformer> <map:transformer name="i18n" src="resource://lib/transforming/I18nTransformer"> <map:catalogues default="index"> <map:catalogue id="index" name="index" location="context://content/translations"/> </map:catalogues> <map:untranslated-text>untranslated text</map:untranslated-text> </map:transformer> <map:transformer name="gallery" src="resource://lib/transforming/GalleryTransformer"> <map:parameter name="root" value="context://gallery/"/> <map:parameter name="image-cache" value="context://resources/images/cache/"/> <map:parameter name="max-thumbnail-width" value="150"/> <map:parameter name="max-thumbnail-height" value="150"/> <map:parameter name="resize" value="1"/> <map:parameter name="max-width" value="600"/> <map:parameter name="max-height" value="600"/> </map:transformer> <map:transformer name="log" src="resource://lib/transforming/LogTransformer"/> <map:transformer name="xinclude" src="resource://lib/transforming/XIncludeTransformer"/> <map:transformer name="password" src="resource://lib/transforming/PasswordTransformer"/> <map:transformer name="write-source" src="resource://lib/transforming/SourceWritingTransformer" /> </map:transformers>

The default attribute specifies the type of serializer to use if none is specified in a pipeline.