org.apache.cocoon.generation
Class SessionAttributeGenerator

java.lang.Object
  |
  +--org.apache.avalon.framework.logger.AbstractLoggable
        |
        +--org.apache.cocoon.xml.AbstractXMLProducer
              |
              +--org.apache.cocoon.generation.AbstractGenerator
                    |
                    +--org.apache.cocoon.generation.SessionAttributeGenerator

All Implemented Interfaces:

org.apache.avalon.framework.component.Component, Generator, org.apache.avalon.framework.logger.Loggable, org.apache.avalon.excalibur.pool.Poolable, org.apache.avalon.excalibur.pool.Recyclable, SitemapModelComponent, XMLProducer

public class SessionAttributeGenerator

extends AbstractGenerator

Generates a document from a session attribute. The attribute may be a DOM node, an XMLizable, or any other object, and is streamed using the same rules as for <xsp:expr> in XSPs (see XSPObjectHelper).

Name of the session attribute is specified using src attribute of the generate tag, or, if no src tag present, using attr-name parameter.

This generator has 2 parameters:

• attr-name : the session attribute name (mandatory if no src attribute specified).
• root-element (optional) : the name of the root element of the produced document. This parameter is optional if the session attribute is a DOM or an XMLizable.

Example usage :

   <map:generator name="session-attr" logger="sitemap.generator.session-attr"
     src="org.apache.cocoon.generation.SessionAttributeGenerator"/>
   ...
   <map:generate type="session-attr">
     <map:parameter name="attr-name" value="myAttribute"/>
     <map:parameter name="root-element" value="root"/>
   </map:generate>
 

Version:

$Id: SessionAttributeGenerator.java,v 1.1.2.2 2002/10/23 03:42:22 vgritsenko Exp $

Author:

Cédric Damioli, Sylvain Wallez

See Also:

ReadDOMSessionTransformer, WriteDOMSessionTransformer

Field Summary

static java.lang.String	ATTR_NAME
static java.lang.String	ELEMENT_NAME

Fields inherited from class org.apache.cocoon.generation.AbstractGenerator

objectModel, parameters, resolver, source

Fields inherited from class org.apache.cocoon.xml.AbstractXMLProducer

contentHandler, lexicalHandler, xmlConsumer

Fields inherited from interface org.apache.cocoon.generation.Generator

ROLE

Constructor Summary

SessionAttributeGenerator()

Method Summary

void	generate() Generate XML data
void	setup(SourceResolver resolver, java.util.Map objectModel, java.lang.String src, org.apache.avalon.framework.parameters.Parameters par) Setup the file generator :try to retrieve the session attribute given as sitemap parameter

Methods inherited from class org.apache.cocoon.generation.AbstractGenerator

recycle

Methods inherited from class org.apache.cocoon.xml.AbstractXMLProducer

setConsumer, setContentHandler, setLexicalHandler

Methods inherited from class org.apache.avalon.framework.logger.AbstractLoggable

getLogger, setLogger, setupLogger, setupLogger, setupLogger

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.cocoon.xml.XMLProducer

setConsumer

Field Detail

ATTR_NAME

public static final java.lang.String ATTR_NAME

ELEMENT_NAME

public static final java.lang.String ELEMENT_NAME

Constructor Detail

SessionAttributeGenerator

public SessionAttributeGenerator()

Method Detail

setup

public void setup(SourceResolver resolver,
                  java.util.Map objectModel,
                  java.lang.String src,
                  org.apache.avalon.framework.parameters.Parameters par)
           throws ProcessingException,
                  org.xml.sax.SAXException,
                  java.io.IOException

Setup the file generator :try to retrieve the session attribute given as sitemap parameter

Overrides:

setup in class AbstractGenerator

generate

public void generate()
              throws java.io.IOException,
                     org.xml.sax.SAXException,
                     ProcessingException

Generate XML data