com.airepublic.microverse.core.client

Class ServiceLookup

java.lang.Object

com.airepublic.microverse.core.client.ServiceLookup

All Implemented Interfaces:

Closeable, Serializable, AutoCloseable

@Singleton
public class ServiceLookup
extends Object
implements Serializable, Closeable

Lookup class for a RestServiceRegistryBinary.

Author:

Torsten Oltmanns

See Also:

Serialized Form

Method Summary

Modifier and Type	Method and Description
void	close()
static ServiceLookup	create() Creates a new ServiceLookup.
protected <T> T	createServiceClient(ServiceDescriptor serviceDescriptor) Create a service client which proxies the calls to the service server.
<T> T	getServiceClient(Class<T> serviceInterface, String serviceId, String serviceVersion) Gets a service client for the specified service interface.
<T> T	getServiceClient(ServiceDescriptor serviceDescriptor) Gets a service client for the specified service interface.
ServiceDescriptor	getServiceDescriptor(String serviceId, String serviceVersion) Gets a ServiceDescriptor for the specified service class.
void	registerService(ServiceDescriptor serviceDescriptor) Register the specified ServiceDescriptor with the registry servers.
void	registerServices(List<ServiceDescriptor> serviceDescriptors) Register the specified ServiceDescriptors with the registry servers.
void	unregisterService(ServiceDescriptor serviceDescriptor) Register the specified ServiceDescriptor with the registry-server.
void	unregisterServices(List<ServiceDescriptor> serviceDescriptors) Register the specified ServiceDescriptors with the registry-server.

Methods inherited from class java.lang.Object

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

Method Detail

create

public static ServiceLookup create()
                            throws ServiceException

Creates a new ServiceLookup.

Throws:

ServiceException

registerServices

public void registerServices(List<ServiceDescriptor> serviceDescriptors)
                      throws ServiceException

Register the specified ServiceDescriptors with the registry servers.

Parameters:

serviceDescriptors - the ServiceDescriptors

Throws:

ServiceException

registerService

public void registerService(ServiceDescriptor serviceDescriptor)
                     throws ServiceException

Register the specified ServiceDescriptor with the registry servers.

Parameters:

serviceDescriptors - the ServiceDescriptor

Throws:

ServiceException

unregisterServices

public void unregisterServices(List<ServiceDescriptor> serviceDescriptors)
                        throws ServiceException

Register the specified ServiceDescriptors with the registry-server.

Parameters:

serviceDescriptors - the ServiceDescriptors

Throws:

ServiceException

unregisterService

public void unregisterService(ServiceDescriptor serviceDescriptor)
                       throws ServiceException

Register the specified ServiceDescriptor with the registry-server.

Parameters:

serviceDescriptors - the ServiceDescriptor

Throws:

ServiceException

getServiceDescriptor

public final ServiceDescriptor getServiceDescriptor(String serviceId,
                                                    String serviceVersion)
                                             throws ServiceException

Gets a ServiceDescriptor for the specified service class.

Parameters:

serviceId - the service-class

Returns:

the service client

Throws:

Exception

ServiceException

getServiceClient

public final <T> T getServiceClient(Class<T> serviceInterface,
                                    String serviceId,
                                    String serviceVersion)
                             throws ServiceException

Gets a service client for the specified service interface.

Parameters:

serviceInterface - the service-interface providing the service functionality

serviceClass - the underlying service-class for the service-interface

Returns:

the service client

Throws:

Exception

ServiceException

getServiceClient

public final <T> T getServiceClient(ServiceDescriptor serviceDescriptor)
                             throws ServiceException

Gets a service client for the specified service interface.

Parameters:

serviceInterface - the service-interface providing the service functionality

serviceClass - the underlying service-class for the service-interface

Returns:

the service client

Throws:

Exception

ServiceException

createServiceClient

protected final <T> T createServiceClient(ServiceDescriptor serviceDescriptor)
                                   throws ServiceException

Create a service client which proxies the calls to the service server.

Parameters:

serviceDescriptor - the ServiceDescriptor

Returns:

the client to the server

Throws:

ClassNotFoundException

ServiceException

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException