Tio Boot DocsTio Boot Docs
Home
  • java-db
  • api-table
  • Enjoy
  • Tio Boot Admin
  • ai_agent
  • translator
  • knowlege_base
  • ai-search
  • 案例
Abount
  • Github
  • Gitee
Home
  • java-db
  • api-table
  • Enjoy
  • Tio Boot Admin
  • ai_agent
  • translator
  • knowlege_base
  • ai-search
  • 案例
Abount
  • Github
  • Gitee
  • 01_tio-boot 简介

    • tio-boot:新一代高性能 Java Web 开发框架
    • tio-boot 入门示例
    • Tio-Boot 配置 : 现代化的配置方案
    • tio-boot 整合 Logback
    • tio-boot 整合 hotswap-classloader 实现热加载
    • 自行编译 tio-boot
    • 最新版本
    • 开发规范
  • 02_部署

    • 使用 Maven Profile 实现分环境打包 tio-boot 项目
    • Maven 项目配置详解:依赖与 Profiles 配置
    • tio-boot 打包成 FastJar
    • 使用 GraalVM 构建 tio-boot Native 程序
    • 使用 Docker 部署 tio-boot
    • 部署到 Fly.io
    • 部署到 AWS Lambda
    • 到阿里云云函数
    • 使用 Deploy 工具部署
    • 胖包与瘦包的打包与部署
    • 使用 Jenkins 部署 Tio-Boot 项目
    • 使用 Nginx 反向代理 Tio-Boot
    • 使用 Supervisor 管理 Java 应用
  • 03_配置

    • 配置参数
    • 服务器监听器
    • 内置缓存系统 AbsCache
    • 使用 Redis 作为内部 Cache
    • 静态文件处理器
    • 基于域名的静态资源隔离
    • DecodeExceptionHandler
  • 04_原理

    • 生命周期
    • 请求处理流程
    • 重要的类
  • 05_json

    • Json
    • 接受 JSON 和响应 JSON
    • 响应实体类
  • 06_web

    • 概述
    • 文件上传
    • 接收请求参数
    • 接收日期参数
    • 接收数组参数
    • 返回字符串
    • 返回文本数据
    • 返回网页
    • 请求和响应字节
    • 文件下载
    • 返回视频文件并支持断点续传
    • http Session
    • Cookie
    • HttpRequest
    • HttpResponse
    • Resps
    • RespBodyVo
    • /zh/06_web/19.html
    • 全局异常处理器
    • 异步
    • 动态 返回 CSS 实现
    • 返回图片
    • Transfer-Encoding: chunked 实时音频播放
    • Server-Sent Events (SSE)
    • 接口访问统计
    • 接口请求和响应数据记录
    • 自定义 Handler 转发请求
    • 使用 HttpForwardHandler 转发所有请求
    • 跨域
    • 添加 Controller
    • 常用工具类
    • HTTP Basic 认证
    • WebJars
    • JProtobuf
  • 07_validate

    • 数据紧校验规范
    • 参数校验
  • 08_websocket

    • 使用 tio-boot 搭建 WebSocket 服务
    • WebSocket 聊天室项目示例
  • 09_java-db

    • java‑db
    • 操作数据库入门示例
    • SQL 模板
    • 数据源配置与使用
    • ActiveRecord
    • Model
    • 生成器与 Model
    • Db 工具类
    • 批量操作
    • 数据库事务处理
    • Cache 缓存
    • Dialect 多数据库支持
    • 表关联操作
    • 复合主键
    • Oracle 支持
    • Enjoy SQL 模板
    • Java-DB 整合 Enjoy 模板最佳实践
    • 多数据源支持
    • 独立使用 ActiveRecord
    • 调用存储过程
    • java-db 整合 Guava 的 Striped 锁优化
    • 生成 SQL
    • 通过实体类操作数据库
    • java-db 读写分离
    • Spring Boot 整合 Java-DB
    • like 查询
    • 常用操作示例
    • Druid 监控集成指南
    • SQL 统计
  • 10_api-table

    • ApiTable 概述
    • 使用 ApiTable 连接 SQLite
    • 使用 ApiTable 连接 Mysql
    • 使用 ApiTable 连接 Postgres
    • 使用 ApiTable 连接 TDEngine
    • 使用 api-table 连接 oracle
    • 使用 api-table 连接 mysql and tdengine 多数据源
    • EasyExcel 导出
    • EasyExcel 导入
    • TQL(Table SQL)前端输入规范
    • ApiTable 实现增删改查
    • 数组类型
    • 单独使用 ApiTable
  • 11_aop

    • JFinal-aop
    • Aop 工具类
    • 配置
    • 配置
    • 独立使用 JFinal Aop
    • @AImport
    • 原理解析
  • 12_cache

    • Caffine
    • Jedis-redis
    • hutool RedisDS
    • Redisson
    • Caffeine and redis
    • CacheUtils 工具类
    • 使用 CacheUtils 整合 caffeine 和 redis 实现的两级缓存
    • 使用 java-db 整合 ehcache
    • 使用 java-db 整合 redis
    • Java DB Redis 相关 Api
    • redis 使用示例
  • 13_认证和权限

    • hutool-JWT
    • FixedTokenInterceptor
    • 使用内置 TokenManager 实现登录
    • 用户系统
    • 重置密码
    • 匿名登录
    • Google 登录
    • 权限校验注解
    • Sa-Token
    • sa-token 登录注册
    • StpUtil.isLogin() 源码解析
    • 短信登录
    • 移动端微信登录实现指南
    • 移动端重置密码
  • 14_i18n

    • i18n
  • 15_enjoy

    • tio-boot 整合 Enjoy 模版引擎文档
    • 引擎配置
    • 表达式
    • 指令
    • 注释
    • 原样输出
    • Shared Method 扩展
    • Shared Object 扩展
    • Extension Method 扩展
    • Spring boot 整合
    • 独立使用 Enjoy
    • tio-boot enjoy 自定义指令 localeDate
    • PromptEngine
    • Enjoy 入门示例-擎渲染大模型请求体
    • Enjoy 使用示例
  • 16_定时任务

    • Quartz 定时任务集成指南
    • 分布式定时任务 xxl-jb
    • cron4j 使用指南
  • 17_tests

    • TioBootTest 类
  • 18_tio

    • TioBootServer
    • tio-core
    • 内置 TCP 处理器
    • 独立启动 UDPServer
    • 使用内置 UDPServer
    • t-io 消息处理流程
    • tio-运行原理详解
    • TioConfig
    • ChannelContext
    • Tio 工具类
    • 业务数据绑定
    • 业务数据解绑
    • 发送数据
    • 关闭连接
    • Packet
    • 监控: 心跳
    • 监控: 客户端的流量数据
    • 监控: 单条 TCP 连接的流量数据
    • 监控: 端口的流量数据
    • 单条通道统计: ChannelStat
    • 所有通道统计: GroupStat
    • 资源共享
    • 成员排序
    • ssl
    • DecodeRunnable
    • 使用 AsynchronousSocketChannel 响应数据
    • 拉黑 IP
    • 深入解析 Tio 源码:构建高性能 Java 网络应用
  • 19_aio

    • ByteBuffer
    • AIO HTTP 服务器
    • 自定义和线程池和池化 ByteBuffer
    • AioHttpServer 应用示例 IP 属地查询
    • 手写 AIO Http 服务器
  • 20_netty

    • Netty TCP Server
    • Netty Web Socket Server
    • 使用 protoc 生成 Java 包文件
    • Netty WebSocket Server 二进制数据传输
    • Netty 组件详解
  • 21_netty-boot

    • Netty-Boot
    • 原理解析
    • 整合 Hot Reload
    • 整合 数据库
    • 整合 Redis
    • 整合 Elasticsearch
    • 整合 Dubbo
    • Listener
    • 文件上传
    • 拦截器
    • Spring Boot 整合 Netty-Boot
    • SSL 配置指南
    • ChannelInitializer
    • Reserve
  • 22_MQ

    • Mica-mqtt
    • EMQX
    • Disruptor
  • 23_tio-utils

    • tio-utils
    • HttpUtils
    • Notification
    • 邮箱
    • JSON
    • 读取文件
    • Base64
    • 上传和下载
    • Http
    • Telegram
    • RsaUtils
    • EnvUtils 使用文档
    • 系统监控
    • 毫秒并发 ID (MCID) 生成方案
  • 24_tio-http-server

    • 使用 Tio-Http-Server 搭建简单的 HTTP 服务
    • tio-boot 添加 HttpRequestHandler
    • 在 Android 上使用 tio-boot 运行 HTTP 服务
    • tio-http-server-native
    • handler 常用操作
  • 25_tio-websocket

    • WebSocket 服务器
    • WebSocket Client
  • 26_tio-im

    • 通讯协议文档
    • ChatPacket.proto 文档
    • java protobuf
    • 数据表设计
    • 创建工程
    • 登录
    • 历史消息
    • 发消息
  • 27_mybatis

    • Tio-Boot 整合 MyBatis
    • 使用配置类方式整合 MyBatis
    • 整合数据源
    • 使用 mybatis-plus 整合 tdengine
    • 整合 mybatis-plus
  • 28_mongodb

    • tio-boot 使用 mongo-java-driver 操作 mongodb
  • 29_elastic-search

    • Elasticsearch
    • JavaDB 整合 ElasticSearch
    • Elastic 工具类使用指南
    • Elastic-search 注意事项
    • ES 课程示例文档
  • 30_magic-script

    • tio-boot 整合 magic-script
  • 31_groovy

    • tio-boot 整合 Groovy
  • 32_firebase

    • 整合 google firebase
    • Firebase Storage
    • Firebase Authentication
    • 使用 Firebase Admin SDK 进行匿名用户管理与自定义状态标记
    • 导出用户
    • 注册回调
    • 登录注册
  • 33_文件存储

    • 文件上传数据表
    • 本地存储
    • 使用 AWS S3 存储文件并整合到 Tio-Boot 项目中
    • 存储文件到 腾讯 COS
  • 34_spider

    • jsoup
    • 爬取 z-lib.io 数据
    • 整合 WebMagic
    • WebMagic 示例:爬取学校课程数据
    • Playwright
    • Flexmark (Markdown 处理器)
    • tio-boot 整合 Playwright
    • 缓存网页数据
  • 36_integration_thirty_party

    • tio-boot 整合 okhttp
    • 整合 GrpahQL
    • 集成 Mailjet
    • 整合 ip2region
    • 整合 GeoLite 离线库
    • 整合 Lark 机器人指南
    • 集成 Lark Mail 实现邮件发送
    • Thymeleaf
    • Swagger
    • Clerk 验证
  • 37_dubbo

    • 概述
    • dubbo 2.6.0
    • dubbo 2.6.0 调用过程
    • dubbo 3.2.0
  • 38_spring

    • Spring Boot Web 整合 Tio Boot
    • spring-boot-starter-webflux 整合 tio-boot
    • Tio Boot 整合 Spring Boot Starter
    • Tio Boot 整合 Spring Boot Starter Data Redis 指南
  • 39_spring-cloud

    • tio-boot spring-cloud
  • 40_mysql

    • 使用 Docker 运行 MySQL
    • /zh/42_mysql/02.html
  • 41_postgresql

    • PostgreSQL 安装
    • PostgreSQL 主键自增
    • PostgreSQL 日期类型
    • Postgresql 金融类型
    • PostgreSQL 数组类型
    • PostgreSQL 全文检索
    • PostgreSQL 查询优化
    • 获取字段类型
    • PostgreSQL 向量
    • PostgreSQL 优化向量查询
    • PostgreSQL 其他
  • 43_oceanbase

    • 快速体验 OceanBase 社区版
    • 快速上手 OceanBase 数据库单机部署与管理
    • 诊断集群性能
    • 优化 SQL 性能指南
    • /zh/43_oceanbase/05.html
  • 50_media

    • JAVE 提取视频中的声音
    • Jave 提取视频中的图片
    • /zh/50_media/03.html
  • 51_asr

    • Whisper-JNI
  • 54_native-media

    • java-native-media
    • JNI 入门示例
    • mp3 拆分
    • mp4 转 mp3
    • 使用 libmp3lame 实现高质量 MP3 编码
    • Linux 编译
    • macOS 编译
    • 从 JAR 包中加载本地库文件
    • 支持的音频和视频格式
    • 任意格式转为 mp3
    • 通用格式转换
    • 通用格式拆分
    • 视频合并
    • VideoToHLS
    • split_video_to_hls 支持其他语言
    • 持久化 HLS 会话
  • 55_telegram4j

    • 数据库设计
    • /zh/55_telegram4j/02.html
    • 基于 MTProto 协议开发 Telegram 翻译机器人
    • 过滤旧消息
    • 保存机器人消息
    • 定时推送
    • 增加命令菜单
    • 使用 telegram-Client
    • 使用自定义 StoreLayout
    • 延迟测试
    • Reactor 错误处理
    • Telegram4J 常见错误处理指南
  • 56_telegram-bots

    • TelegramBots 入门指南
    • 使用工具库 telegram-bot-base 开发翻译机器人
  • 60_LLM

    • 简介
    • AI 问答
    • /zh/60_LLM/03.html
    • /zh/60_LLM/04.html
    • 增强检索(RAG)
    • 结构化数据检索
    • 搜索+AI
    • 集成第三方 API
    • 后置处理
    • 推荐问题生成
    • 连接代码执行器
    • 避免 GPT 混乱
    • /zh/60_LLM/13.html
  • 61_ai_agent

    • 数据库设计
    • 示例问题管理
    • 会话管理
    • 历史记录
    • 对接 Perplexity API
    • 意图识别与生成提示词
    • 智能问答模块设计与实现
    • 文件上传与解析文档
    • 翻译
    • 名人搜索功能实现
    • Ai studio gemini youbue 问答使用说明
    • 自建 YouTube 字幕问答系统
    • 自建 获取 youtube 字幕服务
    • 通用搜索
    • /zh/61_ai_agent/15.html
    • 16
    • 17
    • 18
    • 在 tio-boot 应用中整合 ai-agent
    • 16
  • 62_translator

    • 简介
  • 63_knowlege_base

    • 数据库设计
    • 用户登录实现
    • 模型管理
    • 知识库管理
    • 文档拆分
    • 片段向量
    • 命中测试
    • 文档管理
    • 片段管理
    • 问题管理
    • 应用管理
    • 向量检索
    • 推理问答
    • 问答模块
    • 统计分析
    • 用户管理
    • api 管理
    • 存储文件到 S3
    • 文档解析优化
    • 片段汇总
    • 段落分块与检索
    • 多文档解析
    • 对话日志
    • 检索性能优化
    • Milvus
    • 文档解析方案和费用对比
    • 离线运行向量模型
  • 64_ai-search

    • ai-search 项目简介
    • ai-search 数据库文档
    • ai-search SearxNG 搜索引擎
    • ai-search Jina Reader API
    • ai-search Jina Search API
    • ai-search 搜索、重排与读取内容
    • ai-search PDF 文件处理
    • ai-search 推理问答
    • Google Custom Search JSON API
    • ai-search 意图识别
    • ai-search 问题重写
    • ai-search 系统 API 接口 WebSocket 版本
    • ai-search 搜索代码实现 WebSocket 版本
    • ai-search 生成建议问
    • ai-search 生成问题标题
    • ai-search 历史记录
    • Discover API
    • 翻译
    • Tavily Search API 文档
    • 对接 Tavily Search
    • 火山引擎 DeepSeek
    • 对接 火山引擎 DeepSeek
    • ai-search 搜索代码实现 SSE 版本
    • jar 包部署
    • Docker 部署
    • 爬取一个静态网站的所有数据
    • 网页数据预处理
    • 网页数据检索与问答流程整合
  • 65_java-linux

    • Java 执行 python 代码
    • 通过大模型执行 Python 代码
    • MCP 协议
    • Cline 提示词
    • Cline 提示词-中文版本
  • 66_manim

    • 简介
    • Manim 开发环境搭建
    • 生成场景提示词
    • 生成代码
    • 完整脚本示例
    • 语音合成系统
    • Fish.audio TTS 接口说明文档与 Java 客户端封装
    • 整合 fishaudio 到 java-uni-ai-server 项目
    • 执行 Python (Manim) 代码
    • 使用 SSE 流式传输生成进度的实现文档
    • 整合全流程完整文档
    • HLS 动态推流技术文档
    • manim 分场景生成代码
    • 分场景运行代码及流式播放支持
    • 分场景业务端完整实现流程
    • Maiim布局管理器
    • 仅仅生成场景代码
    • 使用 modal 运行 manim 代码
    • Python 使用 Modal GPU 加速渲染
    • Modal 平台 GPU 环境下运行 Manim
    • Modal Manim OpenGL 安装与使用
    • 优化 GPU 加速
    • 生成视频封面流程
    • Java 调用 manim 命令 执行代码 生成封面
    • Manim 图像生成服务客户端文档
    • manim render help
    • 显示 中文公式
    • manimgl
    • EGL
    • /zh/66_manim/30.html
    • /zh/66_manim/31.html
    • 成本核算
    • /zh/66_manim/33.html
  • 70_tio-boot-admin

    • 入门指南
    • 初始化数据
    • token 存储
    • 与前端集成
    • 文件上传
    • 网络请求
    • 图片管理
    • /zh/70_tio-boot-admin/08.html
    • Word 管理
    • PDF 管理
    • 文章管理
    • 富文本编辑器
  • 71_tio-boot

    • /zh/71_tio-boot/01.html
    • Swagger 整合到 Tio-Boot 中的指南
    • HTTP/1.1 Pipelining 性能测试报告
  • 80_性能测试

    • 压力测试 - tio-http-serer
    • 压力测试 - tio-boot
    • 压力测试 - tio-boot-native
    • 压力测试 - netty-boot
    • 性能测试对比
    • TechEmpower FrameworkBenchmarks
    • 压力测试 - tio-boot 12 C 32G
  • 99_案例

    • 封装 IP 查询服务
    • tio-boot 案例 - 全局异常捕获与企业微信群通知
    • tio-boot 案例 - 文件上传和下载
    • tio-boot 案例 - 整合 ant design pro 增删改查
    • tio-boot 案例 - 流失响应
    • tio-boot 案例 - 增强检索
    • tio-boot 案例 - 整合 function call
    • tio-boot 案例 - 定时任务 监控 PostgreSQL、Redis 和 Elasticsearch
    • Tio-Boot 案例:使用 SQLite 整合到登录注册系统
    • tio-boot 案例 - 执行 shell 命令

