Java轻量级HTTP服务器实战：3大场景解决日常开发痛点-开发者社区

Java轻量级HTTP服务器实战：3大场景解决日常开发痛点

【免费下载链接】hutool🍬A set of tools that keep Java sweet.项目地址: https://gitcode.com/gh_mirrors/hu/hutool

在日常Java开发工作中，你是否经常遇到这些困扰：前端开发需要接口数据但后端尚未完成，本地文档需要在线预览，临时文件共享却找不到合适工具？传统解决方案要么配置繁琐，要么依赖复杂，而Hutool的SimpleServer组件正是为此而生。这个不足300行的核心类，基于JDK内置的HttpServer封装，让你用极简代码搭建功能完备的HTTP服务。

场景一：前端开发中的模拟接口服务

当前端团队等待后端API接口时，你可以用SimpleServer快速搭建模拟服务，避免开发进度受阻。

依赖配置

<dependency> <groupId>cn.hutool</groupId> <artifactId>hutool-http</artifactId> <version>5.8.22</version> </dependency>

核心代码实现

import cn.hutool.http.server.SimpleServer; public class MockServer { public static void main(String[] args) { new SimpleServer(8080) .addAction("/api/user/list", (request, response) -> { response.setContentType("application/json"); String jsonData = "[" + "{\"id\": 1001, \"name\": \"张三\", \"age\": 28}," + "{\"id\": 1002, \"name\": \"李四\", \"age\": 32}," + "{\"id\": 1003, \"name\": \"王五\", \"age\": 25}" + "]"; response.write(jsonData); }) .addAction("/api/product/detail", (request, response) -> { response.write("{\"id\": 2001, \"name\": \"Java工具包\", \"price\": 99.9}"); }) .start(); } }

启动后，前端可直接调用http://localhost:8080/api/user/list获取模拟数据，支持GET/POST等多种请求方式。

场景二：本地文档与静态资源托管

无论是技术文档、项目说明还是个人博客，SimpleServer都能提供便捷的本地预览方案。

文档服务器搭建

new SimpleServer(9090) .setRoot("/home/docs") // 文档根目录 .addFilter((request, response, chain) -> { // 添加访问日志 System.out.println("访问文档: " + request.getPath()); chain.doFilter(); }) .start();

将HTML、Markdown、PDF等文件放入指定目录，访问对应URL即可直接浏览，无需安装任何额外软件。

场景三：局域网文件共享服务

在团队协作或临时文件传输场景中，SimpleServer可以快速搭建安全的文件共享服务。

文件共享实现

new SimpleServer(8080) .setRoot("/shared/files") .addFilter((request, response, chain) -> { // 简单权限验证 String token = request.getHeader("X-Auth-Token"); if (!"team123".equals(token)) { response.sendError(403, "访问被拒绝"); return; } chain.doFilter(); }) .start();

团队成员通过浏览器访问服务器IP地址即可下载共享文件，支持大文件传输和断点续传。

进阶技巧：性能优化与安全配置

并发处理优化

默认情况下SimpleServer使用全局线程池，对于高并发场景可以自定义线程池：

import java.util.concurrent.*; ExecutorService customExecutor = new ThreadPoolExecutor( 5, 20, 60, TimeUnit.SECONDS, new ArrayBlockingQueue<>(100) ); new SimpleServer(8080) .setExecutor(customExecutor) .setRoot("/data/www") .start();

跨域问题一站式解决

前端开发中最常见的跨域问题，通过过滤器轻松搞定：

new SimpleServer(8080) .addFilter((request, response, chain) -> { response.setHeader("Access-Control-Allow-Origin", "*"); response.setHeader("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE"); response.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization"); chain.doFilter(); }) .start();

请求日志与监控

添加全局过滤器实现请求日志记录：

new SimpleServer(8080) .addFilter((request, response, chain) -> { long startTime = System.currentTimeMillis(); chain.doFilter(); long cost = System.currentTimeMillis() - startTime; System.out.printf("请求 %s %s - 耗时 %dms%n", request.getMethod(), request.getPath(), cost); }) .setRoot("/web") .start();

核心源码解析

SimpleServer的核心架构设计简洁高效：

请求处理流程： 客户端请求 → HttpServer接收 → 过滤器链 → Action处理器 → 响应返回

主要组件说明：

SimpleServer：服务器入口类，负责初始化和启动
ActionHandler：请求分发处理器
HttpFilter：过滤器接口，支持全局拦截
RootAction：根路径处理器，用于静态资源服务

关键源码文件：

服务器核心类：hutool-http/src/main/java/cn/hutool/http/server/SimpleServer.java
请求处理接口：hutool-http/src/main/java/cn/hutool/http/server/action/Action.java

实用配置模板

开发环境完整配置

public class DevServer { public static void main(String[] args) { new SimpleServer(8080) // 静态资源 .setRoot("/home/dev/static") // API接口 .addAction("/api/data", new DataAction()) // 全局过滤器 .addFilter(new LogFilter()) .addFilter(new CorsFilter()) .start(); } }