Package de.aristaflow.adept2.base.communication

Interface CommunicationService<I1,O1,I2,O2>

Type Parameters:

I1 - The type of the skeleton communication pipe input.

O1 - The type of the expected skeleton communication pipe output.

I2 - The type of the stub communication pipe input.

O2 - The type of the expected stub communication pipe output.

All Superinterfaces:

ADEPT2Service, ConfigurableService

All Known Subinterfaces:

MappingCommService<I1,O1,I2,O2>

public interface CommunicationService<I1,O1,I2,O2>
extends ConfigurableService

This communication service provides all the technically necessary to do both remote calls to remote services or remote callback objects and to publish remote services itself. The communication service represents a single type of communication, for example SOAP over HTTP or the InvocationMessage over TCP/IP (specially developed for ADEPT2).

Field Summary

Fields inherited from interface de.aristaflow.adept2.base.service.ConfigurableService

CONF_RUNTIME_CONF_PREFIX

Method Summary

Modifier and Type	Method	Description
ADEPT2CallbackExport	getADEPT2CallbackExport()	Returns the submodule responsible for exporting callback objects.
ADEPT2StubFactory<Object>	getADEPT2CallbackStubFactory()	Returns the factory responsible for creating stubs for remote calls to callback objects.
ADEPT2RemoteObjectIdentifierFactory	getADEPT2RemoteObjectIdentifierFactory()	Returns the factory to create remote object identifier valid for the type of communication this communication service represents.
ADEPT2ServiceExport	getADEPT2ServiceExport()	Returns the module responsible for exporting (i.
ADEPT2StubFactory<ADEPT2Service>	getADEPT2ServiceStubFactory()	Returns the factory responsible for creating stubs for remote calls to remote services.
InvocationTarget	getInvocationTarget()	Gets the invocation target of this communication service.
InetAddress	getListeningAddress()	Gets the IP-address this communication service is listening for requests.
CommunicationStack<I1,O1>	getSkeletonCommunicationStack()	Returns the communication stack to be used by skeletons to handle client requests.
CommunicationStack<I2,O2>	getStubCommunicationStack()	Returns the communication stack to be used by stubs to send requests to remote services.
String	getVersion()	Get the version string to check the compatibility with other versions of the communication service.
boolean	isPlatformActive()	Gets whether the underlying platform is currently active, that is, completely started.

Methods inherited from interface de.aristaflow.adept2.base.service.ADEPT2Service

getLocalUris, getRelease, getRuntimeRequiredServices, getServiceInstanceName, getStartupRequiredServices, getURIs, init, ping, preShutdown, shutdown, start

Methods inherited from interface de.aristaflow.adept2.base.service.ConfigurableService

getChangeableConfigurationKeys, getConfiguration, getConfigurationValue, setConfigurationValue

Method Detail

getADEPT2ServiceExport

ADEPT2ServiceExport getADEPT2ServiceExport()

Returns the module responsible for exporting (i. e. publishing) ADEPT2 services.

Returns:

The ADEPT2ServiceExport

getADEPT2CallbackExport

ADEPT2CallbackExport getADEPT2CallbackExport()

Returns the submodule responsible for exporting callback objects.

Returns:

The ADEPT2CallbackExport.

getADEPT2ServiceStubFactory

ADEPT2StubFactory<ADEPT2Service> getADEPT2ServiceStubFactory()

Returns the factory responsible for creating stubs for remote calls to remote services.

Returns:

The ADEPT2StubFactory responsible for creating stubs for remote calls to ADEPT2 services.

getADEPT2CallbackStubFactory

ADEPT2StubFactory<Object> getADEPT2CallbackStubFactory()

Returns the factory responsible for creating stubs for remote calls to callback objects.

Returns:

The ADEPT2StubFactory responsible for creating stubs for remote calls to callback objects.

getSkeletonCommunicationStack

CommunicationStack<I1,O1> getSkeletonCommunicationStack()

Returns the communication stack to be used by skeletons to handle client requests.

Returns:

The communication pipe ready for handling client requests.

getStubCommunicationStack

CommunicationStack<I2,O2> getStubCommunicationStack()

Returns the communication stack to be used by stubs to send requests to remote services.

Returns:

The communication pipe ready for sending client requests.

getInvocationTarget

InvocationTarget getInvocationTarget()

Gets the invocation target of this communication service. This allows for late binding, that is they defer resolving the URI until it is required and thus allow for changing the server transparently.

Returns:

The interface providing the invocation target of this communication service.

getADEPT2RemoteObjectIdentifierFactory

ADEPT2RemoteObjectIdentifierFactory getADEPT2RemoteObjectIdentifierFactory()

Returns the factory to create remote object identifier valid for the type of communication this communication service represents.

Returns:

The ADEPT2RemoteObjectIdentifierFactory

getListeningAddress

InetAddress getListeningAddress()

Gets the IP-address this communication service is listening for requests. This IP-address is checked against the licence.

Returns:

The IP-address this communication service is listening for requests which is checked against the licence.

getVersion

String getVersion()

Get the version string to check the compatibility with other versions of the communication service.

Returns:

The version string to check the compatibility with other versions of the communication service.

isPlatformActive

boolean isPlatformActive()

Gets whether the underlying platform is currently active, that is, completely started. Otherwise it is being (re-)started or shutdown. This allows for more specific exception handling within the communication since the communication service may already or still receive requests before all platform services have been exported or after they have been unregistered.

Returns:

Whether the underlying platform is currently active, that is, the corresponding services have been exported and are available.