# barchart/barchart-udt architecture

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

- Interactive diagram: https://gitdiagram.com/barchart/barchart-udt
- Repository: https://github.com/barchart/barchart-udt

## Overview

Barchart UDT is a Java API and native implementation of UDP-based reliable transport, with Java networking, NIO, and Netty-facing adapters. The principal workflow is an application opening and using a UDT socket, whose JNI bridge invokes the native transport and exchanges packets over UDP. The tree documents additional stream/datagram wrappers, selectors, rendezvous/ICE support, congestion-control hooks, and Netty integration. README detail is limited to a wiki link; sampled excerpts mostly concern unrelated JDK reference code, so internal links beyond the evident JNI/native boundary are conservative.

Main entry points: [`barchart-udt-core/src/main/c++/udt/src/core.cpp`](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/c%2B%2B/udt/src/core.cpp) (UDT transport), [`barchart-udt-core/src/main/java/com/barchart/udt/lib/LibraryLoaderUDT.java`](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/lib/LibraryLoaderUDT.java) (Native loading), [`barchart-udt-core/src/main/java/com/barchart/udt/SocketUDT.java`](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/SocketUDT.java) (UDT sockets), [`barchart-udt-core/src/main/c++/jni/com_barchart_udt_SocketUDT.cpp`](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/c%2B%2B/jni/com_barchart_udt_SocketUDT.cpp) (JNI bindings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_java["Java API"]
  node_socket["UDT sockets<br/>[SocketUDT.java]"]
  node_factory["Socket factory<br/>[FactoryUDT.java]"]
end

subgraph group_native["Native transport"]
  node_jni["JNI bindings"]
  node_nativeapi["Native API<br/>[api.cpp]"]
  node_transport["UDT transport<br/>[core.cpp]"]
  node_packets["Packet handling<br/>[packet.cpp]"]
  node_buffers["Transport buffers<br/>[buffer.cpp]"]
  node_congestion["Congestion control<br/>[ccc.cpp]"]
end

subgraph group_adapters["Network adapters"]
  node_network["Socket wrappers<br/>[NetSocketUDT.java]"]
  node_streams["Stream adapters"]
  node_channels["NIO channels"]
  node_selector["NIO selector<br/>[SelectorUDT.java]"]
  node_rendezvous["Rendezvous"]
  node_ice["ICE sockets<br/>[IceSocket.java]"]
end

subgraph group_integration["Platform integration"]
  node_netty["Netty channels"]
  node_loader["Native loading"]
  node_resources["Resource extraction"]
  node_android["Android loader"]
  node_bundle["Native bundle<br/>[BundleUDT.java]"]
end

node_app(("Application"))
node_udp(("UDP network"))

node_app -->|"opens and uses"| node_socket
node_app -->|"creates sockets"| node_factory
node_socket -->|"calls native methods"| node_jni
node_jni -->|"dispatches calls"| node_nativeapi
node_nativeapi -->|"operates transport"| node_transport
node_transport -->|"processes packets"| node_packets
node_transport -->|"uses buffers"| node_buffers
node_transport -->|"uses control"| node_congestion
node_transport -->|"sends and receives"| node_udp
node_app -->|"uses networking API"| node_network
node_app -->|"uses channels"| node_channels
node_channels -->|"registers readiness"| node_selector
node_app -->|"reads and writes"| node_streams
node_app -->|"connects peers"| node_rendezvous
node_app -->|"uses ICE sockets"| node_ice
node_app -.->|"uses Netty transport"| node_netty
node_loader -->|"extracts native library"| node_resources
node_android -.->|"loads native library"| node_loader
node_bundle -.->|"provides native library"| node_loader

click node_socket "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/SocketUDT.java"
click node_factory "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/FactoryUDT.java"
click node_jni "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/c%2B%2B/jni/com_barchart_udt_SocketUDT.cpp"
click node_nativeapi "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/c%2B%2B/udt/src/api.cpp"
click node_transport "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/c%2B%2B/udt/src/core.cpp"
click node_packets "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/c%2B%2B/udt/src/packet.cpp"
click node_buffers "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/c%2B%2B/udt/src/buffer.cpp"
click node_congestion "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/c%2B%2B/udt/src/ccc.cpp"
click node_network "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/net/NetSocketUDT.java"
click node_streams "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/net/NetInputStreamUDT.java"
click node_channels "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/nio/SocketChannelUDT.java"
click node_selector "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/nio/SelectorUDT.java"
click node_rendezvous "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/nio/RendezvousChannelUDT.java"
click node_ice "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/net/IceSocket.java"
click node_netty "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-netty4/src/main/java/io/netty/transport/udt/nio/NioUdtProvider.java"
click node_loader "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/lib/LibraryLoaderUDT.java"
click node_resources "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/lib/ResourceManagerUDT.java"
click node_android "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core-android/src/main/java/com/barchart/udt/AndroidLoaderUDT.java"
click node_bundle "https://github.com/barchart/barchart-udt/blob/master/barchart-udt-bundle/src/main/java/com/barchart/udt/BundleUDT.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_socket,node_factory toneBlue
class node_jni,node_nativeapi,node_transport,node_packets,node_buffers,node_congestion toneAmber
class node_network,node_streams,node_channels,node_selector,node_rendezvous,node_ice toneMint
class node_netty,node_loader,node_resources,node_android,node_bundle toneRose
class node_app,node_udp toneIndigo
```

## Components

### Java API

- [UDT sockets](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/SocketUDT.java): `barchart-udt-core/src/main/java/com/barchart/udt/SocketUDT.java`
- [Socket factory](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/FactoryUDT.java): `barchart-udt-core/src/main/java/com/barchart/udt/FactoryUDT.java`

### Native transport

- [JNI bindings](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/c%2B%2B/jni/com_barchart_udt_SocketUDT.cpp): `barchart-udt-core/src/main/c++/jni/com_barchart_udt_SocketUDT.cpp`
- [Native API](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/c%2B%2B/udt/src/api.cpp): `barchart-udt-core/src/main/c++/udt/src/api.cpp`
- [UDT transport](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/c%2B%2B/udt/src/core.cpp): `barchart-udt-core/src/main/c++/udt/src/core.cpp`
- [Packet handling](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/c%2B%2B/udt/src/packet.cpp): `barchart-udt-core/src/main/c++/udt/src/packet.cpp`
- [Transport buffers](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/c%2B%2B/udt/src/buffer.cpp): `barchart-udt-core/src/main/c++/udt/src/buffer.cpp`
- [Congestion control](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/c%2B%2B/udt/src/ccc.cpp): `barchart-udt-core/src/main/c++/udt/src/ccc.cpp`

### Network adapters

- [Socket wrappers](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/net/NetSocketUDT.java): `barchart-udt-core/src/main/java/com/barchart/udt/net/NetSocketUDT.java`
- [Stream adapters](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/net/NetInputStreamUDT.java): `barchart-udt-core/src/main/java/com/barchart/udt/net/NetInputStreamUDT.java`
- [NIO channels](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/nio/SocketChannelUDT.java): `barchart-udt-core/src/main/java/com/barchart/udt/nio/SocketChannelUDT.java`
- [NIO selector](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/nio/SelectorUDT.java): `barchart-udt-core/src/main/java/com/barchart/udt/nio/SelectorUDT.java`
- [Rendezvous](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/nio/RendezvousChannelUDT.java): `barchart-udt-core/src/main/java/com/barchart/udt/nio/RendezvousChannelUDT.java`
- [ICE sockets](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/net/IceSocket.java): `barchart-udt-core/src/main/java/com/barchart/udt/net/IceSocket.java`

### Platform integration

- [Netty channels](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-netty4/src/main/java/io/netty/transport/udt/nio/NioUdtProvider.java): `barchart-udt-netty4/src/main/java/io/netty/transport/udt/nio/NioUdtProvider.java`
- [Native loading](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/lib/LibraryLoaderUDT.java): `barchart-udt-core/src/main/java/com/barchart/udt/lib/LibraryLoaderUDT.java`
- [Resource extraction](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core/src/main/java/com/barchart/udt/lib/ResourceManagerUDT.java): `barchart-udt-core/src/main/java/com/barchart/udt/lib/ResourceManagerUDT.java`
- [Android loader](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-core-android/src/main/java/com/barchart/udt/AndroidLoaderUDT.java): `barchart-udt-core-android/src/main/java/com/barchart/udt/AndroidLoaderUDT.java`
- [Native bundle](https://github.com/barchart/barchart-udt/blob/master/barchart-udt-bundle/src/main/java/com/barchart/udt/BundleUDT.java): `barchart-udt-bundle/src/main/java/com/barchart/udt/BundleUDT.java`

### Other components

- **Application**
- **UDP network**

## Connections

- Application → UDT sockets: opens and uses
- Application → Socket factory: creates sockets
- UDT sockets → JNI bindings: calls native methods
- JNI bindings → Native API: dispatches calls
- Native API → UDT transport: operates transport
- UDT transport → Packet handling: processes packets
- UDT transport → Transport buffers: uses buffers
- UDT transport → Congestion control: uses control
- UDT transport → UDP network: sends and receives
- Application → Socket wrappers: uses networking API
- Application → NIO channels: uses channels
- NIO channels → NIO selector: registers readiness
- Application → Stream adapters: reads and writes
- Application → Rendezvous: connects peers
- Application → ICE sockets: uses ICE sockets
- Application → Netty channels: uses Netty transport
- Native loading → Resource extraction: extracts native library
- Android loader → Native loading: loads native library
- Native bundle → Native loading: provides native library
