Package org.infinispan.remoting.transport

Class AbstractDelegatingTransport

  • All Implemented Interfaces:
    Lifecycle, Transport
    public abstract class AbstractDelegatingTransport
extends java.lang.Object
implements Transport
    Designed to be overwrite.
    Since:
    6.0
    Author:
    Pedro Ruivo

    • Field Detail

    • Constructor Detail

      • AbstractDelegatingTransport

        protected AbstractDelegatingTransport​(Transport actual)

    • Method Detail

      • invokeRemotely

        public java.util.Map<Address,​Response> invokeRemotely​(java.util.Collection<Address> recipients,
                                                            org.infinispan.commands.ReplicableCommand rpcCommand,
                                                            ResponseMode mode,
                                                            long timeout,
                                                            ResponseFilter responseFilter,
                                                            DeliverOrder deliverOrder,
                                                            boolean anycast)
                                                     throws java.lang.Exception
        Description copied from interface: Transport
        Invokes an RPC call on other caches in the cluster.
        Specified by:
        invokeRemotely in interface Transport
        Parameters:
        recipients - a list of Addresses to invoke the call on. If this is null, the call is broadcast to the entire cluster.
        rpcCommand - the cache command to invoke
        mode - the response mode to use
        timeout - a timeout after which to throw a replication exception. implementations.
        responseFilter - a response filter with which to filter out failed/unwanted/invalid responses.
        deliverOrder - the DeliverOrder.
        anycast - used when {@param totalOrder} is true, it means that it must use TOA instead of TOB.
        Returns:
        a map of responses from each member contacted.
        Throws:
        java.lang.Exception - in the event of problems.

      • invokeRemotely

        public java.util.Map<Address,​Response> invokeRemotely​(java.util.Map<Address,​org.infinispan.commands.ReplicableCommand> rpcCommands,
                                                            ResponseMode mode,
                                                            long timeout,
                                                            boolean usePriorityQueue,
                                                            ResponseFilter responseFilter,
                                                            boolean totalOrder,
                                                            boolean anycast)
                                                     throws java.lang.Exception
        Specified by:
        invokeRemotely in interface Transport
        Throws:
        java.lang.Exception

      • invokeRemotelyAsync

        public java.util.concurrent.CompletableFuture<java.util.Map<Address,​Response>> invokeRemotelyAsync​(java.util.Collection<Address> recipients,
                                                                                                         org.infinispan.commands.ReplicableCommand rpcCommand,
                                                                                                         ResponseMode mode,
                                                                                                         long timeout,
                                                                                                         ResponseFilter responseFilter,
                                                                                                         DeliverOrder deliverOrder,
                                                                                                         boolean anycast)
                                                                                                  throws java.lang.Exception
        Specified by:
        invokeRemotelyAsync in interface Transport
        Throws:
        java.lang.Exception

      • sendTo

        public void sendTo​(Address destination,
                   org.infinispan.commands.ReplicableCommand rpcCommand,
                   DeliverOrder deliverOrder)
            throws java.lang.Exception
        Description copied from interface: Transport
        Asynchronously sends the ReplicableCommand to the destination using the specified DeliverOrder.
        Specified by:
        sendTo in interface Transport
        Parameters:
        destination - the destination's Address.
        rpcCommand - the ReplicableCommand to send.
        deliverOrder - the DeliverOrder to use.
        Throws:
        java.lang.Exception - if there was problem sending the request.

      • sendToMany

        public void sendToMany​(java.util.Collection<Address> destinations,
                       org.infinispan.commands.ReplicableCommand rpcCommand,
                       DeliverOrder deliverOrder)
                throws java.lang.Exception
        Description copied from interface: Transport
        Asynchronously sends the ReplicableCommand to the set of destination using the specified DeliverOrder.
        Specified by:
        sendToMany in interface Transport
        Parameters:
        destinations - the collection of destination's Address. If null, it sends to all the members in the cluster.
        rpcCommand - the ReplicableCommand to send.
        deliverOrder - the DeliverOrder to use.
        Throws:
        java.lang.Exception - if there was problem sending the request.

      • sendToAll

        public void sendToAll​(org.infinispan.commands.ReplicableCommand rpcCommand,
                      DeliverOrder deliverOrder)
               throws java.lang.Exception
        Description copied from interface: Transport
        Asynchronously sends the ReplicableCommand to the entire cluster.
        Specified by:
        sendToAll in interface Transport
        Throws:
        java.lang.Exception

      • backupRemotely

        public XSiteResponse backupRemotely​(XSiteBackup backup,
                                    XSiteReplicateCommand rpcCommand)
        Description copied from interface: Transport
        Sends a cross-site request to a remote site.

        Currently, no reply values are supported. Or the request completes successfully or it throws an Exception.

        If XSiteBackup.isSync() returns false, the XSiteResponse is only completed when the an ACK from the remote site is received. The invoker needs to make sure not to wait for the XSiteResponse.

        Specified by:
        backupRemotely in interface Transport
        Parameters:
        backup - The remote site.
        rpcCommand - The command to send.
        Returns:
        A XSiteResponse that is completed when the request is completed.

      • isCoordinator

        public boolean isCoordinator()
        Specified by:
        isCoordinator in interface Transport
        Returns:
        true if the current Channel is the coordinator of the cluster.

      • getCoordinator

        public Address getCoordinator()
        Specified by:
        getCoordinator in interface Transport
        Returns:
        the Address of the current coordinator.

      • getAddress

        public Address getAddress()
        Description copied from interface: Transport
        Retrieves the current cache instance's network address
        Specified by:
        getAddress in interface Transport
        Returns:
        an Address

      • getPhysicalAddresses

        public java.util.List<Address> getPhysicalAddresses()
        Description copied from interface: Transport
        Retrieves the current cache instance's physical network addresses. Some implementations might differentiate between logical and physical addresses in which case, this method allows clients to query the physical ones associated with the logical address. Implementations where logical and physical address are the same will simply return a single entry List that contains the same Address as Transport.getAddress().
        Specified by:
        getPhysicalAddresses in interface Transport
        Returns:
        an List of Address

      • getMembers

        public java.util.List<Address> getMembers()
        Description copied from interface: Transport
        Returns a list of members in the current cluster view.
        Specified by:
        getMembers in interface Transport
        Returns:
        a list of members. Typically, this would be defensively copied.

      • getMembersPhysicalAddresses

        public java.util.List<Address> getMembersPhysicalAddresses()
        Description copied from interface: Transport
        Returns physical addresses of members in the current cluster view.
        Specified by:
        getMembersPhysicalAddresses in interface Transport
        Returns:
        a list of physical addresses

      • isMulticastCapable

        public boolean isMulticastCapable()
        Description copied from interface: Transport
        Tests whether the transport supports true multicast
        Specified by:
        isMulticastCapable in interface Transport
        Returns:
        true if the transport supports true multicast

      • start

        public void start()
        Description copied from interface: Lifecycle
        Invoked on component start
        Specified by:
        start in interface Lifecycle
        Specified by:
        start in interface Transport

      • stop

        public void stop()
        Description copied from interface: Lifecycle
        Invoked on component stop
        Specified by:
        stop in interface Lifecycle
        Specified by:
        stop in interface Transport

      • withView

        public java.util.concurrent.CompletableFuture<java.lang.Void> withView​(int expectedViewId)
        Specified by:
        withView in interface Transport
        Returns:
        A CompletableFuture that completes when the transport has installed the expected view.

      • waitForView

        public void waitForView​(int viewId)
                 throws java.lang.InterruptedException
        Specified by:
        waitForView in interface Transport
        Throws:
        java.lang.InterruptedException

      • checkTotalOrderSupported

        public void checkTotalOrderSupported()
        Description copied from interface: Transport
        check if the transport has configured with total order deliver properties (has the sequencer in JGroups protocol stack.
        Specified by:
        checkTotalOrderSupported in interface Transport

      • getLog

        public org.infinispan.util.logging.Log getLog()
        Specified by:
        getLog in interface Transport

      • getDelegate

        public Transport getDelegate()

      • beforeInvokeRemotely

        protected void beforeInvokeRemotely​(org.infinispan.commands.ReplicableCommand command)
        method invoked before a remote invocation.
        Parameters:
        command - the command to be invoked remotely

      • afterInvokeRemotely

        protected java.util.Map<Address,​Response> afterInvokeRemotely​(org.infinispan.commands.ReplicableCommand command,
                                                                    java.util.Map<Address,​Response> responseMap)
        method invoked after a successful remote invocation.
        Parameters:
        command - the command invoked remotely.
        responseMap - can be null if not response is expected.
        Returns:
        the new response map

      • beforeBackupRemotely

        protected void beforeBackupRemotely​(XSiteReplicateCommand command)
        method invoked before a backup remote invocation.
        Parameters:
        command - the command to be invoked remotely

      • afterBackupRemotely

        @Deprecated
protected BackupResponse afterBackupRemotely​(org.infinispan.commands.ReplicableCommand command,
                                             BackupResponse response)
        Deprecated.
        since 10.0. Use afterBackupRemotely(ReplicableCommand, Throwable)
        method invoked after a successful backup remote invocation.
        Parameters:
        command - the command invoked remotely.
        response - can be null if not response is expected.
        Returns:
        the new response map

      • afterBackupRemotely

        protected void afterBackupRemotely​(org.infinispan.commands.ReplicableCommand command,
                                   java.lang.Throwable throwable)
        Method invoked after a cross-site request.
        Parameters:
        command - The command sent.
        throwable - The Throwable if the request failed, or null if successful.

      • getSitesView

        public java.util.Set<java.lang.String> getSitesView()
        Description copied from interface: Transport
        Get the view of interconnected sites. If no cross site replication has been configured, this method returns null. Inspecting the site view can be useful to see if the different sites have managed to join each other, which is pre-requisite to get cross replication working.
        Specified by:
        getSitesView in interface Transport
        Returns:
        set containing the connected sites, or null if no cross site replication has been enabled.

      • invokeCommand

        public <T> java.util.concurrent.CompletionStage<T> invokeCommand​(java.util.Collection<Address> targets,
                                                                 org.infinispan.commands.ReplicableCommand command,
                                                                 ResponseCollector<T> collector,
                                                                 DeliverOrder deliverOrder,
                                                                 long timeout,
                                                                 java.util.concurrent.TimeUnit unit)
        Description copied from interface: Transport
        Invoke a command on a collection of node and pass the responses to a ResponseCollector.

        If one of the targets is the local nodes and the delivery order is not DeliverOrder.TOTAL, the command is only executed on the remote nodes.

        Specified by:
        invokeCommand in interface Transport

      • invokeCommandOnAll

        public <T> java.util.concurrent.CompletionStage<T> invokeCommandOnAll​(org.infinispan.commands.ReplicableCommand command,
                                                                      ResponseCollector<T> collector,
                                                                      DeliverOrder deliverOrder,
                                                                      long timeout,
                                                                      java.util.concurrent.TimeUnit unit)
        Description copied from interface: Transport
        Invoke a command on all the nodes in the cluster and pass the responses to a ResponseCollector.

        The command is only executed on the local node if the delivery order is DeliverOrder.TOTAL. The command is not sent across RELAY2 bridges to remote sites.

        Specified by:
        invokeCommandOnAll in interface Transport

      • invokeCommandStaggered

        public <T> java.util.concurrent.CompletionStage<T> invokeCommandStaggered​(java.util.Collection<Address> targets,
                                                                          org.infinispan.commands.ReplicableCommand command,
                                                                          ResponseCollector<T> collector,
                                                                          DeliverOrder deliverOrder,
                                                                          long timeout,
                                                                          java.util.concurrent.TimeUnit unit)
        Description copied from interface: Transport
        Invoke a command on a collection of nodes and pass the responses to a ResponseCollector.

        The command is only sent immediately to the first target, and there is an implementation-dependent delay before sending the command to each target. There is no delay if the target responds or leaves the cluster. The remaining targets are skipped if ResponseCollector.addResponse(Address, Response) returns a non-null value.

        If one of the targets is the local node and the delivery order is not DeliverOrder.TOTAL, the command is only executed on the remote nodes.

        Specified by:
        invokeCommandStaggered in interface Transport

      • invokeCommands

        public <T> java.util.concurrent.CompletionStage<T> invokeCommands​(java.util.Collection<Address> targets,
                                                                  java.util.function.Function<Address,​org.infinispan.commands.ReplicableCommand> commandGenerator,
                                                                  ResponseCollector<T> collector,
                                                                  DeliverOrder deliverOrder,
                                                                  long timeout,
                                                                  java.util.concurrent.TimeUnit timeUnit)
        Description copied from interface: Transport
        Invoke different commands on a collection of nodes and pass the responses to a ResponseCollector.

        If one of the targets is the local node and the delivery order is not DeliverOrder.TOTAL, the command is only executed on the remote nodes.

        Specified by:
        invokeCommands in interface Transport