Goの構造体には 埋め込みフィールド(Embedded Field)について

Goの構造体には 埋め込みフィールド(Embedded Field) という機能があります。

これは、ある構造体の中に別の構造体をフィールドとして埋め込むことで、フィールドやメソッドを外側の構造体から直接参照できるようにする機能です。

1. 基本的な使い方

通常の構造体フィールドと比較してみます。

通常のフィールド

type Address struct {
    City string
}

type User struct {
    Name    string
    Address Address
}

func main() {
    user := User{
        Name: "Taro",
        Address: Address{
            City: "Tokyo",
        },
    }

    fmt.Println(user.Address.City)
}

この場合、Address というフィールド名を経由してアクセスします。

埋め込みフィールド

type Address struct {
    City string
}

type User struct {
    Name string
    Address
}

func main() {
    user := User{
        Name: "Taro",
        Address: Address{
            City: "Tokyo",
        },
    }

    fmt.Println(user.City)
}

Address をフィールド名として明示せず、型名だけで宣言しています。

これが埋め込みフィールドです。

user.City のように、外側の構造体から直接アクセスできます。

2. メソッドも引き継がれる

埋め込みフィールドの大きな特徴は、埋め込んだ型のメソッドも外側の構造体から呼び出せることです。

type Logger struct{}

func (l Logger) Log(message string) {
    fmt.Println(message)
}

type UserService struct {
    Logger
}

func main() {
    service := UserService{}

    service.Log("Hello")
}

UserService 自体には Log メソッドを定義していませんが、Logger のメソッドを呼び出せます。

ただし、これは継承とは異なります。Goではメソッドのプロモーション(Promotion)と呼ばれる仕組みです。

3. ポインタ型も埋め込める

埋め込みフィールドにはポインタ型も使用できます。

type Logger struct{}

func (l *Logger) Log(message string) {
    fmt.Println(message)
}

type UserService struct {
    *Logger
}

func main() {
    service := UserService{
        Logger: &Logger{},
    }

    service.Log("Hello")
}

*Logger を埋め込むことで、ポインタレシーバのメソッドも利用できます。

4. フィールド名が重複した場合

複数の構造体を埋め込んだ場合、同じ名前のフィールドやメソッドが存在することがあります。

type A struct {
    Name string
}

type B struct {
    Name string
}

type User struct {
    A
    B
}

この場合、

user := User{}

user.A.Name // OK
user.B.Name // OK

user.Name // コンパイルエラー

どちらの Name を参照すべきか判断できないため、直接アクセスできません。

5. 通常のフィールドとの比較

項目 通常のフィールド 埋め込みフィールド
宣言 Address Address Address
フィールドアクセス user.Address.City user.City
メソッドのプロモーション なし あり
型として保持 する する
継承 なし なし

● 埋め込みフィールドがすでに持っているメソッドと命名が被った場合どうなるのか?

Goでは、外側の構造体(埋め込む側)が同じ名前のメソッドをすでに持っている場合、外側の構造体のメソッドが優先されます。

埋め込んだ型のメソッドが上書きされるわけではありません。

例

type Logger struct{}

func (l Logger) Log() {
    fmt.Println("Logger")
}

type UserService struct {
    Logger
}

// UserServiceにも同じ名前のメソッドを定義
func (u UserService) Log() {
    fmt.Println("UserService")
}

実行すると次のようになります。

service := UserService{}

service.Log()
// UserService

service.Logger.Log()
// Logger

どういう仕組みなのか

Goでは、外側の構造体自身が持つメソッドと、埋め込みフィールドからプロモーションされたメソッドでは、外側のメソッドが優先されます。

呼び出し 実行されるメソッド
service.Log() UserService.Log()
service.Logger.Log() Logger.Log()

PHP Traitとの違い

PHPではTraitとクラス自身に同名メソッドがある場合、クラス自身のメソッドが優先されます。

この点についてはGoも似ています。

ただし、Goの場合は埋め込んだ型が独立した構造体として存在しているため、service.Logger.Log() とすれば元のメソッドにもアクセスできます。

つまり、Goの埋め込みフィールドでは、同名メソッドがあってもコンパイルエラーにはならず、外側の構造体のメソッドが優先されます。

No.2782
11/20 09:23

edit