https://github.com/94fzb/simplewebserver
SimpleWebServer 是一款使用Java基于NIO编写的超轻量级开源Web Application Server
https://github.com/94fzb/simplewebserver
java nio simplewebserver webserver
Last synced: 1 day ago
JSON representation
SimpleWebServer 是一款使用Java基于NIO编写的超轻量级开源Web Application Server
- Host: GitHub
- URL: https://github.com/94fzb/simplewebserver
- Owner: 94fzb
- License: apache-2.0
- Created: 2015-09-23T06:13:47.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2025-12-22T06:57:30.000Z (26 days ago)
- Last Synced: 2025-12-23T18:12:42.232Z (25 days ago)
- Topics: java, nio, simplewebserver, webserver
- Language: Java
- Homepage:
- Size: 1020 KB
- Stars: 92
- Watchers: 3
- Forks: 24
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-java - SimpleWebServer
README
# SimpleWebServer
[](https://central.sonatype.com/artifact/com.hibegin/simplewebserver)
> SimpleWebServer 是一款使用Java基于NIO编写的超轻量级开源Web Application Server
是否遇到有时候想做一些小的Web程序，但是迫于Java运行环境过于繁琐而迟迟没有下手，那么现在除了SpringBoot，广大的Java程序员又多了一个选择
### 轻量级
并不基于servlet，源代码仅3000行左右，jar包仅 0.1m 左右，零依赖，无xml，极低的内存占用，所以不用担心程序能不能在嵌入式（树莓派）/Android
上能否正常运行
### 完整
```
基本常用API都有，还是熟悉的配方，熟悉的味道，web程序编写更容易
```
- Request
- Response
- Controller
- Cookie/Session
- Interceptor
- Json
- Freemarker 模板
- 文件上传
- GZip
- 静态文件服务器
### GraalVM Native
Java21 loom + GraalVM Native 让应用有更小的内存占用和更快捷的运行体验
在使用 Native 后，单个可执行文件大概 15mb 左右，通过 zip 后程序在 5m 左右，足够小（对比完整 JDK）
### SimpleWebServer-Cli
快速体验：https://github.com/94fzb/simplewebserver-cli
基于 simplewebserver，使用 GraalVM Native Image，提供一个简单文件服务分享服务（无需 Java环境）
类似 python 的一行代码启动一个基于 http 的文件服务，比 python 更简单，无需 pip
### 快速上手
#### Java 版本
- 必须： Java8 及以上版本，
- 推荐： Java11 及以上的版本
```xml
com.hibegin
simplewebserver
4.0.107
```
```java
public class DemoController extends Controller {
public static void main(String[] args) {
ServerConfig serverConfig = new ServerConfig();
serverConfig.getRouter().addMapper("", DemoController.class);
new WebServerBuilder.Builder().serverConfig(serverConfig).build().startWithThread();
}
public void index() {
getResponse().renderText("Hello world/v" + ServerInfo.getVersion());
}
}
```
然后浏览器输入 http://localhost:6058
### 打包
**推荐使用 maven-assembly-plugin**
```xml
maven-assembly-plugin
2.5.5
com.hibegin.http.server.test.DemoController
simplewebserver-demo
jar-with-dependencies
```
`mvn clean compile assembly:single`
### 性能
简单与号称 “性能打爆网卡的tio” 对比，感兴趣移步到 https://gitee.com/94fzb/simplewebserver-performance
## Changelog
[完整的版本变化日志](CHANGELOG.md)
## TODO
- 支持HTTP2.0基本协议（不包含服务端推送）
- ~~实现多线程解码HTTP请求~~
- 提供类似 SpringMVC 通过注解完成 Restful API的编写
- ~~提供多种 JSON 序列化工具包支持~~
- ~~提供HTTP错误码错误页面配置功能~~
## 其他
* WebServer 默认端口为 `6058` 在 `conf/conf.properties` 中，或则通过代码的方式进行配置
* 使用 `FreeMarkerKit.init` 初始化模板文件根目录，`FreeMarkerKit.initClassTemplate` 初始模板相对jar中的根目录
* 服务器上时建议打包为 `jar` 文件运行（推荐使用 maven，jar文件路径与`conf` 文件夹同目录）
* 依赖的json和freemarker的jar都是非必须
## License
SimpleWebServer is Open Source software released under
the [Apache 2.0 license](https://www.apache.org/licenses/LICENSE-2.0.html).