合成と埋め込み

既存の構造体の機能を、別の構造体で再利用したい場面があります。Goでは、他の構造体を自分の一部として組み込む 合成(composition) の書き方でこれを実現します。

Goで合成を実現する書き方は大きく2つあります。

  • ネスト: 他の構造体をフィールドとして書き入れる方法。「User は Address を持っている」といった所有関係を自然に表現できる
  • 埋め込み: フィールド名なしで書き入れる方法。埋め込まれた型のフィールドやメソッドが「昇格」して、外側の型が直接持っているように使える

順に見ていきます。

1. ネスト

構造体の中に別の構造体を持たせることができます。書き方は以下のとおりです。フィールドの型として別の構造体名を書きます。

type 内側の型 struct {
    // ...
}

type 外側の型 struct {
    フィールド名 内側の型
    // ...
}

次のコードは、住所を表す Address を User の中に持たせる例です。

package main

import "fmt"

type Address struct {
    City string
    Zip  string
}

type User struct {
    Name    string
    Age     int
    Address Address
}

func main() {
    u := User{
        Name: "Taro",
        Age:  30,
        Address: Address{
            City: "Tokyo",
            Zip:  "100-0001",
        },
    }

    fmt.Println(u)
    fmt.Println(u.Address.City)
}

以下のような実行結果が表示されます。

{Taro 30 {Tokyo 100-0001}}
Tokyo

u 全体を表示すると内部の Address もまとめて出力され、u.Address.City でネストしたフィールドに直接アクセスできました。

コードを解説します。

type User struct {
    Name    string
    Age     int
    Address Address
}

User の Address フィールドの型として、別の構造体 Address を指定しています。これで User は Address を1つ内部に持つ構造になります。

Address: Address{
    City: "Tokyo",
    Zip:  "100-0001",
},

初期化するときは、Address フィールドにさらに Address{} の初期化子を渡します。

fmt.Println(u.Address.City)

ネストしたフィールドは . を続けて u.Address.City のように辿って参照します。

2. 埋め込み

ネストは「User は Address を持っている」を自然に表現できますが、u.Address.City のように毎回ネストしたフィールドを辿る必要がありました。埋め込み を使うと、フィールドやメソッドを外側の型で直接使えるようになり、より短く書けます。書き方は以下のとおりです。ネストと違い、フィールド名を書かずに埋め込みたい型名だけを書きます。

type 外側の型 struct {
    埋め込む型
    // 他のフィールド
}

次のコードは、Animal の機能(Name フィールドと Speak メソッド)を Dog に埋め込みで再利用する例です。

package main

import "fmt"

type Animal struct {
    Name string
}

func (a Animal) Speak() string {
    return a.Name + " が鳴きます"
}

type Dog struct {
    Animal
    Breed string
}

func main() {
    d := Dog{
        Animal: Animal{Name: "Pochi"},
        Breed:  "Shiba",
    }

    fmt.Println(d.Name)
    fmt.Println(d.Speak())
    fmt.Println(d.Breed)
}

以下のような実行結果が表示されます。

Pochi
Pochi が鳴きます
Shiba

Dog は Animal を埋め込んでいるため、d.Animal.Name と書かずに d.Name で直接アクセスでき、Speak() も d.Speak() で呼び出せました。

コードを解説します。

type Dog struct {
    Animal
    Breed string
}

Dog の1行目に Animal(フィールド名なし)を書いています。これが埋め込みで、Animal のフィールドとメソッドが Dog の中から直接見えるようになります。

d := Dog{
    Animal: Animal{Name: "Pochi"},
    Breed:  "Shiba",
}

埋め込んだ Animal を初期化するには、フィールド名として Animal を指定し、その値として Animal{...} を渡します。

fmt.Println(d.Name)
fmt.Println(d.Speak())

d.Animal.Name と書かずに d.Name で直接アクセスでき、Speak() も d.Speak() として呼び出せます。埋め込みによって、Animal のフィールドとメソッドがあたかも Dog 自身のものであるかのように振る舞います。

埋め込みはあくまでフィールドとメソッドの委譲にすぎません。外側の型が埋め込んだ型そのものになるわけではなく、「その型を持っている」という関係を短く書けるようにする仕組みだと理解しておくと迷いにくくなります。