org.kuali.rice.ksb.api.bus.support

Class BasicEndpoint

java.lang.Object

org.kuali.rice.ksb.api.bus.support.BasicEndpoint

All Implemented Interfaces:

Endpoint

public final class BasicEndpoint
extends Object
implements Endpoint

A simple immutable implementation of an Endpoint which simply wraps a ServiceConfiguration and it's associated service implementation.

Author:

Kuali Rice Team (rice.collab@kuali.org)

Method Summary

Modifier and Type	Method and Description
Object	getService() Returns a reference to the service that can be invoked through this endpoint.
ServiceConfiguration	getServiceConfiguration() Returns the service configuration information for this endpoint.
static BasicEndpoint	newEndpoint(ServiceConfiguration serviceConfiguration, Object service) Constructs a new basic endpoint from the given service configuration and service instance.

Methods inherited from class java.lang.Object

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

Method Detail

newEndpoint

public static BasicEndpoint newEndpoint(ServiceConfiguration serviceConfiguration,
                                        Object service)

Constructs a new basic endpoint from the given service configuration and service instance.

Parameters:

serviceConfiguration - the service configuration to include in this endpoint

service - the service implementation instance to include in this endpoint

Returns:

the constructed BasicEndpoint which contains the given configuration and service, will never return null

Throws:

IllegalArgumentException - if either serviceConfiguration or service are null

getServiceConfiguration

public ServiceConfiguration getServiceConfiguration()

Description copied from interface: Endpoint

Returns the service configuration information for this endpoint.

Specified by:

getServiceConfiguration in interface Endpoint

Returns:

the service configuration for this endpoint, should never return null

getService

public Object getService()

Description copied from interface: Endpoint

Returns a reference to the service that can be invoked through this endpoint. This could potentially be a proxy to the service (in the case that the endpoint is pointing to a remote service) so calling code should cast this object to the appropriate service interface before using.

It is the client's responsibility to ensure that they are casting the service to the correct interface(s) based on their knowledge of what interface the service should implement.

Specified by:

getService in interface Endpoint

Returns:

a reference to the service object which can be used to invoke operations against the endpoint, should never return null