Curator n ˈkyoor͝ˌātər: a keeper or custodian of a museum or other collection - A ZooKeeper Keeper.
Apache Curator is a Java/JVM client library for Apache ZooKeeper, a distributed coordination service. It includes a highlevel API framework and utilities to make using Apache ZooKeeper much easier and more reliable. It also includes recipes for common use cases and extensions such as service discovery and a Java 8 asynchronous DSL.
See the page for quick start: Getting Started.
|Recipes||Implementations of some of the common ZooKeeper "recipes". The implementations are built on top of the Curator Framework.|
|Framework||The Curator Framework is a high-level API that greatly simplifies using ZooKeeper. It adds many features that build on ZooKeeper and handles the complexity of managing connections to the ZooKeeper cluster and retrying operations.|
|Utilities||Various utilities that are useful when using ZooKeeper.|
|Client||A replacement for the bundled ZooKeeper class that takes care of some low-level housekeeping and provides some useful utilities.|
|Errors||How Curator deals with errors, connection issues, recoverable exceptions, etc.|
|Extensions||The curator-recipes package implements the common recipes that are described in the ZooKeeper documentation. To avoid bloating that package, recipes/applications that have a vertical appeal will be put in separate "extension" packages using the naming convention curator-x-name.|
Curator binaries are published to Maven Central. Curator consists of several artifacts. Which artifacts to use depends on your needs. For most users, the only artifact you need is curator-recipes.
|org.apache.curator||curator-recipes||All of the recipes. Note: this artifact has dependencies on client and framework and, so, Maven (or whatever tool you're using) should pull those in automatically.|
|org.apache.curator||curator-framework||The Curator Framework high level API. This is built on top of the client and should pull it in automatically.|
|org.apache.curator||curator-client||The Curator Client - replacement for the ZooKeeper class in the ZK distribution.|
|org.apache.curator||curator-test||Contains the TestingServer, the TestingCluster and a few other tools useful for testing.|
|org.apache.curator||curator-examples||Example usages of various Curator features.|
|org.apache.curator||curator-x-discovery||A Service Discovery implementation built on the Curator Framework.|
|org.apache.curator||curator-x-discoveryserver||A RESTful server that can be used with Curator Discovery.|
|org.apache.curator||curator-x-rpc||A proxy that bridges non-java environments with the Curator framework and recipes.|
The are currently two released versions of Curator, 2.x.x and 3.x.x:
ZooKeeper 3.5.x adds a number of new features including dynamic reconfiguration, watcher removal and others. The Curator 3.x.x Jira issues tracking these features are here: https://issues.apache.org/jira/browse/CURATOR-159.