Jedis — это Java-клиент для Redis, созданный для повышения производительности и простоты использования.
Вы ищете библиотеку высокого уровня для обработки сопоставления объектов? Смотрите redis-om-spring!
Учитесь бесплатно в Университете Redis
Попробуйте облако Redis
Погрузитесь в руководства для разработчиков
Присоединяйтесь к сообществу Redis
Работа в Редисе
Самая последняя версия этой библиотеки поддерживает Redis версий 5.0, 6.0, 6.2, 7.0, 7.2 и 7.4.
В таблице ниже показана совместимость версий самых последних версий библиотеки и версий Redis. Совместимость означает функции связи и возможности команд Redis.
Джедайская версия | Поддерживаемые версии Redis | JDK-совместимость |
---|---|---|
3.9+ | С 5.0 по 6.2 Семейство выпусков | 8, 11 |
>= 4,0 | Семейство выпусков версий от 5.0 до 7.2 | 8, 11, 17 |
>= 5,0 | Версия 6.0 до текущей | 8, 11, 17, 21 |
>= 5,2 | Версия 7.2 до текущей | 8, 11, 17, 21 |
Чтобы начать работу с Jedis, сначала добавьте его как зависимость в свой Java-проект. Если вы используете Maven, это выглядит так:
< dependency >
< groupId >redis.clients</ groupId >
< artifactId >jedis</ artifactId >
< version >5.2.0</ version >
</ dependency >
Чтобы использовать передовых джедаев, загляните сюда.
Далее вам нужно подключиться к Redis. Рассмотрите возможность установки докера redis-stack:
docker run -p 6379:6379 -it redis/redis-stack:latest
Для многих приложений лучше всего использовать пул соединений. Вы можете создать экземпляр пула соединений Jedis следующим образом:
JedisPool pool = new JedisPool ( "localhost" , 6379 );
С экземпляром JedisPool
вы можете использовать блок try-with-resources для получения соединения и запуска команд Redis.
Вот как запустить одну команду SET в блоке try-with-resources :
try ( Jedis jedis = pool . getResource ()) {
jedis . set ( "clientName" , "Jedis" );
}
Экземпляры Jedis
реализуют большинство команд Redis. Полный список поддерживаемых команд см. в документации Jedis Javadocs.
Использование блока try-with-resources для каждой команды может оказаться затруднительным, поэтому вы можете рассмотреть возможность использования JedisPooled.
JedisPooled jedis = new JedisPooled ( "localhost" , 6379 );
Теперь вы можете отправлять команды, как отправка от Jedis.
jedis . sadd ( "planets" , "Venus" );
Jedis позволяет подключаться к кластерам Redis, поддерживая спецификацию кластера Redis. Для этого вам необходимо подключиться с помощью JedisCluster
. См. пример ниже:
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 );
Теперь вы можете использовать экземпляр JedisCluster
и отправлять команды, как если бы вы использовали стандартное пуловое соединение:
jedis . sadd ( "planets" , "Mars" );
Jedis включает поддержку модулей Redis, таких как RedisJSON и RediSearch.
Подробности см. в RedisJSON Jedis или RediSearch Jedis.
Jedis поддерживает повторные попытки и аварийное переключение для ваших развертываний Redis. Это полезно, когда:
Полные параметры и примеры конфигурации аварийного переключения см. в документации по аварийному переключению Jedis.
Вики Jedis содержит несколько полезных статей по использованию Jedis.
Вы также можете проверить последнюю версию документации Jedis Javadocs.
Некоторые конкретные примеры использования можно найти в пакете redis.clients.jedis.examples
исходных кодов тестов.
Если у вас возникнут проблемы или возникнут вопросы, мы здесь, чтобы помочь!
Свяжитесь с нами на Redis Discord Server, в обсуждениях Jedis GitHub или в списке рассылки Jedis.
Мы будем рады вашему вкладу!
Сообщения об ошибках всегда приветствуются! Вы можете открыть отчет об ошибке на GitHub.
Вы также можете предоставить документацию или что-нибудь еще для улучшения Jedis. Более подробную информацию см. в руководстве по взносам.
Jedis имеет лицензию MIT.