# tio-websocket

**Repository Path**: ppnt/tio-websocket

## Basic Information

- **Project Name**: tio-websocket
- **Description**: tio-websocket 是基于 TIO 高性能网络框架之上的轻量级 Java WebSocket 服务组件。它充分利用异步非阻塞 I/O 特性，提供稳定、高效的双向通信能力。tio-websocket **不支持注解式路由**，所有 WebSocket 端点需通过编程方式进行注册和配置。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-06
- **Last Updated**: 2025-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# tio-websocket

## 概述

tio-websocket 是基于 TIO 高性能网络框架之上的轻量级 Java WebSocket 服务组件。它充分利用异步非阻塞 I/O 特性，提供稳定、高效的双向通信能力。tio-websocket **不支持注解式路由**，所有 WebSocket 端点需通过编程方式进行注册和配置。

## 核心特性

* **高性能并发**：底层依托 TIO 异步非阻塞架构，轻松支撑海量并发 WebSocket 连接。
* **编程式注册**：通过 `WsServerStarter` 或 `WsServerConfig` 在启动阶段手动注册 `WsHandler`，灵活可控。
* **完整协议兼容**：严格遵循 RFC 6455，支持文本帧、二进制帧、Ping/Pong 心跳、消息分片等功能。
* **事件回调**：提供连接建立（onOpen）、消息接收（onMessage）、异常捕获（onError）、连接关闭（onClose）等多种回调钩子。
* **灵活扩展**：可自定义消息编解码器、心跳检测策略、子协议协商，以及与其他业务框架的集成。

## 典型场景

* **实时聊天系统**：支持大规模在线用户的双向消息推送。
* **在线游戏**：低延迟、高并发的游戏数据交换。
* **物联网（IoT）**：设备状态上报与指令下发的实时通信。
* **实时推送服务**：如股票行情、赛事比分等高频更新场景。