一文搞不懂springboot中redis参数配置

最近在看JVM相关参数时，
发现对于不知道并且不清楚含义的参数，
根本没有使用的能力，所以从参数开始逐步学起，
虽然很没有耐心，这么多参数，学了忘，忘了学，
但是，还是要看（^ v ^）,于是从使用的相关组件开始学习，
之前，总结了RabbitMQ的参数，这次学习到了Redis参数，
一文是搞不懂的，需要多实践，会用才是懂，看懂不是懂。
分享如下。

结果：Redis配置参数汇总如下表：

配置样例：

spring:
  redis:
    cluster:
      nodes: 192.168.211.129:9001,192.168.211.129:9002,192.168.211.129:9003,192.168.211.129:9004,192.168.211.129:9005,192.168.211.129:9006
    password: 123456
    jedis:
      pool:
        max-active: 1 # 连接池：最大连接数，-1不限制
        max-idle: 8 # 连接池：最大空闲连接数量
        max-wait: 2000 # 连接池：最大阻塞等待时间，-1不限制，单位：毫秒
        min-idle: 0 # 连接池；最小空闲连接数量
      timeout: 1000 # 连接Redis服务器超时时间，单位：毫秒

首先要找到入口。
自动装配是SpringBoot的最重要设计，
因此，先从自动装配入手，找到自动装配包，如下图所示，
Redis是数据库组件，因此在data模块中可以找到。

data包如下图所示，可以看到redis组件，
属性类为：RedisProperties。

SpringBoot版本：2.4.5

Redis属性类源码如下图所示，该类包括所有Redis配置参数，
后文的所有参数解析均基于该类。
位置：org.springframework.boot.autoconfigure.data.redis.RedisProperties

这层参数即最外层的属性，如下表所示，
有的属性具有第二甚至第三层属性，如jedis和lettuce。

Redis客户端类型，源码提供的类型有：LETTUCE和JEDIS，源码如下图所示。
位置：org.springframework.boot.autoconfigure.data.redis.RedisProperties.ClientType

Redis客户端采用集群方式：cluster，源码如下图所示，
集群参数：

位置：org.springframework.boot.autoconfigure.data.redis.RedisProperties.Cluster

Redis客户端采用哨兵方式：sentinel，源码如下图所示，
参数如下：

org.springframework.boot.autoconfigure.data.redis.RedisProperties.Sentinel

简单易用的Redis客户端（Java版）。同步阻塞IO、不支持异步，
源码位置：https://github.com/redis/jedis

Jedis客户端属性如下表所示，源码如下图所示，
由源码可知，Jedis属性只有Pool
位置：org.springframework.boot.autoconfigure.data.redis.RedisProperties.Pool

位置：org.springframework.boot.autoconfigure.data.redis.RedisProperties.Jedis

Pool源码如下：

	public static class Pool {

		
		private int maxIdle = 8;

		
		private int minIdle = 0;

		
		private int maxActive = 8;

		
		private Duration maxWait = Duration.ofMillis(-1);

		
		private Duration timeBetweenEvictionRuns;
		// setter/getter ommited
	}

高级Redis客户端（Java版），线程安全且支持异步（基于Netty事件驱动）。
支持高级Redis特性：哨兵、集群、管道、自动重连和Redis数据模型等。
Lettuce

Lettuce属性如下表所示，源码如下图所示。
其中，Pool与Jedis相同。
shutdownTimeout为关闭客户端及关闭所有打开的连接的超时时间。一旦关闭所有连接，相关的客户端资源会在安静期和关闭超时期优雅地关闭或释放。
cluster属性，由源码可知，cluster中嵌套了refresh属性，
refresh属性如下：

位置：org.springframework.boot.autoconfigure.data.redis.RedisProperties.Lettuce

Lettuce中的Cluster源码如下所示：

public static class Cluster {

			private final Refresh refresh = new Refresh();

			public Refresh getRefresh() {
				return this.refresh;
			}

			public static class Refresh {

				
				private boolean dynamicRefreshSources = true;

				
				private Duration period;

				
				private boolean adaptive;

				public boolean isDynamicRefreshSources() {
					return this.dynamicRefreshSources;
				}

				public void setDynamicRefreshSources(boolean dynamicRefreshSources) {
					this.dynamicRefreshSources = dynamicRefreshSources;
				}

				public Duration getPeriod() {
					return this.period;
				}

				public void setPeriod(Duration period) {
					this.period = period;
				}

				public boolean isAdaptive() {
					return this.adaptive;
				}

				public void setAdaptive(boolean adaptive) {
					this.adaptive = adaptive;
				}

			}

		}

核心：
（1）支持的客户端连接方式：直连、集群、哨兵；
（2）Redis客户端连接池类型：Jedis和Lettuce；
（3）Jedis简单易用的Redis客户端；Lettuce线程安全、异步的高性能Redis客户端；
（3）Jedis和Lettuce通用连接池配置：最大空闲连接、最小空闲连接等，通过timeBetweenEvictionRuns控制回收空闲连接的频率；
（4）防止获取连接阻塞，必须设置maxWait最大等待时间。