aceld/zinx
Zinx
Zinx is a lightweight TCP server framework written in Go that provides a structured foundation for building scalable network applications. It combines a goroutine-pool worker model for concurrency control with message-ID-based routing, enabling efficient packet dispatching to registered handler functions.
The framework distinguishes itself through its modular plugin architecture, which organizes server components like routers, connections, and message modules as interchangeable plugins for extensibility. It uses packet-header length prefixing for reliable TCP stream framing, assigns a dedicated reader goroutine per connection for non-blocking I/O, and loads server parameters from a JSON configuration file at startup.
Zinx supports concurrent connection management, TCP client connections, and message routing by numeric identifier, providing the core building blocks for constructing TCP servers with controlled concurrency and modular design.
Features
- Asynchronous TCP Frameworks - Provides a lightweight, modular framework for building TCP servers in Go with connection handling and message routing.
- Length-Delimited Encodings - Encodes message length and ID in a fixed-size header for reliable packet framing over TCP streams.
- Numeric Identifier Dispatch - Dispatches incoming data to registered handler functions based on a numeric message identifier.
- Fixed-Size Pools - Provides a fixed goroutine pool for handling client requests, controlling concurrency in the TCP server.
- Concurrent Connection Handling - Manages multiple TCP client connections concurrently in a Go server with efficient resource usage.
- Goroutine-Per-Connection Models - Assigns a dedicated goroutine per TCP connection for continuous packet reading and non-blocking I/O.
- Numeric Message Identifiers - Routes incoming packets to handler functions based on a numeric message identifier in the packet header.
- TCP Client Connections - Establishes TCP connections to remote servers and sends messages with a specified message ID.
- JSON-Driven Configuration Schemas - Loads server parameters from a JSON configuration file at startup, enabling runtime behavior changes.
- Plugin-Based Architectures - Organizes server components as interchangeable plugins, supporting extensibility and custom implementations.
- JSON Configuration Files - Reads server settings such as port, max connections, and log behavior from a JSON configuration file.
- Game Server Frameworks - Lightweight TCP server framework for games.
- Concurrency and Utilities - A framework for building high-concurrency TCP servers.
