org.apache.cocoon.components.modules.output
Interface OutputModule

All Superinterfaces:

org.apache.avalon.framework.component.Component

All Known Implementing Classes:

AbstractOutputModule, SessionAttributeOutputModule, RequestAttributeOutputModule

public interface OutputModule

extends org.apache.avalon.framework.component.Component

Communicate results to other components. This could be done via request attributes, session attribute etc. Implementors should obey the transactional nature and e.g. queue values as request attributes and do the real communication e.g. to a bean only when the transaction completes successfully.

Version:

CVS $Id: OutputModule.java,v 1.4.4.1 2002/11/17 19:12:49 haul Exp $

Author:

Christian Haul

Field Summary

static java.lang.String

ROLE

Method Summary

void	commit(org.apache.avalon.framework.configuration.Configuration modeConf, java.util.Map objectModel) Signal that the database transaction completed successfully.
void	rollback(org.apache.avalon.framework.configuration.Configuration modeConf, java.util.Map objectModel, java.lang.Exception e) If a database transaction needs to rollback, this is called to inform the further processing logic about this fact.
void	setAttribute(org.apache.avalon.framework.configuration.Configuration modeConf, java.util.Map objectModel, java.lang.String name, java.lang.Object value) communicate an attribute value to further processing logic.

Field Detail

ROLE

public static final java.lang.String ROLE

Method Detail

setAttribute

public void setAttribute(org.apache.avalon.framework.configuration.Configuration modeConf,
                         java.util.Map objectModel,
                         java.lang.String name,
                         java.lang.Object value)

communicate an attribute value to further processing logic.

Parameters:

modeConf - column's mode configuration from resource description. This argument is optional.

objectModel - The objectModel

name - The attribute's label, consisting of "table.column" or "table.column[index]" in case of multiple attributes of the same spec.

value - The attriute's value.

rollback

public void rollback(org.apache.avalon.framework.configuration.Configuration modeConf,
                     java.util.Map objectModel,
                     java.lang.Exception e)

If a database transaction needs to rollback, this is called to inform the further processing logic about this fact. All already set attribute values are invalidated. This is difficult because only the request object can be used to synchronize this and build some kind of transaction object. Beaware that sending your data straight to some beans or other entities could result in data corruption!

commit

public void commit(org.apache.avalon.framework.configuration.Configuration modeConf,
                   java.util.Map objectModel)

Signal that the database transaction completed successfully. See notes on rollback.