# lesam24/client-server-connection architecture

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

- Interactive diagram: https://gitdiagram.com/lesam24/client-server-connection
- Repository: https://github.com/lesam24/client-server-connection

## Overview

This is a Java TCP chat application that provides networking infrastructure for multiplayer clients, not game logic. A user enters a server address and username in the text interface, sends messages through the client connection, and receives messages the server broadcasts to connected, named clients. The implementation separates client interaction, shared socket/protocol handling, and server coordination; chat events can also be logged locally. The README documents a thread-per-client server, but the sampled code does not show the accept-loop dispatch details, so that link is marked unverified.

Main entry points: [`src/server/ChatServer.java`](https://github.com/lesam24/client-server-connection/blob/main/src/server/ChatServer.java) (Chat coordinator), [`src/client/ChatClient.java`](https://github.com/lesam24/client-server-connection/blob/main/src/client/ChatClient.java) (Client facade), [`src/server/ServerConnection.java`](https://github.com/lesam24/client-server-connection/blob/main/src/server/ServerConnection.java) (Server connection), [`src/server/ClientHandler.java`](https://github.com/lesam24/client-server-connection/blob/main/src/server/ClientHandler.java) (Client handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_tui["Text interface<br/>[ChatClientTUI.java]"]
  node_chatclient["Client facade<br/>[ChatClient.java]"]
  node_clientlistener["Client events"]
  node_loglistener["Chat logger<br/>[LogListener.java]"]
  node_logfile["Chat log<br/>[logs.txt]"]
end

subgraph group_transport["Transport and protocol"]
  node_clientconn["Client connection"]
  node_serverconn["Server connection"]
  node_socketconn["Socket stream"]
  node_protocol["Message protocol<br/>[Protocol.java]"]
end

subgraph group_server["Server coordination"]
  node_chatserver["Chat coordinator<br/>[ChatServer.java]"]
  node_clienthandler["Client handler<br/>[ClientHandler.java]"]
  node_socketserver["TCP acceptor<br/>[SocketServer.java]"]
end

node_user(("Chat user"))

node_user -->|"enters messages"| node_tui
node_tui -->|"starts and sends"| node_chatclient
node_chatclient -->|"delegates to"| node_clientconn
node_clientconn -->|"encodes and parses"| node_protocol
node_clientconn -->|"uses stream"| node_socketconn
node_socketserver -.->|"dispatches connection"| node_chatserver
node_chatserver -->|"accepts connections"| node_socketserver
node_chatserver -->|"creates connection"| node_serverconn
node_chatserver -->|"creates handler"| node_clienthandler
node_serverconn -->|"uses stream"| node_socketconn
node_serverconn -->|"parses and encodes"| node_protocol
node_serverconn -->|"dispatches messages"| node_clienthandler
node_clienthandler -->|"registers and relays"| node_chatserver
node_clienthandler -->|"sends broadcasts"| node_serverconn
node_chatserver -->|"broadcasts messages"| node_clienthandler
node_clientconn -->|"delivers received messages"| node_chatclient
node_chatclient -->|"dispatches events"| node_clientlistener
node_tui -->|"implements events"| node_clientlistener
node_chatclient -->|"registers logger"| node_loglistener
node_loglistener -->|"implements events"| node_clientlistener
node_loglistener -->|"writes chat"| node_logfile

click node_tui "https://github.com/lesam24/client-server-connection/blob/main/src/client/ChatClientTUI.java"
click node_chatclient "https://github.com/lesam24/client-server-connection/blob/main/src/client/ChatClient.java"
click node_clientlistener "https://github.com/lesam24/client-server-connection/blob/main/src/client/ClientListener.java"
click node_loglistener "https://github.com/lesam24/client-server-connection/blob/main/src/client/LogListener.java"
click node_logfile "https://github.com/lesam24/client-server-connection/blob/main/logs.txt"
click node_clientconn "https://github.com/lesam24/client-server-connection/blob/main/src/client/ClientConnection.java"
click node_serverconn "https://github.com/lesam24/client-server-connection/blob/main/src/server/ServerConnection.java"
click node_socketconn "https://github.com/lesam24/client-server-connection/blob/main/src/network/SocketConnection.java"
click node_protocol "https://github.com/lesam24/client-server-connection/blob/main/src/protocol/Protocol.java"
click node_chatserver "https://github.com/lesam24/client-server-connection/blob/main/src/server/ChatServer.java"
click node_clienthandler "https://github.com/lesam24/client-server-connection/blob/main/src/server/ClientHandler.java"
click node_socketserver "https://github.com/lesam24/client-server-connection/blob/main/src/network/SocketServer.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_tui,node_chatclient,node_clientlistener,node_loglistener,node_logfile,node_user toneBlue
class node_clientconn,node_serverconn,node_socketconn,node_protocol toneAmber
class node_chatserver,node_clienthandler,node_socketserver toneMint
```

## Components

### Client experience

- [Text interface](https://github.com/lesam24/client-server-connection/blob/main/src/client/ChatClientTUI.java): `src/client/ChatClientTUI.java`
- [Client facade](https://github.com/lesam24/client-server-connection/blob/main/src/client/ChatClient.java): `src/client/ChatClient.java`
- [Client events](https://github.com/lesam24/client-server-connection/blob/main/src/client/ClientListener.java): `src/client/ClientListener.java`
- [Chat logger](https://github.com/lesam24/client-server-connection/blob/main/src/client/LogListener.java): `src/client/LogListener.java`
- [Chat log](https://github.com/lesam24/client-server-connection/blob/main/logs.txt): `logs.txt`

### Transport and protocol

- [Client connection](https://github.com/lesam24/client-server-connection/blob/main/src/client/ClientConnection.java): `src/client/ClientConnection.java`
- [Server connection](https://github.com/lesam24/client-server-connection/blob/main/src/server/ServerConnection.java): `src/server/ServerConnection.java`
- [Socket stream](https://github.com/lesam24/client-server-connection/blob/main/src/network/SocketConnection.java): `src/network/SocketConnection.java`
- [Message protocol](https://github.com/lesam24/client-server-connection/blob/main/src/protocol/Protocol.java): `src/protocol/Protocol.java`

### Server coordination

- [Chat coordinator](https://github.com/lesam24/client-server-connection/blob/main/src/server/ChatServer.java): `src/server/ChatServer.java`
- [Client handler](https://github.com/lesam24/client-server-connection/blob/main/src/server/ClientHandler.java): `src/server/ClientHandler.java`
- [TCP acceptor](https://github.com/lesam24/client-server-connection/blob/main/src/network/SocketServer.java): `src/network/SocketServer.java`

### Other components

- **Chat user**

## Connections

- Chat user → Text interface: enters messages (evidence: `src/client/ChatClientTUI.java`)
- Text interface → Client facade: starts and sends (evidence: `src/client/ChatClientTUI.java`)
- Client facade → Client connection: delegates to (evidence: `src/client/ChatClient.java`)
- Client connection → Message protocol: encodes and parses (evidence: `src/client/ClientConnection.java`)
- Client connection → Socket stream: uses stream (evidence: `src/client/ClientConnection.java`)
- TCP acceptor → Chat coordinator: dispatches connection (evidence: `src/server/ChatServer.java`)
- Chat coordinator → TCP acceptor: accepts connections (evidence: `src/server/ChatServer.java`)
- Chat coordinator → Server connection: creates connection (evidence: `src/server/ChatServer.java`)
- Chat coordinator → Client handler: creates handler (evidence: `src/server/ChatServer.java`)
- Server connection → Socket stream: uses stream (evidence: `src/server/ServerConnection.java`)
- Server connection → Message protocol: parses and encodes (evidence: `src/server/ServerConnection.java`)
- Server connection → Client handler: dispatches messages (evidence: `src/server/ServerConnection.java`)
- Client handler → Chat coordinator: registers and relays (evidence: `src/server/ClientHandler.java`)
- Client handler → Server connection: sends broadcasts (evidence: `src/server/ClientHandler.java`)
- Chat coordinator → Client handler: broadcasts messages (evidence: `src/server/ChatServer.java`)
- Client connection → Client facade: delivers received messages (evidence: `src/client/ClientConnection.java`)
- Client facade → Client events: dispatches events (evidence: `src/client/ChatClient.java`)
- Text interface → Client events: implements events (evidence: `src/client/ChatClientTUI.java`)
- Client facade → Chat logger: registers logger (evidence: `src/client/ChatClient.java`)
- Chat logger → Client events: implements events (evidence: `src/client/LogListener.java`)
- Chat logger → Chat log: writes chat (evidence: `src/client/LogListener.java`)
