Redisson Helidon CDI 扩展集成指南依赖配置、属性注入与底层源码解析【免费下载链接】redissonRedisson: Valkey Redis Java Client and Real-Time Data Platform. Sync/Async/RxJava/Reactive API. Over 50 Valkey and Redis based Java objects and services: Set, Multimap, SortedSet, Map, List, Queue, Deque, Semaphore, Lock, AtomicLong, Map Reduce, Bloom filter, Spring, Tomcat, Scheduler, JCache API, Hibernate, RPC, local cache..项目地址: https://gitcode.com/GitHub_Trending/re/redisson导读Redisson 为 Helidon 框架提供了开箱即用的 CDIContexts and Dependency Injection扩展允许开发者以标准的InjectNamed方式将RedissonClient注入到 Helidon 微服务中无需手写工厂或单例。本文以 redisson-helidon/README.md 为骨架结合 docs/microservices-integration.md 中的 Helidon 章节与仓库源码完整讲解依赖引入、MicroProfile Config 属性配置、实例命名规则并深入RedissonExtension与PropertiesConvertor源码揭示其动态注册 Bean 与属性转 YAML 的底层机制。读完本文你将能在 Helidon 1.4.x - 4.x.x 应用中快速接入并灵活配置 Redisson。一、Helidon CDI 扩展是什么Redisson Helidon 扩展的本质是一个标准的 Jakarta/Javax CDI 容器扩展Extension它将 Redisson 与 Helidon 的 CDI 环境无缝衔接应用通过Named限定符声明所需的 Redisson 实例名扩展在 CDI 容器启动阶段扫描注入点、收集限定符并按实例名从 MicroProfile Config 配置源中读取对应的扁平化 Redisson 配置动态注册ApplicationScoped的RedissonClientBean。从 redisson-helidon/pom.xml 可见该模块是一个聚合 POM包含三个子模块分别面向不同 Helidon 版本线子模块面向的 Helidon 版本CDI API编译级别以当前仓库 POM 为准redisson-helidon-20Helidon v1.4.x - v2.5.xjavax.enterprise兼容旧版redisson-helidon-30Helidon v3.x.xjakarta.enterprise兼容 3.xredisson-helidon-40Helidon v4.x.xjakarta.enterpriseJava 21见 redisson-helidon-40/pom.xml三个模块的扩展实现类完全相同类名与逻辑一致仅 import 的 CDI 包名不同均位于org.redisson.helidon包下的RedissonExtension.java例如 redisson-helidon-40/src/main/java/org/redisson/helidon/RedissonExtension.java。二、第一步添加 redisson-helidon 依赖按所使用 Helidon 版本选择对应 artifactId版本号替换为你实际使用的 Redisson 版本当前仓库的父 POM 版本为4.7.1-SNAPSHOT正式发布请使用对应 release 版本号。Mavendependency groupIdorg.redisson/groupId !-- Helidon v1.4.x - v2.5.x -- artifactIdredisson-helidon-20/artifactId !-- Helidon v3.x.x -- artifactIdredisson-helidon-30/artifactId !-- Helidon v4.x.x -- artifactIdredisson-helidon-40/artifactId versionxVERSIONx/version /dependencyGradle// Helidon v1.4.x - v2.5.x compile org.redisson:redisson-helidon-20:xVERSIONx // Helidon v3.x.x compile org.redisson:redisson-helidon-30:xVERSIONx // Helidon v4.x.x compile org.redisson:redisson-helidon-40:xVERSIONx以 redisson-helidon-40/pom.xml 为例模块自身的依赖组合为核心redisson库、jakarta.enterprise.cdi-apiprovided 作用域、jakarta.inject-apiprovided 作用域、microprofile-config-apicompile 作用域并可选引入helidon-microprofile-config与jandex。也就是说应用侧只需保证 Helidon 运行时提供 CDI 与 MicroProfile Config 能力扩展即可工作。三、第二步在 microprofile-config.properties 中配置实例3.1 配置格式扁平化的 Redisson YAMLRedisson Helidon 扩展要求把 Redisson 配置写进 Helidon 的 MicroProfile Config 源META-INF/microprofile-config.properties中配置结构是Redisson YAML 配置的扁平化形式即把 YAML 的层级用点号.展开成属性键。Redisson 支持多种部署拓扑均可用此格式表达单机single、主从复制replicated、集群cluster、哨兵sentinel、代理proxy、多集群multi cluster等。每一种拓扑对应Config中的一组配置类扁平化后的键路径即为 YAML 结构路径。3.2 配置键的命名规则所有属性的键都以org.redisson.Redisson.实例名.为前缀之后紧跟扁平化后的 YAML 路径。下面是为名为simple的实例配置的单机模式示例org.redisson.Redisson.simple.singleServerConfig.addressredis://127.0.0.1:6379 org.redisson.Redisson.simple.singleServerConfig.connectionPoolSize64 org.redisson.Redisson.simple.threads16 org.redisson.Redisson.simple.nettyThreads32这段配置等价于如下 Redisson YAML 配置singleServerConfig: address: redis://127.0.0.1:6379 connectionPoolSize: 64 threads: 16 nettyThreads: 32即org.redisson.Redisson.simple.之后的singleServerConfig.address、singleServerConfig.connectionPoolSize直接映射singleServerConfig下的子键而threads、nettyThreads属于顶层配置。Config.fromYAML解析后即可得到完整的 Redisson 配置对象。3.3 底层转换PropertiesConvertor 如何还原 YAML这一扁平属性 → YAML的还原工作由 PropertiesConvertor.toYaml() 完成。其核心逻辑为遍历 MicroProfile Config 中的全部属性名仅保留以org.redisson.Redisson.实例名.为前缀的条目去掉前缀后按.拆分第一段作为顶层键、第二段作为子键构造两级 Map值类型自动推断数字按 Long 解析、true/false/null原样输出、其余值加引号包裹对node-addresses、sentinel-addresses、addresses等列表型键见LIST_NODES按逗号拆分并输出为 YAML 列表项对codec、load-balancer、netty-hook等需要 class 引用的键见CLASS_PROPERTIES自动输出为!类名 {}的 YAML 标签形式。因此集群、哨兵等拓扑的列表型属性可以直接用逗号分隔写在一条属性中例如示意org.redisson.Redisson.simple.clusterServersConfig.nodeAddressesredis://127.0.0.1:7001,redis://127.0.0.1:7002在 docs/microservices-integration.md 的 Helidon 章节中还给出了哨兵、主从、代理、多集群等各模式的配置文档链接完整模式清单参见 docs/configuration.md。四、第三步注入 RedissonClient配置就绪后即可在任何受 CDI 管理的 Bean 中注入Inject Named(simple) private RedissonClient redisson;Named(simple)的值必须与配置前缀中的实例名一致若不加Named注解则默认使用实例名default对应属性前缀org.redisson.Redisson.default.。注入后即可直接使用 Redisson 提供的 50 余种 Redis/Valkey 数据对象与服务如RBucket、RMap、RLock、RAtomicLong、RRateLimiter等。五、源码原理RedissonExtension 的工作机制扩展类RedissonExtension实现 CDI 的Extension接口通过两个观察者方法完成 Bean 注册以下以 redisson-helidon-40 的实现 为例说明收集注入点限定符processRedissonInjectionPoint观察 CDI 的ProcessInjectionPoint事件将所有RedissonClient类型注入点上的注解Named(simple)等 qualifier收集进qualifiers集合。动态注册 BeanaddBeans观察AfterBeanDiscovery事件在容器完成 Bean 发现后为每个 qualifier 调用discovery.addBean()作用域设为ApplicationScoped单例级类型闭包包含RedissonClientproduceWith工厂方法中若 qualifier 是Named则取其value()作为实例名否则为default从 CDI 容器中取得ConfigMicroProfile Config 全局配置以Redisson.class.getName() . instanceName .为前缀将命中的属性通过PropertiesConvertor.toYaml转成 YAML调用Config.fromYAML(yamlConfig)解析为org.redisson.config.Config最终Redisson.create(config)创建客户端并返回。异常处理解析或创建失败时包装为IllegalStateException抛出容器启动即失败便于尽早暴露配置错误。从源码结构看扩展对每个Named实例都会独立创建一条RedissonClient因此一个应用可以同时注入多个不同名字、指向不同 Redis/Valkey 拓扑的客户端。六、测试验证RedissonExtensionTest仓库在 redisson-helidon-40/src/test/java/org/redisson/RedissonExtensionTest.java 提供了完整的集成测试可作为接入方式的权威参考使用 Testcontainers 的FixedHostPortGenericContainer(redis:latest)启动真实 Redis 实例固定映射 6379 端口通过System.setProperty(org.redisson.Redisson.simple.singleServerConfig.address, redis://127.0.0.1:6379)直接设置配置属性等价于写入 microprofile-config.properties用SeContainerInitializer启动 CDI SE 容器在onInit观察者方法中注入Named(simple) RedissonClient并断言非空测试方法中通过CDI.current().select(RedissonClient.class, NamedLiteral.of(simple))取得客户端执行RBucket的set/get/delete操作并断言结果。这说明该扩展不依赖 Helidon Web 容器在纯 CDI 环境如SeContainerInitializer中同样可用方便单元测试与本地调试。七、实例命名与多实例实践默认实例不使用Named时实例名为default配置前缀为org.redisson.Redisson.default.。命名实例Named(xxx)对应org.redisson.Redisson.xxx.前缀。多实例共存可以为读写、搜索、限流等不同用途创建多个实例各实例拥有独立的连接池与线程池配置。例如org.redisson.Redisson.cache.singleServerConfig.addressredis://10.0.0.1:6379 org.redisson.Redisson.cache.threads8 org.redisson.Redisson.analytics.singleServerConfig.addressredis://10.0.0.2:6379 org.redisson.Redisson.analytics.threads16分别以Named(cache)与Named(analytics)注入即可。八、注意事项版本匹配redisson-helidon-20/30/40必须与 Helidon 主版本对应redisson-helidon-40模块基于 Java 21 与jakarta.enterprise.cdi-api 4.1.0、Helidon MP4.3.0编译见 redisson-helidon-40/pom.xml请确保运行环境满足要求。配置源microprofile-config.properties是标准 MicroProfile Config 源扩展读取的是全局Config因此使用环境变量、application.properties等其他配置源注入同名属性同样有效。属性命名扁平属性中的singleServerConfig、connectionPoolSize、nettyThreads等键需与 RedissonConfig类字段一致列表与 class 引用类型的写法参考上文PropertiesConvertor的转换规则。生命周期Bean 作用域为ApplicationScoped随 CDI 容器启动创建、关闭销毁Redisson 客户端的连接管理、断线重连由 Redisson 自身负责应用无需手动管理。九、延伸阅读更多 Helidon 接入细节与 PRO 版本说明docs/microservices-integration.mdRedisson 各部署拓扑的 YAML 配置详解docs/configuration.md属性转 YAML 的底层实现PropertiesConvertor.javaHelidon 扩展聚合模块与三个子模块 POMredisson-helidon/pom.xml、redisson-helidon-40/pom.xml【免费下载链接】redissonRedisson: Valkey Redis Java Client and Real-Time Data Platform. Sync/Async/RxJava/Reactive API. Over 50 Valkey and Redis based Java objects and services: Set, Multimap, SortedSet, Map, List, Queue, Deque, Semaphore, Lock, AtomicLong, Map Reduce, Bloom filter, Spring, Tomcat, Scheduler, JCache API, Hibernate, RPC, local cache..项目地址: https://gitcode.com/GitHub_Trending/re/redisson创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Redisson Helidon CDI 扩展集成指南：依赖配置、属性注入与底层源码解析
Redisson Helidon CDI 扩展集成指南依赖配置、属性注入与底层源码解析【免费下载链接】redissonRedisson: Valkey Redis Java Client and Real-Time Data Platform. Sync/Async/RxJava/Reactive API. Over 50 Valkey and Redis based Java objects and services: Set, Multimap, SortedSet, Map, List, Queue, Deque, Semaphore, Lock, AtomicLong, Map Reduce, Bloom filter, Spring, Tomcat, Scheduler, JCache API, Hibernate, RPC, local cache..项目地址: https://gitcode.com/GitHub_Trending/re/redisson导读Redisson 为 Helidon 框架提供了开箱即用的 CDIContexts and Dependency Injection扩展允许开发者以标准的InjectNamed方式将RedissonClient注入到 Helidon 微服务中无需手写工厂或单例。本文以 redisson-helidon/README.md 为骨架结合 docs/microservices-integration.md 中的 Helidon 章节与仓库源码完整讲解依赖引入、MicroProfile Config 属性配置、实例命名规则并深入RedissonExtension与PropertiesConvertor源码揭示其动态注册 Bean 与属性转 YAML 的底层机制。读完本文你将能在 Helidon 1.4.x - 4.x.x 应用中快速接入并灵活配置 Redisson。一、Helidon CDI 扩展是什么Redisson Helidon 扩展的本质是一个标准的 Jakarta/Javax CDI 容器扩展Extension它将 Redisson 与 Helidon 的 CDI 环境无缝衔接应用通过Named限定符声明所需的 Redisson 实例名扩展在 CDI 容器启动阶段扫描注入点、收集限定符并按实例名从 MicroProfile Config 配置源中读取对应的扁平化 Redisson 配置动态注册ApplicationScoped的RedissonClientBean。从 redisson-helidon/pom.xml 可见该模块是一个聚合 POM包含三个子模块分别面向不同 Helidon 版本线子模块面向的 Helidon 版本CDI API编译级别以当前仓库 POM 为准redisson-helidon-20Helidon v1.4.x - v2.5.xjavax.enterprise兼容旧版redisson-helidon-30Helidon v3.x.xjakarta.enterprise兼容 3.xredisson-helidon-40Helidon v4.x.xjakarta.enterpriseJava 21见 redisson-helidon-40/pom.xml三个模块的扩展实现类完全相同类名与逻辑一致仅 import 的 CDI 包名不同均位于org.redisson.helidon包下的RedissonExtension.java例如 redisson-helidon-40/src/main/java/org/redisson/helidon/RedissonExtension.java。二、第一步添加 redisson-helidon 依赖按所使用 Helidon 版本选择对应 artifactId版本号替换为你实际使用的 Redisson 版本当前仓库的父 POM 版本为4.7.1-SNAPSHOT正式发布请使用对应 release 版本号。Mavendependency groupIdorg.redisson/groupId !-- Helidon v1.4.x - v2.5.x -- artifactIdredisson-helidon-20/artifactId !-- Helidon v3.x.x -- artifactIdredisson-helidon-30/artifactId !-- Helidon v4.x.x -- artifactIdredisson-helidon-40/artifactId versionxVERSIONx/version /dependencyGradle// Helidon v1.4.x - v2.5.x compile org.redisson:redisson-helidon-20:xVERSIONx // Helidon v3.x.x compile org.redisson:redisson-helidon-30:xVERSIONx // Helidon v4.x.x compile org.redisson:redisson-helidon-40:xVERSIONx以 redisson-helidon-40/pom.xml 为例模块自身的依赖组合为核心redisson库、jakarta.enterprise.cdi-apiprovided 作用域、jakarta.inject-apiprovided 作用域、microprofile-config-apicompile 作用域并可选引入helidon-microprofile-config与jandex。也就是说应用侧只需保证 Helidon 运行时提供 CDI 与 MicroProfile Config 能力扩展即可工作。三、第二步在 microprofile-config.properties 中配置实例3.1 配置格式扁平化的 Redisson YAMLRedisson Helidon 扩展要求把 Redisson 配置写进 Helidon 的 MicroProfile Config 源META-INF/microprofile-config.properties中配置结构是Redisson YAML 配置的扁平化形式即把 YAML 的层级用点号.展开成属性键。Redisson 支持多种部署拓扑均可用此格式表达单机single、主从复制replicated、集群cluster、哨兵sentinel、代理proxy、多集群multi cluster等。每一种拓扑对应Config中的一组配置类扁平化后的键路径即为 YAML 结构路径。3.2 配置键的命名规则所有属性的键都以org.redisson.Redisson.实例名.为前缀之后紧跟扁平化后的 YAML 路径。下面是为名为simple的实例配置的单机模式示例org.redisson.Redisson.simple.singleServerConfig.addressredis://127.0.0.1:6379 org.redisson.Redisson.simple.singleServerConfig.connectionPoolSize64 org.redisson.Redisson.simple.threads16 org.redisson.Redisson.simple.nettyThreads32这段配置等价于如下 Redisson YAML 配置singleServerConfig: address: redis://127.0.0.1:6379 connectionPoolSize: 64 threads: 16 nettyThreads: 32即org.redisson.Redisson.simple.之后的singleServerConfig.address、singleServerConfig.connectionPoolSize直接映射singleServerConfig下的子键而threads、nettyThreads属于顶层配置。Config.fromYAML解析后即可得到完整的 Redisson 配置对象。3.3 底层转换PropertiesConvertor 如何还原 YAML这一扁平属性 → YAML的还原工作由 PropertiesConvertor.toYaml() 完成。其核心逻辑为遍历 MicroProfile Config 中的全部属性名仅保留以org.redisson.Redisson.实例名.为前缀的条目去掉前缀后按.拆分第一段作为顶层键、第二段作为子键构造两级 Map值类型自动推断数字按 Long 解析、true/false/null原样输出、其余值加引号包裹对node-addresses、sentinel-addresses、addresses等列表型键见LIST_NODES按逗号拆分并输出为 YAML 列表项对codec、load-balancer、netty-hook等需要 class 引用的键见CLASS_PROPERTIES自动输出为!类名 {}的 YAML 标签形式。因此集群、哨兵等拓扑的列表型属性可以直接用逗号分隔写在一条属性中例如示意org.redisson.Redisson.simple.clusterServersConfig.nodeAddressesredis://127.0.0.1:7001,redis://127.0.0.1:7002在 docs/microservices-integration.md 的 Helidon 章节中还给出了哨兵、主从、代理、多集群等各模式的配置文档链接完整模式清单参见 docs/configuration.md。四、第三步注入 RedissonClient配置就绪后即可在任何受 CDI 管理的 Bean 中注入Inject Named(simple) private RedissonClient redisson;Named(simple)的值必须与配置前缀中的实例名一致若不加Named注解则默认使用实例名default对应属性前缀org.redisson.Redisson.default.。注入后即可直接使用 Redisson 提供的 50 余种 Redis/Valkey 数据对象与服务如RBucket、RMap、RLock、RAtomicLong、RRateLimiter等。五、源码原理RedissonExtension 的工作机制扩展类RedissonExtension实现 CDI 的Extension接口通过两个观察者方法完成 Bean 注册以下以 redisson-helidon-40 的实现 为例说明收集注入点限定符processRedissonInjectionPoint观察 CDI 的ProcessInjectionPoint事件将所有RedissonClient类型注入点上的注解Named(simple)等 qualifier收集进qualifiers集合。动态注册 BeanaddBeans观察AfterBeanDiscovery事件在容器完成 Bean 发现后为每个 qualifier 调用discovery.addBean()作用域设为ApplicationScoped单例级类型闭包包含RedissonClientproduceWith工厂方法中若 qualifier 是Named则取其value()作为实例名否则为default从 CDI 容器中取得ConfigMicroProfile Config 全局配置以Redisson.class.getName() . instanceName .为前缀将命中的属性通过PropertiesConvertor.toYaml转成 YAML调用Config.fromYAML(yamlConfig)解析为org.redisson.config.Config最终Redisson.create(config)创建客户端并返回。异常处理解析或创建失败时包装为IllegalStateException抛出容器启动即失败便于尽早暴露配置错误。从源码结构看扩展对每个Named实例都会独立创建一条RedissonClient因此一个应用可以同时注入多个不同名字、指向不同 Redis/Valkey 拓扑的客户端。六、测试验证RedissonExtensionTest仓库在 redisson-helidon-40/src/test/java/org/redisson/RedissonExtensionTest.java 提供了完整的集成测试可作为接入方式的权威参考使用 Testcontainers 的FixedHostPortGenericContainer(redis:latest)启动真实 Redis 实例固定映射 6379 端口通过System.setProperty(org.redisson.Redisson.simple.singleServerConfig.address, redis://127.0.0.1:6379)直接设置配置属性等价于写入 microprofile-config.properties用SeContainerInitializer启动 CDI SE 容器在onInit观察者方法中注入Named(simple) RedissonClient并断言非空测试方法中通过CDI.current().select(RedissonClient.class, NamedLiteral.of(simple))取得客户端执行RBucket的set/get/delete操作并断言结果。这说明该扩展不依赖 Helidon Web 容器在纯 CDI 环境如SeContainerInitializer中同样可用方便单元测试与本地调试。七、实例命名与多实例实践默认实例不使用Named时实例名为default配置前缀为org.redisson.Redisson.default.。命名实例Named(xxx)对应org.redisson.Redisson.xxx.前缀。多实例共存可以为读写、搜索、限流等不同用途创建多个实例各实例拥有独立的连接池与线程池配置。例如org.redisson.Redisson.cache.singleServerConfig.addressredis://10.0.0.1:6379 org.redisson.Redisson.cache.threads8 org.redisson.Redisson.analytics.singleServerConfig.addressredis://10.0.0.2:6379 org.redisson.Redisson.analytics.threads16分别以Named(cache)与Named(analytics)注入即可。八、注意事项版本匹配redisson-helidon-20/30/40必须与 Helidon 主版本对应redisson-helidon-40模块基于 Java 21 与jakarta.enterprise.cdi-api 4.1.0、Helidon MP4.3.0编译见 redisson-helidon-40/pom.xml请确保运行环境满足要求。配置源microprofile-config.properties是标准 MicroProfile Config 源扩展读取的是全局Config因此使用环境变量、application.properties等其他配置源注入同名属性同样有效。属性命名扁平属性中的singleServerConfig、connectionPoolSize、nettyThreads等键需与 RedissonConfig类字段一致列表与 class 引用类型的写法参考上文PropertiesConvertor的转换规则。生命周期Bean 作用域为ApplicationScoped随 CDI 容器启动创建、关闭销毁Redisson 客户端的连接管理、断线重连由 Redisson 自身负责应用无需手动管理。九、延伸阅读更多 Helidon 接入细节与 PRO 版本说明docs/microservices-integration.mdRedisson 各部署拓扑的 YAML 配置详解docs/configuration.md属性转 YAML 的底层实现PropertiesConvertor.javaHelidon 扩展聚合模块与三个子模块 POMredisson-helidon/pom.xml、redisson-helidon-40/pom.xml【免费下载链接】redissonRedisson: Valkey Redis Java Client and Real-Time Data Platform. Sync/Async/RxJava/Reactive API. Over 50 Valkey and Redis based Java objects and services: Set, Multimap, SortedSet, Map, List, Queue, Deque, Semaphore, Lock, AtomicLong, Map Reduce, Bloom filter, Spring, Tomcat, Scheduler, JCache API, Hibernate, RPC, local cache..项目地址: https://gitcode.com/GitHub_Trending/re/redisson创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
