org.unix4j.builder

Class GenericCommandBuilder

java.lang.Object

org.unix4j.builder.GenericCommandBuilder

public class GenericCommandBuilder
extends Object

Generic builder dynamically creating an implementation of an interface extending CommandBuilder based on a series of command factories for all the methods present in that interface.

Constructor Summary

Constructors

Constructor and Description
GenericCommandBuilder()

Method Summary

Modifier and Type	Method and Description
static <B extends CommandBuilder> B	createCommandBuilder(Class<B> commandBuilderInterface, CommandInterface<? extends Command<?>>... commandFactories) Returns a new command builder implementing the specified commandBuilderInterface.
static <B extends CommandBuilder> B	createCommandBuilder(Class<B> commandBuilderInterface, DefaultCommandBuilder defaultCommandBuilder, CommandInterface<? extends Command<?>>... commandFactories) Returns a new command builder implementing the specified commandBuilderInterface.

Methods inherited from class java.lang.Object

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

Constructor Detail

GenericCommandBuilder

public GenericCommandBuilder()

Method Detail

createCommandBuilder

public static <B extends CommandBuilder> B createCommandBuilder(Class<B> commandBuilderInterface,
                                                                CommandInterface<? extends Command<?>>... commandFactories)

Returns a new command builder implementing the specified commandBuilderInterface. The methods in that interface, if not already implemented by DefaultCommandBuilder, must be present in one of the given commandFactories with the same signature returning a Command instance. If no factory is found for any of the methods in the interface, an exception is thrown.

Type Parameters:

B - the generic type of the builder interface to be implemented by the returned builder

Parameters:

commandBuilderInterface - the class representing the builder interface to be implemented by the returned builder

commandFactories - the factories containing a factory method for every command method in the given builder interface

Returns:

a new builder instance implementing the specified interface

Throws:

IllegalArgumentException - if commandBuilderInterface is not an interface class, if no factory method implementation exists for any of the command methods defined by that interface or if multiple ambiguous implementations exist

createCommandBuilder

public static <B extends CommandBuilder> B createCommandBuilder(Class<B> commandBuilderInterface,
                                                                DefaultCommandBuilder defaultCommandBuilder,
                                                                CommandInterface<? extends Command<?>>... commandFactories)

Returns a new command builder implementing the specified commandBuilderInterface. The methods in that interface, if not already implemented by the specified defaultCommandBuilder, must be present in one of the given commandFactories with the same signature returning a Command instance. If no factory is found for any of the methods in the interface, an exception is thrown.

Type Parameters:

B - the generic type of the builder interface to be implemented by the returned builder

Parameters:

commandBuilderInterface - the class representing the builder interface to be implemented by the returned builder

defaultCommandBuilder - the default builder with implementations for all non-command specific methods

commandFactories - the factories containing a factory method for every command method in the given builder interface

Returns:

a new builder instance implementing the specified interface

Throws:

IllegalArgumentException - if commandBuilderInterface is not an interface class, if no factory method implementation exists for any of the command methods defined by that interface or if multiple ambiguous implementations exist