org.refcodes.servicebus.impls

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

java.lang.Object

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

All Implemented Interfaces:

ServiceBus<S>

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

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()
boolean	hasService(ServiceMatcher<S> aServiceMatcher) Determines whether the given ServiceMatcher will result in a single Service to be looked up.
protected void	initializeServices()
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.events.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()
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 #onLifecycleEvent(LifecycleEvent) method of this class.
protected void	resumeServices()
protected void	startServices()
protected void	stopServices()

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:

aEventBus - The event bus for subscribing and publishing events.

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 #onLifecycleEvent(LifecycleEvent) method of this class.

Parameters:

aObservableLifecycleAutomaton -

onLifecycleEvent

protected void onLifecycleEvent(org.refcodes.component.ext.observer.events.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(ObservableLifecycle) method to register a dispatcher for any life-cycle events from a provided observable life-cycle instance.

Parameters:

aEvent -

initializeServices

protected void initializeServices()

startServices

protected void startServices()

pauseServices

protected void pauseServices()

resumeServices

protected void resumeServices()

stopServices

protected void stopServices()

destroyServices

protected void destroyServices()