# xkcoding/spring-boot-demo architecture

> Architecture diagram of the GitHub repository xkcoding/spring-boot-demo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/xkcoding/spring-boot-demo
- Repository: https://github.com/xkcoding/spring-boot-demo

## Overview

Spring Boot Demo is a collection of independently runnable Spring Boot integration examples, not one end-to-end application. The typical workflow is to start a module, exercise its web/API or service entry point, and observe the demonstrated integration or result. The graph groups major capabilities from the README and tree; sampled source confirms selected internal behaviors, while unsampled module details are represented at directory level. Edges show only documented module launch or sampled calls, not an inferred cross-demo pipeline.

Main entry points: [`demo-helloworld/src/main/java/com/xkcoding/helloworld/SpringBootDemoHelloworldApplication.java`](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-helloworld/src/main/java/com/xkcoding/helloworld/SpringBootDemoHelloworldApplication.java) (Web demos), [`demo-template-freemarker/src/main/java/com/xkcoding/template/freemarker/controller`](https://github.com/xkcoding/spring-boot-demo/tree/master/demo-template-freemarker/src/main/java/com/xkcoding/template/freemarker/controller) (Page templates), [`demo-upload/src/main/java/com/xkcoding/upload/controller/UploadController.java`](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-upload/src/main/java/com/xkcoding/upload/controller/UploadController.java) (File upload), [`demo-swagger/src/main/java/com/xkcoding/swagger/controller/UserController.java`](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-swagger/src/main/java/com/xkcoding/swagger/controller/UserController.java) (API documentation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web and APIs"]
  node_webmvc["Web demos"]
  node_templates["Page templates"]
  node_upload["File upload"]
  node_swagger["API documentation"]
  node_exceptions["Exception handling"]
end

subgraph group_data["Data and Search"]
  node_orm["ORM examples"]
  node_multi_db["Multi datasource"]
  node_caches["Cache examples"]
  node_codegen["Code generation"]
  node_elasticsearch["Elasticsearch"]
  node_neo4j["Graph database<br/>[NeoService.java]"]
  node_mongodb["MongoDB"]
end

subgraph group_security["Security and Identity"]
  node_ldap["LDAP directory<br/>[PersonService.java]"]
  node_oauth["OAuth servers"]
  node_rbac["RBAC security"]
  node_ratelimit["Rate limiting"]
end

subgraph group_messaging["Messaging and Jobs"]
  node_queues["Message queues"]
  node_quartz["Quartz jobs<br/>[JobService.java]"]
  node_async["Async tasks<br/>[TaskFactory.java]"]
end

subgraph group_platform["Platform Integrations"]
  node_monitoring["Monitoring"]
  node_admin["Admin console"]
  node_email["Email delivery<br/>[MailService.java]"]
  node_websocket["WebSocket push"]
end

node_developer(("Developer"))

node_developer -->|"runs module"| node_webmvc
node_developer -->|"runs module"| node_templates
node_developer -->|"runs module"| node_upload
node_developer -->|"runs module"| node_swagger
node_developer -->|"runs module"| node_exceptions
node_developer -->|"runs module"| node_orm
node_developer -->|"runs module"| node_multi_db
node_developer -->|"runs module"| node_caches
node_developer -->|"runs module"| node_codegen
node_developer -->|"runs module"| node_elasticsearch
node_developer -->|"runs module"| node_neo4j
node_developer -->|"runs module"| node_mongodb
node_developer -->|"runs module"| node_ldap
node_developer -->|"runs module"| node_oauth
node_developer -->|"runs module"| node_rbac
node_developer -->|"runs module"| node_ratelimit
node_developer -->|"runs module"| node_queues
node_developer -->|"runs module"| node_quartz
node_developer -->|"runs module"| node_async
node_developer -->|"runs module"| node_monitoring
node_developer -->|"runs module"| node_admin
node_developer -->|"runs module"| node_email
node_developer -->|"runs module"| node_websocket

click node_webmvc "https://github.com/xkcoding/spring-boot-demo/blob/master/demo-helloworld/src/main/java/com/xkcoding/helloworld/SpringBootDemoHelloworldApplication.java"
click node_templates "https://github.com/xkcoding/spring-boot-demo/tree/master/demo-template-freemarker/src/main/java/com/xkcoding/template/freemarker/controller"
click node_upload "https://github.com/xkcoding/spring-boot-demo/blob/master/demo-upload/src/main/java/com/xkcoding/upload/controller/UploadController.java"
click node_swagger "https://github.com/xkcoding/spring-boot-demo/blob/master/demo-swagger/src/main/java/com/xkcoding/swagger/controller/UserController.java"
click node_exceptions "https://github.com/xkcoding/spring-boot-demo/blob/master/demo-exception-handler/src/main/java/com/xkcoding/exception/handler/controller/TestController.java"
click node_orm "https://github.com/xkcoding/spring-boot-demo/tree/master/demo-orm-jpa/src/main/java/com/xkcoding/orm/jpa/repository"
click node_multi_db "https://github.com/xkcoding/spring-boot-demo/tree/master/demo-dynamic-datasource/src/main/java/com/xkcoding/dynamic/datasource"
click node_caches "https://github.com/xkcoding/spring-boot-demo/blob/master/demo-cache-redis/src/main/java/com/xkcoding/cache/redis/service/impl/UserServiceImpl.java"
click node_codegen "https://github.com/xkcoding/spring-boot-demo/blob/master/demo-codegen/src/main/java/com/xkcoding/codegen/service/CodeGenService.java"
click node_elasticsearch "https://github.com/xkcoding/spring-boot-demo/blob/master/demo-elasticsearch-rest-high-level-client/src/main/java/com/xkcoding/elasticsearch/service/base/BaseElasticsearchService.java"
click node_neo4j "https://github.com/xkcoding/spring-boot-demo/blob/master/demo-neo4j/src/main/java/com/xkcoding/neo4j/service/NeoService.java"
click node_mongodb "https://github.com/xkcoding/spring-boot-demo/blob/master/demo-mongodb/src/main/java/com/xkcoding/mongodb/repository/ArticleRepository.java"
click node_ldap "https://github.com/xkcoding/spring-boot-demo/blob/master/demo-ldap/src/main/java/com/xkcoding/ldap/service/PersonService.java"
click node_oauth "https://github.com/xkcoding/spring-boot-demo/tree/master/demo-oauth/oauth-authorization-server/src/main/java/com/xkcoding/oauth/config"
click node_rbac "https://github.com/xkcoding/spring-boot-demo/blob/master/demo-rbac-security/src/main/java/com/xkcoding/rbac/security/config/RbacAuthorityService.java"
click node_ratelimit "https://github.com/xkcoding/spring-boot-demo/blob/master/demo-ratelimit-redis/src/main/java/com/xkcoding/ratelimit/redis/aspect/RateLimiterAspect.java"
click node_queues "https://github.com/xkcoding/spring-boot-demo/tree/master/demo-mq-rabbitmq/src/main/java/com/xkcoding/mq/rabbitmq/handler"
click node_quartz "https://github.com/xkcoding/spring-boot-demo/blob/master/demo-task-quartz/src/main/java/com/xkcoding/task/quartz/service/JobService.java"
click node_async "https://github.com/xkcoding/spring-boot-demo/blob/master/demo-async/src/main/java/com/xkcoding/async/task/TaskFactory.java"
click node_monitoring "https://github.com/xkcoding/spring-boot-demo/blob/master/demo-actuator/src/main/java/com/xkcoding/actuator/SpringBootDemoActuatorApplication.java"
click node_admin "https://github.com/xkcoding/spring-boot-demo/blob/master/demo-admin/admin-server/src/main/java/com/xkcoding/admin/server/SpringBootDemoAdminServerApplication.java"
click node_email "https://github.com/xkcoding/spring-boot-demo/blob/master/demo-email/src/main/java/com/xkcoding/email/service/MailService.java"
click node_websocket "https://github.com/xkcoding/spring-boot-demo/blob/master/demo-websocket/src/main/java/com/xkcoding/websocket/controller/ServerController.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_webmvc,node_templates,node_upload,node_swagger,node_exceptions toneBlue
class node_orm,node_multi_db,node_caches,node_codegen,node_elasticsearch,node_neo4j,node_mongodb toneAmber
class node_ldap,node_oauth,node_rbac,node_ratelimit toneMint
class node_queues,node_quartz,node_async toneRose
class node_monitoring,node_admin,node_email,node_websocket,node_developer toneIndigo
```

## Components

### Web and APIs

- [Web demos](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-helloworld/src/main/java/com/xkcoding/helloworld/SpringBootDemoHelloworldApplication.java): `demo-helloworld/src/main/java/com/xkcoding/helloworld/SpringBootDemoHelloworldApplication.java`
- [Page templates](https://github.com/xkcoding/spring-boot-demo/tree/master/demo-template-freemarker/src/main/java/com/xkcoding/template/freemarker/controller): `demo-template-freemarker/src/main/java/com/xkcoding/template/freemarker/controller`
- [File upload](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-upload/src/main/java/com/xkcoding/upload/controller/UploadController.java): `demo-upload/src/main/java/com/xkcoding/upload/controller/UploadController.java`
- [API documentation](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-swagger/src/main/java/com/xkcoding/swagger/controller/UserController.java): `demo-swagger/src/main/java/com/xkcoding/swagger/controller/UserController.java`
- [Exception handling](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-exception-handler/src/main/java/com/xkcoding/exception/handler/controller/TestController.java): `demo-exception-handler/src/main/java/com/xkcoding/exception/handler/controller/TestController.java`

### Data and Search

- [ORM examples](https://github.com/xkcoding/spring-boot-demo/tree/master/demo-orm-jpa/src/main/java/com/xkcoding/orm/jpa/repository): `demo-orm-jpa/src/main/java/com/xkcoding/orm/jpa/repository`
- [Multi datasource](https://github.com/xkcoding/spring-boot-demo/tree/master/demo-dynamic-datasource/src/main/java/com/xkcoding/dynamic/datasource): `demo-dynamic-datasource/src/main/java/com/xkcoding/dynamic/datasource`
- [Cache examples](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-cache-redis/src/main/java/com/xkcoding/cache/redis/service/impl/UserServiceImpl.java): `demo-cache-redis/src/main/java/com/xkcoding/cache/redis/service/impl/UserServiceImpl.java`
- [Code generation](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-codegen/src/main/java/com/xkcoding/codegen/service/CodeGenService.java): `demo-codegen/src/main/java/com/xkcoding/codegen/service/CodeGenService.java`
- [Elasticsearch](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-elasticsearch-rest-high-level-client/src/main/java/com/xkcoding/elasticsearch/service/base/BaseElasticsearchService.java): `demo-elasticsearch-rest-high-level-client/src/main/java/com/xkcoding/elasticsearch/service/base/BaseElasticsearchService.java`
- [Graph database](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-neo4j/src/main/java/com/xkcoding/neo4j/service/NeoService.java): `demo-neo4j/src/main/java/com/xkcoding/neo4j/service/NeoService.java`
- [MongoDB](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-mongodb/src/main/java/com/xkcoding/mongodb/repository/ArticleRepository.java): `demo-mongodb/src/main/java/com/xkcoding/mongodb/repository/ArticleRepository.java`

### Security and Identity

- [LDAP directory](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-ldap/src/main/java/com/xkcoding/ldap/service/PersonService.java): `demo-ldap/src/main/java/com/xkcoding/ldap/service/PersonService.java`
- [OAuth servers](https://github.com/xkcoding/spring-boot-demo/tree/master/demo-oauth/oauth-authorization-server/src/main/java/com/xkcoding/oauth/config): `demo-oauth/oauth-authorization-server/src/main/java/com/xkcoding/oauth/config`
- [RBAC security](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-rbac-security/src/main/java/com/xkcoding/rbac/security/config/RbacAuthorityService.java): `demo-rbac-security/src/main/java/com/xkcoding/rbac/security/config/RbacAuthorityService.java`
- [Rate limiting](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-ratelimit-redis/src/main/java/com/xkcoding/ratelimit/redis/aspect/RateLimiterAspect.java): `demo-ratelimit-redis/src/main/java/com/xkcoding/ratelimit/redis/aspect/RateLimiterAspect.java`

### Messaging and Jobs

- [Message queues](https://github.com/xkcoding/spring-boot-demo/tree/master/demo-mq-rabbitmq/src/main/java/com/xkcoding/mq/rabbitmq/handler): `demo-mq-rabbitmq/src/main/java/com/xkcoding/mq/rabbitmq/handler`
- [Quartz jobs](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-task-quartz/src/main/java/com/xkcoding/task/quartz/service/JobService.java): `demo-task-quartz/src/main/java/com/xkcoding/task/quartz/service/JobService.java`
- [Async tasks](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-async/src/main/java/com/xkcoding/async/task/TaskFactory.java): `demo-async/src/main/java/com/xkcoding/async/task/TaskFactory.java`

### Platform Integrations

- [Monitoring](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-actuator/src/main/java/com/xkcoding/actuator/SpringBootDemoActuatorApplication.java): `demo-actuator/src/main/java/com/xkcoding/actuator/SpringBootDemoActuatorApplication.java`
- [Admin console](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-admin/admin-server/src/main/java/com/xkcoding/admin/server/SpringBootDemoAdminServerApplication.java): `demo-admin/admin-server/src/main/java/com/xkcoding/admin/server/SpringBootDemoAdminServerApplication.java`
- [Email delivery](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-email/src/main/java/com/xkcoding/email/service/MailService.java): `demo-email/src/main/java/com/xkcoding/email/service/MailService.java`
- [WebSocket push](https://github.com/xkcoding/spring-boot-demo/blob/master/demo-websocket/src/main/java/com/xkcoding/websocket/controller/ServerController.java): `demo-websocket/src/main/java/com/xkcoding/websocket/controller/ServerController.java`

### Other components

- **Developer**

## Connections

- Developer → Web demos: runs module (evidence: `README.md`)
- Developer → Page templates: runs module (evidence: `README.md`)
- Developer → File upload: runs module (evidence: `README.md`)
- Developer → API documentation: runs module (evidence: `README.md`)
- Developer → Exception handling: runs module (evidence: `README.md`)
- Developer → ORM examples: runs module (evidence: `README.md`)
- Developer → Multi datasource: runs module (evidence: `README.md`)
- Developer → Cache examples: runs module (evidence: `README.md`)
- Developer → Code generation: runs module (evidence: `README.md`)
- Developer → Elasticsearch: runs module (evidence: `README.md`)
- Developer → Graph database: runs module (evidence: `README.md`)
- Developer → MongoDB: runs module (evidence: `README.md`)
- Developer → LDAP directory: runs module (evidence: `README.md`)
- Developer → OAuth servers: runs module (evidence: `README.md`)
- Developer → RBAC security: runs module (evidence: `README.md`)
- Developer → Rate limiting: runs module (evidence: `README.md`)
- Developer → Message queues: runs module (evidence: `README.md`)
- Developer → Quartz jobs: runs module (evidence: `README.md`)
- Developer → Async tasks: runs module (evidence: `README.md`)
- Developer → Monitoring: runs module (evidence: `README.md`)
- Developer → Admin console: runs module (evidence: `README.md`)
- Developer → Email delivery: runs module (evidence: `README.md`)
- Developer → WebSocket push: runs module (evidence: `README.md`)
