The list of Command s configured for this Chain , in the order in which they may delegate processing to the remainder of the Chain .

Flag indicating whether the configuration of our commands list has been frozen by a call to the execute() method.

 public ChainBase() 
{

}

Construct a Chain with no configured Command s.

 public ChainBase(Command command) 
{
        addCommand(command);
}

Construct a Chain configured with the specified Command .

Parameters:

command - The Command to be configured

Throws:

IllegalArgumentException - if command is null

exception: IllegalArgumentException - if command is null

 public ChainBase(Command[] commands) 
{
        if (commands == null) {
            throw new IllegalArgumentException();
        }
        for (int i = 0; i <  commands.length; i++) {
            addCommand(commands[i]);
        }
}

Construct a Chain configured with the specified Command s.

Parameters:

commands - The Command s to be configured

Throws:

IllegalArgumentException - if commands, or one of the individual Command elements, is null

exception: IllegalArgumentException - if commands, or one of the individual Command elements, is null

 public ChainBase(Collection commands) 
{
        if (commands == null) {
            throw new IllegalArgumentException();
        }
        Iterator elements = commands.iterator();
        while (elements.hasNext()) {
            addCommand((Command) elements.next());
        }
}

Construct a Chain configured with the specified Command s.

Parameters:

commands - The Command s to be configured

Throws:

IllegalArgumentException - if commands, or one of the individual Command elements, is null

exception: IllegalArgumentException - if commands, or one of the individual Command elements, is null

 public  void addCommand(Command command) 
{
    // ---------------------------------------------------------- Chain Methods
        if (command == null) {
            throw new IllegalArgumentException();
        }
        if (frozen) {
            throw new IllegalStateException();
        }
        Command[] results = new Command[commands.length + 1];
        System.arraycopy(commands, 0, results, 0, commands.length);
        results[commands.length] = command;
        commands = results;
}

See the Chain JavaDoc.

 public boolean execute(Context context) throws Exception 
{
        // Verify our parameters
        if (context == null) {
            throw new IllegalArgumentException();
        }
        // Freeze the configuration of the command list
        frozen = true;
        // Execute the commands in this list until one returns true
        // or throws an exception
        boolean saveResult = false;
        Exception saveException = null;
        int i = 0;
        int n = commands.length;
        for (i = 0; i <  n; i++) {
            try {
                saveResult = commands[i].execute(context);
                if (saveResult) {
                    break;
                }
            } catch (Exception e) {
                saveException = e;
                break;
            }
        }
        // Call postprocess methods on Filters in reverse order
        if (i  >= n) { // Fell off the end of the chain
            i--;
        }
        boolean handled = false;
        boolean result = false;
        for (int j = i; j  >= 0; j--) {
            if (commands[j] instanceof Filter) {
                try {
                    result =
                        ((Filter) commands[j]).postprocess(context,
                                                           saveException);
                    if (result) {
                        handled = true;
                    }
                } catch (Exception e) {
                      // Silently ignore
                }
            }
        }
        // Return the exception or result state from the last execute()
        if ((saveException != null) && !handled) {
            throw saveException;
        } else {
            return (saveResult);
        }
}

See the Chain JavaDoc.

 Command[] getCommands() 
{
        return (commands);
}

Return an array of the configured Command s for this Chain . This method is package private, and is used only for the unit tests.