de.aristaflow.adept2.base.communication

Interface InvocationTarget

All Known Implementing Classes:

GlobalInvocationTarget

public interface InvocationTarget

This interface provides the means for late binding of connections. That is resolving a remote service of a stub just before it is used. The methods resolve the designated URI and demultiplex them to the appropriate communication service. The URI is also transformed specific to the appropriate communication service and returned. Therefore users should use the returned URI with the returned objects.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	InvocationTarget.InvocationHandling A class encapsulating all objects required for invocation handling of global URIs and therefore late binding of connections.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getInstanceNameFromServiceUri(java.net.URI remId) Returns the hierarchical instance name from the designated remote identifier.
InvocationTarget.InvocationHandling	getInvocationHandling(java.net.URI remId) Gets the interfaces required to handle the invocation for the designated URI.

Method Detail

getInvocationHandling

InvocationTarget.InvocationHandling getInvocationHandling(java.net.URI remId)

Gets the interfaces required to handle the invocation for the designated URI. These are the invocation delegate for proxy calls, the export for callback objects as well as the communication service specific URI.

Parameters:

remId - The remote identifier for which to get the invocation delegate, the callback export and the communication service specific URI.

Returns:

The invocation delegate, the callback export and the communication service specific URI.

getInstanceNameFromServiceUri

java.lang.String getInstanceNameFromServiceUri(java.net.URI remId)

Returns the hierarchical instance name from the designated remote identifier.
Only to be called by the registry or communication framework.

Whenever the instance name needs to be derived from a service identifier, this method should be called. This keeps the way, how the instance name is stored in the identifier more exchangeable.

Parameters:

remId - The remote identifier from which to retrieve the service instance name.

Returns:

The hierarchical instance name from the designated identifier.

Throws:

java.lang.IllegalArgumentException - If the service identifier is invalid for this communication service, an IllegalArgumentException will be thrown.