コンフィギュレーション・ファイルのカスケード

Wrapperバージョン3.0.0から、１つのコンフィギュレーション・ファイル内に、 カスケード形式で「インクルード・ファイル（その他のファイルを埋め込む）」を指定することが可能になりました。 これは、デフォルト値として利用されるメインのコンフィギュレーション・ファイル 「wrapper.conf」を変更せずに、 デフォルト値を上書きすることができるので便利です。

シンタックス：

次のシンタックス（構造文法ルール）に従い、コンフィギュレーション・ファイルに一行を加えることで、 インクルード・ファイルを指定することができます：

#include ../conf/wrapper2.conf

階層の深さ：

インクルード・ファイルは、10階層の深さまで、ネストする（カスケードで数珠つなぎ）ことができます。

インクルード・ファイルが見つからない？：

もし何かの理由で、 指定されたファイルが指定場所に見つからない場合には、単に無視されます。 これで、「ユーザーが作成したファイル」や「未作成ファイル」のどちらも含めることができるので、 「選択肢シリーズ」を簡単に設定することが可能になります。

プロパティの優先度：

ファイル内で「インクルード・ファイル（含めるファイル）」を定義する場所（書き順）は重要です。 特に、同じプロパティ名が存在する場合に、書き順に注意してください。

「#include」行の定義を追記する場所は、コンフィギュレーション・ファイル内の一番下に記述するべきです。 例えば、 「wrapper.conf」ファイルに「File2.conf」が含まれており、 その「File2.conf」ファイルには「File3.conf」が含まれており、 さらに、その３つの各ファイルに同じプロパティ「PropertyX=valueX」が定義されている場合、 「File3.conf」ファイルのプロパティ「PropertyX=value3」が最終的に有効になります。

その他の例では、 「#include」行の定義より後ろに、同じプロパティ名がある場合は、それが優先になります。

このルールは、インクルード・ファイル内でも同様に全てのファイルに適用されます。

パス：

もし、インクルード・ファイルへのパスが相対参照で指定されている場合、 Wrapperの作業ディレクトリーを示す配置場所も、全てのパスが相対参照でなければなりませんので、注意してください。 デフォルトで、作業ディレクトリーは、 Windows上では「wrapper.exe」ファイルがある場所、 あるいは、UNIX上では「wrapper」バイナリ・ファイルがある場所です。 ［wrapper.working.dir］プロパティで、 作業ディレクトリーを変更することができますが、 完全なコンフィギュレーション・ファイルがロード（読み込み）されるまで有効になりません。 つまり、これは、ファイル参照を含めた相対参照が、常に、 本来のWrapper作業ディレクトリーへの相対参照である、という意味です。

#include.required ../conf/wrapper-settings.conf

#include.debug