Module org.refcodes.servicebus

Package org.refcodes.servicebus

Interface ServiceBus<S extends Service<?>>

Type Parameters:

S - the generic type

All Known Implementing Classes:

SimpleServiceBus

public interface ServiceBus<S extends Service<?>>

The ServiceBus defines the functionality for Service instances to look up other Service instances.

Method Summary

Modifier and Type	Method	Description
boolean	hasService(ServiceMatcher<S> aServiceMatcher)	Determines whether the given ServiceMatcher will result in a single Service to be looked up.
S	lookupService(ServiceMatcher<S> aServiceMatcher)	Looks for a service matching the given service descriptor and returns it if found.

Method Details

lookupService

S lookupService(ServiceMatcher<S> aServiceMatcher)
         throws UnknownServiceRuntimeException,
AmbiguousServiceRuntimeException

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

Parameters:

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

Returns:

The desired ServiceConfigurationError.

Throws:

UnknownServiceRuntimeException - in case no Service matched.

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

hasService

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.

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).