【Go言語】埋め込んだ構造体のフィールドやメソッドを同階層にあるとして扱える話

構造体の埋め込みについて

例えば人を定義するとき、その構造体の中に「住所」という情報を混ぜることになったとします。このとき、以下のように構造体の中で構造体を利用することになります。これを構造体の埋め込みと言います。

package main

import "fmt"

type Address struct {
	Street     string
	City       string
	PostalCode int
}

type Person struct {
	FirstName string
	LastName  string
	Age       int
	Address
}

フィールドへのアクセス

このとき、Addressの中のStreetフィールドの値を利用するときは以下のようにアクセスすると思います。

func main() {
	p := Person{
		FirstName: "John",
		LastName:  "Doe",
		Age:       30,
		Address: Address{
			Street:     "123 Main St",
			City:       "Anytown",
			PostalCode: 12345,
		},
	}

	fmt.Println(p.Address.Street)
}

しかし、Go言語ではこのようにPerson構造体を宣言すると、インスタンス利用時には埋め込んだAddress構造体のフィールドがあたかも同階層で宣言されたかのようにアクセスすることが可能になります。

// 以下は同じ結果になる

fmt.Println(p.Address.Street)
// 123 Main St

fmt.Println(p.Street)
// 123 Main St

これはプロパティだけではなく、メソッドでも同じようにアクセスすることが可能になります。

Address構造体にGetAddress()をメソッドとして定義します。
この場合も同様に同階層にあるようにアクセスすることが可能になります。

func (a Address) GetAddress() string {
	return fmt.Sprintf("%s, %s, %d", a.Street, a.City, a.PostalCode)
}

func main() {
	p := Person{...

    // 以下2つは同じ結果
	fmt.Println(p.Address.GetAddress())
    fmt.Println(p.GetAddress())
}

複数の埋め込みと同名のフィールドがある場合

同名のフィールドがある場合は上記のようにアクセスすることはできなくなりエラーになります。
以下の場合コンパイルエラーになります。

type Address struct {
	Street     string
	City       string
	PostalCode int
}

type Person struct {
	FirstName string
	LastName  string
	Age       int
	Address
	ContactInfo
}

type ContactInfo struct {
	Email       string
	PhoneNumber string
	City        string
}

func main() {
	p := Person{...

	// Error : ambiguous selector p.City compiler(AmbiguousSelector)
	fmt.Println(p.City)
}

そのため上記のような場合はフィールド・メソッドともにどの構造体のフィールドにアクセスするのかを明示する必要が発生します

fmt.Println(p.Address.City)
fmt.Println(p.ContactInfo.City)

個人的には同階層として扱える状況でもどの構造体のフィールドにアクセスしているのか明示するほうが可読性が向上すると思いました