w11
872f843c6f
- 新增 webhttp 包: Router 最小路由接口(5 动词) + ServeMuxRouter 适配器 + WriteJSON 统一响应 - file/shell/process 三个被控能力包改以标准库 handler 形态注册, 不再绑死 gin - 由此 gin 及其连带重依赖(quic-go/http3、mongo bson、ugorji codec、goccy、validator)退出被控端二进制 - shell: recDir 死参数修复——原实现硬编码 ./rec, 传入的录制目录不生效; 现录制写入与记录列表同源 - shell: 终端创建失败由 panic 改为记日志后关连接(net/http 按连接兜底恢复, 不再依赖框架 Recovery) - file: 上传落盘不再沿用 SaveUploadedFile 的 MkdirAll+Chmod(Windows 盘根 Chmod 报参数不正确), 保留 MkdirAll 去掉 Chmod - 消费方: remote-client 纯 ServeMux 承载; remote-service 保留 gin 栈经 gin.WrapH 桥接(middle 链照常生效) 破坏性变更: RegisterRouters* 形参 gin.RouterGroup → webhttp.Router, 升级 tag v0.5.0
70 lines
2.4 KiB
Go
70 lines
2.4 KiB
Go
// Package webhttp 被控 HTTP 能力的极薄适配层。
|
|
//
|
|
// file/shell/process 三个被控能力包统一以标准库 http.HandlerFunc 为 handler
|
|
// 形态、以 Router 接口收拢路由注册, 不再绑死任何 Web 框架。消费方按自身
|
|
// 技术栈适配: 纯标准库用 ServeMuxRouter 直挂 *http.ServeMux(Go 1.22+ 方法
|
|
// +路径模式); 已有 gin 栈的用 gin.WrapH 桥接, 中间件链照常生效。
|
|
//
|
|
// 由此 gin(连带其拖入的 quic-go/http3、mongo bson、ugorji codec、goccy
|
|
// 等重依赖)从被控端二进制中整体消失, 体积近乎减半。
|
|
package webhttp
|
|
|
|
import (
|
|
"encoding/json"
|
|
"net/http"
|
|
)
|
|
|
|
// Router file/shell/process 声明路由用的最小接口(pattern 形如
|
|
// "/file/list", 不含组前缀; 前缀由适配器拼)。
|
|
type Router interface {
|
|
GET(pattern string, h http.HandlerFunc)
|
|
POST(pattern string, h http.HandlerFunc)
|
|
PUT(pattern string, h http.HandlerFunc)
|
|
DELETE(pattern string, h http.HandlerFunc)
|
|
HEAD(pattern string, h http.HandlerFunc)
|
|
}
|
|
|
|
// ServeMuxRouter 把 *http.ServeMux 适配为 Router, 注册
|
|
// "METHOD prefix+pattern" 模式路由(如 "GET /api/file/list")。
|
|
// 注册了 GET 的路径自动兼容 HEAD。
|
|
func ServeMuxRouter(mux *http.ServeMux, prefix string) Router {
|
|
return &muxRouter{mux: mux, prefix: prefix}
|
|
}
|
|
|
|
type muxRouter struct {
|
|
mux *http.ServeMux
|
|
prefix string
|
|
}
|
|
|
|
func (m *muxRouter) route(method, pattern string) string {
|
|
return method + " " + m.prefix + pattern
|
|
}
|
|
|
|
func (m *muxRouter) GET(pattern string, h http.HandlerFunc) {
|
|
m.mux.HandleFunc(m.route(http.MethodGet, pattern), h)
|
|
}
|
|
|
|
func (m *muxRouter) POST(pattern string, h http.HandlerFunc) {
|
|
m.mux.HandleFunc(m.route(http.MethodPost, pattern), h)
|
|
}
|
|
|
|
func (m *muxRouter) PUT(pattern string, h http.HandlerFunc) {
|
|
m.mux.HandleFunc(m.route(http.MethodPut, pattern), h)
|
|
}
|
|
|
|
func (m *muxRouter) DELETE(pattern string, h http.HandlerFunc) {
|
|
m.mux.HandleFunc(m.route(http.MethodDelete, pattern), h)
|
|
}
|
|
|
|
func (m *muxRouter) HEAD(pattern string, h http.HandlerFunc) {
|
|
m.mux.HandleFunc(m.route(http.MethodHead, pattern), h)
|
|
}
|
|
|
|
// WriteJSON 统一 JSON 响应(响应头口径与原 gin c.JSON 一致)。
|
|
// 业务码仍在 body 的 code 字段, HTTP 状态恒 200, 与既有前端约定不变。
|
|
func WriteJSON(w http.ResponseWriter, status int, v any) {
|
|
w.Header().Set("Content-Type", "application/json; charset=utf-8")
|
|
w.WriteHeader(status)
|
|
_ = json.NewEncoder(w).Encode(v)
|
|
}
|