Amazon MemoryDB for Redis - Java client examples
This repository contains examples for using Java clients to interact with Amazon MemoryDB for Redis. These examples demonstrate the following,
- How to connect/disconnect to Amazon MemoryDB for Redis using the open-source Redis client Jedis.
- Add/update records to the database.
- Retrieve records by key and field/path.
- Delete records by key.
Overview
Amazon MemoryDB for Redis is a durable, in-memory database service that delivers ultra-fast performance, while removing the complexity associated with deploying and managing a distributed environment. It is compatible with the open source Redis data store.
Repository structure
This repository contains the following directories,
-
src - the Java source files for the sample programs.
-
pom - the Maven POM file to build the sample programs.
-
config - the configuration properties used by the sample programs.
Prerequisites to run the examples
Prior to running these examples, make sure you have all the following components configured in the same AWS region and in the same AWS account.
Amazon MemoryDB for Redis clusters:
- An Amazon MemoryDB for Redis cluster in private subnet groups in the same VPC. Refer here.
- A username with the appropriate access string configured in the cluster's Access Control List (ACL). Refer here.
Security groups:
- The security group should provide inbound TCP access on port 6379 from the EC2 instance that is to be configured in the following steps.
Amazon EC2 instance:
- An Amazon EC2 instance in Linux/Windows in the same VPC as the MemoryDB clusters created in the previous steps. The subnet should be private, preferably one that is part of the private subnet group configured for the MemoryDB clusters.
- Java 11 (Amazon Corretto 11 or Oracle JDK 11) should be installed in this instance.
How to run the examples
-
Build the source code provided in the
src
folder along with the Maven POM file provided in thepom
folder. -
Configure the following in the
MemoryDB_for_Redis_config.properties
file provided in theconfig
folder:a. Specify the MemoryDB cluster endpoint hostname.
b. Specify the MemoryDB cluster endpoint port.
c. The username for connecting to the cluster as configured in the cluster's ACL.
d. The password corresponding to the above username.
e. If you prefer, you can leave the other properties as-is; else update them as required.
-
Run the built programs and observe the output.
Security
See CONTRIBUTING for more information.
License
This library is licensed under the MIT-0 License. See the LICENSE file.