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.

    • Method Detail

      • 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.

      • getInstanceNameFromServiceUri

        @Deprecated
String getInstanceNameFromServiceUri​(URI remId)
        Deprecated.
        Use getServiceInstNames(URI) instead.
        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:
        IllegalArgumentException - If the service identifier is invalid for this communication service, an IllegalArgumentException will be thrown.

      • 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.