Propertiesファイルのネスト vs フラットキー変換
.propertiesファイルをJSONに変換する際のネストオブジェクト展開とフラットキー保持を比較し、各モードの使い分けを解説します。
Conversion Modes
詳細な説明
ネスト vs フラット変換
ツールはプロパティキーをJSONに変換するための2つのモードを提供します：ネスト（ドット記法展開）とフラット（キーをそのまま保持）。適切なモードの選択はユースケースに依存します。
| ネストを使う場合 | フラットを使う場合 |
|---|---|
| YAMLやTOML形式に移行する場合 | 正確なキー名の保持が重要な場合 |
| API設定レスポンスを作成する場合 | ドットが階層的でないキーの場合 |
| 設定階層を可視化する場合 | ラウンドトリップの忠実性が必要な場合 |
競合の警告
ネストモードでは、app.dbとapp.db.hostの両方が別々のプロパティとして存在する場合に問題が発生する可能性があります。フラットモードではこの問題を完全に回避できます。
ユースケース
プロパティファイルを変換する際のネストとフラットJSON出力の選択。特にYAML/TOMLへの移行時や、ドットがオブジェクト階層ではなく命名規則を表すキーの場合。