閲覧できるドキュメントです。DBとは直接関係ありませんが、DBの接続情報などの環境ごとの管理に困る現場も多いため、少し手を延ばしてDBFluteでサポートしています。PropertiesのトラブルPropertiesファイルで設定やメッセージを管理する際の一番の悩みは、環境や言語ごとに分離されたファイルの内容の食い違いです。以下のようなトラブルをよく見かけます。本番に結合テスト用の値が設定されてて(結合用からコピーしたから...)、本番でおかしな動きどんなに気をつけていてもなかなかなくなりません。いや、他にもやることがたくさんあって、じっくり気をつけてる暇がないということもあるでしょう。プロパティの追加や変更が一つや二つとは限りませんから。(非常に多くのプロパティが一気に追加や変更されることも)Propertiesの問題点ずばり、環境や言語ごとにファイルが分離してしまい、横断チェックが大変なこと。プロパティ値はそれぞれ変わるのでDIFFツールでのチェックもしづらいもの。PropertiesHTMLで解決やはり、キーだけの差分を知りたい。一つ一つのキーごとに環境や言語ごとに分かれたプロパティ値を並べて確認したい。特化したDIFFツール、閲覧ツールが欲しい。1.0.1以下は、sea_env.propertiesという名前の環境系設定ファイルを、開発環境と結合テストと本番のものを比較したものです。Key)が表示され、食い違いが一目瞭然です。プロパティにおける、環境ごとに横断的なVIEW部分の例です。開発環境と結合テストと本番でどのようなプロパティ値が定義されているかが一目瞭然です。本番でしかテストができません。設定ファイル、メッセージリソースと思っても、プログラムよりもテストがしづらく、本番でのトラブルに直結するものであると忘れてはいけません。差異がないよう設定ミスがないよう頑張って目視のチェックは必要ですが、PropertiesHtmlがそれを支援するツールとなればと。大きく二つのパートに分かれています。Key)が表示されます。ファイル名から取得された名前が表示されます。ファイル内に同じ名前のキーが二つ以上あった場合にそのキーが表示されます。一つのファイル内にキーが重複してうれしいことはまずないので、表示されたらチェックが必要です。環境や言語ごとのプロパティの有無の差分です。プロパティのキー構成に食い違いが発生しているというのは、通常は良い状態とは言えないので、表示されたらチェックが必要です。オーバーライドや継承していることで、(アプリケーションとしては正常な状態でも)差が出てくる可能性はあります。1.0.3)、かつ、緑色で(override)や(extends)などのマークが一緒に表示されます。赤字のものが要チェックです。Key)に該当する環境(Env)ごと言語(Lang)ごとのプロパティ値(Property)が一覧で表示されます。環境や言語の表現方法はDIFFパートと同じです。ユニークNoと呼び、分かれたファイル間でプロパティ値が同じものを探すのに役に立ちます。同じ番号であれば同じ値であると言えます。プロパティ値を見ればわかる話でもありますが、長く複雑な値の場合などは目視で確認するのも大変です。このユニークNoでどことどこが同じ値なのかがすぐにわかります。プロパティコメントプロパティ定義の直上の行コメント(#始まり)に書いたコメント(Comment)が一緒に表示されます。jdbc:mysql://localhost:3306/integrationdbコメントを積極的に付けることで、Propertiesファイル上でもPropertiesHTMLでもわかりやすくなります。メッセージリソース系はあまり付ける感じにはなりませんが、コンフィグ系のPropertiesではとても有効なので、何の設定なのかを説明するコメントを書いていくと良いでしょう。この行コメントの中で、制御用のアノテーションを付与することもできます。整合性のチェックにもつながります。暗黙のオーバーライドを阻止PropertiesHTMLの作り方dfpropの設定PropertiesHTMLは、Docタスクで自動生成されます。