# vantablackzz/java-design-patterns architecture

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

- Interactive diagram: https://gitdiagram.com/vantablackzz/java-design-patterns
- Repository: https://github.com/vantablackzz/java-design-patterns

## Overview

This repository is an educational catalog of Java design-pattern implementations, not one integrated application. A reader searches or browses by pattern name, tags, or category, then studies the corresponding commented source example. The tree shows many independently runnable pattern modules; there is no shared runtime pipeline connecting them. The graph captures documented browsing routes and representative pattern families. Individual example internals are not inferred from directory names, and the README excerpt does not establish how a website maps catalog entries to source files.

Main entry points: [`abstract-factory/src/main/java/com/iluwatar/abstractfactory`](https://github.com/vantablackzz/java-design-patterns/tree/master/abstract-factory/src/main/java/com/iluwatar/abstractfactory) (Abstract Factory), [`builder/src/main/java/com/iluwatar/builder`](https://github.com/vantablackzz/java-design-patterns/tree/master/builder/src/main/java/com/iluwatar/builder) (Builder), [`adapter/src/main/java/com/iluwatar/adapter`](https://github.com/vantablackzz/java-design-patterns/tree/master/adapter/src/main/java/com/iluwatar/adapter) (Adapter), [`abstract-document/src/main/java/com/iluwatar/abstractdocument`](https://github.com/vantablackzz/java-design-patterns/tree/master/abstract-document/src/main/java/com/iluwatar/abstractdocument) (Abstract Document)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Pattern Catalog"]
  node_pattern_catalog["Pattern Catalog"]
end

subgraph group_creation["Object Creation"]
  node_creational_examples["Creational Examples"]
  node_abstract_factory["Abstract Factory"]
  node_builder["Builder"]
end

subgraph group_structure["Structural Patterns"]
  node_structural_examples["Structural Examples"]
  node_adapter["Adapter"]
  node_abstract_document["Abstract Document"]
end

subgraph group_behavior["Behavioral Patterns"]
  node_behavioral_examples["Behavioral Examples"]
  node_chain["Chain Responsibility"]
  node_command["Command"]
  node_actor_model["Actor Model"]
end

subgraph group_architecture["Application Architecture"]
  node_architecture_examples["Architecture Examples"]
  node_clean_architecture["Clean Architecture"]
  node_cqrs["CQRS"]
  node_bff["Backend for Frontends"]
end

node_reader(("Learner"))

node_reader -->|"browses"| node_pattern_catalog
node_pattern_catalog -->|"selects category"| node_creational_examples
node_pattern_catalog -->|"selects category"| node_structural_examples
node_pattern_catalog -->|"selects category"| node_behavioral_examples
node_pattern_catalog -.->|"selects category"| node_architecture_examples
node_creational_examples -.->|"studies example"| node_abstract_factory
node_creational_examples -.->|"studies example"| node_builder
node_structural_examples -.->|"studies example"| node_adapter
node_structural_examples -.->|"studies example"| node_abstract_document
node_behavioral_examples -.->|"studies example"| node_chain
node_behavioral_examples -.->|"studies example"| node_command
node_behavioral_examples -.->|"studies example"| node_actor_model
node_architecture_examples -.->|"studies example"| node_clean_architecture
node_architecture_examples -.->|"studies example"| node_cqrs
node_architecture_examples -.->|"studies example"| node_bff

click node_abstract_factory "https://github.com/vantablackzz/java-design-patterns/tree/master/abstract-factory/src/main/java/com/iluwatar/abstractfactory"
click node_builder "https://github.com/vantablackzz/java-design-patterns/tree/master/builder/src/main/java/com/iluwatar/builder"
click node_adapter "https://github.com/vantablackzz/java-design-patterns/tree/master/adapter/src/main/java/com/iluwatar/adapter"
click node_abstract_document "https://github.com/vantablackzz/java-design-patterns/tree/master/abstract-document/src/main/java/com/iluwatar/abstractdocument"
click node_chain "https://github.com/vantablackzz/java-design-patterns/tree/master/chain-of-responsibility/src/main/java/com/iluwatar/chain"
click node_command "https://github.com/vantablackzz/java-design-patterns/tree/master/command/src/main/java/com/iluwatar/command"
click node_actor_model "https://github.com/vantablackzz/java-design-patterns/tree/master/actor-model/src/main/java/com/iluwatar/actormodel"
click node_clean_architecture "https://github.com/vantablackzz/java-design-patterns/tree/master/clean-architecture/src/main/java/com/iluwatar/cleanarchitecture"
click node_cqrs "https://github.com/vantablackzz/java-design-patterns/tree/master/command-query-responsibility-segregation/src/main/java/com/iluwatar/cqrs"
click node_bff "https://github.com/vantablackzz/java-design-patterns/tree/master/backends-for-frontends/src/main/java/com/iluwatar/bff"

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_pattern_catalog toneBlue
class node_creational_examples,node_abstract_factory,node_builder toneAmber
class node_structural_examples,node_adapter,node_abstract_document toneMint
class node_behavioral_examples,node_chain,node_command,node_actor_model toneRose
class node_architecture_examples,node_clean_architecture,node_cqrs,node_bff,node_reader toneIndigo
```

## Components

### Pattern Catalog

- **Pattern Catalog**

### Object Creation

- **Creational Examples**
- [Abstract Factory](https://github.com/vantablackzz/java-design-patterns/tree/master/abstract-factory/src/main/java/com/iluwatar/abstractfactory): `abstract-factory/src/main/java/com/iluwatar/abstractfactory`
- [Builder](https://github.com/vantablackzz/java-design-patterns/tree/master/builder/src/main/java/com/iluwatar/builder): `builder/src/main/java/com/iluwatar/builder`

### Structural Patterns

- **Structural Examples**
- [Adapter](https://github.com/vantablackzz/java-design-patterns/tree/master/adapter/src/main/java/com/iluwatar/adapter): `adapter/src/main/java/com/iluwatar/adapter`
- [Abstract Document](https://github.com/vantablackzz/java-design-patterns/tree/master/abstract-document/src/main/java/com/iluwatar/abstractdocument): `abstract-document/src/main/java/com/iluwatar/abstractdocument`

### Behavioral Patterns

- **Behavioral Examples**
- [Chain Responsibility](https://github.com/vantablackzz/java-design-patterns/tree/master/chain-of-responsibility/src/main/java/com/iluwatar/chain): `chain-of-responsibility/src/main/java/com/iluwatar/chain`
- [Command](https://github.com/vantablackzz/java-design-patterns/tree/master/command/src/main/java/com/iluwatar/command): `command/src/main/java/com/iluwatar/command`
- [Actor Model](https://github.com/vantablackzz/java-design-patterns/tree/master/actor-model/src/main/java/com/iluwatar/actormodel): `actor-model/src/main/java/com/iluwatar/actormodel`

### Application Architecture

- **Architecture Examples**
- [Clean Architecture](https://github.com/vantablackzz/java-design-patterns/tree/master/clean-architecture/src/main/java/com/iluwatar/cleanarchitecture): `clean-architecture/src/main/java/com/iluwatar/cleanarchitecture`
- [CQRS](https://github.com/vantablackzz/java-design-patterns/tree/master/command-query-responsibility-segregation/src/main/java/com/iluwatar/cqrs): `command-query-responsibility-segregation/src/main/java/com/iluwatar/cqrs`
- [Backend for Frontends](https://github.com/vantablackzz/java-design-patterns/tree/master/backends-for-frontends/src/main/java/com/iluwatar/bff): `backends-for-frontends/src/main/java/com/iluwatar/bff`

### Other components

- **Learner**

## Connections

- Learner → Pattern Catalog: browses (evidence: `README.md`)
- Pattern Catalog → Creational Examples: selects category (evidence: `README.md`)
- Pattern Catalog → Structural Examples: selects category (evidence: `README.md`)
- Pattern Catalog → Behavioral Examples: selects category (evidence: `README.md`)
- Pattern Catalog → Architecture Examples: selects category
- Creational Examples → Abstract Factory: studies example
- Creational Examples → Builder: studies example
- Structural Examples → Adapter: studies example
- Structural Examples → Abstract Document: studies example
- Behavioral Examples → Chain Responsibility: studies example
- Behavioral Examples → Command: studies example
- Behavioral Examples → Actor Model: studies example
- Architecture Examples → Clean Architecture: studies example
- Architecture Examples → CQRS: studies example
- Architecture Examples → Backend for Frontends: studies example
