base on Redis Java client # Jedis [](https://github.com/redis/jedis/releases/latest) [](https://search.maven.org/artifact/redis.clients/jedis) [](https://www.javadoc.io/doc/redis.clients/jedis) [](./LICENSE.txt) [](https://github.com/redis/jedis/actions/workflows/integration.yml) [](https://codecov.io/gh/redis/jedis) [](https://discord.gg/redis) ## What is Jedis? Jedis is a Java client for [Redis](https://github.com/redis/redis "Redis") designed for performance and ease of use. Are you looking for a high-level library to handle object mapping? See [redis-om-spring](https://github.com/redis/redis-om-spring)! ## How do I Redis? [Learn for free at Redis University](https://university.redis.io/academy/) [Try the Redis Cloud](https://redis.io/try-free/) [Dive in developer tutorials](https://redis.io/learn/) [Join the Redis community](https://redis.io/community/) [Work at Redis](https://redis.io/careers/jobs/) ## Supported Redis versions The most recent version of this library supports redis version [5.0](https://github.com/redis/redis/blob/5.0/00-RELEASENOTES), [6.0](https://github.com/redis/redis/blob/6.0/00-RELEASENOTES), [6.2](https://github.com/redis/redis/blob/6.2/00-RELEASENOTES), [7.0](https://github.com/redis/redis/blob/7.0/00-RELEASENOTES), [7.2](https://github.com/redis/redis/blob/7.2/00-RELEASENOTES) and [7.4](https://github.com/redis/redis/blob/7.4/00-RELEASENOTES). The table below highlights version compatibility of the most-recent library versions and Redis versions. Compatibility means communication features, and Redis command capabilities. | Jedis version | Supported Redis versions | JDK Compatibility | |---------------|---------------------------------------|-------------------| | 3.9+ | 5.0 to 6.2 Family of releases | 8, 11 | | >= 4.0 | Version 5.0 to 7.2 Family of releases | 8, 11, 17 | | >= 5.0 | Version 6.0 to current | 8, 11, 17, 21 | | >= 5.2 | Version 7.2 to current | 8, 11, 17, 21 | ## Getting started To get started with Jedis, first add it as a dependency in your Java project. If you're using Maven, that looks like this: ```xml <dependency> <groupId>redis.clients</groupId> <artifactId>jedis</artifactId> <version>5.2.0</version> </dependency> ``` To use the cutting-edge Jedis, check [here](/docs/jedis-maven.md). Next, you'll need to connect to Redis. Consider installing a redis-stack docker: ```bash docker run -p 6379:6379 -it redis/redis-stack:latest ``` For many applications, it's best to use a connection pool. You can instantiate a Jedis connection pool like so: ```java JedisPool pool = new JedisPool("localhost", 6379); ``` With a `JedisPool` instance, you can use a [try-with-resources](https://docs.oracle.com/javase/tutorial/essential/exceptions/tryResourceClose.html) block to get a connection and run Redis commands. Here's how to run a single [SET](https://redis.io/commands/set) command within a *try-with-resources* block: ```java try (Jedis jedis = pool.getResource()) { jedis.set("clientName", "Jedis"); } ``` `Jedis` instances implement most Redis commands. See the [Jedis Javadocs](https://www.javadoc.io/doc/redis.clients/jedis/latest/redis/clients/jedis/Jedis.html) for the complete list of supported commands. ### Easier way of using connection pool Using a *try-with-resources* block for each command may be cumbersome, so you may consider using JedisPooled. ```java JedisPooled jedis = new JedisPooled("localhost", 6379); ``` Now you can send commands like sending from Jedis. ```java jedis.sadd("planets", "Venus"); ``` ## Connecting to a Redis cluster Jedis lets you connect to Redis Clusters, supporting the [Redis Cluster Specification](https://redis.io/topics/cluster-spec). To do this, you'll need to connect using `JedisCluster`. See the example below: ```java Set<HostAndPort> jedisClusterNodes = new HashSet<HostAndPort>(); jedisClusterNodes.add(new HostAndPort("127.0.0.1", 7379)); jedisClusterNodes.add(new HostAndPort("127.0.0.1", 7380)); JedisCluster jedis = new JedisCluster(jedisClusterNodes); ``` Now you can use the `JedisCluster` instance and send commands like you would with a standard pooled connection: ```java jedis.sadd("planets", "Mars"); ``` ## Using Redis modules Jedis includes support for [Redis modules](https://redis.io/docs/modules/) such as [RedisJSON](https://redis.io/json/) and [RediSearch](https://redis.io/search/). See the [RedisJSON Jedis](docs/redisjson.md) or [RediSearch Jedis](docs/redisearch.md) for details. ## Failover Jedis supports retry and failover for your Redis deployments. This is useful when: 1. You have more than one Redis deployment. This might include two independent Redis servers or two or more Redis databases replicated across multiple [active-active Redis Enterprise](https://redis.io/docs/latest/operate/rs/databases/active-active/) clusters. 2. You want your application to connect to one deployment at a time and to fail over to the next available deployment if the first deployment becomes unavailable. For the complete failover configuration options and examples, see the [Jedis failover docs](docs/failover.md). ## Documentation The [Jedis wiki](http://github.com/redis/jedis/wiki) contains several useful articles for using Jedis. You can also check the [latest Jedis Javadocs](https://www.javadoc.io/doc/redis.clients/jedis/latest/index.html). Some specific use-case examples can be found in [`redis.clients.jedis.examples` package](src/test/java/redis/clients/jedis/examples/) of the test source codes. ## Troubleshooting If you run into trouble or have any questions, we're here to help! Hit us up on the [Redis Discord Server](http://discord.gg/redis) or [Jedis GitHub Discussions](https://github.com/redis/jedis/discussions) or [Jedis mailing list](http://groups.google.com/group/jedis_redis). ## Contributing We'd love your contributions! Bug reports are always welcome! [You can open a bug report on GitHub](https://github.com/redis/jedis/issues/new). You can also contribute documentation -- or anything to improve Jedis. Please see [contribution guideline](https://github.com/redis/jedis/blob/master/.github/CONTRIBUTING.md) for more details. ## License Jedis is licensed under the [MIT license](https://github.com/redis/jedis/blob/master/LICENSE). ## Sponsorship [](https://redis.io/) ", Assign "at most 3 tags" to the expected json: {"id":"3123","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"