Package 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
    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
    Description
    InvocationTarget.InvocationHandling
    getInvocationHandling(URI remId, URI regId)
    Gets the interfaces required to handle the invocation for the designated URI.
    Pair<String,String>
    getServiceInstNames(URI remId)
    Gets the component type name and the simple instance name of the service instance the designated remote identifier refers to.

  • Method Details

    • getInvocationHandling

      InvocationTarget.InvocationHandling getInvocationHandling(URI remId, URI regId)
      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 (physical) remote identifier for which to get the invocation delegate, the callback export and the communication service specific URI.
      regId - The original (logical) remote identifier of the remote service to call, in case a URI mapping was applied on the original URI.
      Returns:
      The invocation delegate, the callback export and the communication service specific URI.

    • getServiceInstNames

      Pair<String,String> getServiceInstNames(URI remId)
      Gets the component type name and the simple instance name of the service instance the designated remote identifier refers to.
      Parameters:
      remId - The remote identifier from which to retrieve the service instance name.
      Returns:
      The component type name and the simple instance name of the service instance the designated remote identifier refers to.
      Throws:
      IllegalArgumentException - If the designated remote identifier is invalid for this communication service or does not refer to a service, an IllegalArgumentException will be thrown.