手写 AIO Http 服务器

本文将介绍一个手写的 Java AIO(Asynchronous I/O)HTTP 服务器的实现。该服务器采用 Java NIO 的异步特性,实现了一个简单的 HTTP 服务器,能够处理基本的 HTTP 请求和响应。以下将详细解析代码的各个部分,帮助您理解其工作原理。

一、概述

该 HTTP 服务器的核心功能包括:

  • 使用 Java NIO 的 AsynchronousServerSocketChannel 实现非阻塞的服务器套接字。
  • 通过 CompletionHandler 接口处理连接、读取和写入操作的回调。
  • 实现了一个简单的路由机制,能够根据请求路径调用相应的处理器。
  • 提供了工具类用于解析 HTTP 请求和构建 HTTP 响应。

二、主要组件介绍

1. 主程序:MainApp

package com.litongjava.aio.boot;

import java.util.Map;

import com.litongjava.aio.boot.config.ServerConfig;
import com.litongjava.aio.boot.context.AioHttpServerJava8;
import com.litongjava.aio.boot.http.HttpRequestHandler;
import com.litongjava.aio.boot.http.HttpRequestRouter;
import com.litongjava.aio.boot.utils.RequestUtils;
import com.litongjava.aio.boot.utils.ResponseUtils;

public class MainApp {

