name: json-to-java-record description: 將 JSON 資料片段轉換為 Java Record 類別。適用於需要從 API 回應或 JSON 資料建立強型別 Java 類別的情境。

JSON 轉 Java Record Skill

這個 Skill 幫助將原始 JSON 資料或 API 回應轉換為結構化、強型別的 Java Record 類別。

目標

將 JSON 資料自動轉換為符合 Java 21+ 標準的 Record 類別，並加上適當的 Jackson 註解。

指示說明

1. 分析輸入：查看使用者提供的 JSON 物件。

2. 推斷型別：

   • string → String
   • number（整數）→ Integer 或 Long
   • number（小數）→ Double 或 BigDecimal
   • boolean → Boolean
   • array → List<Type>
   • null → 使用 @Nullable 或 Optional<Type>
   • 巢狀物件 → 建立個別的子類別 Record

3. 遵循範例：查看 examples/ 資料夾了解如何結構化輸出程式碼。

   • 輸入：examples/input_data.json
   • 輸出：examples/UserRecord.java

   注意巢狀字典（如 preferences）如何被抽取為獨立的 Record 類別。

風格指南

• 使用 PascalCase 命名 Record 類別
• 使用 camelCase 命名欄位
• 使用 @JsonProperty 處理 JSON 欄位名稱與 Java 命名不一致的情況
• 如果欄位可能為 null，使用 @Nullable 註解
• 日期時間字串使用 LocalDateTime 或 Instant
• 加上 @JsonIgnoreProperties(ignoreUnknown = true) 忽略未知欄位

必要的 Import

import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import com.fasterxml.jackson.annotation.JsonProperty;
import java.util.List;
import java.time.Instant;

注意事項

• Record 類別是不可變的（immutable）
• 所有欄位都是 final
• 自動產生 equals()、hashCode() 和 toString()