# tio-http

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

## Basic Information

- **Project Name**: tio-http
- **Description**: tio-http 是一个基于 TIO 高性能网络框架之上的轻量级 Java HTTP 服务组件。它充分利用 Java NIO 的异步非阻塞 I/O 特性，在保持极佳吞吐和并发能力的同时，提供了零侵入路由、统一请求处理、拦截器机制等一系列丰富功能。
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-04-30
- **Last Updated**: 2025-08-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# tio-http
## 概述

tio-http 是一个基于 TIO 高性能网络框架之上的轻量级 Java HTTP 服务组件。它充分利用 Java NIO 的异步非阻塞 I/O 特性，在保持极佳吞吐和并发能力的同时，提供了零侵入路由、统一请求处理、拦截器机制等一系列丰富功能。

## 核心特性

* **高性能**：底层依托 TIO 异步非阻塞架构，具备极低的上下文切换开销和高效的连接管理，特别适用于高并发场景。
* **拦截器机制**：内置 `ControllerInterceptor`，可在请求前后执行统一逻辑，如权限校验、日志记录、异常处理、速率限制等。
* **多协议支持**：除了 HTTP/1.1，tio-http 还支持 Server-Sent Events（SSE）和 WebSocket，方便构建实时推送和双向通信应用。
* **灵活扩展**：通过配置或 SPI，支持自定义序列化（JSON、Protobuf 等）、中间件插件，以及与 Spring、JFinal 等主流框架的无缝集成。

## 典型场景

* **微服务网关**：作为轻量级前置网关，负责路由转发、统一鉴权和监控埋点。
* **实时推送**：利用 SSE/WebSocket 构建消息推送、在线监控、大屏展示等实时应用。
* **IoT 边缘节点**：在资源受限的设备或边缘服务器上，快速部署 HTTP 接口并与设备进行高效数据交互。
* **高并发 API 服务**：金融、游戏、电商等领域，面对海量并发请求时，保持低延迟和高吞吐。