Redis 中的 Java 客户端(Jedis / Lettuce)


本文学习使用 Java 客户端( Jedis / Lettuce) 操作 Redis 。

1 开启远程连接

Redis 默认是不支持远程连接的,需要手动开启,修改 redis.conf ,主要有 3 个地方改动:

vi /usr/local/redis-5.0.8/redis.conf

# bind 127.0.0.1
protected-mode no
requirepass 123456

之后重新启动 Redis 。

2 Jedis

2.1 基本使用

Jedis 的 GitHub 地址:https://github.com/xetorthio/jedis

首先创建一个普通的 Maven 项目 redis-jedis ,项目创建成功后,添加 Jedis 依赖:

<dependencies>
      <dependency>
            <groupId>redis.clients</groupId>
            <artifactId>jedis</artifactId>
            <version>3.2.0</version>
            <type>jar</type>
            <scope>compile</scope>
      </dependency>
      <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13</version>
            <scope>test</scope>
      </dependency>
</dependencies>

然后创建一个测试类及测试方法:

public class JedisTests {
    @Test
    public void testJedis() {
        // 1.构造一个 Jedis 对象,因为这里使用的默认端口 6379,所以不用配置端口
        Jedis jedis = new Jedis("192.168.71.62");
        // 2.密码认证
        jedis.auth("123456");

        // 3.测试是否连接成功
        String r = jedis.ping();
        // 4.返回  pong  表示连接成功
        System.out.println(r);

        jedis.set("k1", "hellojedis");
        String v = jedis.get("k1");
        System.out.println(v);
    }
}

在 Jedis 中,方法的 API 和 Redis 的命令高度一致,所以,Jedis 中的方法见名知意,直接使用即可。

2.2 连接池

因为 Jedis 对象不是线程安全的,所以在实际应用中,我们一般都是通过连接池来获取,使用完成之后,再还给连接池。

@Test
public void testJedisPool() {
      Jedis jedis = null;
      // 1.构造一个 Jedis 连接池
      JedisPool pool = new JedisPool("192.168.71.62", 6379);
      // 2.从连接池中获取一个 Jedis 连接
      jedis = pool.getResource();
      jedis.auth("123456");
      try {
            // 3.Jedis 操作
            String r = jedis.ping();
            System.out.println(r);
      } catch (Exception e) {
            e.printStackTrace();
      } finally {
            // 4.归还连接
            if (jedis != null) {
                  jedis.close();
            }
      }
}

上述代码中,我们使用了 try-catch-finally 来确保 jedis 对象被关闭,也可以使用 JDK1.7 中的 try-with-resource 来实现(代码看着比之前简洁),改造如下:

@Test
public void testJedisPool2() {
      JedisPool pool = new JedisPool("192.168.71.62");
      try (Jedis jedis = pool.getResource()) {
            jedis.auth("123456");
            String ping = jedis.ping();
            System.out.println(ping);
      }
}

JedisPool 也可以使用 GenericObjectPoolConfig 来初始化,支持更丰富的配置,如下:

@Test
public void testJedisPool3() {
      GenericObjectPoolConfig config = new GenericObjectPoolConfig();
      // 连接池最大空闲数
      config.setMaxIdle(300);
      // 最大连接数
      config.setMaxTotal(1000);
      // 连接最大等待时间,如果是 -1 表示没有限制
      config.setMaxWaitMillis(30000);
      // 在空闲时检查有效性
      config.setTestOnBorrow(true);
      JedisPool pool = new JedisPool(config, "192.168.71.62", 6379, Protocol.DEFAULT_TIMEOUT, "123456");
      try (Jedis jedis = pool.getResource()) {
            String r = jedis.ping();
            System.out.println(r);
      }
}

3 Lettuce

Lettuce 的 GitHub 地址:https://github.com/lettuce-io/lettuce-core

Lettuce 和 Jedis 的比较:

  1. Jedis 在实现的过程中是直接连接 Redis 的,在多个线程之间共享一个 Jedis 实例,这是线程不安全的,如果想在多线程场景下使用 Jedis ,就得使用连接池,这样,每个线程都有自己的 Jedis 实例。
  2. Lettuce 基于目前很火的 Netty NIO 框架来构建,所以克服了 Jedis 中线程不安全的问题, Lettuce 支持同步、异步以及响应式调用,多个线程可以共享一个连接实例。

