# tr1cks/springclassloaders architecture

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

- Interactive diagram: https://gitdiagram.com/tr1cks/springclassloaders
- Repository: https://github.com/tr1cks/springclassloaders

## Overview

##### Project Type Analysis
This is a specialized demonstration project showing Spring Framework's limitations with multiple classloaders and plugin architecture, along with a proposed workaround solution.

##### Main Components

A. Core Module (Central Component):
- Sub-components:
- Context interface
- MainService interface
- SomeService interface
- Implementation classes

B. Plugin Modules (Satellite Components):
- Each containing:
- Plugin-specific Context
- Plugin-specific SomeService
- Plugin D should show nested structure with Sub and SubSub components

C. ClassLoader Layer:
- Separate ClassLoader instances for each plugin
- Isolation boundary

D. Workaround Component:
- Two main elements:
- MulticlassloadersAnnotationAwareAspectJAutoProxyCreator
- MulticlassloadersConfigurationClassPostProcessor

##### Additional Elements

- Version information for Spring Framework
- Notes explaining the key problem points
- Small code snippets showing critical configurations

##### Specific Details to Highlight

- How the META-INF/services are used for service loading
- Multiple classpath handling
- Demonstrate the plugin isolation boundaries
- How the workaround components interact with Spring's standard behavior

##### The service discovery mechanism through META-INF/services

