Package org.infinispan.statetransfer

Class StateRequestCommand

  • All Implemented Interfaces:
    org.infinispan.commands.InitializableCommand, org.infinispan.commands.remote.CacheRpcCommand, org.infinispan.commands.ReplicableCommand, org.infinispan.commands.TopologyAffectedCommand
    public class StateRequestCommand
extends org.infinispan.commands.remote.BaseRpcCommand
implements org.infinispan.commands.InitializableCommand, org.infinispan.commands.TopologyAffectedCommand
    This command is used by a StateConsumer to request transactions and cache entries from a StateProvider.
    Since:
    5.2
    Author:
    anistor@redhat.com

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static byte COMMAND_ID  

      • Fields inherited from class org.infinispan.commands.remote.BaseRpcCommand

        cacheName

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      boolean canBlock()
      If true, the command is processed asynchronously in a thread provided by an Infinispan thread pool.
      byte getCommandId()
      Used by marshallers to convert this command into an id for streaming.
      IntSet getSegments()  
      int getTopologyId()  
      StateRequestCommand.Type getType()  
      void init​(ComponentRegistry componentRegistry, boolean isRemote)  
      java.util.concurrent.CompletableFuture<java.lang.Object> invokeAsync()
      Invoke the command asynchronously.
      boolean isReturnValueExpected()
      If true, a return value will be provided when performed remotely.
      void readFrom​(java.io.ObjectInput input)
      Reads this instance from the stream written by ReplicableCommand.writeTo(ObjectOutput).
      void setTopologyId​(int topologyId)  
      java.lang.String toString()  
      void writeTo​(java.io.ObjectOutput output)
      Writes this instance to the ObjectOutput.

      • Methods inherited from class org.infinispan.commands.remote.BaseRpcCommand

        getCacheName, getOrigin, setOrigin

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

      • Methods inherited from interface org.infinispan.commands.ReplicableCommand

        invoke, isSuccessful, perform

    • Method Detail

      • init

        public void init​(ComponentRegistry componentRegistry,
                 boolean isRemote)
        Specified by:
        init in interface org.infinispan.commands.InitializableCommand

      • invokeAsync

        public java.util.concurrent.CompletableFuture<java.lang.Object> invokeAsync()
                                                                     throws java.lang.Throwable
        Description copied from interface: org.infinispan.commands.ReplicableCommand
        Invoke the command asynchronously.

        This method replaces ReplicableCommand.perform(InvocationContext) for remote execution. The default implementation and ReplicableCommand.perform(InvocationContext) will be removed in future versions.

        Specified by:
        invokeAsync in interface org.infinispan.commands.ReplicableCommand
        Throws:
        java.lang.Throwable

      • isReturnValueExpected

        public boolean isReturnValueExpected()
        Description copied from interface: org.infinispan.commands.ReplicableCommand
        If true, a return value will be provided when performed remotely. Otherwise, a remote ResponseGenerator may choose to simply return null to save on marshalling costs.
        Specified by:
        isReturnValueExpected in interface org.infinispan.commands.ReplicableCommand
        Returns:
        true or false

      • canBlock

        public boolean canBlock()
        Description copied from interface: org.infinispan.commands.ReplicableCommand
        If true, the command is processed asynchronously in a thread provided by an Infinispan thread pool. Otherwise, the command is processed directly in the JGroups thread.

        This feature allows to avoid keep a JGroups thread busy that can originate discard of messages and retransmissions. So, the commands that can block (waiting for some state, acquiring locks, etc.) should return true.

        Specified by:
        canBlock in interface org.infinispan.commands.ReplicableCommand
        Overrides:
        canBlock in class org.infinispan.commands.remote.BaseRpcCommand
        Returns:
        true if the command can block/wait, false otherwise

      • getTopologyId

        public int getTopologyId()
        Specified by:
        getTopologyId in interface org.infinispan.commands.TopologyAffectedCommand

      • setTopologyId

        public void setTopologyId​(int topologyId)
        Specified by:
        setTopologyId in interface org.infinispan.commands.TopologyAffectedCommand

      • getSegments

        public IntSet getSegments()

      • getCommandId

        public byte getCommandId()
        Description copied from interface: org.infinispan.commands.ReplicableCommand
        Used by marshallers to convert this command into an id for streaming.
        Specified by:
        getCommandId in interface org.infinispan.commands.ReplicableCommand
        Returns:
        the method id of this command. This is compatible with pre-2.2.0 MethodCall ids.

      • writeTo

        public void writeTo​(java.io.ObjectOutput output)
             throws java.io.IOException
        Description copied from interface: org.infinispan.commands.ReplicableCommand
        Writes this instance to the ObjectOutput.
        Specified by:
        writeTo in interface org.infinispan.commands.ReplicableCommand
        Parameters:
        output - the stream.
        Throws:
        java.io.IOException - if an error occurred during the I/O.

      • readFrom

        public void readFrom​(java.io.ObjectInput input)
              throws java.io.IOException,
                     java.lang.ClassNotFoundException
        Description copied from interface: org.infinispan.commands.ReplicableCommand
        Reads this instance from the stream written by ReplicableCommand.writeTo(ObjectOutput).
        Specified by:
        readFrom in interface org.infinispan.commands.ReplicableCommand
        Parameters:
        input - the stream to read.
        Throws:
        java.io.IOException - if an error occurred during the I/O.
        java.lang.ClassNotFoundException - if it tries to load an undefined class.

      • toString

        public java.lang.String toString()
        Overrides:
        toString in class org.infinispan.commands.remote.BaseRpcCommand