Ore: Go 用の高度な依存性注入パッケージ

原石: Go 言語用の高度な依存関係注入パッケージ

鉱石ドキュメント Web サイト

GitHub リポジトリ

Go 言語はそのシンプルさとパフォーマンスの高さで知られていますが、開発者は依存関係の管理に関してしばしば課題に直面します。 Go 言語には他の言語のような組み込み DI フレームワークはありませんが、役立つサードパーティ ライブラリが多数あります。 Ore は、Go アプリケーションの依存関係注入 (DI) のための軽量で効率的なソリューションを提供するパッケージです。

Ore は、重大なパフォーマンスのオーバーヘッドを発生させることなく、DI 効率を簡素化し、向上させるように設計されています。他の多くの DI ライブラリとは異なり、Ore はリフレクションやコード生成の代わりに Go Generics を利用し、アプリケーションの高速性とタイプセーフを確保します。そのため、Ore は効率的で使いやすい DI ソリューションを探している開発者にとって理想的なものとなっています。 この記事では、Ore の主な機能と、それらの機能が Go での依存関係の管理にどのように役立つかを紹介します。また、Ore を実際のアプリケーションでどのように使用できるかを示すための基本的なコード例もいくつか示します。

---

Ore の主な機能

1.

ジェネリックベースの依存関係の注入

Ore は

Go ジェネリック

を利用して依存関係を登録し、解決します。この設計の選択により、リフレクションとコード生成に通常伴うパフォーマンスのオーバーヘッドが回避されます。 Ore はジェネリックスを使用することで、実行時チェックを一切行わずに、依存関係の解決がタイプセーフかつ効率的に行われることを保証します。 このアプローチにより、他の多くの DI フレームワークでよくあるリフレクションとコード生成の落とし穴が回避されるため、Ore は高性能の DI ソリューションになります。

2.

簡単かつ柔軟な登録

Ore はサービスを登録するための複数の方法を提供しており、サービスのライフサイクル (シングルトン、スコープ、一時的なものなど) に応じて柔軟に選択できます。単一のインスタンスが必要な場合でも、特定のコンテキストのスコープ付きインスタンスが必要な場合でも、リクエストごとに作成される一時的なインスタンスが必要な場合でも、Ore が対応します。

3.

キーイングサービス

Ore では、

キー付きサービス

を使用して、同じインターフェースの複数の実装を登録および解決できます。この機能は、サービスの複数のバージョンを管理する必要がある場合、または特定の条件に基づいて異なる動作を実装する必要がある場合に役立ちます。 たとえば、さまざまな環境 (例: テスト、運用) またはさまざまな構成 (例: ユーザーの役割に基づく) 用にサービスの複数の実装を作成できます。

4.

プレースホルダーサービス

Ore は

プレースホルダー サービス

もサポートしているため、実行時に設定できる未解決の依存関係を持つサービスを登録できます。この機能は、一部の値またはサービスが登録時には利用できなくても、後で利用できるようになる場合に便利です。 たとえば、構成値を必要とするサービスを登録し、コンテキスト (ユーザーの役割や環境など) に基づいて実際の構成を動的に提供できます。

5.検証

Ore には、次のような一般的な問題を検出する組み込みの 登録検証 が含まれています。

• 依存関係がありません: 必要なサービスがすべて登録されていることを確認してください。
• 循環依存関係: 循環依存関係チェーンを検出して防止します。
• ライフサイクルの不一致: ライフサイクルが長いサービスがライフサイクルが短いサービスに依存していないことを確認します。

この検証は、ore.Get または ore.GetList を使用してサービスを解決すると自動的に行われますが、ore.Validate() を使用して手動で検証をトリガーすることもできます。これにより、依存関係グラフが正しいことが保証され、構成ミスによる実行時エラーが回避されます。

さらに、パフォーマンス上の理由から検証を無効にしたり、すべてのサービスを登録した後にコンテナーをシールしてさらなる変更を防ぐこともできます。

6.

高性能

