org.refcodes.servicebus

Class ServiceBusImpl<S extends Service<?>,SCTX extends ServiceContext<S>>

java.lang.Object

org.refcodes.servicebus.ServiceBusImpl<S,SCTX>

Type Parameters:

S - the generic type

SCTX - the generic type

All Implemented Interfaces:

ServiceBus<S>

public class ServiceBusImpl<S extends Service<?>,SCTX extends ServiceContext<S>>
extends Object
implements ServiceBus<S>

The Class ServiceBusImpl.

Constructor Summary

Constructors

Constructor and Description
ServiceBusImpl(ServiceLookup<S,SCTX> aServiceLookup, org.refcodes.component.ext.observer.ObservableLifeCycleAutomaton aObservableLifecycleAutomaton) Constructs the subscriber part of the event bus.

Method Summary

Modifier and Type	Method and Description
protected void	destroyServices() Destroy services.
boolean	hasService(ServiceMatcher<S> aServiceMatcher) Determines whether the given ServiceMatcher will result in a single Service to be looked up.
protected void	initializeServices() Initialize services.
S	lookupService(ServiceMatcher<S> aServiceMatcher) Looks for a service matching the given service descriptor and returns it if found.
protected void	onLifecycleEvent(org.refcodes.component.ext.observer.LifeCycleEvent.LifeCycleRequestEvent aEvent) This method is used to handle life-cycle events and inform the according services of any life-cycle state changes.
protected void	pauseServices() Pause services.
protected void	registerLifecycleEventDispatcher(org.refcodes.component.ext.observer.ObservableLifeCycleAutomaton aObservableLifecycleAutomaton) This method registers a life-cycle event listener which dispatches any incoming life-cycle events to the according dispatcher method below.
protected void	resumeServices() Resume services.
protected void	startServices() Start services.
protected void	stopServices() Stop services.

Methods inherited from class java.lang.Object

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

Constructor Detail

ServiceBusImpl

public ServiceBusImpl(ServiceLookup<S,SCTX> aServiceLookup,
                      org.refcodes.component.ext.observer.ObservableLifeCycleAutomaton aObservableLifecycleAutomaton)

Constructs the subscriber part of the event bus. For doing its job, it needs the list of services which is accessible via the provided service lookup part of the service bus.

Parameters:

aServiceLookup - the a service lookup

aObservableLifecycleAutomaton - the a observable lifecycle automaton

Method Detail

lookupService

public S lookupService(ServiceMatcher<S> aServiceMatcher)
                throws NoMatchingServiceRuntimeException,
                       AmbiguousServiceRuntimeException

Looks for a service matching the given service descriptor and returns it if found.

Specified by:

lookupService in interface ServiceBus<S extends Service<?>>

Parameters:

aServiceMatcher - The ServiceMatcher describing the service for which to look for.

Returns:

The desired ServiceConfigurationError.

Throws:

AmbiguousServiceRuntimeException - in case more than one Service matched the ServiceMatcher.

NoMatchingServiceRuntimeException

hasService

public boolean hasService(ServiceMatcher<S> aServiceMatcher)

Determines whether the given ServiceMatcher will result in a single Service to be looked up. I.e. the ServiceMatcher must result in an unambiguous Service to be identified.

Specified by:

hasService in interface ServiceBus<S extends Service<?>>

Parameters:

aServiceMatcher - The ServiceMatcher describing the Service for which to look for.

Returns:

True in case if exactly one Service is matching the matcher. Else false is returned (either more than one service was identified or none service was identified).

registerLifecycleEventDispatcher

protected void registerLifecycleEventDispatcher(org.refcodes.component.ext.observer.ObservableLifeCycleAutomaton aObservableLifecycleAutomaton)

This method registers a life-cycle event listener which dispatches any incoming life-cycle events to the according dispatcher method below.

Parameters:

aObservableLifecycleAutomaton - the a observable lifecycle automaton

onLifecycleEvent

protected void onLifecycleEvent(org.refcodes.component.ext.observer.LifeCycleEvent.LifeCycleRequestEvent aEvent)

This method is used to handle life-cycle events and inform the according services of any life-cycle state changes. Use the registerLifecycleEventDispatcher(ObservableLifeCycleAutomaton) method to register a dispatcher for any life-cycle events from a provided observable life-cycle instance.

Parameters:

aEvent - the a event

initializeServices

protected void initializeServices()

Initialize services.

startServices

protected void startServices()

Start services.

pauseServices

protected void pauseServices()

Pause services.

resumeServices

protected void resumeServices()

Resume services.

stopServices

protected void stopServices()

Stop services.

destroyServices

protected void destroyServices()

Destroy services.