org.lable.oss.uniqueid.zookeeper

Class ResourceClaim

java.lang.Object

org.lable.oss.uniqueid.zookeeper.ResourceClaim

All Implemented Interfaces:

Closeable, AutoCloseable, ZooKeeperConnectionObserver

Direct Known Subclasses:

ExpiringResourceClaim

public class ResourceClaim
extends Object
implements ZooKeeperConnectionObserver, Closeable

Represents a claim on resource (represented by an int) from a finite pool of resources negotiated through a queueing protocol facilitated by a ZooKeeper-quorum.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ResourceClaim.State Internal state of this ResourceClaim.

Field Summary

Fields

Modifier and Type	Field and Description
protected ResourceClaim.State	state

Method Summary

Modifier and Type	Method and Description
static ResourceClaim	claim(ZooKeeperConnection zooKeeperConnection, int poolSize, String znode) Claim a resource.
void	close() Relinquish the claim to this resource, and release it back to the resource pool.
void	close(boolean nodeAlreadyDeleted)
void	connected() Called when the connection to the ZooKeeper quorum is established.
void	disconnected() Called when the connection to the ZooKeeper quorum was interrupted.
int	get() Get the claimed resource.
String	getConfiguredZNode()

Methods inherited from class java.lang.Object

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

Field Detail

state

protected ResourceClaim.State state

Method Detail

claim

public static ResourceClaim claim(ZooKeeperConnection zooKeeperConnection,
                                  int poolSize,
                                  String znode)
                           throws IOException

Claim a resource.

Parameters:

zooKeeperConnection - ZooKeeper connection to use.

poolSize - Size of the resource pool.

znode - Root znode of the ZooKeeper resource-pool.

Returns:

A resource claim.

Throws:

IOException

get

public int get()

Get the claimed resource.

Returns:

The resource claimed.

Throws:

IllegalStateException - Thrown when the claim is no longer held.

close

public void close()

Relinquish the claim to this resource, and release it back to the resource pool.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

close

public void close(boolean nodeAlreadyDeleted)

getConfiguredZNode

public String getConfiguredZNode()

disconnected

public void disconnected()

Description copied from interface: ZooKeeperConnectionObserver

Called when the connection to the ZooKeeper quorum was interrupted.

Specified by:

disconnected in interface ZooKeeperConnectionObserver

connected

public void connected()

Description copied from interface: ZooKeeperConnectionObserver

Called when the connection to the ZooKeeper quorum is established.

Specified by:

connected in interface ZooKeeperConnectionObserver