# sw-fantastic/swdc-dependency architecture

> Architecture diagram of the GitHub repository sw-fantastic/swdc-dependency, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sw-fantastic/swdc-dependency
- Repository: https://github.com/sw-fantastic/swdc-dependency

## Overview

##### Project type and purpose
- This is an open-source Java library implementing a lightweight, annotation-driven dependency-injection (DI) container that follows the javax.inject specification. It also provides AOP (Before/After/Around) hooks and an event-emitter subsystem.

##### File structure
- Top-level files: pom.xml (Maven build), jitpack.yml (JitPack config), README.md.
- src/main/java/org/swdc/dependency: core packages
- annotations: DI/AOP annotations (@Inject, @Singleton, @Aspect, etc.)
- parser: AnnotationDependencyParser, builds metadata from scanned classes
- registry: holds ComponentInfo, DependencyInfo, InterceptorInfo, DefaultDependencyRegisterContext
- scopes: SingletonDependencyScope, PrototypeDependencyScope
- interceptor: AspectHandler, InvocationPoint, ProcessPoint
- event: EventEmitter, EventHandler, Events
- application: AbstractApplication, SWApplication (optional bootstrapping)
- utils: ReflectionUtil, AnnotationUtil, LoggerProvider
- src/main/resources: logback.xml, native-image reflect config (Graal integration)
- src/test: tests covering annotation parsing, environment loading, registration, reflection utilities

##### README insights
- Focus is on lazy initialization (“initialize when first needed”) vs. Spring’s eager start
- Future plans: XML support, Graal native-image via GraalNativePlugin

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Global external entity
    ClientCode(("Client Code")):::external

    subgraph "Scanner & Loader"
        AL["AnnotationLoader"]:::core
        EL["EnvironmentLoader"]:::core
        AE["AnnotationEnvironment"]:::core
    end

    subgraph "Metadata Parser"
        ADP["AnnotationDependencyParser"]:::core
        DP["DependencyParser"]:::core
    end

    subgraph "Registry & Context"
        DDR["DefaultDependencyRegister"]:::core
        DRC["DefaultDependencyRegistryContext"]:::core
        DR["DependencyRegister"]:::core
        DRCX["DependencyRegisterContext"]:::core
    end

    subgraph "Instance Factory & Scopes"
        DF["DependencyFactory"]:::core
        ADS["AbstractDependencyScope"]:::core
        SDS["SingletonDependencyScope"]:::core
        PDS["PrototypeDependencyScope"]:::core
    end

    subgraph "AOP Interceptor"
        AH["AspectHandler"]:::aop
        IP["InvocationPoint"]:::aop
        PP["ProcessPoint"]:::aop
        RAI["RuntimeAspectInfo"]:::aop
    end

    subgraph "Event System"
        EE["EventEmitter"]:::event
        EH["EventHandler"]:::event
        AEvt["AbstractEvent"]:::event
        Evts["Events"]:::event
    end

    subgraph "Application Bootstrap"
        AA["AbstractApplication"]:::core
        SWA["SWApplication"]:::core
    end

    subgraph "Utilities & External"
        RU["ReflectionUtil"]:::utils
        AU["AnnotationUtil"]:::utils
        LP["LoggerProvider"]:::utils
        LB["logback.xml"]:::utils
        NI["reflect-config.json"]:::ext
    end

    %% Relationships
    SWA -->|"boot()"| AE
    ClientCode -->|"getBean()"| DF
    AE -->|"load()"| AL
    AL -->|"scanAnnotations()"| ADP
    ADP -->|"parseAnnotations()"| DDR
    DDR -->|"registerComponent()"| DRC
    DDR -->|"registerComponent()"| DR
    DDR -->|"registerComponent()"| DRCX
    DF -->|"useScope()"| SDS
    DF -->|"useScope()"| PDS
    DF -->|"applyAspects()"| AH
    AH -->|"intercept()"| IP
    IP -->|"invoke()"| RAI
    RAI -->|"process()"| PP
    DDR -->|"emitRegistration()"| EE
    DF -->|"emitCreation()"| EE
    EE -->|"handleEvent()"| EH
    SWA -->|"shutdown()"| EE

    %% Click events
    click AL "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/AnnotationLoader.java"
    click EL "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/EnvironmentLoader.java"
    click AE "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/AnnotationEnvironment.java"
    click ADP "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/parser/AnnotationDependencyParser.java"
    click DP "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/parser/DependencyParser.java"
    click DDR "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/registry/DefaultDependencyRegister.java"
    click DRC "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/registry/DefaultDependencyRegistryContext.java"
    click DR "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/registry/DependencyRegister.java"
    click DRCX "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/registry/DependencyRegisterContext.java"
    click DF "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/DependencyFactory.java"
    click ADS "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/AbstractDependencyScope.java"
    click SDS "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/scopes/SingletonDependencyScope.java"
    click PDS "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/scopes/PrototypeDependencyScope.java"
    click AH "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/interceptor/AspectHandler.java"
    click IP "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/interceptor/InvocationPoint.java"
    click PP "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/interceptor/ProcessPoint.java"
    click RAI "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/interceptor/RuntimeAspectInfo.java"
    click EE "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/EventEmitter.java"
    click EH "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/event/EventHandler.java"
    click AEvt "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/event/AbstractEvent.java"
    click Evts "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/event/Events.java"
    click AA "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/application/AbstractApplication.java"
    click SWA "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/application/SWApplication.java"
    click RU "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/utils/ReflectionUtil.java"
    click AU "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/utils/AnnotationUtil.java"
    click LP "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/java/org/swdc/dependency/LoggerProvider.java"
    click LB "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/resources/logback.xml"
    click NI "https://github.com/sw-fantastic/swdc-dependency/blob/master/src/main/resources/META-INF/native-image/org.swdc/application-component/reflect-config.json"

    %% Styles
    classDef core fill:#cce5ff,stroke:#000,color:#000;
    classDef aop fill:#d4edda,stroke:#000,color:#000;
    classDef event fill:#fff3cd,stroke:#000,color:#000;
    classDef utils fill:#e2e3e5,stroke:#000,color:#000;
    classDef ext fill:#d6d8db,stroke:#000,color:#000;
    classDef external fill:#f8d7da,stroke:#000,color:#000;
```
