# kaigermany/ultimateutils architecture

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

- Interactive diagram: https://gitdiagram.com/kaigermany/ultimateutils
- Repository: https://github.com/kaigermany/ultimateutils

## Overview

UltimateUtils is a Java utility library rather than a single application: callers use standalone helpers and domain APIs directly. Its README highlights JSON, DDS, DNS, HTTP, WebSocket, parallel work, thread flow control, and ClassExtensions. Shown edges follow explicit imports, documented features, or visible calls; dashed links mark integrations documented by the README but not evidenced in sampled implementation. Several listed subsystems were not excerpted, so their internal wiring is not inferred.

Main entry points: [`src/me/kaigermany/ultimateutils/networking/smarthttp/HTTPClient.java`](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/smarthttp/HTTPClient.java) (HTTP connection), [`src/me/kaigermany/ultimateutils/networking/smarthttp/SmartHTTP.java`](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/smarthttp/SmartHTTP.java) (SmartHTTP API), [`src/me/kaigermany/ultimateutils/networking/websocket/WebSocket.java`](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/websocket/WebSocket.java) (WebSocket client), [`src/me/kaigermany/ultimateutils/image`](https://github.com/kaigermany/ultimateutils/tree/main/src/me/kaigermany/ultimateutils/image) (FFmpeg video I/O)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Data formats"]
  node_json["JSON parser and values"]
  node_dds["DDS reader and writer"]
  node_video["FFmpeg video I/O"]
  node_sorted["Ordered writer<br/>[SortedWriter.java]"]
end

subgraph group_network["Networking"]
  node_dns["DNS resolution"]
  node_httpserver["Mini HTTP server"]
  node_smarthttp["SmartHTTP API<br/>[SmartHTTP.java]"]
  node_httpclient["HTTP connection<br/>[HTTPClient.java]"]
  node_httpresult["HTTP results<br/>[HTTPResult.java]"]
  node_httpevent["HTTP streaming event"]
  node_httpgroup["Keep-alive pool"]
  node_socket["Socket factory<br/>[SocketFactory.java]"]
  node_websocket["WebSocket client<br/>[WebSocket.java]"]
  node_websocketbasic["WebSocket framing"]
  node_websocketevent["WebSocket events"]
  node_websocketserver["WebSocket server"]
end

subgraph group_concurrency["Concurrency"]
  node_parallel["Parallel execution<br/>[Parallel.java]"]
  node_coprocessor["CoProcessor<br/>[CoProcessor.java]"]
  node_queue["Processor queue"]
  node_worker["Thread worker<br/>[ThreadWorker.java]"]
  node_lock["Thread lock<br/>[ThreadLock.java]"]
end

subgraph group_utilities["Core utilities"]
  node_extensions["ClassExtensions"]
  node_fasthex["Fast hex helpers<br/>[FastHex.java]"]
  node_math["Math helpers<br/>[MATH.java]"]
  node_utils["General utility classes"]
end

subgraph group_resources["Resource injection"]
  node_injector["Resource injector"]
  node_listener["Resource listener"]
  node_unsafe["Unsafe access<br/>[Unsafe.java]"]
end

node_users(("Library callers"))
node_ffmpeg["FFmpeg process"]
node_remotehttp(("HTTP endpoint"))
node_remotewebsocket(("Remote WebSocket"))

node_users -->|"parse or write"| node_json
node_json -->|"parses values"| node_json
node_users -->|"read or write DDS"| node_dds
node_users -->|"resolve names"| node_dns
node_users -->|"serve requests"| node_httpserver
node_users -->|"make HTTP requests"| node_smarthttp
node_smarthttp -->|"dispatches requests"| node_httpclient
node_httpclient -->|"opens sockets"| node_socket
node_httpclient -->|"builds results"| node_httpresult
node_httpclient -->|"streams response"| node_httpevent
node_httpclient -->|"uses connection pool"| node_httpgroup
node_smarthttp -->|"manages connections"| node_httpgroup
node_smarthttp -.->|"sends requests"| node_remotehttp
node_users -->|"connect remotely"| node_websocket
node_websocket -->|"uses framing"| node_websocketbasic
node_websocket -->|"opens sockets"| node_socket
node_websocketbasic -->|"dispatches events"| node_websocketevent
node_websocket -.->|"connects to"| node_remotewebsocket
node_users -->|"host browser clients"| node_websocketserver
node_users -->|"spread work"| node_parallel
node_users -->|"coordinate threads"| node_lock
node_coprocessor -->|"starts workers"| node_worker
node_worker -->|"polls jobs"| node_queue
node_worker -->|"awaits idle"| node_lock
node_video -->|"orders frames"| node_sorted
node_video -->|"awaits jobs"| node_coprocessor
node_video -->|"writes video frames"| node_ffmpeg
node_users -->|"include helpers"| node_extensions
node_extensions -->|"extends helpers"| node_fasthex
node_extensions -->|"extends helpers"| node_math
node_users -->|"use utilities"| node_utils
node_users -.->|"register resource lookup"| node_listener
node_listener -->|"selects injector"| node_injector
node_injector -->|"accesses runtime internals"| node_unsafe

click node_json "https://github.com/kaigermany/ultimateutils/tree/main/src/me/kaigermany/ultimateutils/data/json"
click node_dds "https://github.com/kaigermany/ultimateutils/tree/main/src/me/kaigermany/ultimateutils/image/dds"
click node_video "https://github.com/kaigermany/ultimateutils/tree/main/src/me/kaigermany/ultimateutils/image"
click node_sorted "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/data/SortedWriter.java"
click node_dns "https://github.com/kaigermany/ultimateutils/tree/main/src/me/kaigermany/ultimateutils/networking/dns"
click node_httpserver "https://github.com/kaigermany/ultimateutils/tree/main/src/me/kaigermany/ultimateutils/networking/httpserver"
click node_smarthttp "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/smarthttp/SmartHTTP.java"
click node_httpclient "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/smarthttp/HTTPClient.java"
click node_httpresult "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/smarthttp/HTTPResult.java"
click node_httpevent "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/smarthttp/HTTPResultEvent.java"
click node_httpgroup "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/smarthttp/HTTPServerGroup.java"
click node_socket "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/util/SocketFactory.java"
click node_websocket "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/websocket/WebSocket.java"
click node_websocketbasic "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/websocket/WebSocketBasic.java"
click node_websocketevent "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/websocket/WebSocketEvent.java"
click node_websocketserver "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/websocket/WebSocketServer.java"
click node_parallel "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/sync/thread/Parallel.java"
click node_coprocessor "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/sync/thread/CoProcessor.java"
click node_queue "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/sync/thread/ProcessorQueue.java"
click node_worker "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/sync/thread/ThreadWorker.java"
click node_lock "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/sync/thread/ThreadLock.java"
click node_extensions "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/ClassExtensions.java"
click node_fasthex "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/classextensioninternals/FastHex.java"
click node_math "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/classextensioninternals/MATH.java"
click node_utils "https://github.com/kaigermany/ultimateutils/tree/main/src/me/kaigermany/ultimateutils"
click node_injector "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/special/UnknownResourceInjector9.java"
click node_listener "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/special/UnknownResourceListener.java"
click node_unsafe "https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/special/Unsafe.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_json,node_dds,node_video,node_sorted toneBlue
class node_dns,node_httpserver,node_smarthttp,node_httpclient,node_httpresult,node_httpevent,node_httpgroup,node_socket,node_websocket,node_websocketbasic,node_websocketevent,node_websocketserver toneAmber
class node_parallel,node_coprocessor,node_queue,node_worker,node_lock toneMint
class node_extensions,node_fasthex,node_math,node_utils toneRose
class node_injector,node_listener,node_unsafe,node_users,node_ffmpeg,node_remotehttp,node_remotewebsocket toneIndigo
```

## Components

### Data formats

- [JSON parser and values](https://github.com/kaigermany/ultimateutils/tree/main/src/me/kaigermany/ultimateutils/data/json): `src/me/kaigermany/ultimateutils/data/json`
- [DDS reader and writer](https://github.com/kaigermany/ultimateutils/tree/main/src/me/kaigermany/ultimateutils/image/dds): `src/me/kaigermany/ultimateutils/image/dds`
- [FFmpeg video I/O](https://github.com/kaigermany/ultimateutils/tree/main/src/me/kaigermany/ultimateutils/image): `src/me/kaigermany/ultimateutils/image`
- [Ordered writer](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/data/SortedWriter.java): `src/me/kaigermany/ultimateutils/data/SortedWriter.java`

### Networking

- [DNS resolution](https://github.com/kaigermany/ultimateutils/tree/main/src/me/kaigermany/ultimateutils/networking/dns): `src/me/kaigermany/ultimateutils/networking/dns`
- [Mini HTTP server](https://github.com/kaigermany/ultimateutils/tree/main/src/me/kaigermany/ultimateutils/networking/httpserver): `src/me/kaigermany/ultimateutils/networking/httpserver`
- [SmartHTTP API](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/smarthttp/SmartHTTP.java): `src/me/kaigermany/ultimateutils/networking/smarthttp/SmartHTTP.java`
- [HTTP connection](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/smarthttp/HTTPClient.java): `src/me/kaigermany/ultimateutils/networking/smarthttp/HTTPClient.java`
- [HTTP results](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/smarthttp/HTTPResult.java): `src/me/kaigermany/ultimateutils/networking/smarthttp/HTTPResult.java`
- [HTTP streaming event](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/smarthttp/HTTPResultEvent.java): `src/me/kaigermany/ultimateutils/networking/smarthttp/HTTPResultEvent.java`
- [Keep-alive pool](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/smarthttp/HTTPServerGroup.java): `src/me/kaigermany/ultimateutils/networking/smarthttp/HTTPServerGroup.java`
- [Socket factory](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/util/SocketFactory.java): `src/me/kaigermany/ultimateutils/networking/util/SocketFactory.java`
- [WebSocket client](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/websocket/WebSocket.java): `src/me/kaigermany/ultimateutils/networking/websocket/WebSocket.java`
- [WebSocket framing](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/websocket/WebSocketBasic.java): `src/me/kaigermany/ultimateutils/networking/websocket/WebSocketBasic.java`
- [WebSocket events](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/websocket/WebSocketEvent.java): `src/me/kaigermany/ultimateutils/networking/websocket/WebSocketEvent.java`
- [WebSocket server](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/networking/websocket/WebSocketServer.java): `src/me/kaigermany/ultimateutils/networking/websocket/WebSocketServer.java`

### Concurrency

- [Parallel execution](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/sync/thread/Parallel.java): `src/me/kaigermany/ultimateutils/sync/thread/Parallel.java`
- [CoProcessor](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/sync/thread/CoProcessor.java): `src/me/kaigermany/ultimateutils/sync/thread/CoProcessor.java`
- [Processor queue](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/sync/thread/ProcessorQueue.java): `src/me/kaigermany/ultimateutils/sync/thread/ProcessorQueue.java`
- [Thread worker](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/sync/thread/ThreadWorker.java): `src/me/kaigermany/ultimateutils/sync/thread/ThreadWorker.java`
- [Thread lock](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/sync/thread/ThreadLock.java): `src/me/kaigermany/ultimateutils/sync/thread/ThreadLock.java`

### Core utilities

- [ClassExtensions](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/ClassExtensions.java): `src/me/kaigermany/ultimateutils/ClassExtensions.java`
- [Fast hex helpers](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/classextensioninternals/FastHex.java): `src/me/kaigermany/ultimateutils/classextensioninternals/FastHex.java`
- [Math helpers](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/classextensioninternals/MATH.java): `src/me/kaigermany/ultimateutils/classextensioninternals/MATH.java`
- [General utility classes](https://github.com/kaigermany/ultimateutils/tree/main/src/me/kaigermany/ultimateutils): `src/me/kaigermany/ultimateutils`

### Resource injection

- [Resource injector](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/special/UnknownResourceInjector9.java): `src/me/kaigermany/ultimateutils/special/UnknownResourceInjector9.java`
- [Resource listener](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/special/UnknownResourceListener.java): `src/me/kaigermany/ultimateutils/special/UnknownResourceListener.java`
- [Unsafe access](https://github.com/kaigermany/ultimateutils/blob/main/src/me/kaigermany/ultimateutils/special/Unsafe.java): `src/me/kaigermany/ultimateutils/special/Unsafe.java`

### Other components

- **Library callers**
- **FFmpeg process**
- **HTTP endpoint**
- **Remote WebSocket**

## Connections

- Library callers → JSON parser and values: parse or write (evidence: `README.md`)
- JSON parser and values → JSON parser and values: parses values (evidence: `src/me/kaigermany/ultimateutils/data/json/JSONTokener.java`)
- Library callers → DDS reader and writer: read or write DDS (evidence: `README.md`)
- Library callers → DNS resolution: resolve names (evidence: `README.md`)
- Library callers → Mini HTTP server: serve requests (evidence: `README.md`)
- Library callers → SmartHTTP API: make HTTP requests (evidence: `README.md`)
- SmartHTTP API → HTTP connection: dispatches requests (evidence: `src/me/kaigermany/ultimateutils/networking/smarthttp/SmartHTTP.java`)
- HTTP connection → Socket factory: opens sockets (evidence: `src/me/kaigermany/ultimateutils/networking/smarthttp/HTTPClient.java`)
- HTTP connection → HTTP results: builds results (evidence: `src/me/kaigermany/ultimateutils/networking/smarthttp/HTTPClient.java`)
- HTTP connection → HTTP streaming event: streams response (evidence: `src/me/kaigermany/ultimateutils/networking/smarthttp/HTTPClient.java`)
- HTTP connection → Keep-alive pool: uses connection pool (evidence: `src/me/kaigermany/ultimateutils/networking/smarthttp/HTTPClient.java`)
- SmartHTTP API → Keep-alive pool: manages connections (evidence: `src/me/kaigermany/ultimateutils/networking/smarthttp/SmartHTTP.java`)
- SmartHTTP API → HTTP endpoint: sends requests (evidence: `README.md`)
- Library callers → WebSocket client: connect remotely (evidence: `README.md`)
- WebSocket client → WebSocket framing: uses framing (evidence: `src/me/kaigermany/ultimateutils/networking/websocket/WebSocket.java`)
- WebSocket client → Socket factory: opens sockets (evidence: `src/me/kaigermany/ultimateutils/networking/websocket/WebSocket.java`)
- WebSocket framing → WebSocket events: dispatches events (evidence: `src/me/kaigermany/ultimateutils/networking/websocket/WebSocketBasic.java`)
- WebSocket client → Remote WebSocket: connects to (evidence: `README.md`)
- Library callers → WebSocket server: host browser clients (evidence: `README.md`)
- Library callers → Parallel execution: spread work (evidence: `README.md`)
- Library callers → Thread lock: coordinate threads (evidence: `README.md`)
- CoProcessor → Thread worker: starts workers (evidence: `src/me/kaigermany/ultimateutils/sync/thread/CoProcessor.java`)
- Thread worker → Processor queue: polls jobs (evidence: `src/me/kaigermany/ultimateutils/sync/thread/ThreadWorker.java`)
- Thread worker → Thread lock: awaits idle (evidence: `src/me/kaigermany/ultimateutils/sync/thread/ThreadWorker.java`)
- FFmpeg video I/O → Ordered writer: orders frames (evidence: `src/me/kaigermany/ultimateutils/image/FFmpegVideoWriter.java`)
- FFmpeg video I/O → CoProcessor: awaits jobs (evidence: `src/me/kaigermany/ultimateutils/image/FFmpegVideoWriter.java`)
- FFmpeg video I/O → FFmpeg process: writes video frames (evidence: `src/me/kaigermany/ultimateutils/image/FFmpegVideoWriter.java`)
- Library callers → ClassExtensions: include helpers (evidence: `README.md`)
- ClassExtensions → Fast hex helpers: extends helpers (evidence: `src/me/kaigermany/ultimateutils/ClassExtensions.java`)
- ClassExtensions → Math helpers: extends helpers (evidence: `src/me/kaigermany/ultimateutils/ClassExtensions.java`)
- Library callers → General utility classes: use utilities (evidence: `README.md`)
- Library callers → Resource listener: register resource lookup
- Resource listener → Resource injector: selects injector (evidence: `src/me/kaigermany/ultimateutils/special/UnknownResourceListener.java`)
- Resource injector → Unsafe access: accesses runtime internals (evidence: `src/me/kaigermany/ultimateutils/special/UnknownResourceInjector9.java`)
