# sudarshanag31/java-redis architecture

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

- Interactive diagram: https://gitdiagram.com/sudarshanag31/java-redis
- Repository: https://github.com/sudarshanag31/java-redis

## Overview

Java Redis is an in-memory, Redis-compatible TCP server. A client sends RESP-formatted commands; Main accepts connections, parses each request, dispatches it to a command handler, and writes the encoded response. Handlers cover basic string commands and TTL, lists and blocking pops, and streams; they use the shared in-memory store. The README also documents multiple client connections and expiration. Edges reflect the Main excerpt, command excerpts, source-index references, and README; unsampled implementation details are not inferred.

Main entry points: [`src/main/java/Main.java`](https://github.com/sudarshanag31/java-redis/blob/main/src/main/java/Main.java) (TCP server and dispatcher), [`src/main/java/protocol/resp.java`](https://github.com/sudarshanag31/java-redis/blob/main/src/main/java/protocol/resp.java) (RESP response encoder), [`src/main/java/command`](https://github.com/sudarshanag31/java-redis/tree/main/src/main/java/command) (GET, SET, TYPE), [`src/main/java/store/store.java`](https://github.com/sudarshanag31/java-redis/blob/main/src/main/java/store/store.java) (Key, list, stream store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_server["Server and protocol"]
  node_main["TCP server and dispatcher<br/>[Main.java]"]
  node_parser["RESP request parser<br/>[respParser.java]"]
  node_encoder["RESP response encoder<br/>[resp.java]"]
end

subgraph group_commands["Command handling"]
  node_simple["PING and ECHO"]
  node_strings["GET, SET, TYPE"]
  node_lists["List commands"]
  node_streams["Stream commands"]
end

subgraph group_state["In-memory data"]
  node_store[("Key, list, stream store<br/>[store.java]")]
end

node_client(("Redis client"))

node_client -->|"sends commands"| node_main
node_main -->|"parses requests"| node_parser
node_main -->|"dispatches"| node_simple
node_main -->|"dispatches"| node_strings
node_main -->|"dispatches"| node_lists
node_main -->|"dispatches"| node_streams
node_main -->|"writes responses"| node_client
node_simple -->|"encodes replies"| node_encoder
node_strings -->|"reads and writes"| node_store
node_strings -->|"encodes replies"| node_encoder
node_lists -->|"operates on lists"| node_store
node_lists -->|"encodes replies"| node_encoder
node_streams -->|"operates on streams"| node_store
node_streams -->|"encodes replies"| node_encoder

click node_main "https://github.com/sudarshanag31/java-redis/blob/main/src/main/java/Main.java"
click node_parser "https://github.com/sudarshanag31/java-redis/blob/main/src/main/java/protocol/respParser.java"
click node_encoder "https://github.com/sudarshanag31/java-redis/blob/main/src/main/java/protocol/resp.java"
click node_simple "https://github.com/sudarshanag31/java-redis/tree/main/src/main/java/command"
click node_strings "https://github.com/sudarshanag31/java-redis/tree/main/src/main/java/command"
click node_lists "https://github.com/sudarshanag31/java-redis/tree/main/src/main/java/command"
click node_streams "https://github.com/sudarshanag31/java-redis/tree/main/src/main/java/command"
click node_store "https://github.com/sudarshanag31/java-redis/blob/main/src/main/java/store/store.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_main,node_parser,node_encoder toneBlue
class node_simple,node_strings,node_lists,node_streams,node_client toneAmber
class node_store toneMint
```

## Components

### Server and protocol

- [TCP server and dispatcher](https://github.com/sudarshanag31/java-redis/blob/main/src/main/java/Main.java): `src/main/java/Main.java`
- [RESP request parser](https://github.com/sudarshanag31/java-redis/blob/main/src/main/java/protocol/respParser.java): `src/main/java/protocol/respParser.java`
- [RESP response encoder](https://github.com/sudarshanag31/java-redis/blob/main/src/main/java/protocol/resp.java): `src/main/java/protocol/resp.java`

### Command handling

- [PING and ECHO](https://github.com/sudarshanag31/java-redis/tree/main/src/main/java/command): `src/main/java/command`
- [GET, SET, TYPE](https://github.com/sudarshanag31/java-redis/tree/main/src/main/java/command): `src/main/java/command`
- [List commands](https://github.com/sudarshanag31/java-redis/tree/main/src/main/java/command): `src/main/java/command`
- [Stream commands](https://github.com/sudarshanag31/java-redis/tree/main/src/main/java/command): `src/main/java/command`

### In-memory data

- [Key, list, stream store](https://github.com/sudarshanag31/java-redis/blob/main/src/main/java/store/store.java): `src/main/java/store/store.java`

### Other components

- **Redis client**

## Connections

- Redis client → TCP server and dispatcher: sends commands (evidence: `README.md`)
- TCP server and dispatcher → RESP request parser: parses requests (evidence: `src/main/java/Main.java`)
- TCP server and dispatcher → PING and ECHO: dispatches (evidence: `src/main/java/Main.java`)
- TCP server and dispatcher → GET, SET, TYPE: dispatches (evidence: `src/main/java/Main.java`)
- TCP server and dispatcher → List commands: dispatches (evidence: `src/main/java/Main.java`)
- TCP server and dispatcher → Stream commands: dispatches (evidence: `src/main/java/Main.java`)
- TCP server and dispatcher → Redis client: writes responses (evidence: `src/main/java/Main.java`)
- PING and ECHO → RESP response encoder: encodes replies (evidence: `src/main/java/command/echoCommand.java`)
- GET, SET, TYPE → Key, list, stream store: reads and writes (evidence: `src/main/java/command/setCommand.java`)
- GET, SET, TYPE → RESP response encoder: encodes replies (evidence: `src/main/java/command/setCommand.java`)
- List commands → Key, list, stream store: operates on lists (evidence: `src/main/java/command/lpopCommand.java`)
- List commands → RESP response encoder: encodes replies (evidence: `src/main/java/command/blpopCommand.java`)
- Stream commands → Key, list, stream store: operates on streams (evidence: `src/main/java/command/xreadCommand.java`)
- Stream commands → RESP response encoder: encodes replies (evidence: `src/main/java/command/xreadCommand.java`)
