此版本仍在开发中，尚未被视为稳定版本。如需最新的稳定版本，请使用 Spring Data Redis 3.4.0！spring-doc.cadn.net.cn

迁移指南

本节包含有关迁移步骤、弃用和删除的详细信息。spring-doc.cadn.net.cn

从 2.x 升级到 3.x

重新/移动类型

类型	更换
o.s.d.redis.版本spring-doc.cadn.net.cn	o.s.d.util.版本spring-doc.cadn.net.cn
o.s.d.redis.VersionParserspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.connection.RedisZSetCommands.Aggregatespring-doc.cadn.net.cn	o.s.d.redis.connection.zset.Aggregatespring-doc.cadn.net.cn
o.s.d.redis.connection.RedisZSetCommands.Tuplespring-doc.cadn.net.cn	o.s.d.redis.connection.zset.Tuplespring-doc.cadn.net.cn
o.s.d.redis.connection.RedisZSetCommands.Weightsspring-doc.cadn.net.cn	o.s.d.redis.connection.zset.Weightsspring-doc.cadn.net.cn
o.s.d.redis.connection.RedisZSetCommands.Rangespring-doc.cadn.net.cn	o.s.d.domain.范围spring-doc.cadn.net.cn
o.s.d.redis.connection.RedisZSetCommands.Limitspring-doc.cadn.net.cn	o.s.d.redis.connection.Limit.javaspring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.JedisUtilsspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.JedisVersionUtilspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.core.convert.CustomConversionsspring-doc.cadn.net.cn	o.s.d.convert.CustomConversionsspring-doc.cadn.net.cn

类型

更换

o.s.d.redis.版本spring-doc.cadn.net.cn

o.s.d.util.版本spring-doc.cadn.net.cn

o.s.d.redis.VersionParserspring-doc.cadn.net.cn

-spring-doc.cadn.net.cn

o.s.d.redis.connection.RedisZSetCommands.Aggregatespring-doc.cadn.net.cn

o.s.d.redis.connection.zset.Aggregatespring-doc.cadn.net.cn

o.s.d.redis.connection.RedisZSetCommands.Tuplespring-doc.cadn.net.cn

o.s.d.redis.connection.zset.Tuplespring-doc.cadn.net.cn

o.s.d.redis.connection.RedisZSetCommands.Weightsspring-doc.cadn.net.cn

o.s.d.redis.connection.zset.Weightsspring-doc.cadn.net.cn

o.s.d.redis.connection.RedisZSetCommands.Rangespring-doc.cadn.net.cn

o.s.d.domain.范围spring-doc.cadn.net.cn

o.s.d.redis.connection.RedisZSetCommands.Limitspring-doc.cadn.net.cn

o.s.d.redis.connection.Limit.javaspring-doc.cadn.net.cn

o.s.d.redis.connection.jedis.JedisUtilsspring-doc.cadn.net.cn

-spring-doc.cadn.net.cn

o.s.d.redis.connection.jedis.JedisVersionUtilspring-doc.cadn.net.cn

-spring-doc.cadn.net.cn

o.s.d.redis.core.convert.CustomConversionsspring-doc.cadn.net.cn

o.s.d.convert.CustomConversionsspring-doc.cadn.net.cn

更改的方法和类型

表 1.核心
类型	方法	更换
o.s.d.redis.core.Cursorspring-doc.cadn.net.cn	打开spring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.core.RedisTemplatespring-doc.cadn.net.cn	执行spring-doc.cadn.net.cn	doWithKeys 键spring-doc.cadn.net.cn
o.s.d.redis.stream.StreamMessageListenerContainerspring-doc.cadn.net.cn	isAutoAckspring-doc.cadn.net.cn	isAutoAcknowledgespring-doc.cadn.net.cn
o.s.d.redis.stream.StreamMessageListenerContainerspring-doc.cadn.net.cn	自动确认spring-doc.cadn.net.cn	自动确认spring-doc.cadn.net.cn

表 2.Redis 连接
类型	方法	更换
o.s.d.redis.connection.ClusterCommandExecutionFailureExceptionspring-doc.cadn.net.cn	getCausesspring-doc.cadn.net.cn	getSuppressedspring-doc.cadn.net.cn
o.s.d.redis.connection.RedisConnectionspring-doc.cadn.net.cn	bgWriteAofspring-doc.cadn.net.cn	bgReWriteAofspring-doc.cadn.net.cn
o.s.d.redis.connection.RedisConnectionspring-doc.cadn.net.cn	slaveOf 的spring-doc.cadn.net.cn	replicaOf 的spring-doc.cadn.net.cn
o.s.d.redis.connection.RedisConnectionspring-doc.cadn.net.cn	奴隶spring-doc.cadn.net.cn	replicaOfNoOne （无一个的复制品）spring-doc.cadn.net.cn
o.s.d.redis.connection.ReactiveCluster命令spring-doc.cadn.net.cn	clusterGetSlavesspring-doc.cadn.net.cn	clusterGetReplicasspring-doc.cadn.net.cn
o.s.d.redis.connection.ReactiveCluster命令spring-doc.cadn.net.cn	clusterGetMasterSlaveMapspring-doc.cadn.net.cn	clusterGetMasterReplicaMapspring-doc.cadn.net.cn
o.s.d.redis.connection.ReactiveKeyCommandsspring-doc.cadn.net.cn	getNewNamespring-doc.cadn.net.cn	getNewKeyspring-doc.cadn.net.cn
o.s.d.redis.connection.RedisClusterNode.Flagspring-doc.cadn.net.cn	奴隶spring-doc.cadn.net.cn	复制品spring-doc.cadn.net.cn
o.s.d.redis.connection.RedisClusterNode.Builderspring-doc.cadn.net.cn	slaveOf 的spring-doc.cadn.net.cn	replicaOf 的spring-doc.cadn.net.cn
o.s.d.redis.connection.RedisNodespring-doc.cadn.net.cn	isSlave 的spring-doc.cadn.net.cn	isReplicaspring-doc.cadn.net.cn
o.s.d.redis.connection.RedisSentinel命令spring-doc.cadn.net.cn	奴隶spring-doc.cadn.net.cn	副本spring-doc.cadn.net.cn
o.s.d.redis.connection.RedisServerspring-doc.cadn.net.cn	getNumberSlavesspring-doc.cadn.net.cn	getNumberReplicasspring-doc.cadn.net.cn
o.s.d.redis.connection.RedisServerCommandsspring-doc.cadn.net.cn	slaveOf 的spring-doc.cadn.net.cn	replicaOf 的spring-doc.cadn.net.cn
o.s.d.redis.core.ClusterOperationsspring-doc.cadn.net.cn	getSlavesspring-doc.cadn.net.cn	获取副本spring-doc.cadn.net.cn
o.s.d.redis.core.RedisOperationsspring-doc.cadn.net.cn	slaveOf 的spring-doc.cadn.net.cn	replicaOf 的spring-doc.cadn.net.cn

