# conquerant2135/sprint_mvc architecture

> Architecture diagram of the GitHub repository conquerant2135/sprint_mvc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/conquerant2135/sprint_mvc
- Repository: https://github.com/conquerant2135/sprint_mvc

## Overview

SprintMVC is a small Java MVC web framework. A client application configures its servlet context and controller packages; startup scans annotated controllers, builds URL/method mappings, and installs the mapping table, view resolver, bean container, and JSON writer. The front controller matches GET/POST requests, invokes mapped controller methods through the container, then writes JSON or resolves a JSP view with model attributes. The README also documents optional Spring integration. Source excerpts show this core path; lesser runtime details are omitted where their implementations were not sampled.

Main entry points: [`src/main/java/mg/conquerant/sprintmvc/core/web/InitializerContextListener.java`](https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/web/InitializerContextListener.java) (Context initializer), [`src/main/java/mg/conquerant/sprintmvc/core/web/FrontControllerServlet.java`](https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/web/FrontControllerServlet.java) (Front controller), [`src/main/java/mg/conquerant/sprintmvc/core/scan/MappingBuilder.java`](https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/scan/MappingBuilder.java) (Route builder), [`src/main/java/mg/conquerant/sprintmvc/core/web/view/ViewResolver.java`](https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/web/view/ViewResolver.java) (View resolver)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Startup and discovery"]
  node_initializer["Context initializer"]
  node_scanner["Classpath scanner"]
end

subgraph group_routing["Routing metadata"]
  node_controllers["Controller annotations"]
  node_urlinfo["URL identity<br/>[UrlInfo.java]"]
  node_methodmap["Method mapping<br/>[MethodMapping.java]"]
  node_mappingbuilder["Route builder"]
  node_duplicate["Duplicate URL error"]
end

subgraph group_execution["Request execution"]
  node_front["Front controller"]
  node_modelview["Model and view<br/>[ModelAndView.java]"]
  node_resolver["View resolver<br/>[ViewResolver.java]"]
end

subgraph group_integration["Application integration"]
  node_containerapi["Bean container API"]
  node_defaultcontainer["Default bean container"]
  node_springcontainer["Spring bean adapter"]
end

node_client(("Client application"))
node_servlet{{"Servlet container"}}
node_spring{{"Spring context"}}
node_jsp["JSP views"]
node_httpclient(("HTTP client"))

node_client -->|"configures"| node_servlet
node_servlet -.->|"notifies startup"| node_initializer
node_initializer -->|"scans packages"| node_scanner
node_scanner -->|"finds annotated"| node_controllers
node_initializer -->|"builds routes"| node_mappingbuilder
node_mappingbuilder -->|"reads annotations"| node_controllers
node_mappingbuilder -->|"keys routes"| node_urlinfo
node_mappingbuilder -->|"creates mappings"| node_methodmap
node_mappingbuilder -->|"rejects duplicates"| node_duplicate
node_initializer -->|"creates fallback"| node_defaultcontainer
node_initializer -->|"wraps Spring"| node_springcontainer
node_springcontainer -->|"gets beans"| node_spring
node_defaultcontainer -->|"implements"| node_containerapi
node_springcontainer -->|"implements"| node_containerapi
node_initializer -->|"configures"| node_resolver
node_httpclient -.->|"sends requests"| node_front
node_servlet -->|"dispatches requests"| node_front
node_front -->|"matches request"| node_urlinfo
node_front -->|"executes route"| node_methodmap
node_methodmap -->|"gets controller"| node_containerapi
node_front -->|"handles view result"| node_modelview
node_front -->|"renders view"| node_resolver
node_resolver -->|"reads model"| node_modelview
node_resolver -->|"forwards to"| node_jsp