  public static void main(String[] args) {
    HttpRequestRouter r = ServerConfig.me().getHttpRequestRouter();
    r.add("/", new HttpRequestHandler() {

      @Override
      public String handle(String request) throws Exception {
        Map<String, String> requestMap = RequestUtils.getRequestMap(request);
        String body = requestMap.get("ip");
        if (body == null) {
          body = "ok";
        }
        String response = ResponseUtils.toResponse(200, "text/plain;charset=utf-8", body);
        return response;
      }
    });
    AioHttpServerJava8.run();
  }

}

解析:

  • 创建了一个 HttpRequestRouter,并添加了对路径/的处理器。
  • 处理器从请求中获取参数ip,如果不存在则返回"ok"。
  • 使用 ResponseUtils 构建 HTTP 响应。
  • 启动 AIO HTTP 服务器。

2. 请求解析工具:RequestUtils

package com.litongjava.aio.boot.utils;

import java.util.HashMap;
import java.util.Map;

public class RequestUtils {

  // 从请求中提取请求路径
  public static String getRequestPath(String request) {
    String[] lines = request.split("\r\n");
    for (String line : lines) {
      if (line.startsWith("GET") || line.startsWith("POST")) {
        String[] parts = line.split(" ");
        if (parts.length > 1) {
          String query = parts[1];
          return query.split("\\?")[0]; // 提取请求路径
        }
      }
    }
    return "/";
  }

