# derekyrc/mini-spring architecture

> Architecture diagram of the GitHub repository derekyrc/mini-spring, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/derekyrc/mini-spring
- Repository: https://github.com/derekyrc/mini-spring

## Overview

##### Project type and purpose
- This is not a web app or microservice but a simplified re-implementation of the Spring Framework’s core IoC and AOP functionality (“mini-spring”).
- Its goal is to let readers explore Spring’s internals via a highly distilled container: XML configuration, Resource loading, BeanFactory, ApplicationContext, BeanPostProcessor/FactoryPostProcessor extension points, type conversion, events, and both JDK- and CGLIB-based AOP.

##### File structure
- Top-level:
- pom.xml – Maven coordinates and dependencies
- src/main/java/org/springframework/... – core packages:
– aop/* – Advisor, Advice, Pointcut, ProxyFactory, JDK & CGLIB proxies, adapters
– beans/* – BeanDefinition, BeanFactory interfaces, PropertyValue(s)
– beans/factory/* & support/* – AbstractBeanFactory implementations, BeanDefinitionReader, InstantiationStrategy
– beans/factory/xml – XmlBeanDefinitionReader
– context/* – ApplicationContext hierarchy, event multicaster, listeners
– context/annotation – classpath scanning, annotation support
– core/convert & convert/support – ConversionService and converters
– core/io – ResourceLoader and Resource implementations
– stereotype – @Component
– src/test – wide coverage of IoC, AOP, type conversion, events, XML config, annotation injection, circular dependencies, etc.

##### README for additional insights
- README and changelog enumerate each feature in progressive “chapters”: simple container, bean definition registry, instantiation strategy, property population, XML, BeanPostProcessor/BeanFactoryPostProcessor, ApplicationContext, lifecycle callbacks, Aware interfaces, scope, FactoryBean, events; then AOP (pointcuts, dynamic proxies, CGLIB, ProxyFactory), and extensions (placeholder configurer, package scan, @Value, @Autowired, type conversion), then circular-dependency solutions.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Resource Loader Module
    subgraph "Resource Loader Module"
        RL1["ResourceLoader"]:::purple
        RL2["ClassPathResource"]:::purple
        RL3["FileSystemResource"]:::purple
        RL4["UrlResource"]:::purple
    end

    %% BeanFactory Module
    subgraph "BeanFactory Module"
        BF1["BeanDefinitionRegistry / DefaultListableBeanFactory"]:::blue
        BF2["XmlBeanDefinitionReader"]:::blue
        BF3["InstantiationStrategy\n(Cglib & Simple)"]:::blue
        BF4["BeanFactoryPostProcessor"]:::blue
        BF5["BeanPostProcessor"]:::blue
        BF6["FactoryBean"]:::blue
    end

    %% ApplicationContext Module
    subgraph "ApplicationContext Module"
        AC1["AbstractXmlApplicationContext\n→ ClassPathXmlApplicationContext"]:::blue
        AC2["ApplicationContextAwareProcessor"]:::blue
        AC3["SimpleApplicationEventMulticaster"]:::yellow
    end

    %% AOP Module
    subgraph "AOP Module"
        AOP1["ProxyFactory / AopProxy"]:::green
        AOP2["AdvisorChainFactory"]:::green
        AOP3["Advisor, Advice, Pointcut"]:::green
        AOP4["Advice Adapters"]:::green
        AOP5["DefaultAdvisorAutoProxyCreator"]:::green
    end

    %% Conversion Service Module
    subgraph "Conversion Service Module"
        CS1["ConversionService\n& ConverterRegistry"]:::purple
        CS2["Converters & ConverterFactory"]:::purple
        CS3["DefaultConversionService"]:::purple
    end

    %% Annotation Support Module
    subgraph "Annotation Support Module"
        AS1["ClassPathBeanDefinitionScanner"]:::orange
        AS2["AutowiredAnnotationBeanPostProcessor"]:::orange
        AS3["@Autowired, @Qualifier, @Value"]:::orange
    end

    %% Eventing Module
    subgraph "Eventing Module"
        EV1["ApplicationEventPublisher / Listener"]:::yellow
        EV2["ApplicationEventMulticaster"]:::yellow
        EV3["ContextRefreshedEvent, ContextClosedEvent"]:::yellow
    end

    %% Relationships
    RL1 -->|"loads"| RL2
    RL1 --> RL3
    RL1 --> RL4
    RL2 -->|"provides InputStream"| BF2

    BF2 -->|"register definitions"| BF1
    BF1 -->|"instantiate"| BF3
    BF3 -->|"create instances"| BF1
    BF1 -->|"postProcessFactory"| BF4
    BF1 -->|"postProcessBean"| BF5
    BF1 -->|"handle FactoryBean"| BF6

    BF1 -->|"used by"| AC1
    AC1 -->|"registers post-processors"| BF4
    AC1 -->|"registers post-processors"| BF5
    AC1 -->|"awareness processing"| AC2
    AC1 -->|"initializes multicaster"| AC3
    AC1 -->|"on refresh publishes"| EV3

    BF5 -->|"wrap via AutoProxy"| AOP5
    AOP5 -->|"creates proxy via"| AOP1
    AOP1 -->|"uses proxies"| AOP3
    AOP3 -->|"build chain"| AOP2
    AOP4 -->|"adapts advice"| AOP2

    CS3 -->|"registered bean"| BF1
    BF1 -->|"uses for conversion"| CS1

    AS1 -->|"scan and register"| BF2
    AS2 -->|"post-process beans"| BF5
    AS3 -->|"annotations used by"| AS2

    EV1 -->|"publish"| EV2
    EV2 -->|"multicast to"| EV1
    EV3 -->|"is published to"| EV1

    %% Click Events
    click RL1 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/core/io/ResourceLoader.java"
    click RL2 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/core/io/ClassPathResource.java"
    click RL3 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/core/io/FileSystemResource.java"
    click RL4 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/core/io/UrlResource.java"

    click BF1 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/beans/factory/support/DefaultListableBeanFactory.java"
    click BF1 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/beans/factory/BeanDefinitionRegistry.java"
    click BF2 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/beans/factory/xml/XmlBeanDefinitionReader.java"
    click BF3 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/beans/factory/support/CglibSubclassingInstantiationStrategy.java"
    click BF3 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/beans/factory/support/SimpleInstantiationStrategy.java"
    click BF4 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/beans/factory/config/BeanFactoryPostProcessor.java"
    click BF5 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/beans/factory/config/BeanPostProcessor.java"
    click BF6 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/beans/factory/FactoryBean.java"

    click AC1 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/context/support/AbstractXmlApplicationContext.java"
    click AC1 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/context/support/ClassPathXmlApplicationContext.java"
    click AC2 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/context/support/ApplicationContextAwareProcessor.java"
    click AC3 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/context/event/SimpleApplicationEventMulticaster.java"

    click AOP1 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/aop/framework/ProxyFactory.java"
    click AOP1 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/aop/framework/AopProxy.java"
    click AOP2 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/aop/framework/AdvisorChainFactory.java"
    click AOP2 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/aop/framework/DefaultAdvisorChainFactory.java"
    click AOP3 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/aop/Advisor.java"
    click AOP4 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/aop/framework/adapter/AfterReturningAdviceInterceptor.java"
    click AOP4 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/aop/framework/adapter/MethodBeforeAdviceInterceptor.java"
    click AOP5 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/aop/framework/autoproxy/DefaultAdvisorAutoProxyCreator.java"

    click CS1 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/core/convert/ConversionService.java"
    click CS1 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/core/convert/ConverterRegistry.java"
    click CS2 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/core/convert/converter/Converter.java"
    click CS2 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/core/convert/converter/ConverterFactory.java"
    click CS2 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/core/convert/converter/GenericConverter.java"
    click CS3 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/core/convert/support/DefaultConversionService.java"

    click AS1 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/context/annotation/ClassPathBeanDefinitionScanner.java"
    click AS2 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/beans/factory/annotation/AutowiredAnnotationBeanPostProcessor.java"
    click AS3 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/beans/factory/annotation/Autowired.java"
    click AS3 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/beans/factory/annotation/Qualifier.java"
    click AS3 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/beans/factory/annotation/Value.java"

    click EV1 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/context/ApplicationEventPublisher.java"
    click EV1 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/context/ApplicationListener.java"
    click EV1 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/context/ApplicationEvent.java"
    click EV2 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/context/event/ApplicationEventMulticaster.java"
    click EV2 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/context/event/AbstractApplicationEventMulticaster.java"
    click EV3 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/context/event/ContextRefreshedEvent.java"
    click EV3 "https://github.com/derekyrc/mini-spring/blob/main/src/main/java/org/springframework/context/event/ContextClosedEvent.java"

    %% Styles
    classDef blue fill:#e0f0ff,stroke:#007acc,color:#000
    classDef green fill:#e0ffe0,stroke:#00aa00,color:#000
    classDef orange fill:#ffe8cc,stroke:#ff6600,color:#000
    classDef purple fill:#f5e0ff,stroke:#aa00cc,color:#000
    classDef yellow fill:#fff8cc,stroke:#ccaa00,color:#000
```
