com.clearlydecoded.commander

Interface CommandHandler<CommandT extends Command<CommandResponseT>,CommandResponseT extends CommandResponse>

public interface CommandHandler<CommandT extends Command<CommandResponseT>,CommandResponseT extends CommandResponse>

CommandHandler interface defines methods which allow its implementations to do the actual work of processing a concrete type of Command implementation and produce a response that is a concerete implementation of CommandResponse.

Clients of this framework should implement a concrete implementation of this interface for each distinct type of Command/CommandResponse pair.

Warning! Implementations of this interface must account for the fact that the execution of its code might happen in a multi-threaded environment. Do NOT assume that a new instance of this handler will be created for each thread. In other words, multiple threads might share the same instance of the handler.

Author:

Yaakov Chaikin (yaakov@ClearlyDecoded.com)

Method Summary

Modifier and Type	Method and Description
CommandResponseT	execute(CommandT command) Executes the command, producing command response of class type which is embedded in the type of command.
Class<CommandT>	getCompatibleCommandClassType() Retrieves class type of the command this handler is to able to process.
Class<CommandResponseT>	getCompatibleCommandResponseClassType() Retrieves class type of the command response this handler is set to return.
String	getCompatibleCommandType() Retrieves command type identifier that this handler is able to process.

Method Detail

execute

CommandResponseT execute(CommandT command)

Executes the command, producing command response of class type which is embedded in the type of command.

Parameters:

command - Command object containing data which is needed for execution this command.

Returns:

Command response object that represents a processed response to the command.

getCompatibleCommandType

String getCompatibleCommandType()

Retrieves command type identifier that this handler is able to process. The type identifier is system-wide unique.

Returns:

Command type identifier that is unique system-wide which is associated with a concrete class that implements Command interface.

getCompatibleCommandClassType

Class<CommandT> getCompatibleCommandClassType()

Retrieves class type of the command this handler is to able to process.

Returns:

Class type of the command this handler is able to process.

getCompatibleCommandResponseClassType

Class<CommandResponseT> getCompatibleCommandResponseClassType()

Retrieves class type of the command response this handler is set to return.

Returns:

Class type of the command response this handler is set to return.