名前がないstructを実装するとgo vetでエラーになる

Question

いつもお世話になっております。
https://github.com/deepmap/oapi-codegen というOpenAPIから
golangサーバー(自分はechoを使ってます) のスタブを出してくれるツールがあるのですが
そこで問題があります。

困っていること

時間を取り扱うOepnAPIの要素の場合、 types をgenerateすると、
下記の通り、structの実装部分でエラーになります。

func generateEstimateItem() EstimateItem {
	var item EstimateItem
	dummyTime, _ := time.Parse("2006-01-02", "2021-01-01")
	var currentDate openapi_types.Date = openapi_types.Date{dummyTime}
	return item
}

hoge:~/work/temp$ go vet ./...
# github.com/hoge/temp/api
api/server.go:27:39: github.com/deepmap/oapi-codegen/pkg/types.Date composite literal uses unkeyed fields

解消したいこと

ビルドはできるのですが go vet ./... で引っかからない、警告がでない
正しい実装を教えてください。

そもそも oapi-codegen の実装は？

package types

import (
	"encoding/json"
	"time"
)

const DateFormat = "2006-01-02"

type Date struct {
	time.Time
}

Answer 1

エラーメッセージが述べている

composite literal uses unkeyed fields

この通りで、構造体リテラルを記述するのに「フィールドキー名」を記述しましょうということです。

つまり、以下の記述は

openapi_types.Date{dummyTime}

以下の様に書きましょうという警告です。

openapi_types.Date{Time: dummyTime}

確かに単独のフイールドであれば省略しても問題ない様に見えますが、将来、openapi_types.Dateのフィールドが増えた時に前者の記述はエラーになり、後者は問題なくコンパイルできます。

補足

ちなみに同パッケージ内定義の構造体リテラルの場合、フィールド数が合っていればgo-vetによる警告は出ません。このパターンで警告になるのは外部パッケージに定義された構造体リテラルを記述するときだけです。（外部パッケージの更新により上記の様なエラーが発生するのを未然に防ぐためと思われます）

Comments

[zonamoshi]

ご回答ありがとうございます。修正できました!!!

>構造体リテラルを記述するのに「フィールドキー名」を記述しましょうということです。
deeplで警告内容はわかっていたのですがそのフィールドキー名がわかりませんでした。
この場合は型名がフィールドキー名にあたるのでしょうか？

[nobonobo]

フィールド定義では「フィールド名 型名」が一般的ですが、
「型名」だけを書くと「埋め込みフィールド」になります（埋め込まれた型の機能や振る舞いが親の型に「委譲」されます）。
「埋め込みフィールド」へのアクセスには型名を使います。

[zonamoshi]

@nobonobo
ご回答ありがとうございます。埋め込みフィールドというのですね!!
embedded field inheritanceという名前でググったらたくさん事例が出てきました。
そういうことだったのか...ご丁寧な説明痛み入ります。