Java 及 Spring 环境下的 Redis 操作实战 | 极客日志

Javajava

Java 及 Spring 环境下的 Redis 操作实战

基于 Jedis 客户端实现 Java 原生 Redis 连接，演示 String、List、Hash、Set 及 ZSet 数据结构的常用命令。结合 Spring Boot 环境，展示如何通过 StringRedisTemplate 简化开发流程。包含本地端口转发配置步骤，确保远程 Redis 服务的安全访问与调试，适合需要快速集成缓存功能的 Java 开发者参考。

橘子海发布于 2026/2/23更新于 2026/4/251 浏览

Java 及 Spring 环境下的 Redis 操作实战

Java 原生环境：Jedis 连接与基础操作

在 Java 项目中直接使用 Jedis 客户端是理解 Redis 底层交互最直接的方式。它的 API 设计与 Redis 命令高度一致，适合需要精细控制或学习原理的场景。

1. 项目搭建与依赖引入

首先创建一个 Maven 项目，并在 pom.xml 中引入 Jedis 依赖。这里我们使用较稳定的 4.3.2 版本。

<dependency>
    <groupId>redis.clients</groupId>
    <artifactId>jedis</artifactId>
    <version>4.3.2</version>
</dependency>

2. 网络配置与连接

如果 Redis 部署在云服务器上，直接访问可能存在安全限制。为了本地调试方便，可以通过 Xshell 等工具配置端口转发，将云服务器的 6379 端口映射到本地。

文章配图

配置完成后，访问本地 8888 端口即等同于访问远程的 6379 端口。

文章配图

此时即可建立连接并进行后续操作。

3. 数据结构常用命令演示

Jedis 提供了丰富的方法对应 Redis 的各种数据类型。下面按类型梳理核心用法。

String（字符串）

String 是最基础的数据类型，支持原子性自增、范围截取等操作。

public static void test(Jedis jedis) {
    // 清空数据库
    jedis.flushAll();
    
    System.out.println("mset 和 mget 使用");
    jedis.mset("k1", "111", "k2", , , );
    List<String> mget = jedis.mget(, , , );
    System.out.println( + mget);
    
    System.out.println();
    jedis.set(, );
       jedis.getrange(, , );
    System.out.println( + k4);
    jedis.setrange(, , );
    System.out.println( + jedis.get());
    
    System.out.println();
    jedis.append(, );
    System.out.println( + jedis.get());
    
    System.out.println();
    jedis.set(, );
    System.out.println( + jedis.incr());
    System.out.println( + jedis.decr());
}

public static void test(Jedis jedis) {
    jedis.flushAll();
    System.out.println("lpush 和 lrange 使用");
    jedis.lpush("key", "1", "2", "3", "4", "5");
    System.out.println("key:" + jedis.lrange("key", 0, -1));
    
    System.out.println("rpush, rpop, lpop 使用");
    jedis.rpush("key2", "1", "2", "3", "4", "5");
    System.out.println("key2:" + jedis.lrange("key2", 0, -1));
    System.out.println("lpop key2：" + jedis.lpop("key2"));
    System.out.println("rpop key2：" + jedis.rpop("key2"));
    
    System.out.println("llen 使用");
    System.out.println("len key2: " + jedis.llen("key2"));
}

private static void test(Jedis jedis) {
    jedis.flushAll();
    System.out.println("hset 和 hget 使用");
    HashMap<String, String> hash = new HashMap<>();
    hash.put("f2", "v2");
    hash.put("f3", "v3");
    hash.put("f4", "v4");
    jedis.hset("key", hash);
    jedis.hset("key", "f1", "v1");
    
    System.out.println("key f1: " + jedis.hget("key", "f1"));
    System.out.println("key f5: " + jedis.hget("key", "f5"));
    
    System.out.println("hexists 使用");
    Boolean result = jedis.hexists("key", "f1");
    System.out.println("key f1 result: " + result);
    
    System.out.println("hkeys 和 hvals 使用");
    Set<String> hkeys = jedis.hkeys("key");
    System.out.println("hkeys: " + hkeys);
    List<String> hvals = jedis.hvals("key");
    System.out.println("hvals: " + hvals);
    
    System.out.println("hdel 使用");
    jedis.hdel("key", "f1");
    result = jedis.hexists("key", "f1");
    System.out.println("key f1 result: " + result);
    
    System.out.println("hmset 和 hmget 使用");
    List<String> hmget = jedis.hmget("key", "f1", "f2", "f3");
    System.out.println("hmget key: " + hmget);
}

public static void test(Jedis jedis) {
    jedis.flushAll();
    System.out.println("sadd 和 smembers 使用");
    jedis.sadd("key", "a", "b", "c", "d");
    Set<String> smembers = jedis.smembers("key");
    System.out.println("key: " + smembers);
    
    System.out.println("sismember, scard, spop 使用");
    boolean result = jedis.sismember("key", "a");
    System.out.println("result: " + result);
    long len = jedis.scard("key");
    System.out.println("key len: " + len);
    jedis.spop("key");
    System.out.println("key len: " + jedis.scard("key"));
    
    System.out.println("sinter 和 sinterstore");
    jedis.sadd("key2", "1", "2", "3", "4", "5");
    jedis.sadd("key3", "3", "4", "5", "6", "7");
    System.out.println("[key2 key3]sinter: " + jedis.sinter("key2", "key3"));
    long sinterstore = jedis.sinterstore("key4", "key2", "key3");
    System.out.println("sinterstore: " + sinterstore);
    System.out.println("key4: " + jedis.smembers("key4"));
}

public static void test(Jedis jedis) {
    jedis.flushAll();
    System.out.println("zadd 和 zrange 使用");
    jedis.zadd("key", 10.0, "zhangsan");
    Map<String, Double> hash = new HashMap<>();
    hash.put("lisi", 20.0);
    hash.put("wangwu", 30.0);
    jedis.zadd("key", hash);
    
    List<String> members = jedis.zrange("key", 0, -1);
    System.out.println("members: " + members);
    List<Tuple> key = jedis.zrangeWithScores("key", 0, -1);
    System.out.println("key: " + key);
    
    System.out.println("zcard, zscore 使用");
    long len = jedis.zcard("key");
    System.out.println("len key: " + len);
    Double score = jedis.zscore("key", "zhangsan");
    System.out.println("score: " + score);
    
    System.out.println("zrem, zrank 使用");
    Long zrank = jedis.zrank("key", "lisi");
    System.out.println("lisi rank: " + zrank);
    jedis.zrem("key", "zhangsan");
    System.out.println("lisi rank: " + jedis.zrank("key", "lisi"));
}