Package org.apache.mina.statemachine

Class StateMachineProxyBuilder

java.lang.Object

org.apache.mina.statemachine.StateMachineProxyBuilder

public class StateMachineProxyBuilder
extends java.lang.Object

Used to create proxies which will forward all method calls on them to a StateMachine.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	StateMachineProxyBuilder.MethodInvocationHandler

Field Summary

Fields

Modifier and Type	Field	Description
private StateContextLookup	contextLookup
private java.lang.ClassLoader	defaultCl
private static java.lang.Object[]	EMPTY_ARGUMENTS
private EventFactory	eventFactory
private boolean	ignoreStateContextLookupFailure
private boolean	ignoreUnhandledEvents
private EventArgumentsInterceptor	interceptor
private static org.slf4j.Logger	LOGGER
private java.lang.String	name

Constructor Summary

Constructors

Constructor	Description
StateMachineProxyBuilder()	Creates a new StateMachineProxyBuilder instance

Method Summary

Modifier and Type	Method	Description
java.lang.Object	create(java.lang.Class<?>[] ifaces, StateMachine sm)	Creates a proxy for the specified interfaces and which uses the specified StateMachine.
<T> T	create(java.lang.Class<T> iface, StateMachine sm)	Creates a proxy for the specified interface and which uses the specified StateMachine.
StateMachineProxyBuilder	setClassLoader(java.lang.ClassLoader cl)	Sets the class loader to use for instantiating proxies.
StateMachineProxyBuilder	setEventArgumentsInterceptor(EventArgumentsInterceptor interceptor)	Sets the EventArgumentsInterceptor to be used.
StateMachineProxyBuilder	setEventFactory(EventFactory eventFactory)	Sets the EventFactory to be used.
StateMachineProxyBuilder	setIgnoreStateContextLookupFailure(boolean b)	Sets whether the failure to lookup a StateContext corresponding to a method call on the proxy produced by this builder will raise an exception or be silently ignored.
StateMachineProxyBuilder	setIgnoreUnhandledEvents(boolean b)	Sets whether events which have no handler in the current state will raise an exception or be silently ignored.
StateMachineProxyBuilder	setName(java.lang.String name)	Sets the name of the proxy created by this builder.
StateMachineProxyBuilder	setStateContextLookup(StateContextLookup contextLookup)	Sets the StateContextLookup to be used.

Methods inherited from class java.lang.Object

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

Field Detail

LOGGER

private static final org.slf4j.Logger LOGGER

EMPTY_ARGUMENTS

private static final java.lang.Object[] EMPTY_ARGUMENTS

contextLookup

private StateContextLookup contextLookup

eventFactory

private EventFactory eventFactory

interceptor

private EventArgumentsInterceptor interceptor

ignoreUnhandledEvents

private boolean ignoreUnhandledEvents

ignoreStateContextLookupFailure

private boolean ignoreStateContextLookupFailure

name

private java.lang.String name

defaultCl

private java.lang.ClassLoader defaultCl

Constructor Detail

StateMachineProxyBuilder

public StateMachineProxyBuilder()

Creates a new StateMachineProxyBuilder instance

Method Detail

setName

public StateMachineProxyBuilder setName(java.lang.String name)

Sets the name of the proxy created by this builder. This will be used by the proxies toString() method. If not specified a default auto generated name will be used.

Parameters:

name - the name.

Returns:

this StateMachineProxyBuilder for method chaining.

setStateContextLookup

public StateMachineProxyBuilder setStateContextLookup(StateContextLookup contextLookup)

Sets the StateContextLookup to be used. The default is to use a SingletonStateContextLookup.

Parameters:

contextLookup - the StateContextLookup to use.

Returns:

this StateMachineProxyBuilder for method chaining.

setEventFactory

public StateMachineProxyBuilder setEventFactory(EventFactory eventFactory)

Sets the EventFactory to be used. The default is to use a DefaultEventFactory.

Parameters:

eventFactory - the EventFactory to use.

Returns:

this StateMachineProxyBuilder for method chaining.

setEventArgumentsInterceptor

public StateMachineProxyBuilder setEventArgumentsInterceptor(EventArgumentsInterceptor interceptor)

Sets the EventArgumentsInterceptor to be used. By default no EventArgumentsInterceptor will be used.

Parameters:

interceptor - the EventArgumentsInterceptor to use.

Returns:

this StateMachineProxyBuilder for method chaining.

setIgnoreUnhandledEvents

public StateMachineProxyBuilder setIgnoreUnhandledEvents(boolean b)

Sets whether events which have no handler in the current state will raise an exception or be silently ignored. The default is to raise an exception.

Parameters:

b - true to ignore context lookup failures.

Returns:

this StateMachineProxyBuilder for method chaining.

setIgnoreStateContextLookupFailure

public StateMachineProxyBuilder setIgnoreStateContextLookupFailure(boolean b)

Sets whether the failure to lookup a StateContext corresponding to a method call on the proxy produced by this builder will raise an exception or be silently ignored. The default is to raise an exception.

Parameters:

b - true to ignore context lookup failures.

Returns:

this StateMachineProxyBuilder for method chaining.

setClassLoader

public StateMachineProxyBuilder setClassLoader(java.lang.ClassLoader cl)

Sets the class loader to use for instantiating proxies. The default is to use the current threads context ClassLoader as returned by Thread.getContextClassLoader().

Parameters:

cl - the class loader

Returns:

this StateMachineProxyBuilder for method chaining.

create

public <T> T create(java.lang.Class<T> iface,
                    StateMachine sm)

Creates a proxy for the specified interface and which uses the specified StateMachine.

Type Parameters:

T - The specified interface type

Parameters:

iface - the interface the proxy will implement.

sm - the StateMachine which will receive the events generated by the method calls on the proxy.

Returns:

the proxy object.

create

public java.lang.Object create(java.lang.Class<?>[] ifaces,
                               StateMachine sm)

Creates a proxy for the specified interfaces and which uses the specified StateMachine.

Parameters:

ifaces - the interfaces the proxy will implement.

sm - the StateMachine which will receive the events generated by the method calls on the proxy.

Returns:

the proxy object.