2017.12.11

Go言語とDependency Injection

伊藤瑛

はじめに

こんにちは、APソリューショングループの伊藤です。このブログに記事を投稿するのは２年ぶりとなります。今回はGoに関する記事です。
この記事では下期（10月~）に私達のチームで行っている取り組みについて紹介させて頂きます。

私達リクルートテクノロジーズでは、全社で共通の開発標準として現在JavaベースのWebフレームワーク(WAF)を定めています。これらのJavaベースの技術に加えて、現在Go言語を全社的に展開しようと考え、プロトタイプ作成や実際のプロダクト開発を行ってきました。

この記事では、その中でも中核をなす技術である、Dependency InjectionのGoにおける実装について紹介をさせて頂きます。

Dependency Injectionの設計と実装

最初に、Dependency Injection(以下, DI)の意義や背景について説明しようと思います。

Interfaceによる実装の隠蔽

以下の擬似コードのように、UserServiceとUserRepositoryのモジュールがあったとして、
UserServiceがUserRepositoryに依存している(つまり内部で用いている)とします。

type UserService struct {
    repo UserRepository
    ...
}
func (s *UserService) All() ([]User, error){
    return s.repo.All()
}
...

type UserService struct {

repo UserRepository

...

}

func (s *UserService) All() ([]User, error){

return s.repo.All()

}

...

type UserRepository interface {
    All() ([]User, error)
    ...
}
func NewUserRepository() *userRepository {
    return &userRepository{}
}
type userRepository struct {...}
/* 実際の実装は割愛 */

type UserRepository interface {

All() ([]User, error)

...

}

func NewUserRepository() *userRepository {

return &userRepository{}

}

type userRepository struct {...}

/* 実際の実装は割愛 */

UserRepositoryはinterfaceとして定義されており、UserServiceの内部ではUserRepositoryの内部実装を気にすることなく使用できるようになっています。
この実装パターンはモジュール間の結合度合いを弱め、より変更に強い設計になっているかと思います。interfaceさえ変わらなければ、UserRepositoryの内部実装は他のモジュールへの影響を考慮することなく自由に変更することができます。
このケースで言うと、UserRepositoryがDBへの読み書きを担当しているモジュールだとして、UserServiceへの影響を気にすることなく、書き込み先のDBを異なるRDBへ変更したり、あるいはテスト用にインメモリのDBモックへ変更したりといったことが可能になります。

Dependency Injection

さて、上記はうまくいっている実装かのように見えますが、実は大きな問題がひとつあります。
それは、誰が、どうやってUserRepositoryを生成し、UserServiceに引き渡すかという問題です。

例えば、以下のようなコードでは破綻は目に見えているかと思います。

func (u *UserService) initRepository() {
    u.repo := NewUserRepository()
}

func (u *UserService) initRepository() {

u.repo := NewUserRepository()

}

つまり、実際のUserRepositoryの生成をUserServiceの内部に埋め込んでしまうパターンです。これでは結局UserRepositoryの実装を切り替えることができず、interfaceにした意味がありませんね。
単体テストをイメージするとわかりやすいかと思うのですが、このコードのテストコードを書こうとした場合、DBなどをStub化 / Mock化することが非常に難しく、テスタビリティにも欠けたコードだと言わざるをえないかと思います。

Dependency Injectionとはこの問題を取り扱うための実装パターンを指す用語とし、Martin Fowlerらによって定義されたものです。
Dependency Injectionでは、依存の生成を行うモジュールと、実際に依存を使用するモジュールを完全に分離するパターンです。

つまり、依存モジュールを使う側は、そのモジュールがどこで作られたのか、どうやって作られたのかの一切の知識を有さずに、外部から渡されたものをただ使うだけになります。

Dependency Inejectionには依存モジュールの渡され方によって、4つのパターンがあります。1) Constructor Injection, 2) Setter Injection, 3) Interface Injection, 4) Field Injectionです。
1), 2) は最もイメージしやすいものかと思います。その名の通り、それぞれConstructor(Goの場合はNew…で構造体の生成を行っている関数）または、依存を受けられる関数(Setter)により依存を外部から受け取るパターンです。
3), 4)に関する説明は省略させて頂きますが、特に4)はJavaの世界では一般的な方式となります。

ここで、1)のパターンのコードを見てみましょう。

