jetcd is the official java client for etcdv3.
Note: jetcd is work-in-progress and may break backward compatibility.
Java 8 or above is required.
<dependency>
<groupId>com.coreos</groupId>
<artifactId>jetcd-core</artifactId>
<version>0.0.2</version>
</dependency>Development snapshots are available in Sonatypes's snapshot repository.
dependencies {
compile 'com.coreos:jetcd-core:0.0.2'
}
Download latest jetcd-core jar from Maven and all its dependent jars:
grpc-core-1.10.0.jar grpc-netty-1.10.0.jar grpc-protobuf-1.10.0.jar grpc-stub-1.10.0.jar slf4j-api-1.7.2.jar
// create client
Client client = Client.builder().endpoints("https://localhost:2379").build();
KV kvClient = client.getKVClient();
ByteSequence key = ByteSequence.fromString("test_key");
ByteSequence value = ByteSequence.fromString("test_value");
// put the key-value
kvClient.put(key, value).get();
// get the CompletableFuture
CompletableFuture<GetResponse> getFuture = kvClient.get(key);
// get the value from CompletableFuture
GetResponse response = getFuture.get();
// delete the key
DeleteResponse deleteRangeResponse = kvClient.delete(key).get();For full etcd v3 API, plesase refer to API_Reference.
The examples are standalone projects that show usage of jetcd.
The project follows Semantic Versioning.
The current major version is zero (0.y.z). Anything may change at any time. The public API should not be considered stable.
The project is to be tested against a three node etcd setup, which automatically launched via Testcontainers framework.
For more info and prerequisites visit official website
It should work on either macOS or Linux.
$ mvn test
...
[INFO] T E S T S
[INFO] -------------------------------------------------------
[INFO] Running TestSuite
[WARNING] Tests run: 104, Failures: 0, Errors: 0, Skipped: 3, Time elapsed: 31.308 s - in TestSuite
[INFO]
[INFO] Results:
[INFO]
[WARNING] Tests run: 104, Failures: 0, Errors: 0, Skipped: 3
...
[INFO] Reactor Summary:
[INFO]
[INFO] jetcd .............................................. SUCCESS [ 0.010 s]
[INFO] jetcd-core ......................................... SUCCESS [ 55.480 s]
[INFO] jetcd-discovery-dns-srv ............................ SUCCESS [ 3.225 s]
[INFO] jetcd-watch-example ................................ SUCCESS [ 0.291 s]
[INFO] jetcd-simple-ctl ................................... SUCCESS [ 0.028 s]
[INFO] jetcd-examples ..................................... SUCCESS [ 0.000 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 59.929 s
[INFO] Finished at: 2018-02-13T12:51:13-08:00
[INFO] Final Memory: 84M/443M- Mailing list: etcd-dev
- IRC: #etcd on freenode.org
See CONTRIBUTING for details on submitting patches and the contribution workflow.
See reporting bugs for details about reporting any issues.
jetcd is under the Apache 2.0 license. See the LICENSE file for details.