Connect with Java

Learn how to establish a connection to your Aiven for Caching service using Java and the jedis library.

Variables

Replace the following placeholders in the code sample with actual values from your service overview page:

Variable	Description
SERVICE_URI	URI for the Aiven for Caching connection, from the service overview page

Prerequisites

With maven installed, use the following commands to download jedis and its dependencies into the lib folder:

mvn org.apache.maven.plugins:maven-dependency-plugin:2.8:get -Dartifact=redis.clients:jedis:4.1.1:jar -Ddest=lib/jedis-4.1.1.jar \
&& mvn org.apache.maven.plugins:maven-dependency-plugin:2.8:get -Dartifact=org.apache.commons:commons-pool2:2.11.1:jar -Ddest=lib/commons-pool2-2.11.1.jar \
&& mvn org.apache.maven.plugins:maven-dependency-plugin:2.8:get -Dartifact=org.slf4j:slf4j-api:1.7.35:jar -Ddest=lib/slf4j-api-1.7.35.jar \
&& mvn org.apache.maven.plugins:maven-dependency-plugin:2.8:get -Dartifact=com.google.code.gson:gson:2.8.9:jar -Ddest=lib/gson-2.8.9.jar

If maven is not installed, download the dependencies from the Maven Central Repository and place them in the lib folder manually.

Code

Create a file named CachingExample.java and insert the code below, substituting the placeholder with your Aiven for Caching URI:

import redis.clients.jedis.JedisPooled;

public class RedisExample {

    public static void main(String[] args) {
        if (args.length != 1) {
            throw new IllegalArgumentException("Expected only one argument redis URI");
        } else {
            JedisPooled jedisPooled = new JedisPooled(args[0]);
            jedisPooled.set("key", "hello world");
            System.out.println("The value of key is: " + jedisPooled.get("key"));
        }
    }
}

This code connects to Aiven for Caching, sets a key named key with the value hello world (without expiration), then retrieves and prints the value of this key.

Replace the placeholder with the SERVICE_URI, compile and run the code:

javac -cp lib/*:. CachingExample.java && java -cp lib/*:. CachingExample SERVICE_URI

Successful execution results in the following output:

The value of key is: hello world