click node_controllers "https://github.com/conquerant2135/sprint_mvc/tree/master/src/main/java/mg/conquerant/sprintmvc/core/annotation"
click node_urlinfo "https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/mapping/UrlInfo.java"
click node_methodmap "https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/mapping/MethodMapping.java"
click node_mappingbuilder "https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/scan/MappingBuilder.java"
click node_duplicate "https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/exception/UrlRepetitionException.java"
click node_initializer "https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/web/InitializerContextListener.java"
click node_scanner "https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/utils/ClasspathAnalyzer.java"
click node_containerapi "https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/context/ApplicationContainer.java"
click node_defaultcontainer "https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/context/DefaultApplicationContainer.java"
click node_springcontainer "https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/context/SpringApplicationContainer.java"
click node_front "https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/web/FrontControllerServlet.java"
click node_modelview "https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/web/view/ModelAndView.java"
click node_resolver "https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/web/view/ViewResolver.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_initializer,node_scanner,node_client,node_jsp,node_httpclient toneBlue
class node_controllers,node_urlinfo,node_methodmap,node_mappingbuilder,node_duplicate toneAmber
class node_front,node_modelview,node_resolver toneMint
class node_containerapi,node_defaultcontainer,node_springcontainer toneRose
class node_servlet,node_spring toneIndigo
```

## Components

### Startup and discovery

- [Context initializer](https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/web/InitializerContextListener.java): `src/main/java/mg/conquerant/sprintmvc/core/web/InitializerContextListener.java`
- [Classpath scanner](https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/utils/ClasspathAnalyzer.java): `src/main/java/mg/conquerant/sprintmvc/utils/ClasspathAnalyzer.java`

### Routing metadata

- [Controller annotations](https://github.com/conquerant2135/sprint_mvc/tree/master/src/main/java/mg/conquerant/sprintmvc/core/annotation): `src/main/java/mg/conquerant/sprintmvc/core/annotation`
- [URL identity](https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/mapping/UrlInfo.java): `src/main/java/mg/conquerant/sprintmvc/core/mapping/UrlInfo.java`
- [Method mapping](https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/mapping/MethodMapping.java): `src/main/java/mg/conquerant/sprintmvc/core/mapping/MethodMapping.java`
- [Route builder](https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/scan/MappingBuilder.java): `src/main/java/mg/conquerant/sprintmvc/core/scan/MappingBuilder.java`
- [Duplicate URL error](https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/exception/UrlRepetitionException.java): `src/main/java/mg/conquerant/sprintmvc/core/exception/UrlRepetitionException.java`

### Request execution

- [Front controller](https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/web/FrontControllerServlet.java): `src/main/java/mg/conquerant/sprintmvc/core/web/FrontControllerServlet.java`
- [Model and view](https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/web/view/ModelAndView.java): `src/main/java/mg/conquerant/sprintmvc/core/web/view/ModelAndView.java`
- [View resolver](https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/web/view/ViewResolver.java): `src/main/java/mg/conquerant/sprintmvc/core/web/view/ViewResolver.java`

### Application integration

- [Bean container API](https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/context/ApplicationContainer.java): `src/main/java/mg/conquerant/sprintmvc/core/context/ApplicationContainer.java`
- [Default bean container](https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/context/DefaultApplicationContainer.java): `src/main/java/mg/conquerant/sprintmvc/core/context/DefaultApplicationContainer.java`
- [Spring bean adapter](https://github.com/conquerant2135/sprint_mvc/blob/master/src/main/java/mg/conquerant/sprintmvc/core/context/SpringApplicationContainer.java): `src/main/java/mg/conquerant/sprintmvc/core/context/SpringApplicationContainer.java`

### Other components

- **Client application**
- **Servlet container**
- **Spring context**
- **JSP views**
- **HTTP client**

## Connections

- Client application → Servlet container: configures (evidence: `README.md`)
- Servlet container → Context initializer: notifies startup
- Context initializer → Classpath scanner: scans packages (evidence: `src/main/java/mg/conquerant/sprintmvc/core/web/InitializerContextListener.java`)
- Classpath scanner → Controller annotations: finds annotated (evidence: `src/main/java/mg/conquerant/sprintmvc/utils/ClasspathAnalyzer.java`)
- Context initializer → Route builder: builds routes (evidence: `src/main/java/mg/conquerant/sprintmvc/core/web/InitializerContextListener.java`)
- Route builder → Controller annotations: reads annotations (evidence: `src/main/java/mg/conquerant/sprintmvc/core/scan/MappingBuilder.java`)
- Route builder → URL identity: keys routes (evidence: `src/main/java/mg/conquerant/sprintmvc/core/scan/MappingBuilder.java`)
- Route builder → Method mapping: creates mappings (evidence: `src/main/java/mg/conquerant/sprintmvc/core/scan/MappingBuilder.java`)
- Route builder → Duplicate URL error: rejects duplicates (evidence: `src/main/java/mg/conquerant/sprintmvc/core/scan/MappingBuilder.java`)
- Context initializer → Default bean container: creates fallback (evidence: `src/main/java/mg/conquerant/sprintmvc/core/web/InitializerContextListener.java`)
- Context initializer → Spring bean adapter: wraps Spring (evidence: `src/main/java/mg/conquerant/sprintmvc/core/web/InitializerContextListener.java`)
- Spring bean adapter → Spring context: gets beans (evidence: `src/main/java/mg/conquerant/sprintmvc/core/context/SpringApplicationContainer.java`)
- Default bean container → Bean container API: implements (evidence: `src/main/java/mg/conquerant/sprintmvc/core/context/DefaultApplicationContainer.java`)
- Spring bean adapter → Bean container API: implements (evidence: `src/main/java/mg/conquerant/sprintmvc/core/context/SpringApplicationContainer.java`)
- Context initializer → View resolver: configures (evidence: `src/main/java/mg/conquerant/sprintmvc/core/web/InitializerContextListener.java`)
- HTTP client → Front controller: sends requests
- Servlet container → Front controller: dispatches requests (evidence: `README.md`)
- Front controller → URL identity: matches request (evidence: `src/main/java/mg/conquerant/sprintmvc/core/web/FrontControllerServlet.java`)
- Front controller → Method mapping: executes route (evidence: `src/main/java/mg/conquerant/sprintmvc/core/web/FrontControllerServlet.java`)
- Method mapping → Bean container API: gets controller (evidence: `src/main/java/mg/conquerant/sprintmvc/core/mapping/MethodMapping.java`)
- Front controller → Model and view: handles view result (evidence: `src/main/java/mg/conquerant/sprintmvc/core/web/FrontControllerServlet.java`)
- Front controller → View resolver: renders view (evidence: `src/main/java/mg/conquerant/sprintmvc/core/web/FrontControllerServlet.java`)
- View resolver → Model and view: reads model (evidence: `src/main/java/mg/conquerant/sprintmvc/core/web/view/ViewResolver.java`)
- View resolver → JSP views: forwards to (evidence: `src/main/java/mg/conquerant/sprintmvc/core/web/view/ViewResolver.java`)
