An access control list assignable to a ZooKeeper node.
An access control list assignable to a ZooKeeper node.
the identity to which permissions apply
the bitwise union of permissions that apply to this ACL
A ZooKeeper client with asynchronous and watchable operations.
A ZooKeeper client with asynchronous operations.
A check operation.
A check operation.
the path of the node
a Some
containing the expected version of the node or None
if a version match is not required
A problem with a check operation.
A problem with a check operation.
the check operation corresponding to this problem
a Some
containing the exception that led to this problem or None
if no problem was reported
The result of a check operation.
The result of a check operation.
the check operation corresponding to this result
An event indicating that the children associated with a node were changed.
A client configuration for connecting to a ZooKeeper cluster.
A create operation.
A create operation.
the path of the node
the data to associate with the node
the ACL to associate with the node
the disposition of the node
A problem with a create operation.
A problem with a create operation.
the create operation corresponding to this problem
a Some
containing the exception that led to this problem or None
if no problem was reported
The result of a create operation.
The result of a create operation.
the create operation corresponding to this result
the final path of the created node, which will differ from the path in op
if either PersistentSequential
or EphemeralSequential disposition is specified
An event indicating that a node was created.
A credential with a ZooKeeper session.
An event indicating that the data associated with a node was changed.
A delete operation.
A delete operation.
the path of the node
a Some
containing the expected version of the node or None
if a version match is not required
A problem with a delete operation.
A problem with a delete operation.
the delete operation corresponding to this problem
a Some
containing the exception that led to this problem or None
if no problem was reported
The result of a delete operation.
The result of a delete operation.
the delete operation corresponding to this result
An event indicating that a node was deleted.
An identity whose scheme is "digest"
and id is equal to "username:password"
.
Specifies the disposition of nodes when created.
An event generated by ZooKeeper.
An identity whose scheme is "host"
and id is equal to "domain"
.
An identity associated with an ACL.
An identity whose scheme is "ip"
and id is equal to "addr/prefix"
.
Represents a node in ZooKeeper.
A category of events representing changes to nodes.
An operation that may be composed with others to form an atomic transaction to ZooKeeper.
Represents an absolute or relative path to a node in ZooKeeper.
Represents an absolute or relative path to a node in ZooKeeper.
An absolute path starts with the /
character. All other forms are considered relative. Paths are virtually
identical to those on Unix file systems and may include both .
and ..
parts, indicating the current and parent node,
respectively.
Examples:
"/" "../foo" "/foo/bar" "./foo/../bar"
A problem with an operation in the context of an atomic operation.
The result of an operation within an atomic transaction.
A session established with ZooKeeper.
A session established with ZooKeeper.
Note that a session, particularly the life cycle, is managed by ZooKeeper servers, not the client. Under normal
circumstances in which the client explicitly disconnects from the ZooKeeper cluster, its session is automatically expired.
However, in cases where the client does not properly disconnect, ZooKeeper retains the session for a period of time defined
by timeout
.
A set operation.
A set operation.
the path of the node
the data to associate with the node
a Some
containing the expected version of the node or None
if a version match is not required
A problem with a set operation.
A problem with a set operation.
the set operation corrresponding to this problem
a Some
containing the exception that led to this problem or None
if no problem was reported
The result of a set operation.
The result of a set operation.
the set operation corresponding to this result
A category of events representing state changes to sessions.
The status of a ZooKeeper node.
The status of a ZooKeeper node.
Each modification to ZooKeeper is stamped with a monotonically-increasing sequence number, known as a transaction id or
zxid, which conveys a total ordering of all changes. Thus, given any two changes, A and B, denoted by transaction ids,
zxidA
and zxidB
, respectively, A is said to happen before B if zxidA
< zxidB
. Note that the
transaction id is scoped to the entire ZooKeeper repository, not to individual nodes.
In addition to stamping all repository changes with a transaction id, which establishes total order, each modification to a given node also causes some version of that node to increment.
A ZooKeeper client with synchronous and watchable operations.
A ZooKeeper client with synchronous operations.
An instance of a ZooKeeper client.
Constructs and deconstructs ACL values.
Constructs and deconstructs ACL values.
The permissions assigned to an ACL are constructed by performing a bitwise union of individual permission attributes: Read, Write, Create, Delete, Admin. In addition, the All permission encompasses all of these attributes.
Several commonly used ACL values have been predefined for sake of convenience: AnyoneAll, AnyoneRead, CreatorAll.
Constructs AsynchronousZookeeper values.
Constructs AsynchronousZookeeper values.
This companion object is provided as a convenience and is equivalent to:
Zookeeper(...).async
An event indicating that the client successfully authenticated with ZooKeeper.
An event indicating that the client failed to authenticate with ZooKeeper.
Constructs and deconstructs Configuration values.
Constructs and deconstructs Configuration values.
A configuration is constructed by first specifying required attributes via Configuration()
and then attaching
optional attributes as necessary. A set of implicit methods conveniently convert between instances of Configuration
and Builder.
Example:
val config = Configuration { ("foo.server.com", 2181) :: ("bar.server.com", 2181) :: Nil } withTimeout { 60 seconds } withWatcher { (event, session) => // ... }
The type of config
above is Builder since an implicit conversion occurred when attaching
optional attributes using the various with
methods. An explicit conversion back to Configuration, which can be
accomplished using build()
, is unnecessary since another implicit will perform this function automatically.
An event indicating that the client is connected to ZooKeeper.
An event indicating that the client is connected to ZooKeeper in a read-only manner.
Constructs and deconstructs Credential values.
An event indicating that the client is not connected to ZooKeeper.
Indicates that a node will be automatically deleted when the creator disconnects from ZooKeeper.
Indicates that a node will be automatically deleted when the creator disconnects from ZooKeeper and that the name will be appended with a monotonically increasing number.
An event indicating that the client session has been expired by ZooKeeper.
Constructs and deconstructs Id values.
Constructs and deconstructs Id values.
An Id is composed of two parts: a scheme and an id. There exists only a finite set of schemes recognized by ZooKeeper, which are noted below. The acceptable form of id depends on the chosen scheme.
Schemes
world
-- id must be "anyone"
.
auth
-- id must be ""
(empty string).
digest
-- id must be of the form "username:password"
.
host
-- id should be an Internet domain name.
ip
-- id must be a valid IPv4 or IPv6 address with an optional network prefix, variations of which follow:
"addr"
where prefix is assumed to be 32
and 128
for IPv4 and IPv6, respectively."addr/prefix"
where prefix is in the range [0,32]
and [0,128]
for IPv4 and IPv6, respectively.
Constructs and deconstructs Node values.
Constructs and deconstructs Path values.
Indicates that a node will persist when the creator disconnects from ZooKeeper.
Indicates that a node will persist when the creator disconnects from ZooKeeper and that the name will be appended with a monotonically increasing number.
Constructs and deconstructs Session values.
Constructs SynchronousZookeeper values.
Constructs SynchronousZookeeper values.
This companion object is provided as a convenience and is equivalent to:
Zookeeper(...).sync
Constructs Zookeeper values.
Converts the tuple (host,port) to an Internet socket address.
Converts the tuple (host,port) to an Internet socket address.
an InetSocketAddress
composed from the given addr
tuple
A Scala API for ZooKeeper.