Package org.apache.commons.chain.impl

Class AddingCommand

java.lang.Object

org.apache.commons.chain.impl.NonDelegatingCommand

org.apache.commons.chain.impl.AddingCommand

All Implemented Interfaces:

Command<Context>

public class AddingCommand
extends NonDelegatingCommand

Implementation of Command that logs its identifier and and attempts to add a new Command to the Chain. This should cause an IllegalStateException if the Chain implementation subclasses ChainBase.

Version:

$Revision$ $Date$

Author:

Craig R. McClanahan

Field Summary

Fields inherited from class org.apache.commons.chain.impl.NonDelegatingCommand

id

Fields inherited from interface org.apache.commons.chain.Command

CONTINUE_PROCESSING, PROCESSING_COMPLETE

Constructor Summary

Constructors

Constructor	Description
AddingCommand()
AddingCommand(String id, Chain<Context> parent)	Construct an instance that will log the specified identifier

Method Summary

Modifier and Type	Method	Description
boolean	execute(Context context, Chain<Context> chain)	Execution method for this Command

Methods inherited from class org.apache.commons.chain.impl.NonDelegatingCommand

execute, log, setId

Methods inherited from class java.lang.Object

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

Constructor Details

AddingCommand

public AddingCommand()

AddingCommand

public AddingCommand(String id,
 Chain<Context> parent)

Construct an instance that will log the specified identifier

Parameters:

id - identifier to log for this Command instance

parent - the parent Chain

Method Details

execute

public boolean execute(Context context,
 Chain<Context> chain)
                throws Exception

Execution method for this Command

Parameters:

context - The Context to be processed by this Command

chain - the parent Chain

Returns:

true if the processing of this Context has been completed, or false if the processing of this Context should be delegated to a subsequent Command in an enclosing Chain

Throws:

Exception - general purpose exception return to indicate abnormal termination

IllegalArgumentException - if context is null