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

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

GitHub リポジトリ

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

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

---

Ore の主な機(jī)能

1.

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

Ore は

Go ジェネリック

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

2.

簡単かつ柔軟な登録

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

3.

キーイングサービス

Ore では、

キー付きサービス

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

4.

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

Ore は

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

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

5.検証

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

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

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

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

6.

高性能

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

7.

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

Ore は

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

---

コード例

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

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

package main

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

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

// 定義一個(gè)服務(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"
)

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

// 定義多個(gè)實(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() {
    // 使用鍵注冊多個(gè)實(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 はリフレクションによるパフォーマンスのオーバーヘッドを発生させずに、高速 と タイプセーフ の依存関係解決を提供します。柔軟で使いやすく、アプリケーションの堅(jiān)牢性を確保するための Keyed Services、Placeholder Services、Validation などの機(jī)能が含まれています。

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

GitHub リポジトリ

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