de.aristaflow.adept2.base.communication

Interface ADEPT2ServiceExport

public interface ADEPT2ServiceExport

This submodule of the CommunicationService is responsible for publishing services, i. e. to enable them to be called remotely.

Author:

Markus Lauer, Ulrich Kreher

Method Summary

Modifier and Type	Method and Description
boolean	exportService(java.net.URI serviceURI, java.lang.Class<? extends ADEPT2Service> serviceInterface, ADEPT2Service service) Enables the designated service identified by the designated URI to be called remotely through the designated service interface.
ADEPT2Service	getExportedService(java.net.URI remoteObjectIdentifier) Returns the service associated with the given remote object identifier.
java.lang.Class<?>	getRemoteInterfaceForExportedService(java.net.URI remoteObjectIdentifier) Returns the remote interface to be used to access the service associated with the given remote object identifier.
boolean	isExportPrepared(java.net.URI remoteObjectIdentifier) Returns whether the specified service identifier has been prepared by this service export but has not been exported yet.
boolean	isRegisteredService(java.net.URI remoteObjectIdentifier) Returns if the specified service identifier is known to this service export, that is whether this URI has been exported.
java.net.URI	prepareServiceExport(java.lang.String serviceType, java.lang.String simpleServiceName, java.lang.Class<? extends ADEPT2Service> serviceInterface) Prepares the specified service for being exported and creates a remote object identifier of type URI valid for the communication protocol this communication factory supports.
void	unregisterService(java.net.URI serviceURI) Unregisters the service with the designated URI to release resources.

Method Detail

prepareServiceExport

java.net.URI prepareServiceExport(java.lang.String serviceType,
                                  java.lang.String simpleServiceName,
                                  java.lang.Class<? extends ADEPT2Service> serviceInterface)
                           throws AbortServiceException

Prepares the specified service for being exported and creates a remote object identifier of type URI valid for the communication protocol this communication factory supports.

Parameters:

serviceType - The identifier of the ADEPT2 service type the specified service is an instance of.

simpleServiceName - The name assigned to the service to export by the registry.

serviceInterface - The remote interface used to access the exported service remotely.

Returns:

The remote object identifier identifying the service instance and the communication protocol to use for remote access.

Throws:

AbortServiceException - If the preparation of the service export fails, an AbortServiceException will be thrown.

exportService

boolean exportService(java.net.URI serviceURI,
                      java.lang.Class<? extends ADEPT2Service> serviceInterface,
                      ADEPT2Service service)
               throws AbortServiceException

Enables the designated service identified by the designated URI to be called remotely through the designated service interface.

Before the service could be exported, it must be prepared for export by calling prepareExport. The returned URI must match the URI returned by the prepareExport call.

Parameters:

serviceURI - The URI under which the service should be exported.

serviceInterface - The remote interface used to access the exported service remotely.

service - The service to export.

Returns:

Whether the user should be informed of the URI of the (locally) exported service. Usually only the globally exported URIs should be disclosed but specific communication service may want that, too, for instance the web service export.

Throws:

AbortServiceException - If the exporting the service fails, an AbortServiceException will be thrown.

unregisterService

void unregisterService(java.net.URI serviceURI)

Unregisters the service with the designated URI to release resources. In case the designated URI is not registered, this is a no-op.

Parameters:

serviceURI - The URI of the service to be unregistered and not exported any more.

getExportedService

ADEPT2Service getExportedService(java.net.URI remoteObjectIdentifier)

Returns the service associated with the given remote object identifier.

Parameters:

remoteObjectIdentifier - The remote object identifier identifying the requested remote service.

Returns:

The remote service identified by the given remoteObjectIdentifier.

getRemoteInterfaceForExportedService

java.lang.Class<?> getRemoteInterfaceForExportedService(java.net.URI remoteObjectIdentifier)

Returns the remote interface to be used to access the service associated with the given remote object identifier.

Parameters:

remoteObjectIdentifier - The remote object identifier identifying the requested remote service.

Returns:

The remote interface that must be used to access the service identified by the given remoteObjectIdentifier.

isExportPrepared

boolean isExportPrepared(java.net.URI remoteObjectIdentifier)

Returns whether the specified service identifier has been prepared by this service export but has not been exported yet.

Parameters:

remoteObjectIdentifier - The identifier to check.

Returns:

Whether the designated identifier has been prepared for service export but not exported yet.

isRegisteredService

boolean isRegisteredService(java.net.URI remoteObjectIdentifier)

Returns if the specified service identifier is known to this service export, that is whether this URI has been exported.

Parameters:

remoteObjectIdentifier - The identifier to check.

Returns:

if the passed service identifier is exported by this service export TRUE is returned else FALSE is returned.