org.apache.mina.handler.chain

Class IoHandlerChain

java.lang.Object

org.apache.mina.handler.chain.IoHandlerChain

All Implemented Interfaces:

IoHandlerCommand

public class IoHandlerChain
extends Object
implements IoHandlerCommand

A chain of IoHandlerCommands.

Author:

Apache MINA Project

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	IoHandlerChain.Entry Represents a name-command pair that an IoHandlerChain contains.

Nested classes/interfaces inherited from interface org.apache.mina.handler.chain.IoHandlerCommand

IoHandlerCommand.NextCommand

Constructor Summary

Constructors

Constructor and Description
IoHandlerChain() Creates a new, empty chain of IoHandlerCommands.

Method Summary

Modifier and Type	Method and Description
void	addAfter(String baseName, String name, IoHandlerCommand command) Adds a name-command after a given name-command in the chain
void	addBefore(String baseName, String name, IoHandlerCommand command) Adds a name-command before a given name-command in the chain
void	addFirst(String name, IoHandlerCommand command) Adds a name-command pair into the chain
void	addLast(String name, IoHandlerCommand command) Adds a name-command at the end of the chain
void	clear() Remove all the IoHandlerCommand from the chain
boolean	contains(Class<? extends IoHandlerCommand> commandType) Checks if the chain of IoHandlerCommand contains a specific IoHandlerCommand
boolean	contains(IoHandlerCommand command) Checks if the chain of IoHandlerCommand contains a specific IoHandlerCommand
boolean	contains(String name) Checks if the chain of IoHandlerCommand contains a IoHandlerCommand by its name
void	execute(IoHandlerCommand.NextCommand next, IoSession session, Object message) Execute a unit of processing work to be performed.
IoHandlerCommand	get(String name) Retrieve a IoHandlerCommand by its name
List<IoHandlerChain.Entry>	getAll()
List<IoHandlerChain.Entry>	getAllReversed()
IoHandlerChain.Entry	getEntry(String name) Retrieve a name-command pair by its name
IoHandlerCommand.NextCommand	getNextCommand(String name) Retrieve the IoHandlerCommand following the IoHandlerCommand we fetched by its name
IoHandlerCommand	remove(String name) Removes a IoHandlerCommand by its name
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

IoHandlerChain

public IoHandlerChain()

Creates a new, empty chain of IoHandlerCommands.

Method Detail

getEntry

public IoHandlerChain.Entry getEntry(String name)

Retrieve a name-command pair by its name

Parameters:

name - The name of the IoHandlerCommand we are looking for

Returns:

The associated name-command pair, if any, null otherwise

get

public IoHandlerCommand get(String name)

Retrieve a IoHandlerCommand by its name

Parameters:

name - The name of the IoHandlerCommand we are looking for

Returns:

The associated IoHandlerCommand, if any, null otherwise

getNextCommand

public IoHandlerCommand.NextCommand getNextCommand(String name)

Retrieve the IoHandlerCommand following the IoHandlerCommand we fetched by its name

Parameters:

name - The name of the IoHandlerCommand

Returns:

The IoHandlerCommand which is next to teh ngiven name, if any, null otherwise

addFirst

public void addFirst(String name,
                     IoHandlerCommand command)

Adds a name-command pair into the chain

Parameters:

name - The name

command - The command

addLast

public void addLast(String name,
                    IoHandlerCommand command)

Adds a name-command at the end of the chain

Parameters:

name - The name

command - The command

addBefore

public void addBefore(String baseName,
                      String name,
                      IoHandlerCommand command)

Adds a name-command before a given name-command in the chain

Parameters:

baseName - The IoHandlerCommand name before which we will inject a new name-command

name - The name The name

command - The command The command

addAfter

public void addAfter(String baseName,
                     String name,
                     IoHandlerCommand command)

Adds a name-command after a given name-command in the chain

Parameters:

baseName - The IoHandlerCommand name after which we will inject a new name-command

name - The name The name

command - The command The command

remove

public IoHandlerCommand remove(String name)

Removes a IoHandlerCommand by its name

Parameters:

name - The name

Returns:

The removed IoHandlerCommand

clear

public void clear()
           throws Exception

Remove all the IoHandlerCommand from the chain

Throws:

Exception - If we faced some exception during the cleanup

execute

public void execute(IoHandlerCommand.NextCommand next,
                    IoSession session,
                    Object message)
             throws Exception

Execute a unit of processing work to be performed. This IoHandlerCommand may either complete the required processing and just return to stop the processing, or delegate remaining processing to the next IoHandlerCommand in a IoHandlerChain containing this IoHandlerCommand by calling IoHandlerCommand.NextCommand.execute(IoSession,Object).

Specified by:

execute in interface IoHandlerCommand

Parameters:

next - an indirect reference to the next IoHandlerCommand that provides a way to forward the request to the next IoHandlerCommand.

session - the IoSession which is associated with this request

message - the message object of this request

Throws:

Exception - general purpose exception return to indicate abnormal termination

getAll

public List<IoHandlerChain.Entry> getAll()

Returns:

The list of name-commands registered into the chain

getAllReversed

public List<IoHandlerChain.Entry> getAllReversed()

Returns:

A reverted list of the registered name-commands

contains

public boolean contains(String name)

Checks if the chain of IoHandlerCommand contains a IoHandlerCommand by its name

Parameters:

name - The IoHandlerCommand name

Returns:

TRUE if the IoHandlerCommand is found in the chain

contains

public boolean contains(IoHandlerCommand command)

Checks if the chain of IoHandlerCommand contains a specific IoHandlerCommand

Parameters:

command - The IoHandlerCommand we are looking for

Returns:

TRUE if the IoHandlerCommand is found in the chain

contains

public boolean contains(Class<? extends IoHandlerCommand> commandType)

Checks if the chain of IoHandlerCommand contains a specific IoHandlerCommand

Parameters:

commandType - The type of IoHandlerCommand we are looking for

Returns:

TRUE if the IoHandlerCommand is found in the chain

toString

public String toString()

Overrides:

toString in class Object