ekit-hertz

module
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 14, 2026 License: MIT

README

ekit-hertz

Hertz HTTP 生态——自研标准中间件栈、社区库桥接、CRUD handler、注册发现/NNS 适配器、OTel 桥接。

本仓库是 ekit(git.enjoye.top/enjoydream/ekit v0.34.0) 按框架耦合分层拆分出的独立 Go module,属于 yi-nology ekit 子项目矩阵。

安装

go get github.com/yi-nology/ekit-hertz@v0.1.0

包清单

  • middleware/ — 标准栈:Recovery/Response/AccessLog/RateLimit/BearerTokenAuth/Prometheus/I18n/Fail(DefaultMiddleware 一键注册)
  • middleware/contrib/ — hertz-contrib 桥接:JWT/Cache/Sessions/Swagger/CSRF/pprof/Debug/Lark/ReverseProxy/Sentinel 等
  • middleware/traceid/hmw/ — requestid 集成(hmw)
  • handler/ — crudh(CRUD HTTP handler)、validatorh(参数绑定)、versionh
  • hertz/ — 运行时集成:日志桥接、RunServer 生命周期、Shutdown Hook;子包 metrics/health/sse/render/adaptor
  • registry/hertz/、nns/hertz/ — Hertz 注册发现适配器
  • governance/hertz/ — 动态限流/超时中间件
  • observability/tracing/instrumentation/hertzotel|hertztracer/ — OTel / OpenTracing 桥接

依赖关系

子项目矩阵与依赖方向(自底向上):

ekit-core                      纯工具层(零内部依赖)
  └─ ekit-observability        日志/追踪/指标门面
       └─ ekit-registry        注册发现 + 配置
            ├─ ekit-data       存储层
            ├─ ekit-network    网络客户端
            │    └─ ekit-nns   服务治理客户端
            │         └─ ekit-bootstrap  应用引导
            ├─ ekit-hertz      Hertz 生态
            ├─ ekit-kitex      Kitex 生态
            └─ ekit-workflow   流程编排

依赖:ekit-core、ekit-observability、ekit-registry、ekit-nns、ekit-data。

与 ekit 单体仓库的关系

  • 代码与 ekit v0.34.0 等价,仅 module 路径从 git.enjoye.top/enjoydream/ekit/... 改为 github.com/yi-nology/ekit-hertz/...
  • 后续演进以各子仓库独立发版(SemVer);ekit 单体仓库保留完整历史与架构文档(docs/PLATFORM_CONTRACT.md)
  • 开发规范(命名/错误处理/并发安全/日志门面)沿用 ekit AGENTS.md 约定

License

见 LICENSE

Directories

Path Synopsis
governance
hertz
Package govhertz 把 governance.Store 消费成 hertz server 治理中间件 (audit 5.2 阶段 1:hertz 侧治理)。
Package govhertz 把 governance.Store 消费成 hertz server 治理中间件 (audit 5.2 阶段 1:hertz 侧治理)。
handler
crudh
Package crudh 提供基于 Hertz 的通用 CRUD HTTP Handler。
Package crudh 提供基于 Hertz 的通用 CRUD HTTP Handler。
validatorh
Package validatorh 提供基于 Hertz 的请求参数绑定与验证。
Package validatorh 提供基于 Hertz 的请求参数绑定与验证。
versionh
Package versionh 提供版本信息的 HTTP Handler。
Package versionh 提供版本信息的 HTTP Handler。
Package hertz 为 Hertz HTTP 框架提供 ekit 生态集成。
Package hertz 为 Hertz HTTP 框架提供 ekit 生态集成。
adaptor
Package adaptor 提供 hertz-contrib/adaptor 常用 helper,让 ekit 业务 用 1 行代码把 net/http 生态(http.FileServer / embed.FS / gorilla/websocket)接入 hertz。
Package adaptor 提供 hertz-contrib/adaptor 常用 helper,让 ekit 业务 用 1 行代码把 net/http 生态(http.FileServer / embed.FS / gorilla/websocket)接入 hertz。
health
Package health 提供 Hertz 健康检查端点。
Package health 提供 Hertz 健康检查端点。
metrics
Package metrics 提供 Hertz Prometheus 指标端点。
Package metrics 提供 Hertz Prometheus 指标端点。
render
Package render 提供业务特定的 hertz Render interface 实现,与 hertz 官方 render 子包(https://www.cloudwego.io/zh/docs/hertz/tutorials/basic-feature/render/) 风格一致。
Package render 提供业务特定的 hertz Render interface 实现,与 hertz 官方 render 子包(https://www.cloudwego.io/zh/docs/hertz/tutorials/basic-feature/render/) 风格一致。
sse
Package sse 提供 Hertz SSE(Server-Sent Events)封装。
Package sse 提供 Hertz SSE(Server-Sent Events)封装。
Package mw 提供 CloudWeGo Hertz 服务的自研标准中间件栈。
Package mw 提供 CloudWeGo Hertz 服务的自研标准中间件栈。
contrib
Package contrib 集中承载 hertz-contrib 社区库的桥接适配。
Package contrib 集中承载 hertz-contrib 社区库的桥接适配。
traceid/hmw
Package hmw 提供 trace_id 的 Hertz 中间件实现。
Package hmw 提供 trace_id 的 Hertz 中间件实现。
nns
hertz
Package hertz 提供 nns 与 CloudWeGo Hertz 集成的适配器。
Package hertz 提供 nns 与 CloudWeGo Hertz 集成的适配器。
observability
tracing/instrumentation/hertzotel
Package hertzotel 提供 Hertz HTTP client/server 的 OpenTelemetry tracing 集成 helper,桥接 hertz-contrib/obs-opentelemetry/tracing。
Package hertzotel 提供 Hertz HTTP client/server 的 OpenTelemetry tracing 集成 helper,桥接 hertz-contrib/obs-opentelemetry/tracing。
tracing/instrumentation/hertztracer
Package hertztracer 提供 Hertz HTTP client/server 的 OpenTracing tracing 集成 helper,桥接 hertz-contrib/tracer。
Package hertztracer 提供 Hertz HTTP client/server 的 OpenTracing tracing 集成 helper,桥接 hertz-contrib/tracer。
registry
hertz
Package hertz 提供 ekit registry 抽象到 CloudWeGo Hertz 框架的适配器。
Package hertz 提供 ekit registry 抽象到 CloudWeGo Hertz 框架的适配器。

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL