com.amazonaws.services.kinesis.leases.interfaces

Interface ILeaseTaker<T extends Lease>

All Known Implementing Classes:

LeaseTaker

public interface ILeaseTaker<T extends Lease>

ILeaseTaker is used by LeaseCoordinator to take new leases, or leases that other workers fail to renew. Each LeaseCoordinator instance corresponds to one worker and uses exactly one ILeaseTaker to take leases for that worker.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	getWorkerIdentifier()
java.util.Map<java.lang.String,T>	takeLeases() Compute the set of leases available to be taken and attempt to take them.

Method Detail

takeLeases

java.util.Map<java.lang.String,T> takeLeases()
                                                           throws DependencyException,
                                                                  InvalidStateException

Compute the set of leases available to be taken and attempt to take them. Lease taking rules are: 1) If a lease's counter hasn't changed in long enough, try to take it. 2) If we see a lease we've never seen before, take it only if owner == null. If it's owned, odds are the owner is holding it. We can't tell until we see it more than once. 3) For load balancing purposes, you may violate rules 1 and 2 for EXACTLY ONE lease per call of takeLeases().

Returns:

map of shardId to Lease object for leases we just successfully took.

Throws:

DependencyException - on unexpected DynamoDB failures

InvalidStateException - if lease table does not exist

getWorkerIdentifier

java.lang.String getWorkerIdentifier()

Returns:

workerIdentifier for this LeaseTaker