examples update

docs/examples/practices/injection/injection.md

@@ -0,0 +1,138 @@
+---
+title: 依赖注入
+slug: /examples/practices/injection
+keywords: [依赖注入, 测试, goframe, di]
+description: 使用GoFrame框架和do包实现的依赖注入示例
+hide_title: true
+---
+
+# 依赖注入示例
+
+Code Source: https://github.com/gogf/examples/tree/main/practices/injection
+
+
+## 简介
+
+本示例展示了如何在 `GoFrame` 应用程序中实现依赖注入。主要演示：
+
+1. 基础依赖注入设置
+2. 使用DI的服务层实现
+3. 集成gRPC的控制器层
+4. 使用模拟依赖的单元测试
+
+实现重点在于使核心业务逻辑易于测试：
+- 使用依赖注入分离关注点
+- 为服务依赖提供清晰的接口
+- 使依赖易于在测试中模拟
+
+## 环境要求
+
+- [Go](https://golang.org/dl/) `1.22` 或更高版本
+- [Git](https://git-scm.com/downloads)
+- [`GoFrame`](https://goframe.org)
+- [`do`](https://github.com/samber/do)
+- [MongoDB](https://www.mongodb.com)
+- [Redis](https://redis.io)
+
+## 目录结构
+
+```text
+injection/
+├── app/
+│   ├── gateway/          # API网关服务
+│   │   ├── api/         # API定义
+│   │   ├── internal/    # 内部实现
+│   │   │   ├── cmd/    # 命令行工具
+│   │   │   ├── controller/  # 控制器
+│   │   │   ├── model/  # 数据模型
+│   │   │   └── service/  # 业务逻辑
+│   │   └── manifest/   # 配置文件
+│   └── user/           # 用户服务
+│       ├── api/        # API定义
+│       │   ├── entity/ # 实体定义
+│       │   └── user/   # 用户API proto
+│       ├── internal/   # 内部实现
+│       │   ├── cmd/    # 命令行工具
+│       │   ├── controller/  # 使用DI的控制器
+│       │   ├── dao/    # 数据访问对象
+│       │   ├── model/  # 数据模型
+│       │   └── service/  # 使用DI的业务逻辑
+│       └── manifest/   # 配置文件
+├── hack/               # 开发工具
+└── utility/           # 通用工具
+    ├── injection/     # DI工具
+    └── mongohelper/   # MongoDB辅助工具
+```
+
+## 功能特性
+
+- 依赖注入使用
+- MongoDB和Redis集成
+- gRPC服务实现
+- 完整的单元测试
+- 清理资源的关闭处理
+- 命名依赖支持
+
+## 安装设置
+
+1. 克隆仓库：
+    ```bash
+    git clone https://github.com/gogf/examples.git
+    cd examples/practices/injection
+    ```
+
+2. 安装依赖：
+    ```bash
+    go mod tidy
+    ```
+
+3. 使用Docker启动所需服务：
+    ```bash
+    # 启动MongoDB
+    docker run -d --name mongo -p 27017:27017 mongo:latest
+
+    # 启动Redis
+    docker run -d --name redis -p 6379:6379 redis:latest
+    ```
+
+## 使用方法
+
+1. 运行应用：
+   ```bash
+   go run main.go
+   ```
+
+2. 运行测试：
+   ```bash
+   go test ./...
+   ```
+
+## 实现细节
+
+### 依赖注入设置
+- 使用 `do` 包进行依赖管理
+- 支持命名和未命名依赖
+- 提供常用操作的辅助函数
+
+### 服务层
+- 清晰的关注点分离
+- 基于接口的设计
+- 易于使用模拟实现进行测试
+
+### 控制器层
+- 支持DI的gRPC集成
+- 清晰的错误处理
+- 合理的资源管理
+
+### 测试
+- 完整的单元测试
+- 依赖模拟
+- 清晰的测试设置和清理
+
+## 注意事项
+
+- 始终使用接口定义依赖，使其可模拟
+- 在 `Shutdown` 方法中正确清理资源
+- 当需要同类型的多个实例时使用命名依赖
+- 在测试中考虑使用外部服务的模拟实现
+

i18n/en/docusaurus-plugin-content-docs/current/examples/balancer/http/http.md

@@ -21,7 +21,7 @@ This example demonstrates how to implement HTTP service load balancing with `GoF
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 

i18n/en/docusaurus-plugin-content-docs/current/examples/balancer/polaris/polaris.md

@@ -22,7 +22,7 @@ This example demonstrates how to implement HTTP service load balancing with `GoF
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [`GoFrame`](https://goframe.org)
 - [`GoFrame Polaris Registry`](https://github.com/gogf/gf/tree/master/contrib/registry/polaris)

i18n/en/docusaurus-plugin-content-docs/current/examples/config/apollo/apollo.md

@@ -38,7 +38,7 @@ This directory contains an example demonstrating how to integrate `Apollo` confi
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [GoFrame Apollo Config](https://github.com/gogf/gf/tree/master/contrib/config/apollo)

i18n/en/docusaurus-plugin-content-docs/current/examples/config/consul/consul.md

@@ -35,7 +35,7 @@ This directory contains an example demonstrating how to integrate `Consul` confi
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [GoFrame Consul Config](https://github.com/gogf/gf/tree/master/contrib/config/consul)

i18n/en/docusaurus-plugin-content-docs/current/examples/config/kubecm/kubecm.md

@@ -41,7 +41,7 @@ This directory contains an example demonstrating how to integrate `Kubernetes Co
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [GoFrame Kubernetes ConfigMap Config](https://github.com/gogf/gf/tree/master/contrib/config/kubecm)

i18n/en/docusaurus-plugin-content-docs/current/examples/config/nacos/nacos.md

@@ -35,7 +35,7 @@ This directory contains an example demonstrating how to integrate `Nacos` config
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [GoFrame Nacos Config](https://github.com/gogf/gf/tree/master/contrib/config/nacos)

i18n/en/docusaurus-plugin-content-docs/current/examples/config/polaris/polaris.md

@@ -39,7 +39,7 @@ This directory contains an example demonstrating how to integrate `Polaris` conf
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [GoFrame Polaris Config](https://github.com/gogf/gf/tree/master/contrib/config/polaris)

i18n/en/docusaurus-plugin-content-docs/current/examples/grpc/balancer/balancer.md

@@ -57,7 +57,7 @@ The example showcases the following features:
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [gRPC](https://grpc.io/docs/languages/go/quickstart/)

i18n/en/docusaurus-plugin-content-docs/current/examples/grpc/basic/basic.md

@@ -59,7 +59,7 @@ The example showcases the following features:
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [gRPC](https://grpc.io/docs/languages/go/quickstart/)

i18n/en/docusaurus-plugin-content-docs/current/examples/grpc/ctx/ctx.md

@@ -59,7 +59,7 @@ The example showcases the following features:
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [gRPC](https://grpc.io/docs/languages/go/quickstart/)

i18n/en/docusaurus-plugin-content-docs/current/examples/grpc/rawgrpc/rawgrpc.md

@@ -57,7 +57,7 @@ The example showcases the following features:
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [gRPC](https://grpc.io/docs/languages/go/quickstart/)

i18n/en/docusaurus-plugin-content-docs/current/examples/grpc/resolver/resolver.md

@@ -58,7 +58,7 @@ The example showcases the following features:
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [gRPC](https://grpc.io/docs/languages/go/quickstart/)

i18n/en/docusaurus-plugin-content-docs/current/examples/httpserver/proxy/proxy.md

@@ -28,7 +28,7 @@ The proxy server implements the following features:
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 

i18n/en/docusaurus-plugin-content-docs/current/examples/httpserver/rate-limit/rate-limit.md

@@ -23,7 +23,7 @@ The example implements:
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 

i18n/en/docusaurus-plugin-content-docs/current/examples/httpserver/response-json-array/response-json-array.md

@@ -24,7 +24,7 @@ The example implements a `/user` endpoint that returns a list of users in JSON a
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 

i18n/en/docusaurus-plugin-content-docs/current/examples/httpserver/upload-file/upload-file.md

@@ -25,7 +25,7 @@ The example provides both a REST API endpoint and a web interface for file uploa
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 

i18n/en/docusaurus-plugin-content-docs/current/examples/httpserver/websocket/websocket.md

@@ -28,7 +28,7 @@ The implementation demonstrates:
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [`GoFrame`](https://goframe.org)
 - [`Gorilla WebSocket`](https://github.com/gorilla/websocket)

i18n/en/docusaurus-plugin-content-docs/current/examples/observability/metric/basic/basic.md

@@ -53,7 +53,7 @@ The example showcases the following metric types:
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [GoFrame OpenTelemetry Metric](https://github.com/gogf/gf/tree/master/contrib/metric/otelmetric)

i18n/en/docusaurus-plugin-content-docs/current/examples/observability/metric/callback/callback.md

@@ -47,7 +47,7 @@ The example showcases the following features:
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [GoFrame OpenTelemetry Metric](https://github.com/gogf/gf/tree/master/contrib/metric/otelmetric)

i18n/en/docusaurus-plugin-content-docs/current/examples/observability/metric/dynamic_attributes/dynamic_attributes.md

@@ -47,7 +47,7 @@ The example showcases the following features:
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [GoFrame OpenTelemetry Metric](https://github.com/gogf/gf/tree/master/contrib/metric/otelmetric)

i18n/en/docusaurus-plugin-content-docs/current/examples/observability/metric/global_attributes/global_attributes.md

@@ -47,7 +47,7 @@ The example showcases the following features:
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [GoFrame OpenTelemetry Metric](https://github.com/gogf/gf/tree/master/contrib/metric/otelmetric)

i18n/en/docusaurus-plugin-content-docs/current/examples/observability/metric/http_client/http_client.md

@@ -49,7 +49,7 @@ The example showcases the following metrics:
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [GoFrame OpenTelemetry Metric](https://github.com/gogf/gf/tree/master/contrib/metric/otelmetric)

i18n/en/docusaurus-plugin-content-docs/current/examples/observability/metric/http_server/http_server.md

@@ -56,7 +56,7 @@ The example showcases the following endpoints and metrics:
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [GoFrame OpenTelemetry Metric](https://github.com/gogf/gf/tree/master/contrib/metric/otelmetric)

i18n/en/docusaurus-plugin-content-docs/current/examples/observability/metric/meter_attributes/meter_attributes.md

@@ -47,7 +47,7 @@ The example showcases the following features:
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [GoFrame OpenTelemetry Metric](https://github.com/gogf/gf/tree/master/contrib/metric/otelmetric)

i18n/en/docusaurus-plugin-content-docs/current/examples/observability/metric/prometheus/prometheus.md

@@ -46,7 +46,7 @@ The example showcases the following features:
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [GoFrame OpenTelemetry Metric](https://github.com/gogf/gf/tree/master/contrib/metric/otelmetric)

i18n/en/docusaurus-plugin-content-docs/current/examples/observability/trace/grpc-with-db/grpc-with-db.md

@@ -21,7 +21,7 @@ This example demonstrates how to implement distributed tracing in a gRPC service
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [GoFrame gRPCx](https://github.com/gogf/gf/tree/master/contrib/rpc/grpcx)

i18n/en/docusaurus-plugin-content-docs/current/examples/observability/trace/http-with-db/http-with-db.md

@@ -21,7 +21,7 @@ This example demonstrates how to implement distributed tracing in an HTTP servic
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [GoFrame MySQL Driver](https://github.com/gogf/gf/tree/master/contrib/drivers/mysql)

i18n/en/docusaurus-plugin-content-docs/current/examples/observability/trace/http/http.md

@@ -21,7 +21,7 @@ This example demonstrates how to implement distributed tracing in HTTP services
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [GoFrame OpenTelemetry Tracing](https://github.com/gogf/gf/tree/master/contrib/trace/otlphttp)

i18n/en/docusaurus-plugin-content-docs/current/examples/observability/trace/inprocess-grpc/inprocess-grpc.md

@@ -21,7 +21,7 @@ This example demonstrates how to implement distributed tracing in in-process ser
 
 ## Requirements
 
-- [Go](https://golang.org/dl/) 1.22 or higher
+- [Go](https://golang.org/dl/) `1.22` or higher
 - [Git](https://git-scm.com/downloads)
 - [GoFrame](https://goframe.org)
 - [GoFrame OpenTelemetry gRPC Tracing](https://github.com/gogf/gf/tree/master/contrib/trace/otlpgrpc)