表 3.Redis作
类型	方法	更换
o.s.d.redis.core.GeoOperations & BoundGeoOperationsspring-doc.cadn.net.cn	地理添加spring-doc.cadn.net.cn	加spring-doc.cadn.net.cn
o.s.d.redis.core.GeoOperations & BoundGeoOperationsspring-doc.cadn.net.cn	地理距离spring-doc.cadn.net.cn	距离spring-doc.cadn.net.cn
o.s.d.redis.core.GeoOperations & BoundGeoOperationsspring-doc.cadn.net.cn	地理哈希spring-doc.cadn.net.cn	散列spring-doc.cadn.net.cn
o.s.d.redis.core.GeoOperations & BoundGeoOperationsspring-doc.cadn.net.cn	geoPosspring-doc.cadn.net.cn	位置spring-doc.cadn.net.cn
o.s.d.redis.core.GeoOperations & BoundGeoOperationsspring-doc.cadn.net.cn	地理半径spring-doc.cadn.net.cn	半径spring-doc.cadn.net.cn
o.s.d.redis.core.GeoOperations & BoundGeoOperationsspring-doc.cadn.net.cn	geoRadiusByMemberspring-doc.cadn.net.cn	半径spring-doc.cadn.net.cn
o.s.d.redis.core.GeoOperations & BoundGeoOperationsspring-doc.cadn.net.cn	地理删除spring-doc.cadn.net.cn	删除spring-doc.cadn.net.cn

表 4.Redis 缓存
类型	方法	更换
o.s.d.redis.cache.RedisCacheConfigurationspring-doc.cadn.net.cn	prefixKeys替换为spring-doc.cadn.net.cn	prefixCacheName替换为spring-doc.cadn.net.cn
o.s.d.redis.cache.RedisCacheConfigurationspring-doc.cadn.net.cn	getKeyPrefixspring-doc.cadn.net.cn	getKeyPrefixForspring-doc.cadn.net.cn

杰迪斯

请阅读 Jedis 升级指南，其中涵盖了重要的驱动程序更改。spring-doc.cadn.net.cn

表 5.Jedis Redis 连接
类型	方法	更换
o.s.d.redis.connection.jedis.JedisConnectionFactoryspring-doc.cadn.net.cn	获取分片信息spring-doc.cadn.net.cn	可以通过 JedisClientConfiguration 获取spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.JedisConnectionFactoryspring-doc.cadn.net.cn	setShardInfospring-doc.cadn.net.cn	可以通过 JedisClientConfiguration 进行设置spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.JedisConnectionFactoryspring-doc.cadn.net.cn	createClusterspring-doc.cadn.net.cn	现在需要一个`Connection`而不是`Jedis`实例spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.Jedis转换器spring-doc.cadn.net.cn		现在具有包可见性spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.Jedis转换器spring-doc.cadn.net.cn	tuplesToTuplesspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.Jedis转换器spring-doc.cadn.net.cn	tuplesToTuplesspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.Jedis转换器spring-doc.cadn.net.cn	stringListToByteListspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.Jedis转换器spring-doc.cadn.net.cn	stringSetToByteSetspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.Jedis转换器spring-doc.cadn.net.cn	stringMapToByteMapspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.Jedis转换器spring-doc.cadn.net.cn	tupleSetToTupleSetspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.Jedis转换器spring-doc.cadn.net.cn	toTupleSetspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.Jedis转换器spring-doc.cadn.net.cn	toDataAccessExceptionspring-doc.cadn.net.cn	o.s.d.redis.connection.jedis.JedisExceptionConverter#转换spring-doc.cadn.net.cn

事务 / 流水线

Pipelining 和 Transactions 现在是互斥的。不再可以在 pipeline/transactions 模式下使用 server 或 connection 命令。spring-doc.cadn.net.cn

生菜

生菜池

LettucePool及其实施DefaultLettucePool已被删除且未替换。请参阅驱动程序文档，了解驱动程序本机池功能。接受池化参数的方法已更新。这会影响LettuceConnectionFactory和LettuceConnection.spring-doc.cadn.net.cn

生菜认证

AuthenticatingRedisClient已被删除且未更换。请参阅驱动程序文档RedisURI设置认证数据。spring-doc.cadn.net.cn