ptupitsyn commented on code in PR #7357:
URL: https://github.com/apache/ignite-3/pull/7357#discussion_r2671001238
##########
modules/client/DEVNOTES.md:
##########
@@ -0,0 +1,106 @@
+# Client Internals
+
+This document describes the internal architecture and design decisions of the
Apache Ignite 3 client.
+
+## Glossary
+
+- **Node** / **Server** / **Server Node**: A single cluster member (see
`IgniteImpl`)
+ - Multiple nodes can run in a single JVM
+- **Cluster**: A group of interconnected nodes
+- **Client** (formerly "Thin Client"): A single instance of `IgniteClient`
(see `TcpIgniteClient`)
+ - A client connects to one or more servers
+- **Channel** / **Connection**: A single TCP connection between a client and a
server (see `TcpClientChannel`)
+
+---
+
+## Connection Management
+
+### Overview
+
+Connection management involves three primary concerns:
+
+1. **Address Resolution**: Get server addresses
+2. **Connection Establishment**: Establish connections using resolved addresses
+3. **Connection Selection**: Choose an appropriate connection for each
operation
+
+These concerns are handled concurrently:
+
+- Background executor refreshes server addresses (periodically and/or on
specific events)
+- Background executor establishes new connections and maintains existing ones
(reconnects if necessary)
+- Operation threads select connections for operations
+
+### Connection Lifecycle
+
+#### Initial Connection
+
+When `IgniteClient.builder().addresses("foo:10800", "192.168.0.1").build()` is
called:
+
+1. **Build endpoint list** - For each provided address:
+ - Extract port if present, otherwise use default port
+ - Resolve DNS if necessary (a hostname can resolve to multiple IP addresses)
Review Comment:
Done.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