  // 从请求中提取参数并封装为Map的方法
  public static Map<String, String> getRequestMap(String request) {
    Map<String, String> paramMap = new HashMap<>();
    String[] lines = request.split("\r\n");
    for (String line : lines) {
      if (line.startsWith("GET") || line.startsWith("POST")) {
        String[] parts = line.split(" ");
        if (parts.length > 1) {
          String query = parts[1];
          if (query.contains("?")) {
            String[] queryParams = query.substring(query.indexOf("?") + 1).split("&");
            for (String param : queryParams) {
              String[] keyValue = param.split("=");
              if (keyValue.length > 1) {
                paramMap.put(keyValue[0], keyValue[1]);
              } else {
                paramMap.put(keyValue[0], ""); // 如果没有值,则设为空字符串
              }
            }
          }
        }
      }
    }
    return paramMap;
  }
}

解析:

  • getRequestPath:从 HTTP 请求中提取请求的路径。
  • getRequestMap:解析请求参数,返回一个包含参数键值对的 Map。

3. 响应构建工具:ResponseUtils

package com.litongjava.aio.boot.utils;

import java.nio.charset.StandardCharsets;

public class ResponseUtils {

  public static String toResponse(int statusCode, String contentType, String body) {
    String statusMessage;
    switch (statusCode) {
    case 200:
      statusMessage = "OK";
      break;
    case 404:
      statusMessage = "Not Found";
      break;
    case 500:
      statusMessage = "Internal Server Error";
      break;
    default:
      statusMessage = "Unknown";
    }

    String response;
    String string = "HTTP/1.1 " + statusCode + " " + statusMessage + "\r\n" + "Content-Type: " + contentType + "\r\n";

    if (body != null) {
      byte[] bytes = body.getBytes(StandardCharsets.UTF_8);
      response = string + "Content-Length: " + bytes.length + "\r\n" + "\r\n" + body;
    } else {
      response = string + "Content-Length: 0" + "\r\n" + "\r\n";
    }
    return response;
  }
}

