diff --git a/README.md b/README.md index 85869d3..f56864a 100644 --- a/README.md +++ b/README.md @@ -63,84 +63,162 @@ #### 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、注解、手动注册的上下文。 + + - `ClassPathXmlApplicationContext`：类路径（classpath）加载 XML 配置文件的上下文。 + + - `FileSystemXmlApplicationContext`：文件系统加载 XML 配置文件的上下文。 + + - `AnnotationConfigApplicationContext`：注解配置类中加载配置信息的上下文。 + + - `GenericApplicationContext`：支持多种配置方式，XML、注解、手动注册的上下文。 + - Bean生命周期 - - `Bean的定义解析`：加载配置，解析配置文件，注册解析得到的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)：扩展BeanPostProcessor，提供更深层次的实例化和属性注入控制。 + - [`DestructionAwareBeanPostProcessor`](spring-interface/spring-interface-destructionAwareBeanPostProcessor/README.md)： 扩展BeanPostProcessor，允许在Bean销毁前进行额外的清理操作。 + - [`MergedBeanDefinitionPostProcessor`](spring-interface/spring-interface-mergedBeanDefinitionPostProcessor/README.md)：在合并Bean定义时，对BeanDefinition进行进一步处理。 + - [`SmartInstantiationAwareBeanPostProcessor`](spring-interface/spring-interface-smartInstantiationAwareBeanPostProcessor/README.md)：扩展InstantiationAwareBeanPostProcessor，提供更智能的实例化控制。 + - [`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规范