ekit-network

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-network

网络客户端层——HTTP 客户端(服务发现/熔断/重试/指标)、WebSocket、NATS、消息队列抽象。

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

安装

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

包清单

  • network/httpx/ — Hertz Client 高层封装:NNS 服务发现、熔断(gobreaker)、指数退避重试、Prometheus 弹性指标、OTel 透传、实例权重贯通
  • network/loadbalance/ — 加权负载均衡策略
  • network/wsutil/ — WebSocket 广播器(背压安全)
  • network/nats/、network/mq/ — NATS 客户端与 MQ 抽象
  • network/conn/、network/streamx/ — 连接管理与流工具
  • network/octopus/ — Octopus 推送客户端

依赖关系

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

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 单体仓库的关系

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

License

见 LICENSE

Directories

Path Synopsis
network
conn
Package conn 提供连接管理相关的工具。
Package conn 提供连接管理相关的工具。
httpx
Package httpx 提供 JSON HTTP 客户端。
Package httpx 提供 JSON HTTP 客户端。
loadbalance
Package loadbalance 提供与具体服务发现实现解耦的负载均衡策略。
Package loadbalance 提供与具体服务发现实现解耦的负载均衡策略。
mq
Package mq 提供消息队列统一门面。
Package mq 提供消息队列统一门面。
nats
Package nats 提供 NATS 消息队列客户端封装。
Package nats 提供 NATS 消息队列客户端封装。
octopus
Package octopus octopus 消息平台推送客户端(公司 IM 基建件,收编自 argus internal/notify,v0.32.0):POST /api/v2/send/quick,X-User-Id 机器账号头(octopus AuthMiddleware 按 header 自动建账号)+ 可选 Bearer。
Package octopus octopus 消息平台推送客户端(公司 IM 基建件,收编自 argus internal/notify,v0.32.0):POST /api/v2/send/quick,X-User-Id 机器账号头(octopus AuthMiddleware 按 header 自动建账号)+ 可选 Bearer。
streamx
Package streamx 提供跨 SSE / WebSocket / Chunked Transfer 协议的 流式响应抽象(Event/Source/Sink/Hub),跟 ekit 已有 hertz/sse(Stream 单连接 SSE)+ network/wsutil(Broadcaster 房间广播) 协同工作,业务可一次写 Event,多协议扇出。
Package streamx 提供跨 SSE / WebSocket / Chunked Transfer 协议的 流式响应抽象(Event/Source/Sink/Hub),跟 ekit 已有 hertz/sse(Stream 单连接 SSE)+ network/wsutil(Broadcaster 房间广播) 协同工作,业务可一次写 Event,多协议扇出。
wsutil
Package wsutil 提供通用 WebSocket 基础设施。
Package wsutil 提供通用 WebSocket 基础设施。

Jump to

Keyboard shortcuts

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