解析:

  • toResponse:根据状态码、内容类型和响应体构建 HTTP 响应字符串。

4. 服务器启动类:AioHttpServerJava8

package com.litongjava.aio.boot.context;

import java.io.IOException;
import java.net.InetSocketAddress;
import java.nio.channels.AsynchronousServerSocketChannel;

import com.litongjava.aio.boot.handler.AcceptCompletionHandler;

public class AioHttpServerJava8 {
  public static void run() {
    try {
      // 创建异步服务器通道并绑定到端口8080
      AsynchronousServerSocketChannel serverChannel = AsynchronousServerSocketChannel.open();
      serverChannel.bind(new InetSocketAddress(8080));

      System.out.println("AIO HTTP Server started on port 8080...");

      AcceptCompletionHandler acceptCompletionHandler = new AcceptCompletionHandler(serverChannel);

      serverChannel.accept(null, acceptCompletionHandler);

      // 防止主线程退出
      Thread.currentThread().join();

    } catch (IOException | InterruptedException e) {
      e.printStackTrace();
    }
  }
}

解析:

  • 创建了 AsynchronousServerSocketChannel,绑定到 8080 端口。
  • 使用 AcceptCompletionHandler 处理新的客户端连接。
  • 主线程阻塞,防止程序退出。

5. 连接处理器:AcceptCompletionHandler

package com.litongjava.aio.boot.handler;

import java.nio.ByteBuffer;
import java.nio.channels.AsynchronousServerSocketChannel;
import java.nio.channels.AsynchronousSocketChannel;
import java.nio.channels.CompletionHandler;

public class AcceptCompletionHandler implements CompletionHandler<AsynchronousSocketChannel, Void> {

  private AsynchronousServerSocketChannel serverChannel;

  public AcceptCompletionHandler(AsynchronousServerSocketChannel serverChannel) {
    this.serverChannel = serverChannel;
  }

  @Override
  public void completed(AsynchronousSocketChannel clientChannel, Void attachment) {
    // 再次调用 accept(),以继续接受新连接
    serverChannel.accept(null, this);

    if (clientChannel != null && clientChannel.isOpen()) {
      ByteBuffer buffer = ByteBuffer.allocate(4096);
      ReadCompletionHandler readCompletionHandler = new ReadCompletionHandler(clientChannel);
      clientChannel.read(buffer, buffer, readCompletionHandler);
    }

  }

  @Override
  public void failed(Throwable exc, Void attachment) {
    serverChannel.accept(null, this);
    exc.printStackTrace();
  }
}

解析:

  • 当有新的客户端连接时,completed方法被调用。
  • 再次调用accept以接受新的连接,保持服务器持续监听。
  • 为每个新连接创建一个 ReadCompletionHandler 来处理读操作。

6. 读取处理器:ReadCompletionHandler

package com.litongjava.aio.boot.handler;

import java.io.IOException;
import java.nio.ByteBuffer;
import java.nio.channels.AsynchronousSocketChannel;
import java.nio.channels.CompletionHandler;