Remember to include a title: "Spring Multi-ClassLoader Plugin Architecture with Workaround Solution" and add a brief description of the problem being solved.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Title
    title["Spring Multi-ClassLoader Plugin Architecture with Workaround Solution"]

    %% Core Module
    subgraph CoreModule["Core Module"]
        Context["Context Interface"]:::interface
        MainService["MainService Interface"]:::interface
        SomeService["SomeService Interface"]:::interface
        CoreImpl["Core Implementations"]:::implementation
    end

    %% Plugin Modules
    subgraph PluginA["Plugin A"]
        PluginAContext["Plugin A Context"]:::plugin
        PluginASomeService["Plugin A SomeService"]:::plugin
    end

    subgraph PluginB["Plugin B"]
        PluginBContext["Plugin B Context"]:::plugin
        PluginBSomeService["Plugin B SomeService"]:::plugin
    end

    subgraph PluginC["Plugin C"]
        PluginCContext["Plugin C Context"]:::plugin
        PluginCSomeService["Plugin C SomeService"]:::plugin
    end

    subgraph PluginD["Plugin D"]
        PluginDContext["Plugin D Context"]:::plugin
        PluginDSomeService["Plugin D SomeService"]:::plugin
        
        subgraph PluginDSub["Sub Component"]
            PluginDSubContext["Sub Context"]:::plugin
            PluginDSubSomeService["Sub SomeService"]:::plugin
            
            subgraph PluginDSubSub["SubSub Component"]
                PluginDSubSubContext["SubSub Context"]:::plugin
                PluginDSubSubSomeService["SubSub SomeService"]:::plugin
            end
        end
    end

    %% ClassLoader Layer
    subgraph ClassLoaders["ClassLoader Isolation Layer"]
        CL_A["Plugin A ClassLoader"]:::classloader
        CL_B["Plugin B ClassLoader"]:::classloader
        CL_C["Plugin C ClassLoader"]:::classloader
        CL_D["Plugin D ClassLoader"]:::classloader
    end

    %% Workaround Components
    subgraph Workaround["Workaround Solution"]
        AOP["MulticlassloadersAnnotationAwareAspectJAutoProxyCreator"]:::workaround
        ConfigPost["MulticlassloadersConfigurationClassPostProcessor"]:::workaround
    end

    %% Relationships
    Context --> PluginAContext
    Context --> PluginBContext
    Context --> PluginCContext
    Context --> PluginDContext
    SomeService --> PluginASomeService
    SomeService --> PluginBSomeService
    SomeService --> PluginCSomeService
    SomeService --> PluginDSomeService

    %% ClassLoader Relationships
    CL_A -.-> PluginA
    CL_B -.-> PluginB
    CL_C -.-> PluginC
    CL_D -.-> PluginD

    %% Workaround Relationships
    AOP --> ClassLoaders
    ConfigPost --> ClassLoaders

    %% Entry Points
    OneClasspath["Single Classpath Main"]:::entry
    MultipleClasspath["Multiple Classpaths Main"]:::entry
    WorkaroundMain["Workaround Main"]:::entry

    OneClasspath --> CoreModule
    MultipleClasspath --> ClassLoaders
    WorkaroundMain --> Workaround

    %% Click Events
    click Context "https://github.com/tr1cks/springclassloaders/blob/master/core/src/main/java/spring/core/Context.java"
    click MainService "https://github.com/tr1cks/springclassloaders/blob/master/core/src/main/java/spring/core/MainService.java"
    click SomeService "https://github.com/tr1cks/springclassloaders/blob/master/core/src/main/java/spring/core/SomeService.java"
    click CoreImpl "https://github.com/tr1cks/springclassloaders/tree/master/core/src/main/java/spring/core/impl/"
    click PluginAContext "https://github.com/tr1cks/springclassloaders/blob/master/plugina/src/main/java/spring/plugina/PluginAContext.java"
    click PluginASomeService "https://github.com/tr1cks/springclassloaders/blob/master/plugina/src/main/java/spring/plugina/PluginASomeService.java"
    click PluginBContext "https://github.com/tr1cks/springclassloaders/blob/master/pluginb/src/main/java/spring/pluginb/PluginBContext.java"
    click PluginBSomeService "https://github.com/tr1cks/springclassloaders/blob/master/pluginb/src/main/java/spring/pluginb/PluginBSomeService.java"
    click PluginCContext "https://github.com/tr1cks/springclassloaders/blob/master/pluginc/src/main/java/spring/pluginc/PluginCContext.java"
    click PluginCSomeService "https://github.com/tr1cks/springclassloaders/blob/master/pluginc/src/main/java/spring/pluginc/PluginCSomeService.java"
    click PluginDContext "https://github.com/tr1cks/springclassloaders/blob/master/plugind/src/main/java/spring/plugind/PluginDContext.java"
    click PluginDSomeService "https://github.com/tr1cks/springclassloaders/blob/master/plugind/src/main/java/spring/plugind/PluginDSomeService.java"
    click PluginDSubContext "https://github.com/tr1cks/springclassloaders/blob/master/plugind/src/main/java/spring/plugind/PluginDSubContext.java"
    click PluginDSubSomeService "https://github.com/tr1cks/springclassloaders/blob/master/plugind/src/main/java/spring/plugind/PluginDSubSomeService.java"
    click PluginDSubSubContext "https://github.com/tr1cks/springclassloaders/blob/master/plugind/src/main/java/spring/plugind/PluginDSubSubContext.java"
    click PluginDSubSubSomeService "https://github.com/tr1cks/springclassloaders/blob/master/plugind/src/main/java/spring/plugind/PluginDSubSubSomeService.java"
    click AOP "https://github.com/tr1cks/springclassloaders/blob/master/workaround/src/main/java/org/springframework/aop/framework/autoproxy/MulticlassloadersAnnotationAwareAspectJAutoProxyCreator.java"
    click ConfigPost "https://github.com/tr1cks/springclassloaders/blob/master/workaround/src/main/java/org/springframework/context/annotation/MulticlassloadersConfigurationClassPostProcessor.java"
    click OneClasspath "https://github.com/tr1cks/springclassloaders/blob/master/oneclasspath/src/main/java/spring/oneclasspath/OneClasspathMain.java"
    click MultipleClasspath "https://github.com/tr1cks/springclassloaders/blob/master/mutlipleclasspaths/src/main/java/spring/multipleclasspath/MultipleClasspathMain.java"
    click WorkaroundMain "https://github.com/tr1cks/springclassloaders/blob/master/workaround/src/main/java/spring/workaround/WorkaroundMain.java"

    %% Styling
    classDef interface fill:#gray,stroke:#333,stroke-width:2px
    classDef implementation fill:#blue,stroke:#333,stroke-width:2px
    classDef plugin fill:#green,stroke:#333,stroke-width:2px
    classDef classloader fill:#yellow,stroke:#333,stroke-width:2px
    classDef workaround fill:#purple,stroke:#333,stroke-width:2px,stroke-dasharray: 5 5
    classDef entry fill:#orange,stroke:#333,stroke-width:2px
```
