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

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

GitHub リポジトリ

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

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

---

Ore の主な機(jī)能

1.

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

Ore は

Go ジェネリック

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

2.

簡単かつ柔軟な登録

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

3.

キーイングサービス

Ore では、

キー付きサービス

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

4.

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

Ore は

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

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

5.検証

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

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

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

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

6.

高性能

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

7.

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

Ore は

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

---

コード例

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

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

package main

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

// 定義一個接口
type Greeter interface {
    Greet() string
}

// 定義一個服務(wù)實(shí)現(xiàn)
type FriendlyGreeter struct{}

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

func main() {
    // 使用默認(rèn)Ore容器注冊服務(wù)
    ore.RegisterFunc[Greeter](ore.Singleton, func(ctx context.Context) (Greeter, context.Context) {
        return &FriendlyGreeter{}, ctx
    })

    // 從默認(rèn)Ore容器解析服務(wù)
    greeter, _ := ore.Get[Greeter](context.Background())
    fmt.Println(greeter.Greet()) // 輸出：Hello, world!
}

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

例 2: 複數(shù)の実裝で使用されるキー付きサービス

package main

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

// 定義一個接口
type Greeter interface {
    Greet() string
}

// 定義多個實(shí)現(xiàn)
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() {
    // 使用鍵注冊多個實(shí)現(xiàn)
    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")

    // 根據(jù)鍵解析特定實(shí)現(xiàn)
    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 つの実裝をキー (「フレンドリー」と「フォーマル」) で登録し、必要なキーに基づいて解決します。この柔軟性により、さまざまな実裝を簡単に管理できます。

---

結(jié)論

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

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

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

GitHub リポジトリ

以上がOre: Go 用の高度な依存性注入パッケージの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國語 Web サイトの他の関連記事を參照してください。