import com.litongjava.aio.boot.config.ServerConfig;

public class ReadCompletionHandler implements CompletionHandler<Integer, ByteBuffer> {

  private AsynchronousSocketChannel clientChannel;

  public ReadCompletionHandler(AsynchronousSocketChannel clientChannel) {
    this.clientChannel = clientChannel;
  }

  @Override
  public void completed(Integer result, ByteBuffer attachment) {
    ServerConfig.me().getByteBufferHandler().handle(clientChannel, result, attachment);
  }

  @Override
  public void failed(Throwable exc, ByteBuffer attachment) {
    exc.printStackTrace();
    try {
      clientChannel.close();
    } catch (IOException e) {
      e.printStackTrace();
    }
  }
}

解析:

  • 在读取操作完成后,completed方法被调用。
  • 调用 ServerConfig 中的 ByteBufferHandler 来处理读取的数据。

7. 写入处理器:WriteCompletionHandler

package com.litongjava.aio.boot.handler;

import java.io.IOException;
import java.nio.ByteBuffer;
import java.nio.channels.AsynchronousSocketChannel;
import java.nio.channels.CompletionHandler;

public class WriteCompletionHandler implements CompletionHandler<Integer, ByteBuffer> {

  private AsynchronousSocketChannel clientChannel;
  public WriteCompletionHandler(AsynchronousSocketChannel clientChannel) {
    this.clientChannel=clientChannel;
  }

  @Override
  public void completed(Integer result, ByteBuffer buffer) {
    try {
      clientChannel.close();
    } catch (IOException e) {
      e.printStackTrace();
    }
  }

  @Override
  public void failed(Throwable exc, ByteBuffer buffer) {
    try {
      clientChannel.close();
    } catch (IOException e) {
      e.printStackTrace();
    }
    exc.printStackTrace();
  }
}

解析:

  • 在写入操作完成后,关闭客户端连接。

8. 配置类:ServerConfig

package com.litongjava.aio.boot.config;

import com.litongjava.aio.boot.handler.ByteBufferHandler;
import com.litongjava.aio.boot.handler.DefaultByteBufferHandler;
import com.litongjava.aio.boot.http.DefaultHttpReqeustRouter;
import com.litongjava.aio.boot.http.HttpRequestRouter;

public class ServerConfig {
  private static ServerConfig me = new ServerConfig();

  public static ServerConfig me() {
    return me;
  }

  private ByteBufferHandler byteBufferHandler = new DefaultByteBufferHandler();;
  private HttpRequestRouter httpRequestRouter = new DefaultHttpReqeustRouter();

  public HttpRequestRouter getHttpRequestRouter() {
    return httpRequestRouter;
  }

  public void setHttpRequestRouter(HttpRequestRouter httpRequestRouter) {
    this.httpRequestRouter = httpRequestRouter;
  }

  public ByteBufferHandler getByteBufferHandler() {
    return byteBufferHandler;
  }

  public void setByteBufferHandler(ByteBufferHandler byteBufferHandler) {
    this.byteBufferHandler = byteBufferHandler;
  }
}

解析:

  • 使用单例模式存储服务器的配置。
  • 包含 ByteBufferHandler 和 HttpRequestRouter 的实例。

9. ByteBuffer 处理器接口:ByteBufferHandler

package com.litongjava.aio.boot.handler;

import java.nio.ByteBuffer;
import java.nio.channels.AsynchronousSocketChannel;

public interface ByteBufferHandler {

  public ByteBuffer handle(AsynchronousSocketChannel clientChannel, Integer result, ByteBuffer attachment);
}

解析:

  • 定义了处理读取到的 ByteBuffer 的接口方法。

10. 默认的 ByteBuffer 处理器:DefaultByteBufferHandler

package com.litongjava.aio.boot.handler;

import java.nio.ByteBuffer;
import java.nio.channels.AsynchronousSocketChannel;
import java.nio.charset.StandardCharsets;

import com.litongjava.aio.boot.config.ServerConfig;
import com.litongjava.aio.boot.http.HttpRequestHandler;
import com.litongjava.aio.boot.http.HttpRequestRouter;
import com.litongjava.aio.boot.utils.RequestUtils;
import com.litongjava.aio.boot.utils.ResponseUtils;

public class DefaultByteBufferHandler implements ByteBufferHandler {

  @Override
  public ByteBuffer handle(AsynchronousSocketChannel clientChannel, Integer result, ByteBuffer attachment) {
    attachment.flip();
    String request = StandardCharsets.UTF_8.decode(attachment).toString();

    // 解析请求路径
    String requestPath = RequestUtils.getRequestPath(request);

    HttpRequestRouter httpRequestRouter = ServerConfig.me().getHttpRequestRouter();
    HttpRequestHandler handler = httpRequestRouter.find(requestPath);
    if (handler != null) {
      String response = null;
      try {
        response = handler.handle(request);
      } catch (Exception e) {
        response = ResponseUtils.toResponse(500, "text/plain", e.getMessage());
        e.printStackTrace();
      }
      if (request == null) {
        response = ResponseUtils.toResponse(404, "text/plain", "Null");
        writeHttpResponse(clientChannel, response);
      } else {
        writeHttpResponse(clientChannel, response);
      }

    }else {
      // 其他路径,返回404
      String response = ResponseUtils.toResponse(404, "text/plain", "404 Not Found");
      writeHttpResponse(clientChannel, response);
    }


    return null;
  }

