# kcpeppe/javamemoryleaks architecture

> Architecture diagram of the GitHub repository kcpeppe/javamemoryleaks, 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/kcpeppe/javamemoryleaks
- Repository: https://github.com/kcpeppe/javamemoryleaks

## Overview

This repository is a Java stock-history workshop plus a separate garbage-collection monitoring exercise. In the stock workflow, a user requests history or a latest close; a servlet selects a configured data source, obtains prices, and renders a response. A separate analysis endpoint exposes price-list calculations. Exercise 2 adds ticker value objects and a price cache. The monitoring workflow captures JVM GC notifications and decodes memory-pool usage. Some routes and implementations were not excerpted, so uncertain connections are omitted.

Main entry points: [`exercise1/src/main/java/com/kodewerk/stock/ClosingPriceList.java`](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/stock/ClosingPriceList.java) (Price list), [`exercise2/src/main/java/com/kodewerk/web/StockHistory.java`](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise2/src/main/java/com/kodewerk/web/StockHistory.java) (Stock history), [`exercise1/src/main/java/com/kodewerk/db/ClosingPriceDataSource.java`](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/db/ClosingPriceDataSource.java) (Source interface), [`exercise1/src/main/java/com/kodewerk/web/Analysis.java`](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/web/Analysis.java) (Price analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Stock web"]
  node_stock_history["Stock history<br/>[StockHistory.java]"]
  node_analysis["Price analysis<br/>[Analysis.java]"]
  node_db_history["DB history<br/>[DBHistory.java]"]
  node_history_servlet["History servlet"]
end

subgraph group_data["Price data"]
  node_filesystem_source["File source"]
  node_rdb_source["RDB source"]
  node_db["Database access<br/>[DataBase.java]"]
  node_datasource_api["Source interface"]
  node_stock_properties["Stock properties"]
  node_price_cache[("Price cache<br/>[PriceCache.java]")]
end

subgraph group_domain["Stock domain"]
  node_price_list["Price list"]
  node_price["Closing price<br/>[ClosingPrice.java]"]
  node_ticker_list["Ticker list<br/>[TickerList.java]"]
  node_ticker_symbol["Ticker symbol<br/>[TickerSymbol.java]"]
  node_result_set["Analysis results"]
  node_crumb_trail["History trail<br/>[CrumbTrail.java]"]
end

subgraph group_monitor["GC monitoring"]
  node_gc_monitor["GC monitor"]
  node_gc_event["GC event parser<br/>[PSFull.java]"]
  node_memory_pool["Memory pool<br/>[MemoryPool.java]"]
end

node_user(("User"))
node_jvm(("JVM GC notifications"))

node_user -->|"requests prices"| node_stock_history
node_stock_history -->|"reads configuration"| node_stock_properties
node_stock_history -->|"loads prices"| node_datasource_api
node_stock_history -->|"renders results"| node_price_list
node_stock_history -->|"builds selector"| node_ticker_list
node_analysis -->|"reads configuration"| node_stock_properties
node_analysis -->|"loads prices"| node_datasource_api
node_analysis -->|"calculates statistics"| node_price_list
node_analysis -->|"builds selector"| node_ticker_list
node_db_history -->|"loads prices"| node_datasource_api
node_db_history -->|"uses history trail"| node_crumb_trail
node_datasource_api -->|"returns price lists"| node_price_list
node_datasource_api -->|"returns latest price"| node_price
node_filesystem_source -->|"loads into"| node_price_list
node_filesystem_source -->|"reads settings"| node_stock_properties
node_filesystem_source -->|"creates records"| node_price
node_db -->|"loads source data"| node_rdb_source
node_db -->|"constructs records"| node_price
node_db -->|"loads records"| node_price_list
node_price_cache -->|"stores and retrieves"| node_price_list
node_price_cache -->|"keys by ticker"| node_ticker_symbol
node_price_list -->|"contains prices"| node_price
node_stock_history -->|"parses request ticker"| node_ticker_symbol
node_jvm -->|"sends notifications"| node_gc_monitor
node_gc_monitor -->|"decodes GC data"| node_gc_event
node_gc_event -->|"extracts usage"| node_memory_pool

click node_stock_history "https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise2/src/main/java/com/kodewerk/web/StockHistory.java"
click node_analysis "https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/web/Analysis.java"
click node_db_history "https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/web/DBHistory.java"
click node_history_servlet "https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/web/HistoryServlet.java"
click node_filesystem_source "https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/db/ClosingPriceFileSystemDataSource.java"
click node_rdb_source "https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/db/ClosingPriceRDBDataSource.java"
click node_db "https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise2/src/main/java/com/kodewerk/db/DataBase.java"
click node_datasource_api "https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/db/ClosingPriceDataSource.java"
click node_stock_properties "https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/stock/StockProperties.java"
click node_price_cache "https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise2/src/main/java/com/kodewerk/cache/PriceCache.java"
click node_price_list "https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/stock/ClosingPriceList.java"
click node_price "https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/stock/ClosingPrice.java"
click node_ticker_list "https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/stock/TickerList.java"
click node_ticker_symbol "https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise2/src/main/java/com/kodewerk/stock/TickerSymbol.java"
click node_result_set "https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/stock/AnalysisResultSet.java"
click node_crumb_trail "https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/stock/CrumbTrail.java"
click node_gc_monitor "https://github.com/kcpeppe/javamemoryleaks/blob/main/leaky/src/main/java/com/kodewerk/monitoring/GarbageCollectionMonitor.java"
click node_gc_event "https://github.com/kcpeppe/javamemoryleaks/blob/main/leaky/src/main/java/com/kodewerk/monitoring/PSFull.java"
click node_memory_pool "https://github.com/kcpeppe/javamemoryleaks/blob/main/leaky/src/main/java/com/kodewerk/monitoring/MemoryPool.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_stock_history,node_analysis,node_db_history,node_history_servlet,node_user toneBlue
class node_filesystem_source,node_rdb_source,node_db,node_datasource_api,node_stock_properties,node_price_cache toneAmber
class node_price_list,node_price,node_ticker_list,node_ticker_symbol,node_result_set,node_crumb_trail toneMint
class node_gc_monitor,node_gc_event,node_memory_pool toneRose
class node_jvm toneIndigo
```

## Components

### Stock web

- [Stock history](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise2/src/main/java/com/kodewerk/web/StockHistory.java): `exercise2/src/main/java/com/kodewerk/web/StockHistory.java`
- [Price analysis](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/web/Analysis.java): `exercise1/src/main/java/com/kodewerk/web/Analysis.java`
- [DB history](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/web/DBHistory.java): `exercise1/src/main/java/com/kodewerk/web/DBHistory.java`
- [History servlet](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/web/HistoryServlet.java): `exercise1/src/main/java/com/kodewerk/web/HistoryServlet.java`

### Price data

- [File source](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/db/ClosingPriceFileSystemDataSource.java): `exercise1/src/main/java/com/kodewerk/db/ClosingPriceFileSystemDataSource.java`
- [RDB source](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/db/ClosingPriceRDBDataSource.java): `exercise1/src/main/java/com/kodewerk/db/ClosingPriceRDBDataSource.java`
- [Database access](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise2/src/main/java/com/kodewerk/db/DataBase.java): `exercise2/src/main/java/com/kodewerk/db/DataBase.java`
- [Source interface](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/db/ClosingPriceDataSource.java): `exercise1/src/main/java/com/kodewerk/db/ClosingPriceDataSource.java`
- [Stock properties](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/stock/StockProperties.java): `exercise1/src/main/java/com/kodewerk/stock/StockProperties.java`
- [Price cache](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise2/src/main/java/com/kodewerk/cache/PriceCache.java): `exercise2/src/main/java/com/kodewerk/cache/PriceCache.java`

### Stock domain

- [Price list](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/stock/ClosingPriceList.java): `exercise1/src/main/java/com/kodewerk/stock/ClosingPriceList.java`
- [Closing price](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/stock/ClosingPrice.java): `exercise1/src/main/java/com/kodewerk/stock/ClosingPrice.java`
- [Ticker list](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/stock/TickerList.java): `exercise1/src/main/java/com/kodewerk/stock/TickerList.java`
- [Ticker symbol](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise2/src/main/java/com/kodewerk/stock/TickerSymbol.java): `exercise2/src/main/java/com/kodewerk/stock/TickerSymbol.java`
- [Analysis results](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/stock/AnalysisResultSet.java): `exercise1/src/main/java/com/kodewerk/stock/AnalysisResultSet.java`
- [History trail](https://github.com/kcpeppe/javamemoryleaks/blob/main/exercise1/src/main/java/com/kodewerk/stock/CrumbTrail.java): `exercise1/src/main/java/com/kodewerk/stock/CrumbTrail.java`

### GC monitoring

- [GC monitor](https://github.com/kcpeppe/javamemoryleaks/blob/main/leaky/src/main/java/com/kodewerk/monitoring/GarbageCollectionMonitor.java): `leaky/src/main/java/com/kodewerk/monitoring/GarbageCollectionMonitor.java`
- [GC event parser](https://github.com/kcpeppe/javamemoryleaks/blob/main/leaky/src/main/java/com/kodewerk/monitoring/PSFull.java): `leaky/src/main/java/com/kodewerk/monitoring/PSFull.java`
- [Memory pool](https://github.com/kcpeppe/javamemoryleaks/blob/main/leaky/src/main/java/com/kodewerk/monitoring/MemoryPool.java): `leaky/src/main/java/com/kodewerk/monitoring/MemoryPool.java`

### Other components

- **User**
- **JVM GC notifications**

## Connections

- User → Stock history: requests prices (evidence: `exercise2/src/main/java/com/kodewerk/web/StockHistory.java`)
- Stock history → Stock properties: reads configuration (evidence: `exercise2/src/main/java/com/kodewerk/web/StockHistory.java`)
- Stock history → Source interface: loads prices (evidence: `exercise2/src/main/java/com/kodewerk/web/StockHistory.java`)
- Stock history → Price list: renders results (evidence: `exercise2/src/main/java/com/kodewerk/web/StockHistory.java`)
- Stock history → Ticker list: builds selector (evidence: `exercise2/src/main/java/com/kodewerk/web/StockHistory.java`)
- Price analysis → Stock properties: reads configuration (evidence: `exercise1/src/main/java/com/kodewerk/web/Analysis.java`)
- Price analysis → Source interface: loads prices (evidence: `exercise1/src/main/java/com/kodewerk/web/Analysis.java`)
- Price analysis → Price list: calculates statistics (evidence: `exercise1/src/main/java/com/kodewerk/web/Analysis.java`)
- Price analysis → Ticker list: builds selector (evidence: `exercise1/src/main/java/com/kodewerk/web/Analysis.java`)
- DB history → Source interface: loads prices (evidence: `exercise1/src/main/java/com/kodewerk/web/DBHistory.java`)
- DB history → History trail: uses history trail (evidence: `exercise1/src/main/java/com/kodewerk/web/DBHistory.java`)
- Source interface → Price list: returns price lists (evidence: `exercise1/src/main/java/com/kodewerk/db/ClosingPriceDataSource.java`)
- Source interface → Closing price: returns latest price (evidence: `exercise1/src/main/java/com/kodewerk/db/ClosingPriceDataSource.java`)
- File source → Price list: loads into (evidence: `exercise1/src/main/java/com/kodewerk/db/ClosingPriceFileSystemDataSource.java`)
- File source → Stock properties: reads settings (evidence: `exercise1/src/main/java/com/kodewerk/db/ClosingPriceFileSystemDataSource.java`)
- File source → Closing price: creates records (evidence: `exercise1/src/main/java/com/kodewerk/db/ClosingPriceFileSystemDataSource.java`)
- Database access → RDB source: loads source data (evidence: `exercise2/src/main/java/com/kodewerk/db/DataBase.java`)
- Database access → Closing price: constructs records (evidence: `exercise2/src/main/java/com/kodewerk/db/DataBase.java`)
- Database access → Price list: loads records (evidence: `exercise2/src/main/java/com/kodewerk/db/DataBase.java`)
- Price cache → Price list: stores and retrieves (evidence: `exercise2/src/main/java/com/kodewerk/cache/PriceCache.java`)
- Price cache → Ticker symbol: keys by ticker (evidence: `exercise2/src/main/java/com/kodewerk/cache/PriceCache.java`)
- Price list → Closing price: contains prices (evidence: `exercise1/src/main/java/com/kodewerk/stock/ClosingPriceList.java`)
- Stock history → Ticker symbol: parses request ticker (evidence: `exercise2/src/main/java/com/kodewerk/web/StockHistory.java`)
- JVM GC notifications → GC monitor: sends notifications (evidence: `leaky/src/main/java/com/kodewerk/monitoring/GarbageCollectionMonitor.java`)
- GC monitor → GC event parser: decodes GC data (evidence: `leaky/src/main/java/com/kodewerk/monitoring/GarbageCollectionMonitor.java`)
- GC event parser → Memory pool: extracts usage (evidence: `leaky/src/main/java/com/kodewerk/monitoring/PSFull.java`)
