既存の Kotlin の data class を貼り付けると、シリアライズしたときの姿をサンプルの JSON ドキュメントとして確認できます。ネストしたクラス、List/Map のプロパティ、enum もたどって埋め、@SerialName などの名前を変えるアノテーションをキーに反映します。
サーバーとアプリでモデルを共有していて、クラスが実際にどんな JSON を送受信するのかを確かめたいときや、API ドキュメントやモックサーバーにリクエストボディのサンプルが必要なときに使ってください。
import/package の行やメンバー関数は残したままで構いません。読み飛ばされます。ルート型 は 自動 のままで大丈夫です。他のクラスから参照されていない最初のクラスがルートになります。リストから特定のクラスを選ぶこともできます。Money クラス)は null で出力され、その名前がオプションの横に一覧表示されます。それらのクラスも貼り付ければ値が埋まります。@Serializable
data class Article(
val id: Long,
val title: String,
@SerialName("author_name") val authorName: String,
val status: PostStatus = PostStatus.DRAFT,
val tags: List<String> = emptyList(),
val publishedAt: Instant? = null,
@Transient val cachedHtml: String = "",
)
@Serializable
enum class PostStatus {
@SerialName("draft") DRAFT,
@SerialName("published") PUBLISHED,
}{
"id": 0,
"title": "",
"author_name": "",
"status": "draft",
"tags": [
""
],
"publishedAt": "1970-01-01T00:00:00Z"
}authorName は @SerialName によって author_name として出力され、デフォルト値の PostStatus.DRAFT は enum エントリー自身の @SerialName を通して "draft" になります。cachedHtml は @Transient が付いているので除外されます。publishedAt のようにデフォルトが null の nullable プロパティにも、null ではなく型に応じたサンプル(Instant → ISO タイムスタンプ)が入ります。
@SerialName、Jackson の @JsonProperty、Gson の @SerializedName、Moshi の @Json(name = ...)。@Transient や @JsonIgnore の付いたプロパティ、private プロパティ、by lazy のような委譲プロパティ、getter だけの計算プロパティ、const 値、companion object のメンバー。Status.PAID のようなデフォルトはそのエントリーの JSON 値になります。@SerialName を考慮したうえで最初のエントリーを使います。LocalDate → 1970-01-01、LocalDateTime → 1970-01-01T00:00:00、Instant/OffsetDateTime → Z で終わる ISO 文字列、Duration → PT0S。UUID には正しい形式の値が入ります。List、Set、Array は要素を1つ持ち、Map<Int, V> のように数値のキー型を持つマップは "0" をキーにします。null や空の配列で打ち切ります。レスポンス DTO を貼り付ければ、OpenAPI の example や README に使う JSON の骨組みが得られます。@SerialName で名前を変えたフィールドも、シリアライザーが実際に書き出す名前で表示されます。
Retrofit のインターフェースが返すモデルそのものから、MockWebServer やローカルの JSON フィクスチャのボディを作れます。仮の値(""、0)を現実的なデータに差し替えても、構造はモデルと一致したままです。
アプリが何を送るのかをサーバーチームに正確に見せたり、受け取った仕様を Kotlin のモデルと比べたりして、キー名の食い違いを実行時エラーになる前に見つけられます。
""、0、false)で、現実的なデータではありません。ドキュメントを公開する前に置き換えてください。String?)にも null ではなく型に応じたサンプルが入るので、実際に null になりうるフィールドは別途明記してください。@JsonNaming や kotlinx の JsonNamingStrategy のようなグローバルな命名ルールは反映されません。アノテーションのないプロパティは Kotlin の名前がそのままキーになります。type の識別子)や独自の KSerializer は反映されません。emptyList() や listOf(...) のような関数呼び出しで作るデフォルト値は評価せず、宣言された型から値を作ります。@Transient のプロパティが出力にありません。これで正しいですか?正しいです。kotlinx.serialization の @Transient と Jackson の @JsonIgnore はフィールドをシリアライズの対象外にするので、サンプルからも省かれます。クラス本体で宣言した private val も同じ理由で除外されます。
クラスの構文は同じなので、問題なく解析できます。Gson の @SerializedName("...") や Moshi の @Json(name = "...") による名前の変更も認識します。
= null と宣言したのに、フィールドに値が入っているのはなぜですか?目的は各フィールドの形を見せることなので、null のデフォルト値は無視して型に応じたサンプルを使います。そのおかげで、たとえば Instant? がどんな文字列形式でやり取りされるかがわかります。
同じ入力欄に続けて貼り付けてください。まだ足りない型があればオプションの横に名前が表示されるので、何を追加すればよいかがわかります。