  private static void writeHttpResponse(AsynchronousSocketChannel clientChannel, String response) {
    ByteBuffer responseBuffer = ByteBuffer.wrap(response.getBytes());
    WriteCompletionHandler writeCompletionHandler = new WriteCompletionHandler(clientChannel);
    clientChannel.write(responseBuffer, responseBuffer, writeCompletionHandler);
  }

}

解析:

  • 实现了 ByteBufferHandler 接口。
  • 解析 HTTP 请求,找到对应的处理器,并生成 HTTP 响应。
  • 使用 WriteCompletionHandler 来发送响应并关闭连接。

11. HTTP 请求路由器:DefaultHttpReqeustRouter

package com.litongjava.aio.boot.http;

public interface HttpRequestRouter {

  /**
   * 添加路由
   * @param path
   * @param handler
   */
  public void add(String path, HttpRequestHandler handler);

  /**
   * 查找路由
   * @param path
   * @return
   */
  public HttpRequestHandler find(String path);
}

package com.litongjava.aio.boot.http;

import java.util.Map;
import java.util.Set;
import java.util.concurrent.ConcurrentHashMap;

public class DefaultHttpReqeustRouter implements HttpRequestRouter {
  Map<String, HttpRequestHandler> requestMapping = new ConcurrentHashMap<>();

  public void add(String path, HttpRequestHandler handler) {
    requestMapping.put(path, handler);
  }

  /**
   * find route /* 表示匹配任何以特定路径开始的路径,/** 表示匹配该路径及其下的任何子路径
   */
  public HttpRequestHandler find(String path) {
    HttpRequestHandler httpRequestRouteHandler = requestMapping.get(path);
    if (httpRequestRouteHandler != null) {
      return httpRequestRouteHandler;
    }

    // Check for wildcard matches
    Set<Map.Entry<String, HttpRequestHandler>> entrySet = requestMapping.entrySet();

    for (Map.Entry<String, HttpRequestHandler> entry : entrySet) {
      String key = entry.getKey();

      if (key.endsWith("/*")) {
        String baseRoute = key.substring(0, key.length() - 1);
        if (path.startsWith(baseRoute)) {
          return entry.getValue();
        }
      } else if (key.endsWith("/**")) {
        String baseRoute = key.substring(0, key.length() - 2);
        if (path.startsWith(baseRoute)) {
          return entry.getValue();
        }
      }
    }

    return null;
  }
}