Ore ではパフォーマンスが重要な考慮事項です。リフレクションとコード生成を回避することにより、Ore は複雑な依存関係グラフを含む大規模なアプリケーションでも高速性を維持します。 Ore のベンチマーク結果は、特定の操作が完了するまでにわずか数ナノ秒しかかからないという、その効率性を示しています。このため、Ore は、追加のオーバーヘッドなしで効率的な DI を必要とする高性能 Go アプリケーションにとって優れた選択肢となります。

7.

モジュール化とスコープコンテナ

Ore は

モジュラーコンテナ をサポートしており、アプリケーションのさまざまな部分に個別のコンテナを定義できます。これは、異なるコンポーネントまたはモジュールが異なる依存関係を持つモジュール型アプリケーションに特に役立ちます。さまざまなユースケースに応じてスコープ付きコンテナーを定義できるため、依存関係の管理がより組織化され、保守が容易になります。

---

コード例

Ore がどのように機能するかをより深く理解するために、デフォルトの Ore コンテナを使用した簡単な例をいくつか見てみましょう。

例 1: 基本的なサービスの登録と解決

package main

import (
    "context"
    "fmt"
    "github.com/firasdarwish/ore"
)

// 定义一个接口
type Greeter interface {
    Greet() string
}

// 定义一个服务实现
type FriendlyGreeter struct{}

func (g *FriendlyGreeter) Greet() string {
    return "Hello, world!"
}

func main() {
    // 使用默认Ore容器注册服务
    ore.RegisterFunc[Greeter](ore.Singleton, func(ctx context.Context) (Greeter, context.Context) {
        return &FriendlyGreeter{}, ctx
    })

    // 从默认Ore容器解析服务
    greeter, _ := ore.Get[Greeter](context.Background())
    fmt.Println(greeter.Greet()) // 输出：Hello, world!
}

この例は、サービスの登録を示しています。ここでは、Greeter インターフェイスと FriendlyGreeter 実装を定義し、それをシングルトンとして登録し、デフォルトの Ore コンテナーを使用して解決します。

例 2: 複数の実装で使用されるキー付きサービス

package main

import (
    "context"
    "fmt"
    "github.com/firasdarwish/ore"
)

// 定义一个接口
type Greeter interface {
    Greet() string
}

// 定义多个实现
type FriendlyGreeter struct{}

func (g *FriendlyGreeter) Greet() string {
    return "Hello, friend!"
}

type FormalGreeter struct{}

func (g *FormalGreeter) Greet() string {
    return "Good day, Sir/Madam."
}

func main() {
    // 使用键注册多个实现
    ore.RegisterKeyedFunc[Greeter](ore.Singleton, func(ctx context.Context) (Greeter, context.Context) {
        return &FriendlyGreeter{}, ctx
    }, "friendly")

    ore.RegisterKeyedFunc[Greeter](ore.Singleton, func(ctx context.Context) (Greeter, context.Context) {
        return &FormalGreeter{}, ctx
    }, "formal")

    // 根据键解析特定实现
    greeter, _ := ore.GetKeyed[Greeter](context.Background(), "friendly")
    fmt.Println(greeter.Greet()) // 输出：Hello, friend!

    greeter, _ = ore.GetKeyed[Greeter](context.Background(), "formal")
    fmt.Println(greeter.Greet()) // 输出：Good day, Sir/Madam.
}

この例では、Greeter インターフェースの 2 つの実装をキー (「フレンドリー」と「フォーマル」) で登録し、必要なキーに基づいて解決します。この柔軟性により、さまざまな実装を簡単に管理できます。

---

結論

Ore は、Go 用の簡潔でシンプルかつ効率的な依存関係注入ソリューションを提供します。

Go ジェネリックス を使用することで、Ore はリフレクションによるパフォーマンスのオーバーヘッドを発生させずに、高速 と タイプセーフ の依存関係解決を提供します。柔軟で使いやすく、アプリケーションの堅牢性を確保するための Keyed Services、Placeholder Services、Validation などの機能が含まれています。

鉱石ドキュメント Web サイト

GitHub リポジトリ

以上がOre: Go 用の高度な依存性注入パッケージの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。