Goの構造体には 埋め込みフィールド(Embedded Field) という機能があります。
これは、ある構造体の中に別の構造体をフィールドとして埋め込むことで、フィールドやメソッドを外側の構造体から直接参照できるようにする機能です。
通常の構造体フィールドと比較してみます。
通常のフィールド
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 のように、外側の構造体から直接アクセスできます。
埋め込みフィールドの大きな特徴は、埋め込んだ型のメソッドも外側の構造体から呼び出せることです。
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)と呼ばれる仕組みです。
埋め込みフィールドにはポインタ型も使用できます。
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 を埋め込むことで、ポインタレシーバのメソッドも利用できます。
複数の構造体を埋め込んだ場合、同じ名前のフィールドやメソッドが存在することがあります。
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 を参照すべきか判断できないため、直接アクセスできません。
| 項目 | 通常のフィールド | 埋め込みフィールド |
|---|---|---|
| 宣言 | 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とクラス自身に同名メソッドがある場合、クラス自身のメソッドが優先されます。
この点についてはGoも似ています。
ただし、Goの場合は埋め込んだ型が独立した構造体として存在しているため、service.Logger.Log() とすれば元のメソッドにもアクセスできます。
つまり、Goの埋め込みフィールドでは、同名メソッドがあってもコンパイルエラーにはならず、外側の構造体のメソッドが優先されます。