<img src="https://avatars2.githubusercontent.com/u/2344919?v=2&s=250" align="right">
Java driver for Tarantool Cartridge for Tarantool versions 1.10+ based on the asynchronous Netty framework and official MessagePack serializer. Provides CRUD APIs for seamlessly working with standalone Tarantool servers and clusters managed by Tarantool Cartridge with sharding via vshard.
Here is an easy way to try using Tarantool together with this Java driver.
Look at the single instance test to start experimenting with a single Tarantool server instance and a simple Java app. You can set breakpoints and run it in "debug" mode using your IDE. Testcontainers library will start a single instance Tarantool server for you. Try to manipulate data in Tarantool in real time through evaluating Java expressions in debug mode or using the Tarantool console.
If you want to start a simple Tarantool application manually, all you need is to install Tarantool and run it with this file:
tarantool src/test/resources/single-instance.lua
Example of creating a TarantoolClient
instance:
https://github.com/tarantool/cartridge-java/blob/2f8e826deb9833a5deb6d21177527a46e8fdd039/src/test/java/io/tarantool/driver/integration/SingleInstanceExampleTest.java#L51-L59
Example of the TarantoolClient
API usage:
https://github.com/tarantool/cartridge-java/blob/2f8e826deb9833a5deb6d21177527a46e8fdd039/src/test/java/io/tarantool/driver/integration/SingleInstanceExampleTest.java#L64-L79
If you use this code in another project don't forget to add a cartridge-driver
dependency:
<dependency>
<groupId>io.tarantool</groupId>
<artifactId>cartridge-driver</artifactId>
<version>0.14.0</version>
</dependency>
The Java Docs are available at Github pages.
If you have any questions about working with Tarantool, check out the site tarantool.io.
Feel free to ask questions about Tarantool and usage of this driver on Stack Overflow with tag tarantool or join our community support chats in Telegram: English and Russian.
Java 1.8 or higher is required for building and using this driver.
export TARANTOOL_SERVER_USER=<current user>
export TARANTOOL_SERVER_GROUP=<current group>
Substitute the user and group in these commands with the user and group under which the tests will run.
./mvnw verify
to run unit tests and ./mvnw test -Pintegration
to run integration tests../mvnw install
for installing the artifact locally.Contributions to this project are always welcome and highly encouraged. See conventions for tests