このバージョンはまだ開発中であり、まだ安定しているとは見なされていません。最新の安定バージョンについては、Spring Cloud Config 5.0.5 を使用してください！

代替フォーマットの提供

環境エンドポイントからのデフォルトの JSON 形式は、Environment 抽象化に直接マッピングされるため、Spring アプリケーションでの利用に最適です。必要に応じて、リソースパスにサフィックス（.json、.yml、.yaml または .properties）を追加することで、同じデータをフラットな JSON オブジェクト、YAML、Java プロパティとして利用することもできます。これは、JSON エンドポイントの構造や、それらが提供する追加のメタデータに関心のないアプリケーション（たとえば、Spring を使用していないアプリケーションなど）での利用に役立ちます。このシンプルなアプローチは、こうしたアプリケーションにとってメリットとなるでしょう。

以下の URL パターンがサポートされています。

URL パターン 説明

/{application}-{profile}.json

フラットな JSON オブジェクト (すべてのアセット源から統合された)

/{label}/{application}-{profile}.json

同じ、特定のラベル (ブランチ、タグ付け、コミット)

/{application}-{profile}.yml (or .yaml)

Flat YAML representation

/{label}/{application}-{profile}.yml (or .yaml)

Same, at a specific label

/{application}-{profile}.properties

Java .properties 形式

/{label}/{application}-{profile}.properties

同じ、特定のラベル

フラットな JSON、YAML、プロパティ表現には、ソースドキュメント内のプレースホルダー（標準の Spring ${…​} 形式）をレンダリング前に可能な限り出力で解決するように指示する追加のフラグ（resolvePlaceholders というブール型クエリパラメーターとして提供）があります。これは、Spring プレースホルダーの規則を知らない利用者にとって便利な機能です。

これらのフラット形式の使用には、主にメタデータの損失に関連する制限があります。例: 完全な JSON 環境表現は、ソースと関連付けられた名前を持つプロパティソースの順序付きリストとして構成されています。フラットな JSON、YAML、プロパティ形式は、値の出所が複数のソースを持つ場合でも単一のマップに統合され、元のソースファイルの名前が失われます。また、YAML 表現も、バックエンドリポジトリ内の YAML ソースを忠実に表現しているとは限りません。これはフラットなプロパティソースのリストから構築されるため、キーの形式について仮定を置く必要があります。