type UserRepository interface {
    All() ([]User, error)
}
func NewUserRepository(db DB) UserRepository {
    return &userRepository{
        db: db,
    }
}
type userRepository struct {
    db DB
}
/* 実装は割愛 */

type UserRepository interface {

All() ([]User, error)

}

func NewUserRepository(db DB) UserRepository {

return &userRepository{

db: db,

}

type userRepository struct {

db DB

}

/* 実装は割愛 */

type UserService struct {
    repo UserRepository
}
func NewUserService(repo UserRepository) *UserService {
    return &UserService{
        repo: repo,
    }
}
func (s *UserService) All() ([]User, error) {
    return s.repo.All()
}

type UserService struct {

repo UserRepository

}

func NewUserService(repo UserRepository) *UserService {

return &UserService{

repo: repo,

}

func (s *UserService) All() ([]User, error) {

return s.repo.All()

}

上記のように、Constructorで依存性を受け取れるように実装を変更しました。
Constructor Injectionを行ってみます。

func main() {
    db := DefaultDBMod()
    repo := NewUserRepository(db) // dbモジュールをUserRepositoryに注入
    service := NewUserService(repo) // UserRepositoryをUserServiceに注入
    .....
}

func main() {

db := DefaultDBMod()

repo := NewUserRepository(db) // dbモジュールをUserRepositoryに注入

service := NewUserService(repo) // UserRepositoryをUserServiceに注入

.....

}

Constructor Injectionという名前は仰々しいですが、実際はこれだけです。
これだけで、Dependency Injectionが目的とした 生成の知識の分離 が実現できています。
今回はmain()で呼んでいますが、初期化時に呼ぶ場所であればどこでも構いません。
単体テストもとてもシンプルなものになっています。UserServiceのテストを見てみましょう。

func TestUserService_All(t *testing.T) {
    repo := &UserRepositoryStub{}
    s := NewUserRepository(repo)
    /* 以下任意にテスト */
    if _, err := s.All(); err != nil {
        t.Error(err)
    }
}
type UserRepositoryStub struct {}
func (*UserRepositoryStub) All() ([]User, error) {
    return []User{}, nil
}

func TestUserService_All(t *testing.T) {

repo := &UserRepositoryStub{}

s := NewUserRepository(repo)

/* 以下任意にテスト */

if _, err := s.All(); err != nil {

t.Error(err)

}

type UserRepositoryStub struct {}

func (*UserRepositoryStub) All() ([]User, error) {

return []User{}, nil

}

このテストコードに意味は無いですが、UserRepositoryの生成が埋め込まれ、DBのStub化が不可能だったコードに比べると、大幅な進歩だと思います。
interface化による実装の隠蔽および依存に関する知識の切り出しを行うことで、モジュールの独立性を高め、テスタビリティを向上させる。
これがDependency Injectionの大きなメリットの1つです。

DI Container

そうとは言っても、このままでは使い物にはなりません。
main()ですべての依存を生成し、コンストラクタに配って回る方式は、規模がごくごく小さければうまくいくのかもしれませんが、モジュールが数十、あるい数百数千の規模になると、破綻する未来しか見えません。
この依存の生成および注入をうまく解決してくれるのがDI Containerです。
上のmain()の内部で行っていた処理を肩代わりしてくれるもがDI Containerの本質的な役割です。

では、どのようにDI Containerを実装すればよいのでしょうか。
DI Containerと言うと、JavaのSpringなど、重厚で複雑な仕組みがあるのかとイメージしがちですが（私もそうでした）、main()の中身を見れば分かる通り、本質的には非常にシンプルです。

以下の機能を持ったモジュールを実装すれば良いわけです。

モジュールの生成の方法を登録することが出来る。
モジュールを取り出す時に、登録した方法でモジュールが生成される（遅延実行される）。

実際にコードを見たほうが早いと思うので、DI Containerのサンプルコードを記述します。

// モジュールの生成の方法を表す関数
type Builder(con Container) interface{}
// モジュール名と生成の方法の構造体
type Definition struct {
    Name string
    Builder Builder
}
// DI Container
type Container struct {
    store map[string]Builder
}
func NewContainer() *Container {
    return &Container{
        store: map[string]Builder{},
    }
}
// DI Containerにモジュールを登録する
func (c *Container) Register(d *Definition) {
    c.store[d.Name] = d.Build
}
// DI Containerからモジュールを取り出す
func (c *Container) Get(key string) interface{} {
    builder, _ := c.store[key]
    instance := builder(c)
    return instance
}

// モジュールの生成の方法を表す関数

type Builder(con Container) interface{}

// モジュール名と生成の方法の構造体

type Definition struct {

Name string

Builder Builder

}

// DI Container

type Container struct {

store map[string]Builder

}

func NewContainer() *Container {

return &Container{

store: map[string]Builder{},

}

// DI Containerにモジュールを登録する

func (c *Container) Register(d *Definition) {

c.store[d.Name] = d.Build

}

// DI Containerからモジュールを取り出す

func (c *Container) Get(key string) interface{} {

builder, _ := c.store[key]

instance := builder(c)

return instance

}

例外処理や諸々の仕組みは省いていますが、これでDI Containerの実装は終わりです。
実際に使ってみましょう。

container := NewContainer()
rd := &Definition{
    Name: "UserRepository",
    Builder: func(c *Contaier) interface{} {
        return NewUserRepository()
    },
}
container.Register("UserRepository", rd)
sd := &Definition{
    Name: "UserService",
    Builder: func(c *Container) interface{} {
        repo, _ := c.Get("UserRepository").(UserRepository)
        return NewUserService(repo)     
    },
}
container.Register("UserService", sd)
// ここで取り出されるServiceにはすでにRepositoryがセット済
service := container.Get("UserService")

container := NewContainer()

rd := &Definition{

Name: "UserRepository",

Builder: func(c *Contaier) interface{} {

return NewUserRepository()

}

container.Register("UserRepository", rd)

sd := &Definition{

Name: "UserService",

Builder: func(c *Container) interface{} {

repo, _ := c.Get("UserRepository").(UserRepository)

return NewUserService(repo)

}

container.Register("UserService", sd)

// ここで取り出されるServiceにはすでにRepositoryがセット済

service := container.Get("UserService")

如何でしょうか？DI Containerと聞くと身構えてしまいそうな気もしますが、本質はこれで十分です。
Builderの第一引数にContainerが渡され、そこから依存を引っ張ってこれること、生成時に初めてBuilderが実行され依存の解決がなされることの2点が重要なポイントになっています。
実際には一度生成したモジュールはキャッシュに保存し、再生成のコストを下げること、Circular Dependenciesに対する対処、型キャストに対する例外処理など、実際に適用する場合にはもう少し複雑な処理が必要ですが、DI Containerの挙動を把握するにはこれで必要十分かと思います。

main()など、初期化時にContainerに対し生成の仕方をそれぞれ登録し、実際に使う場面になって初めてモジュールを生成する、これにより、DIによるモジュールの独立性は保ちつつも、一つの場所ですべて初期化を行っていたような以前のコードに比べると大分現実的なコードになってきたかと思います。

dicon

さて、前置きは長くなってしまいましたが、私が個人のプロダクトとして開発し、現在プロジェクトに導入しているDI Containerの生成ツール、diconについて紹介させて頂きます。

上記のDI Containerでも本質的には十分なのですが、個人的に改善したいポイントが2つありました。

interface{} でwrapしてしまうため、型が壊れ、コンパイラの恩恵を受けられない。
Builderの実装が煩雑

この問題を解決するため、モジュールのAST(抽象構文木)を解析し、自動で依存関係を読み取り、DIコンテナは自動生成してくれるツール、diconを作成しました。(ちなみにSeasar2のdiconはDI CONfigurationでしたが、このdiconはDI CONtainerです。)

diconの使い方 (Generate)

diconでは、まずユーザは通常と同様にConstructor Injectionを行えるようにモジュールを実装します。なお、DI可能なモジュールはすべてinterfaceに限定されるので注意してください。

type UserRepository interface {
    All() ([]User, error)
}
func NewUserRepository() (UserRepository, error) {
    return &userRepository{}, nil
}
type userRepository struct {}
/* 実装は割愛 */

type UserRepository interface {

All() ([]User, error)

}

func NewUserRepository() (UserRepository, error) {

return &userRepository{}, nil

}

type userRepository struct {}

/* 実装は割愛 */

type UserService interface {
    All() ([]User, error)
}
func NewUserService(repo UserRepository) UserService {
    return &userService{
        repo: repo,
    }, nil
}
type userService struct {
    repo UserRepository
}
func (s *UserService) All() ([]User, error) {
    return s.repo.All()
}

type UserService interface {

All() ([]User, error)

}

func NewUserService(repo UserRepository) UserService {

return &userService{

repo: repo,

}, nil

}

type userService struct {

repo UserRepository

}

func (s *UserService) All() ([]User, error) {

return s.repo.All()

}

この際、コンストラクタの名前は必ずNew + interface名になるようにします。
例えば、UserServiceのコンストラクタは必ずNewUserServiceとなります。シグネチャは(interface名, error)のタプル固定となります。

次に、ContainerのBaseとなるinterfaceを定義します。

// +DICON
type Container interface {
    UserService() (UserService, error)
    UserRepository() (UserRepository, error)
}

// +DICON

type Container interface {

UserService() (UserService, error)

UserRepository() (UserRepository, error)

}

メソッドにはそれぞれのinterface名と同一のメソッド名を定義します。シグネチャは、引数なし、返り値は(interface名, error)固定になります。これがDI Containerに対し、Builderを登録するのと同義になります。
また、diconにコンテナのinterfaceであることを明示するため、必ず// +DICONというコメントを記述してください。

ここまでが準備になります。実際やることといえば、contaierに1行メソッドを追加するだけなので、簡単な作業かと思います。

あとは、コマンドラインから以下のように実行します。

$ dicon generate --pkg sample

1	$ dicon generate --pkg sample

DI対象が存在するパッケージを明示することを忘れないでください。（現在はサブパッケージを明示的に指定しないと動作しない仕様になっております）。
すると、dicon_gen.go というファイルがcontainerを定義したパッケージと同じパッケージに生成されているはずです。
このファイルが定義したContainer interfaceの実装となっており、内部でコンストラクタのシグネチャを読み取り、依存性を解決した上でインスタンスを返却してくれるような作りになっています。実際に使用する場合は以下のようになります。

di := NewDIContainer() // DI Containerのコンストラクタも自動生成されます
service, _ := di.UserSerivce() // UserRepositoryが注入されたモジュールが返ってくる

di := NewDIContainer() // DI Containerのコンストラクタも自動生成されます

service, _ := di.UserSerivce() // UserRepositoryが注入されたモジュールが返ってくる

上記のBuilderを登録するタイプのDI Containerに比べると、非常に簡単になったのではないでしょうか。
また、予めContainerに型を明示した上でメソッドを定義し、その実装を自動生成する形を取っているので、interface{}からキャストする必要がなく、型が壊れないため、コンパイラの恩恵を受けることができます。

diconではConstructorの名前とシグネチャを規約で縛ることにより、Builderの定義を不要にし、また、予めinterfaceに型を明記することにより、実行時の型キャストを排除した実装となります。

diconの規約をまとめますと、

DI可能なモジュールはinterface限定
DIするモジュールのConstructor名は固定
DIするモジュールの依存性はすべてConstructorで受け取り、Constructorの返り値のシグネチャは固定

上記の規約を厳しすぎるとするかどうかはプロジェクト次第かと思いますが、私はこの規約は許容可能な範囲であると捉えています。

おわりに

少し長くなってしまいましたが、DIの意義、DI Containerの実装、 GoにおいてDI Containerの作成を支援するツール、dicon の紹介を行いました。実はdiconにはMockの自動作成などの機能もありますので、興味がある方はGithubの方を見ていただければと思います。現在diconは私の個人プロダクトという位置付けですが、全社で採用されることになりましたら、社のレポジトリに移管したいと思っております。

今回の記事ではDIのみしか触れられませんでしたが、Go言語を用いたWeb開発および全社標準化の取り組みについて、また機会があれば紹介させていただきたいと思います！

それでは失礼します。

参考文献

Martin Fowler: Inversion of Control Containers and Dependency Injection pattern
アイキャッチ画像はこちらから借用させて頂きました。

Recruit Tech Blog

タグから見つける

タグから見つける

職種を選択

事業領域を選択

Go言語とDependency Injection

はじめに

Dependency Injectionの設計と実装

Interfaceによる実装の隠蔽

Dependency Injection

DI Container

dicon

diconの使い方 (Generate)

おわりに

参考文献