diff --git a/README-FUTURE.md b/README-FUTURE.md deleted file mode 100644 index f494694..0000000 --- a/README-FUTURE.md +++ /dev/null @@ -1,370 +0,0 @@ -
- logo -
-
-

深入Spring,从源码开始!

-

探索Java最受欢迎的框架,理解它的内部机制,带大家从入门到精通。

-
-

- Stars Badge - Follow Badge - Fork Badge - Watchers Badge -

-

- Visitor Badge - Wechat Badge - CSDN Badge -

-

- ⚡ 技术 - | - 👋 简介 - | - 🍵 Why - | - 🙏 点个星 - | - 🌱 Spring源码 - | - 💬 联系我 - | - ⛵ 贡献 - | - 🔄 更新 - | - 💻 统计 -

- ---- - -## ⚡技术 - -
- - - - - - -
- -## 👋简介 -大家好呀,我是Lex👨‍💻。我是一名拥有8年经验的Java 后端开发人员👨‍💼,也是一个对 Spring 框架充满热情❤️的程序员。为了帮助那些希望深入了解 Spring 框架的程序员们🧑‍💻,我创建了这个 “Spring 源码阅读系列”📖。通过这个系列,我希望能够与你们共同探索 Spring 的内部工作机制⚙️。如果您有同样的兴趣或问题🤔,请联系我📩! - -## 🍵**为何做Spring源码分析** -在我作为框架研发的开发者👨‍🔬的工作中,我经常遇到需要深入理解和调整框架行为的情况🔧。这些工作不只是简单地使用框架的API,更多地是需要对框架的内部工作方式有详细的了解🔍。虽然Github上有关于Spring的简化版本📦,这些对于入门学习确实有很大的帮助✅,但当涉及到真实的项目应用时,与真正的Spring框架还是有很大的差异❌。因此,我开始深入研究Spring的源码,希望能够更透彻地理解其内部的工作机制,以便更好地应用到我的实际工作中🧰。分享我的源码分析📝,也是为了给那些希望真正理解Spring,而不仅仅是使用它的开发者提供一些参考和帮助🙌。 - -## 🙏顺手点个星 -亲爱的朋友们👥,我真的花了很多心思💭去研究和整理这个“Spring 源码阅读系列”📘。如果你觉得这东西还不错👍,或者给你带来了一点点帮助🤗,麻烦点一下星星吧🌟。这真的对我意义重大🎖,每一颗星✨都能让我觉得所有的努力都是值得的💪。我知道这是小事一桩,但你的那一下点击🖱,对我来说就是最好的鼓励🎉。无论如何,都要感谢你抽时间🕰阅读我的内容,真的很感激🙏! - -## 🌱Spring 源码阅读系列 - -#### Spring IOC - -- 资源加载与访问 - - - [`Resource`](spring-resources/spring-resource/README.md):抽象接口,表示文件、类路径等,用于访问不同来源的资源。 - - - [`ResourceLoader`](spring-resources/spring-resource-resourceLoader/README.md):资源获取核心接口,实现统一加载不同位置资源的策略。 - - - [`DocumentLoader`](spring-resources/spring-resource-documentLoader/README.md):XML文档加载解析核心接口,支持后台自动配置Spring应用。 - -- 元数据与过滤 - - - [`MetadataReader`](spring-metadata/spring-metadata-metadataReader/README.md):类元数据获取核心,支持组件扫描、条件化注解、AOP等高级功能。 - - - [`AnnotationMetadata`](spring-metadata/spring-metadata-annotationMetadata/README.md):动态获取和操作运行时类注解信息 - - - [`TypeFilter`](spring-metadata/spring-metadata-typeFilter/README.md):组件扫描时自定义类筛选,支持复杂条件和精确过滤。 - - - [`Condition`](spring-metadata/spring-metadata-condition/README.md):条件判断,决定Bean创建和配置的灵活机制。 - -- Bean定义与注册 - - - [`BeanDefinition`](spring-beans/spring-bean-beanDefinition/README.md):详细描述Bean,支持依赖注入、AOP、作用域控制等核心功能。 - - - [`BeanDefinitionHolder`](spring-beans/spring-bean-beanDefinitionHolder/README.md):管理和操作BeanDefinition的关键类。 - - - [`BeanDefinitionRegistry`](spring-beans/spring-bean-beanDefinitionRegistry/README.md):Bean定义注册管理关键接口,处理Bean元数据。 - -- Bean定义读取与扫描 - - - [`XmlBeanDefinitionReader`](spring-beans/spring-bean-xmlBeanDefinitionReader/README.md):加载解析XML配置,构建IOC容器,注册Bean定义。 - - - [`PropertiesBeanDefinitionReader`](spring-beans/spring-bean-propertiesBeanDefinitionReader/README.md):属性文件加载,解析为Bean定义,提升配置灵活性和可扩展性。 - - - [`GroovyBeanDefinitionReader`](spring-beans/spring-bean-groovyBeanDefinitionReader/README.md):Groovy脚本解析为Bean定义,支持应用程序上下文配置。 - - - [`AnnotatedBeanDefinitionReader`](spring-beans/spring-bean-annotatedBeanDefinitionReader/README.md):注解配置,自动扫描注册Spring组件,简化Bean定义配置。 - - - [`ClassPathBeanDefinitionScanner`](spring-beans/spring-bean-classPathBeanDefinitionScanner/README.md):类路径扫描注册Spring Bean,支持自动装配,提高可维护性和扩展性。 - -- Bean定义导入与组合 - - - `ImportBeanDefinitionRegistrar`:运行时动态注册 Bean,实现灵活配置,扩展配置类功能。 - - - `ImportSelector`:运行时动态导入配置类,实现条件选择和灵活配置。 - - - `DeferredImportSelector`:运行时动态导入配置,支持条件选择和按组别延迟加载。 - -- Bean工厂 - - - `BeanFactory`:Spring的核心接口,提供对Bean的配置、创建、管理的基本功能。 - - - `ListableBeanFactory`:支持按类型获取Bean的集合。 - - - `HierarchicalBeanFactory`:支持父子容器关系,实现Bean定义的层次结构。 - - - `ConfigurableBeanFactory`:提供对BeanFactory配置的扩展,如属性编辑器、作用域等。 - -- 基于Java的配置 - - - `ConfigurationClassPostProcessor`:处理@Configuration注解,关键容器启动后置处理器。 - - - `ConfigurationClassParser`:解析@Configuration,提取Config信息,支持@Bean和条件化配置。 - -- 容器上下文 - - - `ClassPathXmlApplicationContext`:类路径(classpath)加载 XML 配置文件的上下文。 - - - `FileSystemXmlApplicationContext`:文件系统加载 XML 配置文件的上下文。 - - - `AnnotationConfigApplicationContext`:注解配置类中加载配置信息的上下文。 - - - `GenericApplicationContext`:支持多种配置方式,XML、注解、手动注册的上下文。 - -- Bean生命周期 - - - `Bean的定义解析`:加载与解析配置文件,注册解析Bean定义,类名、作用域、属性等。 - - - [`Bean的初始化过程`](spring-core/spring-core-getBean/README.md):实例化、属性注入、Aware回调、后置处理器、初始化方法调用、Bean就绪。 - - - [`Bean的依赖解析过程`](spring-core/spring-core-resolveDependency/README.md):声明依赖,查找依赖,注入依赖,处理循环依赖,延迟依赖解析。 - - - `Bean的销毁过程`:销毁方法调用,接口回调,后处理清理,通知触发,GC回收资源。 - -- Bean初始化与扩展点 - - - [`InitializingBean`](spring-interface/spring-interface-initializingBean/README.md):提供Bean初始化时执行自定义逻辑的接口。 - - - [`DisposableBean`](spring-interface/spring-interface-disposableBean/README.md):定义Bean销毁前执行清理操作的接口。 - - - [`BeanDefinitionRegistryPostProcessor`](spring-interface/spring-interface-beanDefinitionRegistryPostProcessor/README.md):在容器启动时,对BeanDefinition进行动态修改或添加。 - - - [`BeanFactoryPostProcessor`](spring-interface/spring-interface-beanFactoryPostProcessor/README.md):在Bean实例化前,对BeanFactory进行全局修改或配置。 - - - [`BeanPostProcessor`](spring-interface/spring-interface-beanPostProcessor/README.md):在Bean初始化前后,进行自定义处理,可影响所有Bean。 - - - [`InstantiationAwareBeanPostProcessor`](spring-interface/spring-interface-instantiationAwareBeanPostProcessor/README.md):提供更深层次的实例化和属性注入控制。 - - - [`DestructionAwareBeanPostProcessor`](spring-interface/spring-interface-destructionAwareBeanPostProcessor/README.md): 允许在Bean销毁前进行额外的清理操作。 - - - [`MergedBeanDefinitionPostProcessor`](spring-interface/spring-interface-mergedBeanDefinitionPostProcessor/README.md):在合并Bean定义时,对BeanDefinition进行进一步处理。 - - - [`SmartInstantiationAwareBeanPostProcessor`](spring-interface/spring-interface-smartInstantiationAwareBeanPostProcessor/README.md):提供更智能的实例化控制。 - - - [`SmartInitializingSingleton`](spring-interface/spring-interface-smartInitializingSingleton/README.md):在所有单例Bean初始化完成后,执行自定义逻辑。 -- Aware接口系列 - - - [`BeanNameAware`](spring-aware/spring-aware-beanNameAware/README.md):让Bean获取自身在容器中的名字,实现`setBeanName`方法。 - - - [`BeanClassLoaderAware`](spring-aware/spring-aware-beanClassLoaderAware/README.md):允许Bean获取其类加载器,实现`setBeanClassLoader`方法。 - - - [`BeanFactoryAware`](spring-aware/spring-aware-beanFactoryAware/README.md):提供Bean获取所属的BeanFactory,实现`setBeanFactory`方法。 - - - [`EnvironmentAware`](spring-aware/spring-aware-environmentAware/README.md):允许Bean获取应用程序环境配置,实现`setEnvironment`方法。 - - - [`EmbeddedValueResolverAware`](spring-aware/spring-aware-embeddedValueResolverAware/README.md):允许Bean解析嵌入式值占位符,实现`setEmbeddedValueResolver`方法。 - - - [`ResourceLoaderAware`](spring-aware/spring-aware-beanClassLoaderAware/README.md):允许Bean获取资源加载器,实现`setResourceLoader`方法。 - - - [`ApplicationEventPublisherAware`](spring-aware/spring-aware-applicationEventPublisherAware/README.md):允许Bean发布应用程序事件,实现`setApplicationEventPublisher`方法。 - - - [`MessageSourceAware`](spring-aware/spring-aware-messageSourceAware/README.md):允许Bean获取消息源,实现`setMessageSource`方法。 - - - [`ApplicationStartupAware`](spring-aware/spring-aware-applicationStartupAware/README.md):允许Bean获取应用程序启动信息,实现`setApplicationStartup`方法。 - - - [`ApplicationContextAware`](spring-aware/spring-aware-applicationContextAware/README.md):允许Bean获取应用程序上下文,实现`setApplicationContext`方法。 - - - [`ImportAware`](spring-aware/spring-aware-importAware/README.md):允许被导入的配置类获取导入它的类的信息,实现`setImportMetadata`方法。 - -- 核心注解 - - - [`@Configuration`](spring-annotation/spring-annotation-configuration/README.md):声明类为配置类,定义Bean和Bean之间的依赖关系。 - - - [`@ComponentScan`](spring-annotation/spring-annotation-componentScan/README.md):启用组件扫描,自动发现并注册标记为组件的类。 - - - [`@Bean`](spring-annotation/spring-annotation-bean/README.md):在配置类中声明方法,返回Bean实例。 - - - [`@Import`](spring-annotation/spring-annotation-import/README.md):引入其他配置类,将其Bean定义合并到当前容器。 - - - [`@PropertySource`](spring-annotation/spring-annotation-propertySource/README.md):指定属性文件,加载外部配置到环境中。 - - - [`@DependsOn`](spring-annotation/spring-annotation-dependsOn/README.md):指定Bean的依赖顺序,确保特定Bean在其他Bean之前初始化。 - - - [`@Conditional`](spring-annotation/spring-annotation-conditional/README.md):根据条件决定是否创建Bean。 - - - [`@Lazy`](spring-annotation/spring-annotation-lazy/README.md):指定Bean的延迟初始化,只有在首次使用时才创建。 - - - [`@Value`](spring-annotation/spring-annotation-value/README.md):注入简单值或表达式到Bean的字段或方法参数。 - - - [`@Autowired`](spring-annotation/spring-annotation-autowired/README.md):自动装配Bean依赖。 - - - `@Primary`:指定在多个候选Bean中优先选择的首选Bean。 - - - `@Description`:为Bean提供描述性信息。 - - - `@Role`:为Bean提供角色提示,用于区分相似类型的Bean。 - - - `@Indexed`: 标记Bean用于索引。 - - - `@Order`:指定Bean的加载顺序。 -- JSR规范 - - - [`@Inject`](spring-jsr/spring-jsr330-inject/README.md):JSR-330标准的依赖注入注解。 - - - [`@Named`](spring-jsr/spring-jsr330-named/README.md):JSR-330标准的命名注解。 - - - [`@Resource`](spring-jsr/spring-jsr250-resource/README.md):Java EE标准的资源注入注解。 - - - [`@Qualifier`](spring-jsr/spring-jsr330-qualifier/README.md):用于限定注入的Bean。 - - - [`@Scope`](spring-jsr/spring-jsr330-scope/README.md):指定Bean的作用域。 - - - [`@Singleton`](spring-jsr/spring-jsr330-singleton/README.md):指定Bean为单例。 - - - [`@PostConstruct`](spring-jsr/spring-jsr250-postConstruct/README.md):指定初始化方法。 - - - [`@PreDestroy`](spring-jsr/spring-jsr250-preDestroy/README.md):指定销毁方法。 - - - [`Provider`](spring-jsr/spring-jsr330-provider/README.md):ava标准库提供的通用Bean工厂接口。 - -#### Spring AOP - -+ AOP 术语:Aspect、Join point、Advice、Pointcut 等 - -+ Spring AOP 实现原理 - -+ 动态代理:JDK 与 CGLIB - -+ @AspectJ 支持与使用 - -+ 切点表达式解析 - -#### Spring 事件机制 - -+ 事件的发布与监听 - -+ 自定义事件 - -#### Spring 事务管理 - -+ Spring 事务管理介绍 - -+ 编程式与声明式事务 - -+ @Transactional 注解解析 - -+ 事务传播行为 - -+ 事务隔离级别 - -+ 事务管理器实现原理 - -#### Spring MVC - -+ Spring MVC 流程 - -+ DispatcherServlet 的角色与工作原理 - -+ 控制器(Controller)的工作机制 - -+ 视图解析与渲染 - -+ 异常处理 - -+ RESTful 支持 - -#### Spring Boot - -+ Spring Boot 与 Spring 的区别 - -+ 自动配置原理 - -+ Spring Boot starter 介绍 - -+ Spring Boot Actuator - -#### Spring Cloud - -- `@EnableDiscoveryClient`:启用服务发现客户端,用于将服务注册到服务注册中心(例如 Eureka)。 - -- `@EnableEurekaServer`:启用 Eureka 服务端,用于搭建服务注册中心。 - -- `@LoadBalanced`:启用负载均衡,通常用于 RestTemplate 和 WebClient,使其具备负载均衡的能力。 - -- `@FeignClient`:声明一个声明式的 HTTP 客户端,简化了服务调用的过程。 - -- `@EnableCircuitBreaker`:启用断路器,用于防止分布式系统中的雪崩效应。 - -- `@HystrixCommand`:定义一个熔断器命令。 - -- `@EnableZuulProxy`:启用 Zuul API 网关代理。 - -- `@ZuulRoute`:用于配置 Zuul 路由。 - -- `@EnableConfigServer`:启用配置中心服务端。 - -- `@RefreshScope`:用于刷新配置,通常与 Spring Cloud Config 配合使用。 - -- `@EnableZipkinServer`:启用 Zipkin 服务器,用于分布式链路追踪。 - -- `@EnableBinding`:绑定消息通道,与 Spring Cloud Stream 配合使用。 - -- `@GlobalTransactional`:全局事务注解,与 Seata 等分布式事务框架配合使用。 - -- `@SentinelResource`:Sentinel 限流和熔断注解。 - -- `@DubboTransported`:用于 Dubbo 服务的注解。 - -- `@NacosInjected`:用于注入 Nacos 相关的实例。 - - -#### Spring 编程风格与设计模式 - -+ 设计模式在 Spring 源码中的应用 - -+ Spring 源码阅读技巧 - -## 💬与我联系 - -✉️ [Email](xuchengshengsuper@163.com) | 💬 [Issue](https://github.com/xuchengsheng/spring-reading/issues) | 🌐 [CSDN](https://blog.csdn.net/duzhuang2399?type=blog) Me about everything! - -## ⛵欢迎贡献! - -如果你发现任何错误🔍或者有改进建议🛠️,欢迎提交 issue 或者 pull request。你的反馈📢对于我非常宝贵💎! - -## 🔄持续更新中 - -为了给大家提供最新🌱、最有价值的内容💼,我会坚持每天更新这个仓库⏳。每一天,你都可以期待看到一些新的内容或者对已有内容的改进✨。如果你有任何建议或反馈📣,欢迎随时联系我📞。我非常珍视每一个反馈💌,因为这是我持续改进的动力🚀。 - -## 💻我的 GitHub 统计 - -[![Star History Chart](https://api.star-history.com/svg?repos=xuchengsheng/spring-reading&type=Date)](https://star-history.com/#xuchengsheng/spring-reading&Date) - -## 🍱请我吃盒饭? - -作者晚上还要写博客✍️,平时还需要工作💼,如果帮到了你可以请作者吃个盒饭🥡 -
-logo -logo -
- -## 👥加入我们 - -欢迎加入我们的群聊!一起探讨、分享和学习吧! 🌐 - -
-logo -
\ No newline at end of file diff --git a/README.md b/README.md index b6dca78..064ea8e 100644 --- a/README.md +++ b/README.md @@ -104,7 +104,7 @@ - 属性解析和环境配置 - - `PropertyResolver`:通用属性解析,获取配置值,处理属性缺失,简便灵活 + - [`PropertyResolver`](spring-env/spring-env-propertyResolver/README.md):通用属性解析,获取配置值,处理属性缺失,简便灵活 - `Environment`:应用环境表示,提供属性访问,支持配置文件,实现动态配置。 @@ -253,7 +253,7 @@ - [`@PreDestroy`](spring-jsr/spring-jsr250-preDestroy/README.md):指定销毁方法。 - - [`Provider`](spring-jsr/spring-jsr330-provider/README.md):ava标准库提供的通用Bean工厂接口。 + - [`Provider`](spring-jsr/spring-jsr330-provider/README.md):Java标准库提供的通用Bean工厂接口。 #### Spring AOP diff --git a/pom.xml b/pom.xml index e790663..f73d792 100644 --- a/pom.xml +++ b/pom.xml @@ -30,6 +30,7 @@ spring-beans spring-context spring-factory + spring-env diff --git a/spring-env/pom.xml b/spring-env/pom.xml new file mode 100644 index 0000000..33fdf23 --- /dev/null +++ b/spring-env/pom.xml @@ -0,0 +1,22 @@ + + + + spring-reading + com.xcs.spring + 0.0.1-SNAPSHOT + + + 4.0.0 + spring-env + pom + + + spring-env-propertyResolver + spring-env-environment + spring-env-configurableEnvironment + spring-env-configurablePropertyResolver + + + \ No newline at end of file diff --git a/spring-env/spring-env-configurableEnvironment/pom.xml b/spring-env/spring-env-configurableEnvironment/pom.xml new file mode 100644 index 0000000..9c22be6 --- /dev/null +++ b/spring-env/spring-env-configurableEnvironment/pom.xml @@ -0,0 +1,14 @@ + + + + spring-env + com.xcs.spring + 0.0.1-SNAPSHOT + + + 4.0.0 + spring-env-configurableEnvironment + + \ No newline at end of file diff --git a/spring-env/spring-env-configurablePropertyResolver/pom.xml b/spring-env/spring-env-configurablePropertyResolver/pom.xml new file mode 100644 index 0000000..fc3f41a --- /dev/null +++ b/spring-env/spring-env-configurablePropertyResolver/pom.xml @@ -0,0 +1,14 @@ + + + + spring-env + com.xcs.spring + 0.0.1-SNAPSHOT + + + 4.0.0 + spring-env-configurablePropertyResolver + + \ No newline at end of file diff --git a/spring-env/spring-env-environment/pom.xml b/spring-env/spring-env-environment/pom.xml new file mode 100644 index 0000000..a477bce --- /dev/null +++ b/spring-env/spring-env-environment/pom.xml @@ -0,0 +1,14 @@ + + + + spring-env + com.xcs.spring + 0.0.1-SNAPSHOT + + + 4.0.0 + spring-env-environment + + \ No newline at end of file diff --git a/spring-env/spring-env-propertyResolver/README.md b/spring-env/spring-env-propertyResolver/README.md new file mode 100644 index 0000000..fc81166 --- /dev/null +++ b/spring-env/spring-env-propertyResolver/README.md @@ -0,0 +1,291 @@ +## PropertyResolver + +- [PropertyResolver](#propertyresolver) + - [一、基本信息](#一基本信息) + - [二、知识储备](#二知识储备) + - [三、基本描述](#三基本描述) + - [四、主要功能](#四主要功能) + - [五、接口源码](#五接口源码) + - [六、主要实现](#六主要实现) + - [七、最佳实践](#七最佳实践) + - [八、与其他组件的关系](#八与其他组件的关系) + - [九、常见问题](#九常见问题) + + +### 一、基本信息 + +✒️ **作者** - Lex 📝 **博客** - [掘金](https://juejin.cn/user/4251135018533068/posts) 📚 **源码地址** - [github](https://github.com/xuchengsheng/spring-reading) + +### 二、知识储备 + +1. **Spring 属性占位符解析** + + + 理解 `${...}` 占位符的使用,这是 Spring 配置中的一个关键特性,允许从外部源(如配置文件、环境变量)动态注入属性值。 + +2. **Spring Environment 抽象** + + + 熟悉 `Environment` 接口及其如何与 `PropertyResolver` 协作,用于处理配置和属性值。这是理解属性解析和占位符处理的基础。 + +3. **属性文件和配置管理** + + + 了解如何在 Java 和 Spring 应用程序中使用和管理配置文件(例如 `.properties` 和 `.yml` 文件),以及如何在这些文件中使用占位符。 + +4. **Spring 表达式语言(SpEL)** + + + 虽然与 `PropertyResolver` 直接关系不大,但对 Spring 表达式语言的理解有助于深入理解在 Spring 中处理动态属性值的各种方式。 + +5. **环境配置和 Profile** + + + 理解 Spring Profiles 的概念和如何在不同环境(如开发、测试、生产)中使用不同的配置。 + +6. **泛型和类型转换** + + + 对 Java 泛型的了解对于理解 `PropertyResolver` 中的类型安全属性访问方法(如 ` T getProperty(String key, Class targetType)`)很重要。 + +### 三、基本描述 + +`PropertyResolver` 接口是 Spring 框架的一个核心组件,专注于提供一套灵活且强大的机制来处理应用程序配置属性。它定义了一系列方法,用于访问和操纵来自各种源(例如属性文件、环境变量、JVM 参数)的属性值。 + +### 四、主要功能 + +1. **获取属性值** + + + 通过 `getProperty(String key)` 方法可以获取给定键名的属性值。这是处理配置数据时最常用的功能。 + +2. **带默认值的属性获取** + + + 如果指定的属性键不存在,`getProperty(String key, String defaultValue)` 方法允许返回一个默认值。 + +3. **属性值类型转换** + + + `getProperty(String key, Class targetType)` 和 `getProperty(String key, Class targetType, T defaultValue)` 方法使得可以将属性值转换成指定的数据类型,如从字符串转换为整数或布尔值。 + +4. **检查属性存在性** + + + `containsProperty(String key)` 方法用于判断是否存在特定的属性键。 + +5. **获取必需属性** + + + `getRequiredProperty(String key)` 和 `getRequiredProperty(String key, Class targetType)` 方法用于获取必须存在的属性值。如果属性不存在,这些方法会抛出异常。 + +6. **解析占位符** + + + `resolvePlaceholders(String text)` 方法支持解析字符串中的占位符,并用相应的属性值替换它们。这对于处理包含动态内容的配置文件非常有用。 + +### 五、接口源码 + +`PropertyResolver` 接口提供了一系列方法来处理属性值的解析,包括检查属性是否存在,获取属性值,支持默认值,以及类型转换,另外它还包含用于解析字符串中的占位符的方法,允许动态替换配置值。 + +```java +/** + * 用于针对任何底层源解析属性的接口。 + * + * @author Chris Beams + * @author Juergen Hoeller + * @since 3.1 + * @see Environment + * @see PropertySourcesPropertyResolver + */ +public interface PropertyResolver { + + /** + * 返回给定属性键是否可用于解析,即给定键的值是否不为 {@code null}。 + */ + boolean containsProperty(String key); + + /** + * 返回与给定键关联的属性值,或者如果无法解析该键,则返回 {@code null}。 + * @param key 要解析的属性名称 + */ + @Nullable + String getProperty(String key); + + /** + * 返回与给定键关联的属性值,或者如果无法解析该键,则返回 {@code defaultValue}。 + * @param key 要解析的属性名称 + * @param defaultValue 如果找不到值,则返回的默认值 + */ + String getProperty(String key, String defaultValue); + + /** + * 返回与给定键关联的属性值,或者如果无法解析该键,则返回 {@code null}。 + * @param key 要解析的属性名称 + * @param targetType 期望的属性值类型 + */ + @Nullable + T getProperty(String key, Class targetType); + + /** + * 返回与给定键关联的属性值,或者如果无法解析该键,则返回 {@code defaultValue}。 + * @param key 要解析的属性名称 + * @param targetType 期望的属性值类型 + * @param defaultValue 如果找不到值,则返回的默认值 + */ + T getProperty(String key, Class targetType, T defaultValue); + + /** + * 返回与给定键关联的属性值(永远不会是 {@code null})。 + * @throws IllegalStateException 如果无法解析该键 + */ + String getRequiredProperty(String key) throws IllegalStateException; + + /** + * 返回与给定键关联的属性值,转换为给定的 targetType(永远不会是 {@code null})。 + * @throws IllegalStateException 如果无法解析给定键 + */ + T getRequiredProperty(String key, Class targetType) throws IllegalStateException; + + /** + * 解析给定文本中的 ${...} 占位符,将它们替换为 {@link #getProperty} 解析的相应属性值。 + * 无法解析且没有默认值的占位符将被忽略并保持不变。 + * @param text 要解析的字符串 + * @return 解析后的字符串(永远不会是 {@code null}) + * @throws IllegalArgumentException 如果给定的文本是 {@code null} + */ + String resolvePlaceholders(String text); + + /** + * 解析给定文本中的 ${...} 占位符,将它们替换为 {@link #getProperty} 解析的相应属性值。 + * 无法解析且没有默认值的占位符将导致抛出 IllegalArgumentException。 + * @return 解析后的字符串(永远不会是 {@code null}) + * @throws IllegalArgumentException 如果给定文本是 {@code null} 或任何占位符无法解析 + */ + String resolveRequiredPlaceholders(String text) throws IllegalArgumentException; + +} +``` + +### 六、主要实现 + +1. **`PropertySourcesPropertyResolver`** + + + 这是最常用的 `PropertyResolver` 实现之一。它使用 `PropertySource` 对象(可能包含多个,如环境变量、JVM 属性、配置文件等)来解析属性。 + +2. **`AbstractEnvironment`** + + + 虽然 `AbstractEnvironment` 本身不直接实现 `PropertyResolver` 接口,但它提供了访问 `PropertyResolver` 功能的接口。`AbstractEnvironment` 通过内部持有的 `PropertySourcesPropertyResolver` 实例来提供属性解析服务。 + +3. **`StandardEnvironment` 和 `ConfigurableEnvironment`** + + + 这些类扩展了 `AbstractEnvironment`,提供了更具体的环境配置。它们通过继承 `AbstractEnvironment` 间接提供 `PropertyResolver` 的功能。 + +### 七、最佳实践 + +下面代码演示了关于`PropertyResolver`接口 ,包括了获取属性值、检查属性存在性、处理默认值、获取必需属性以及解析占位符等多个方面。 + +```java +public class SimplePropertyResolverDemo { + + public static void main(String[] args) { + // 创建属性源 + Map properties = new HashMap<>(); + properties.put("app.name", "Spring-Reading"); + properties.put("app.version", "1.0.0"); + properties.put("app.description", "This is a ${app.name} with version ${app.version}"); + + MapPropertySource propertySource = new MapPropertySource("myPropertySource", properties); + MutablePropertySources propertySources = new MutablePropertySources(); + propertySources.addLast(propertySource); + + // 使用 PropertySourcesPropertyResolver + PropertyResolver propertyResolver = new PropertySourcesPropertyResolver(propertySources); + + // 获取属性 + String appName = propertyResolver.getProperty("app.name"); + String appVersion = propertyResolver.getProperty("app.version"); + System.out.println("获取属性 app.name: " + appName); + System.out.println("获取属性 app.version: " + appVersion); + + // 检查属性是否存在 + boolean containsDescription = propertyResolver.containsProperty("app.description"); + boolean containsReleaseDate = propertyResolver.containsProperty("app.releaseDate"); + System.out.println("是否包含 'app.description' 属性: " + containsDescription); + System.out.println("是否包含 'app.releaseDate' 属性: " + containsReleaseDate); + + // 带默认值的属性获取 + String appReleaseDate = propertyResolver.getProperty("app.releaseDate", "2023-11-30"); + System.out.println("带默认值的属性获取 app.releaseDate : " + appReleaseDate); + + // 获取必需属性 + String requiredAppName = propertyResolver.getRequiredProperty("app.name"); + System.out.println("获取必需属性 app.name: " + requiredAppName); + + // 解析占位符 + String appDescription = propertyResolver.resolvePlaceholders(properties.get("app.description").toString()); + System.out.println("解析占位符 app.description: " + appDescription); + + // 解析必需的占位符 + String requiredAppDescription = propertyResolver.resolveRequiredPlaceholders("App Description: ${app.description}"); + System.out.println("解析必需的占位符 : " + requiredAppDescription); + } +} +``` + +运行结果发现,可以看到如何在实际场景中使用 `PropertyResolver` 接口来灵活处理配置属性。 + +```java +获取属性 app.name: Spring-Reading +获取属性 app.version: 1.0.0 +是否包含 'app.description' 属性: true +是否包含 'app.releaseDate' 属性: false +带默认值的属性获取 app.releaseDate : 2023-11-30 +获取必需属性 app.name: Spring-Reading +解析占位符 app.description: This is a Spring-Reading with version 1.0.0 +解析必需的占位符 : App Description: This is a Spring-Reading with version 1.0.0 +``` + +### 八、与其他组件的关系 + +1. **`Environment` 抽象** + + - `PropertyResolver` 是 `Environment` 接口的一部分,而 `Environment` 提供了一个更为全面的配置和属性管理接口。`Environment` 抽象了属性源(Property Sources),如系统环境变量、JVM 属性、配置文件等。 + + - 在实际使用中,当我们操作 `Environment` 对象时,我们也在使用 `PropertyResolver` 的功能,因为 `Environment` 继承了 `PropertyResolver` 接口。 + +2. **`PropertySource(s)` 和 `PropertySourcesPropertyResolver`** + + - `PropertySource` 代表了一个属性的源头,比如一个 `.properties` 文件或者环境变量。`MutablePropertySources` 是一个包含多个 `PropertySource` 的容器。 + + - `PropertySourcesPropertyResolver` 是 `PropertyResolver` 的具体实现,它可以解析由一个或多个 `PropertySource` 提供的属性。 + +3. **占位符解析** + + - `PropertyResolver` 提供了解析占位符(如 `${property.name}`)的能力,这在处理配置文件时特别有用。 + + - 它与 Spring 的 `PropertyPlaceholderConfigurer` 或者 `@Value` 注解协同工作,用于将配置文件中的属性值注入到 Spring 管理的 bean 中。 + +4. **配置类和注解** + + - 在使用基于注解的配置类(如使用 `@Configuration` 注解的类)时,`PropertyResolver` 可以用来动态解析和注入属性值,特别是结合 `@PropertySource` 注解使用时。 + + - 例如,可以使用 `@Value("${property.name}")` 注解来将属性值注入到配置类的字段或方法中。 + +5. **Profile 管理** + + - `PropertyResolver` 与 Spring Profiles 的概念紧密相连。通过 `PropertyResolver`,可以方便地访问和检查当前激活的 Profiles,这对于根据不同环境(开发、测试、生产等)来加载特定的配置非常有用。 + +### 九、常见问题 + +1. **属性值未找到** + + + 如果尝试解析不存在的属性,可以通过提前使用 `containsProperty` 方法来检查属性是否存在,以避免问题。同时,确认属性名是否正确,并确保属性源已经包含了对应的属性。 + +2. **属性类型转换错误** + + + 在将属性值转换为不同的类型时,确保属性值的格式与目标类型兼容。如果格式不匹配,可以使用类型转换服务(如 Spring 的 `ConversionService`)进行显式转换。 + +3. **占位符未解析** + + + 如果属性值中的 `${...}` 占位符没有被正确解析,确保使用了合适的 `PropertyResolver` 实现(如 `PropertySourcesPropertyResolver`),并且相关的属性源已经包含了占位符引用的属性。 + +4. **环境相关属性处理** + + + 在处理不同环境(开发、测试、生产)下的属性时,可以使用 Spring Profiles 来定义环境特定的属性。启动应用时,确保激活了正确的 Profile。 + +5. **配置文件加载问题** + + + 如果属性文件没有被正确加载,检查属性文件的路径和格式是否正确,并确保在 Spring 配置类中使用了 `@PropertySource` 注解来指定属性文件。 + +6. **使用 `@Value` 注解注入属性时出错** + + + 在使用 `@Value` 注解注入属性值时,确保 `PropertyPlaceholderConfigurer` 或 `PropertySourcesPlaceholderConfigurer` 被正确配置并加载到 Spring 容器中。 \ No newline at end of file diff --git a/spring-env/spring-env-propertyResolver/pom.xml b/spring-env/spring-env-propertyResolver/pom.xml new file mode 100644 index 0000000..1f86c77 --- /dev/null +++ b/spring-env/spring-env-propertyResolver/pom.xml @@ -0,0 +1,14 @@ + + + + spring-env + com.xcs.spring + 0.0.1-SNAPSHOT + + + 4.0.0 + spring-env-propertyResolver + + \ No newline at end of file diff --git a/spring-env/spring-env-propertyResolver/src/main/java/com/xcs/spring/SimplePropertyResolverDemo.java b/spring-env/spring-env-propertyResolver/src/main/java/com/xcs/spring/SimplePropertyResolverDemo.java new file mode 100644 index 0000000..f4708ab --- /dev/null +++ b/spring-env/spring-env-propertyResolver/src/main/java/com/xcs/spring/SimplePropertyResolverDemo.java @@ -0,0 +1,59 @@ +package com.xcs.spring; + +import org.springframework.core.env.MapPropertySource; +import org.springframework.core.env.MutablePropertySources; +import org.springframework.core.env.PropertyResolver; +import org.springframework.core.env.PropertySourcesPropertyResolver; + +import java.util.HashMap; +import java.util.Map; + +/** + * @author xcs + * @date 2023年11月30日 15时27分 + **/ +public class SimplePropertyResolverDemo { + + public static void main(String[] args) { + // 创建属性源 + Map properties = new HashMap<>(); + properties.put("app.name", "Spring-Reading"); + properties.put("app.version", "1.0.0"); + properties.put("app.description", "This is a ${app.name} with version ${app.version}"); + + MapPropertySource propertySource = new MapPropertySource("myPropertySource", properties); + MutablePropertySources propertySources = new MutablePropertySources(); + propertySources.addLast(propertySource); + + // 使用 PropertySourcesPropertyResolver + PropertyResolver propertyResolver = new PropertySourcesPropertyResolver(propertySources); + + // 获取属性 + String appName = propertyResolver.getProperty("app.name"); + String appVersion = propertyResolver.getProperty("app.version"); + System.out.println("获取属性 app.name: " + appName); + System.out.println("获取属性 app.version: " + appVersion); + + // 检查属性是否存在 + boolean containsDescription = propertyResolver.containsProperty("app.description"); + boolean containsReleaseDate = propertyResolver.containsProperty("app.releaseDate"); + System.out.println("是否包含 'app.description' 属性: " + containsDescription); + System.out.println("是否包含 'app.releaseDate' 属性: " + containsReleaseDate); + + // 带默认值的属性获取 + String appReleaseDate = propertyResolver.getProperty("app.releaseDate", "2023-11-30"); + System.out.println("带默认值的属性获取 app.releaseDate : " + appReleaseDate); + + // 获取必需属性 + String requiredAppName = propertyResolver.getRequiredProperty("app.name"); + System.out.println("获取必需属性 app.name: " + requiredAppName); + + // 解析占位符 + String appDescription = propertyResolver.resolvePlaceholders(properties.get("app.description").toString()); + System.out.println("解析占位符 app.description: " + appDescription); + + // 解析必需的占位符 + String requiredAppDescription = propertyResolver.resolveRequiredPlaceholders("App Description: ${app.description}"); + System.out.println("解析必需的占位符 : " + requiredAppDescription); + } +}