diff --git a/README.MD b/README.MD
index 65dfd1c..8fd36ee 100644
--- a/README.MD
+++ b/README.MD
@@ -12,6 +12,10 @@
- ⚡ 支持通配符路由（`*` 和 `**`）
- 🔄 支持所有 HTTP 方法（GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS）
- 🏗️ 构造函数风格的 API 设计
+- 📁 静态文件服务中间件（类似 Hono.js 的 serveStatic）
+- 🛡️ 内置安全防护（路径遍历攻击防护、点文件访问控制）
+- 💾 智能缓存支持（ETag、Last-Modified、Cache-Control）
+- 🎯 自动 Content-Type 检测
## 安装
@@ -225,6 +229,45 @@ app.use(fn (mut c hono.Context, next fn (mut hono.Context) http.Response) http.R
})
```
+### 静态文件服务
+
+提供类似 Hono.js 的 `serveStatic` 中间件：
+
+```v
+// 使用默认配置（./public 目录）
+app.use(hono.serve_static_default())
+
+// 指定根目录
+app.use(hono.serve_static_root('./static'))
+
+// 指定路径前缀和根目录
+app.use(hono.serve_static_path('/assets', './static'))
+
+// 使用自定义配置
+options := hono.StaticOptions{
+ root: './public'
+ path: '/static'
+ index: 'index.html'
+ dotfiles: false
+ etag: true
+ last_modified: true
+ max_age: 3600 // 1小时缓存
+ headers: {
+ 'X-Custom-Header': 'value'
+ }
+}
+app.use(hono.serve_static(options))
+```
+
+**特性：**
+- 🛡️ 路径遍历攻击防护
+- 📁 自动索引文件支持（index.html）
+- 🔒 点文件访问控制
+- 🏷️ ETag 和 Last-Modified 支持
+- 💾 可配置缓存策略
+- 📋 自定义响应头
+- 🎯 智能 Content-Type 检测
+
### 查询参数和请求体
```v
@@ -256,6 +299,8 @@ app.clear_cache()
## 示例
+### 基础示例
+
运行完整示例：
```bash
@@ -269,6 +314,51 @@ v run example.v
- 中间件功能
- 参数提取和查询参数处理
+### 静态文件服务示例
+
+运行静态文件服务示例：
+
+```bash
+v run static_example.v
+```
+
+这个示例演示了：
+- 多个静态文件目录配置
+- 自定义缓存策略
+- 安全特性演示
+- 完整的HTML界面
+
+**重要提示**: 静态文件路径映射
+- `./public` 目录 → 访问路径 `/`
+- `./static` 目录 → 访问路径 `/assets`
+- `./uploads` 目录 → 访问路径 `/files`
+
+例如：
+- `./public/test.txt` → `http://localhost:8080/test.txt`
+- `./static/style.css` → `http://localhost:8080/assets/style.css`
+- `./uploads/sample.json` → `http://localhost:8080/files/sample.json`
+
+### 快速测试
+
+运行简单的静态文件测试：
+
+```bash
+v run test_static.v
+```
+
+测试文件结构：
+```
+v-hono/
+├── public/
+│ ├── index.html # 默认索引文件
+│ └── test.txt # 测试文本文件
+├── static/
+│ ├── style.css # 样式文件
+│ └── app.js # JavaScript文件
+└── uploads/
+ └── sample.json # JSON文件
+```
+
## 性能特性
- **混合路由算法**：静态路由 O(1) 查找，动态路由正则匹配
diff --git a/example.v b/example.v
index e8e50ce..590c08b 100644
--- a/example.v
+++ b/example.v
@@ -6,6 +6,34 @@ import hono
fn main() {
mut app := hono.new_hono()
+ // 日志中间件
+ app.use(fn (mut c hono.Context, next fn (mut hono.Context) http.Response) http.Response {
+ println('[LOG] ${c.req.method} ${c.url}')
+ return next(mut c)
+ })
+
+ // 静态文件服务 - 默认配置（./public 目录）
+ app.use(hono.serve_static_default())
+
+ // 静态文件服务 - 指定路径前缀
+ app.use(hono.serve_static_path('/assets', './static'))
+
+ // 静态文件服务 - 自定义配置
+ options := hono.StaticOptions{
+ root: './uploads'
+ path: '/files'
+ index: 'index.html'
+ dotfiles: false
+ etag: true
+ last_modified: true
+ max_age: 3600 // 1小时缓存
+ headers: {
+ 'X-Served-By': 'V-Hono'
+ 'X-Static-Files': 'true'
+ }
+ }
+ app.use(hono.serve_static(options))
+
// 基本路由
app.get('/hello', fn (mut c hono.Context) http.Response {
return c.text('Hello, World!')
@@ -13,7 +41,108 @@ fn main() {
// 根路径
app.get('/', fn (mut c hono.Context) http.Response {
- return c.html('Welcome to V-Hono!
A lightweight web framework for V
')
+ html_content := '
+
+
+
+
+ V-Hono 完整示例
+
+
+
+ 🚀 V-Hono 完整示例
+ A lightweight web framework for V with static file serving
+
+
+
📁 静态文件服务
+
+ 默认目录: / → ./public
+
+
+ 资源目录: /assets → ./static
+
+
+ 文件目录: /files → ./uploads
+
+
测试文件:
+
+
+
✨ 特性
+
+ - 🚀 高性能路由系统
+ - 🛡️ 路径遍历攻击防护
+ - 📁 自动索引文件支持
+ - 🔒 点文件访问控制
+ - 🏷️ ETag 和 Last-Modified 支持
+ - 💾 可配置缓存策略
+ - 🎯 智能 Content-Type 检测
+ - 🔧 洋葱模型中间件
+
+
+
🧪 测试命令
+
+# 静态文件测试
+curl http://localhost:8080/test.txt
+curl http://localhost:8080/assets/style.css
+curl http://localhost:8080/files/sample.json
+
+# API 测试
+curl http://localhost:8080/api/health
+curl http://localhost:8080/api/status
+curl http://localhost:8080/hello
+
+# 动态路由测试
+curl http://localhost:8080/users/123
+curl http://localhost:8080/posts/456/comments/789
+
+
+
🎉 成功！
+
这是来自 ./public 目录的 index.html 文件
+
+
+
✨ V-Hono 静态文件服务特性
+
✅ 自动索引文件支持
+
✅ 路径遍历攻击防护
+
✅ ETag 和缓存支持
+
✅ 智能 Content-Type 检测
+
+
+
← 返回主页
+