首先创建一个普通的 Maven 项目 redis-lettuce ,项目创建成功后,添加 Lettuce 依赖:

<dependencies>
      <dependency>
            <groupId>io.lettuce</groupId>
            <artifactId>lettuce-core</artifactId>
            <version>5.2.2.RELEASE</version>
      </dependency>
      <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13</version>
            <scope>test</scope>
      </dependency>
</dependencies>

然后创建一个测试类及测试方法:

public class LettuceTests {
    @Test
    public void testLettuce() {
        RedisClient redisClient = RedisClient.create("redis://123456@192.168.71.62");
        StatefulRedisConnection<String, String> connect = redisClient.connect();
        RedisCommands<String, String> sync = connect.sync();
        sync.set("k1", "hellolettuce");
        String v = sync.get("k1");
        System.out.println(v);
    }
}


扫码关注微信公众号 程序员35 ,获取最新技术干货,畅聊 #程序员的35,35的程序员# 。独立站点:https://cxy35.com

<think>好的,我现在需要帮助用户解决NoClassDefFoundError错误,具体是关于redis.clients.jedis.JedisShardInfo类的缺失。首先,我应该回忆一下这个错误的常见原因。NoClassDefFoundError通常意味着在编译时存在某个类,但在运行时找不到,可能的原因包括依赖缺失、版本冲突或者类路径问题。 根据用户提供的引用信息,特别是引用[3]和[4],版本冲突是一个常见的问题。用户提到Jedis和Spring Data Redis之间的版本不兼容。例如,引用[4]指出Spring Data Redis的版本需要与Jedis版本对应,比如Spring Data Redis 2.1.x对应Jedis 2.9.x,而2.2.x对应Jedis 3.x。所以,用户可能需要检查他们的项目中这两个库的版本是否匹配。 接下来,用户提到的错误是关于JedisShardInfo类,这个类在Jedis的某些版本中可能存在变动。比如,在Jedis 3.x中,某些类的包路径或结构可能发生了变化,导致旧版本代码引用时找不到类。因此,用户需要确认他们使用的Jedis版本是否包含这个类,或者是否已经被废弃或移动到其他包中。 此外,用户可能在Maven或Gradle中引入了错误的依赖,或者依赖的版本没有正确指定,导致传递依赖的版本冲突。例如,Spring Boot的父POM可能已经指定了某个Jedis版本,而用户显式地引入了另一个版本,导致版本覆盖问题。这时候需要检查依赖树,排除冲突的版本,并确保所有相关库的版本兼容。 另外,用户可能没有正确引入Jedis库。例如,可能只引入了spring-boot-starter-data-redis,而该starter可能默认使用Lettuce而不是Jedis,所以需要显式地排除Lettuce并引入Jedis依赖。或者,用户可能遗漏了Jedis的依赖,导致类缺失。 解决方案方面,首先应该检查依赖版本,调整Jedis的版本以匹配Spring Data Redis的版本。例如,如果用户使用的是Spring Boot 2.3.x,对应的Spring Data Redis可能是2.3.x,这时候需要查看对应的Jedis版本是否兼容。根据引用[4]的对应关系,可能需要将Jedis升级到3.x版本,或者降级Spring Data Redis到匹配的版本。 另外,用户需要检查项目中是否有多个版本的Jedis被引入,这可以通过Maven的依赖树分析(mvn dependency:tree)或者Gradle的依赖报告来实现,排除掉冲突的版本。 如果确定版本正确,但问题依旧存在,可能需要清除构建工具缓存,重新下载依赖,比如删除Maven的本地仓库中的相关目录,或者Gradle的缓存,然后重新构建项目。 最后,如果JedisShardInfo类已经被废弃或移除,用户可能需要修改代码,使用新的类或方法替代。例如,查看Jedis的官方文档,了解替代方案,并调整代码中的相关部分。 总结下来,解决步骤应该是:1. 确认依赖是否正确引入;2. 检查版本兼容性;3. 排除冲突的依赖;4. 清理和重建项目;5. 必要时调整代码以适应新版本的API。</think>### 解决 `NoClassDefFoundError: redis/clients/jedis/JedisShardInfo` 的步骤 #### 1. **确认依赖版本兼容性** - **问题根源**:`JedisShardInfo` 类在 Jedis 3.x 版本中已被标记为**过时**或移除[^4]。若项目中使用的是 Spring Data Redis 2.2+ 或 Spring Boot 2.2+,默认会依赖 Jedis 3.x,而 `JedisShardInfo` 可能在 Jedis 3.x 中不再兼容。 - **解决方案**: 1. **检查当前依赖版本**: 在 `pom.xml` 或 `build.gradle` 中确认 `spring-boot-starter-data-redis` 和 `jedis` 的版本。例如: ```xml <!-- Spring Boot 2.3.x 对应 Jedis 3.2.0 --> <dependency> <groupId>redis.clients</groupId> <artifactId>jedis</artifactId> <version>3.6.0</version> </dependency> ``` 2. **调整版本匹配关系**: 根据 Spring Data RedisJedis 的版本对应关系[^4]: - Spring Data Redis 2.1.x ➔ Jedis 2.9.x - Spring Data Redis 2.2.x ➔ Jedis 3.x 若需保留 `JedisShardInfo`,可降级 Jedis 至 2.9.x,并确保 Spring Data Redis 版本为 2.1.x。 #### 2. **排除依赖冲突** - **问题场景**:项目中可能同时引入了多个 Jedis 版本,导致类加载混乱。 - **操作步骤**: - **Maven 项目**:运行 `mvn dependency:tree`,检查是否有其他依赖间接引入了旧版 Jedis。 - **排除冲突依赖**: 例如,若 `spring-boot-starter-data-redis` 默认依赖 Lettuce,需显式排除并引入 Jedis: ```xml <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-redis</artifactId> <exclusions> <exclusion> <groupId>io.lettuce</groupId> <artifactId>lettuce-core</artifactId> </exclusion> </exclusions> </dependency> <dependency> <groupId>redis.clients</groupId> <artifactId>jedis</artifactId> <version>3.6.0</version> </dependency> ``` #### 3. **代码适配新版本 API** - **若必须使用 Jedis 3.x**: `JedisShardInfo` 在 Jedis 3.x 中已被废弃,建议改用新的连接配置类,例如 `JedisClientConfig` 或 `JedisPoolConfig`[^3]。 - **代码修改示例**: ```java // 旧代码(Jedis 2.x) JedisShardInfo shardInfo = new JedisShardInfo("redis://localhost:6379"); // 新代码(Jedis 3.x) JedisPoolConfig poolConfig = new JedisPoolConfig(); try (Jedis jedis = new Jedis(poolConfig, "localhost", 6379)) { // 操作代码 } ``` #### 4. **清理并重新构建项目** - **操作**: 执行以下命令清理缓存并重新编译: ```bash # Maven mvn clean install -U # Gradle gradle clean build --refresh-dependencies ``` #### 5. **验证依赖是否生效** - **检查编译后的 JAR/WAR**: 解压构建产物,确认 `redis/clients/jedis/JedisShardInfo.class` 是否存在于 `WEB-INF/lib` 或 `BOOT-INF/lib` 目录中。若不存在,说明依赖未正确引入。 --- ### 版本兼容表示例 | Spring Boot 版本 | Spring Data Redis 版本 | 推荐 Jedis 版本 | |------------------|------------------------|-----------------| | 2.1.x | 2.1.x | 2.9.x | | 2.2.x | 2.2.x | 3.0.x | | 2.3.x | 2.3.x | 3.6.x | --- ### 相关问题 1. **如何检查 Maven 项目的依赖树?** > 运行 `mvn dependency:tree` 可查看依赖传递关系,定位冲突版本。 2. **Spring Boot 中 LettuceJedis 有什么区别?** > Lettuce 基于 Netty 实现,支持异步非阻塞;Jedis 是同步阻塞客户端。需根据场景选择[^1]。 3. **Jedis 3.x 中弃用了哪些常见类?** > 包括 `JedisShardInfo`、`ShardedJedisPool`,建议改用 `JedisPool` 或 `JedisCluster`。 : SpringBoot整合Spring Data RedisJedis报错:java.lang.NoClassDefFoundError: redis/clients/jedis/util/...。 已整合jar包和编写配置类后,在测试类中测试报错:java.lang.NoClassDefFoundError: redis/clients/jedis/util/Pool [^2]: springboot整合redis中 出现Caused by: java.lang.NoClassDefFoundError: redis/clients/jedis/util/Pool [^3]: Caused by: java.lang.NoClassDefFoundError: redis/clients/jedis/JedisClientConfig : nested exception is java.lang.NoClassDefFoundError: redis/clients/jedis/JedisClientConfig
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值