解析:

  • 实现了 HttpRequestRouter 接口。
  • 维护了一个路径到处理器的映射。
  • 支持精确匹配和通配符匹配(/*和/**)。

12. HTTP 请求处理器接口:HttpRequestHandler

package com.litongjava.aio.boot.http;

@FunctionalInterface
public interface HttpRequestHandler {
  String handle(String rquest) throws Exception;
}

解析:

  • 定义了处理 HTTP 请求的接口方法。

三、工作流程

  1. 服务器启动

    • AioHttpServerJava8.run()启动服务器,绑定端口并开始监听。
    • 使用AcceptCompletionHandler处理新的连接。
  2. 接受连接

    • 当有新连接时,AcceptCompletionHandler.completed方法被调用。
    • 为新连接创建ReadCompletionHandler来处理读操作。
  3. 读取请求

    • ReadCompletionHandler.completed方法被调用,读取客户端发送的数据。
    • 调用DefaultByteBufferHandler.handle处理读取的数据。
  4. 处理请求

    • 在DefaultByteBufferHandler.handle中:
      • 解析请求路径和参数。
      • 使用HttpRequestRouter找到对应的HttpRequestHandler。
      • 调用处理器的handle方法获取响应内容。
      • 使用ResponseUtils构建 HTTP 响应。
  5. 发送响应

    • 使用WriteCompletionHandler将响应发送给客户端。
    • 发送完成后,关闭客户端连接。

四、总结

该 Java AIO HTTP 服务器通过异步非阻塞的方式,实现了一个简单的 HTTP 服务器。它使用了 Java NIO 中的异步通道和回调机制,充分利用了 Java 8 的特性。通过自定义的路由器和处理器,能够方便地扩展处理不同的请求路径。

潜在的改进方向:

  • 支持更多的 HTTP 方法:目前只处理了 GET 和 POST 方法,可以扩展对其他 HTTP 方法的支持。
  • 完善 HTTP 协议解析:当前的请求解析较为简单,可能无法处理复杂的 HTTP 请求。
  • 错误处理:增加对异常和错误状态的处理,提供更加友好的错误响应。
  • 性能优化:针对高并发场景,进行性能调优。

参考:

  • Java 官方文档关于 NIO 的介绍。
  • Java NIO 的异步通道和 CompletionHandler 的使用示例。

通过阅读以上内容,相信您已经对手写 Java AIO HTTP 服务器的实现有了深入的了解。

压力测试

测试数据

root@ping-Inspiron-3458:~# ab -c1000 -n10000000 http://localhost:8080/
This is ApacheBench, Version 2.3 <$Revision: 1843412 $>
Copyright 1996 Adam Twiss, Zeus Technology Ltd, http://www.zeustech.net/
Licensed to The Apache Software Foundation, http://www.apache.org/

Benchmarking localhost (be patient)
Completed 1000000 requests
Completed 2000000 requests
Completed 3000000 requests
Completed 4000000 requests
Completed 5000000 requests
Completed 6000000 requests
Completed 7000000 requests
Completed 8000000 requests
Completed 9000000 requests
Completed 10000000 requests
Finished 10000000 requests


Server Software:
Server Hostname:        localhost
Server Port:            8080

Document Path:          /
Document Length:        2 bytes

Concurrency Level:      1000
Time taken for tests:   908.218 seconds
Complete requests:      10000000
Failed requests:        0
Total transferred:      800000000 bytes
HTML transferred:       20000000 bytes
Requests per second:    11010.57 [#/sec] (mean)
Time per request:       90.822 [ms] (mean)
Time per request:       0.091 [ms] (mean, across all concurrent requests)
Transfer rate:          860.20 [Kbytes/sec] received

Connection Times (ms)
              min  mean[+/-sd] median   max
Connect:        0   45  60.0     42    3095
Processing:     1   46  16.9     46    6842
Waiting:        0   32  16.7     31    6832
Total:          4   91  63.1     88    7882

Percentage of the requests served within a certain time (ms)
  50%     88
  66%     90
  75%     91
  80%     92
  90%     94
  95%     97
  98%    103
  99%    108
 100%   7882 (longest request)

压力测试报告

一、测试概述

本次压力测试旨在评估本地服务器(localhost:8080)在高并发条件下的性能和稳定性。通过使用 ApacheBench(ab)工具,模拟大量并发请求,以测量服务器在高负载下的响应能力和处理效率。

二、测试环境

  • 服务器主机名: localhost
  • 服务器端口: 8080
  • 操作系统: 未明确提供(假设为 Linux 系统)
  • 服务器软件: 未明确提供(可能为 Apache、Nginx 或其他)
  • 硬件配置: 未明确提供(建议补充具体配置,如 CPU、内存、存储等)
  • 网络环境: 本地网络

三、测试工具

  • 工具名称: ApacheBench (ab)
  • 版本: 2.3
  • 官方网站: ApacheBench Documentation

四、测试参数

  • 目标 URL: http://localhost:8080/
  • 文档路径: /
  • 文档长度: 2 字节
  • 并发级别(Concurrency Level): 1000
  • 请求总数(Total Requests): 10,000,000
  • 连接类型: 默认(短连接)

五、测试结果

5.1 总体性能指标
指标数值
测试总耗时908.218 秒 (~15 分钟)
完成请求数10,000,000
失败请求数0
每秒请求数11,010.57 [#/sec] (平均)
每个请求的平均时间90.822 毫秒 (单个请求)
每个请求的平均时间0.091 毫秒 (所有并发请求)
传输速率860.20 KB/s 接收
5.2 连接时间分析
阶段最小值 (ms)平均值 (ms)标准差 (ms)中位数 (ms)最大值 (ms)
连接04560.0423095
处理14616.9466842
等待03216.7316832
总时间49163.1887882
5.3 响应时间分布
百分比响应时间 (ms)
50%88
66%90
75%91
80%92
90%94
95%97
98%103
99%108
100%7882 (最长请求)

六、分析与讨论

6.1 高吞吐量表现

服务器在高并发(1000)情况下,成功处理了每秒约 11,000 个请求,且所有请求均未失败。这表明服务器在高负载下具有较高的处理能力和稳定性。

6.2 响应时间表现
  • 整体响应速度: 大部分请求(99%)的响应时间均在 108 毫秒以内,显示出良好的响应速度。
  • 极端响应时间: 有 1%的请求响应时间显著增高,最长达到 7882 毫秒。这可能由以下因素导致:
    • 服务器资源瞬时紧张(CPU、内存等)
    • 应用程序内部的长时间运行操作
    • 垃圾回收(若使用 JVM 等)
    • 锁竞争或其他后台任务
6.3 连接时间波动

连接时间的标准差较大(60 ms),最大值达到 3095 ms,表明在高并发情况下,部分连接建立时间较长。可能原因包括:

  • 网络堆栈的性能瓶颈
  • 服务器的连接管理策略不优化
  • 资源竞争导致的延迟
6.4 资源利用率
  • 传输量: 每个请求的文档长度仅为 2 字节,传输量极小,有助于提高每秒处理请求数。然而,在实际应用中,文档大小可能更大,需要根据实际情况调整测试参数。
  • 系统资源: 未提供具体的 CPU、内存、I/O 等资源利用率数据,建议在未来测试中监控这些指标,以更全面地评估系统性能。
6.5 系统瓶颈

尽管整体性能表现良好,但极少数请求的高响应时间提示可能存在潜在的性能瓶颈。需要进一步调查具体原因,建议:

  • 检查服务器日志,寻找异常请求或错误信息
  • 监控系统资源使用情况(CPU、内存、I/O 等)
  • 优化应用程序,减少长时间运行的操作

八、结论

本次压力测试表明,目标服务器在高并发条件下具有良好的处理能力和稳定性,能够高效地处理大量请求。然而,极少数请求的高响应时间提示可能存在潜在的性能瓶颈。建议根据上述改进建议,进一步优化系统,以确保在各种负载情况下都能保持优异的性能表现。

Edit this page
Last Updated:
Contributors: Tong Li
Prev
AioHttpServer 应用示例 IP 属地查询