Class TransportReplicationAction.ReplicasProxy
- java.lang.Object
-
- org.elasticsearch.action.support.replication.TransportReplicationAction.ReplicasProxy
-
- All Implemented Interfaces:
ReplicationOperation.Replicas<ReplicaRequest>
- Enclosing class:
- TransportReplicationAction<Request extends ReplicationRequest<Request>,ReplicaRequest extends ReplicationRequest<ReplicaRequest>,Response extends ReplicationResponse>
protected class TransportReplicationAction.ReplicasProxy extends java.lang.Object implements ReplicationOperation.Replicas<ReplicaRequest>
TheReplicasProxy
is an implementation of theReplicas
interface that performs the actualReplicaRequest
on the replica shards. It also encapsulates the logic required for failing the replica if deemed necessary as well as marking it as stale when needed.
-
-
Field Summary
Fields Modifier and Type Field Description protected long
primaryTerm
-
Constructor Summary
Constructors Constructor Description ReplicasProxy(long primaryTerm)
-
Method Summary
Modifier and Type Method Description void
failShardIfNeeded(ShardRouting replica, java.lang.String message, java.lang.Exception exception, ActionListener<java.lang.Void> listener)
Fail the specified shard if needed, removing it from the current set of active shards.void
markShardCopyAsStaleIfNeeded(ShardId shardId, java.lang.String allocationId, ActionListener<java.lang.Void> listener)
Marks shard copy as stale if needed, removing its allocation id from the set of in-sync allocation ids.void
performOn(ShardRouting replica, ReplicaRequest request, long globalCheckpoint, long maxSeqNoOfUpdatesOrDeletes, ActionListener<ReplicationOperation.ReplicaResponse> listener)
Performs the specified request on the specified replica.
-
-
-
Method Detail
-
performOn
public void performOn(ShardRouting replica, ReplicaRequest request, long globalCheckpoint, long maxSeqNoOfUpdatesOrDeletes, ActionListener<ReplicationOperation.ReplicaResponse> listener)
Description copied from interface:ReplicationOperation.Replicas
Performs the specified request on the specified replica.- Specified by:
performOn
in interfaceReplicationOperation.Replicas<ReplicaRequest extends ReplicationRequest<ReplicaRequest>>
- Parameters:
replica
- the shard this request should be executed onrequest
- the operation to performglobalCheckpoint
- the global checkpoint on the primarymaxSeqNoOfUpdatesOrDeletes
- the max seq_no of updates (index operations overwriting Lucene) or deletes on primary after this replication was executed on it.listener
- callback for handling the response or failure
-
failShardIfNeeded
public void failShardIfNeeded(ShardRouting replica, java.lang.String message, java.lang.Exception exception, ActionListener<java.lang.Void> listener)
Description copied from interface:ReplicationOperation.Replicas
Fail the specified shard if needed, removing it from the current set of active shards. Whether a failure is needed is left up to the implementation.- Specified by:
failShardIfNeeded
in interfaceReplicationOperation.Replicas<ReplicaRequest extends ReplicationRequest<ReplicaRequest>>
- Parameters:
replica
- shard to failmessage
- a (short) description of the reasonexception
- the original exception which caused the ReplicationOperation to request the shard to be failedlistener
- a listener that will be notified when the failing shard has been removed from the in-sync set
-
markShardCopyAsStaleIfNeeded
public void markShardCopyAsStaleIfNeeded(ShardId shardId, java.lang.String allocationId, ActionListener<java.lang.Void> listener)
Description copied from interface:ReplicationOperation.Replicas
Marks shard copy as stale if needed, removing its allocation id from the set of in-sync allocation ids. Whether marking as stale is needed is left up to the implementation.- Specified by:
markShardCopyAsStaleIfNeeded
in interfaceReplicationOperation.Replicas<ReplicaRequest extends ReplicationRequest<ReplicaRequest>>
- Parameters:
shardId
- shard idallocationId
- allocation id to remove from the set of in-sync allocation idslistener
- a listener that will be notified when the failing shard has been removed from the in-sync set
-
-