リソースバンドルの集約
ローカライズされたメッセージを共有するモジュールを操作する場合、bndヘッダは、モジュールに関連付けるリソースバンドルを指定する必要があります。 Liferayは、リソースバンドルを集約するために必要なパラメーターを自動的に指定するbnd命令を提供します。
bnd.bndファイルを開きます。-liferay-aggregate-resource-bundles:bnd命令を追加し、現在のモジュールと集約するリソースバンドルがあるモジュールのバンドルシンボリック名を割り当てます。-liferay-aggregate-resource-bundles: \ [bundle.symbolic.name1],\ [bundle.symbolic.name2]たとえば、モジュール
com.acme.able.implおよびcom.acme.baker.implのリソースバンドルを使用するモジュールは、次のように構成されます。-liferay-aggregate-resource-bundles: \ com.acme.able.impl,\ com.acme.baker.impl
現在のモジュールのリソースバンドルは、リストされているモジュールのリソースバンドルよりも優先されます。
ビルド時に、Liferayのbndプラグインは、bnd命令をRequire-CapabilityおよびProvide-Capabilityパラメーターに自動的に変換します。
Liferayのネイティブモジュールを使用してリソースを集約するには、パラメーターを手動で指定する必要があります。
参照
結果のOSGiヘッダは、jarファイルのMANIFEST.MFファイルにあります。 たとえば、モジュールのシンボリック名がcom.acme.webで、com.acme.able.implおよびcom.acme.baker.implのリソースバンドルを使用する場合、Require-Capabilityは次のようになります。
Require-Capability: liferay.resource.bundle;filter:="(bundle.symbolic.name=com.acme.able.impl)",liferay.resource.bundle;filter:="(bundle.symbolic.name=com.acme.baker.impl)"
Provide-Capabilityは次のようになります。
Provide-Capability: liferay.resource.bundle;resource.bundle.base.name="content.Language"\
liferay.resource.bundle;resource.bundle.aggregate="(bundle.symbolic.name=com.acme.web),(bundle.symbolic.name=com.acme.able.impl),(bundle.symbolic.name=com.acme.baker.impl)";\
bundle.symbolic.name="com.acme.web";resource.bundle.base.name="content.Language";\
service.ranking=1,;servlet.context.name="com.acme.web"
サンプルのProvide-Capabilityヘッダには、次の2つの部分があります。
liferay.resource.bundle;resource.bundle.base.name="content.Language"は、モジュールがベース名がcontent.languageのリソースバンドルを提供することを宣言します。liferay.resource.bundle;resource.bundle.aggregate=...ディレクティブは、リソースバンドルが集約されるバンドルのリスト、ターゲットバンドル、ターゲットバンドルのリソースバンドル名、およびこのサービスのランキングを指定します。"(bundle.symbolic.name=com.acme.web),(bundle.symbolic.name=com.acme.able.impl),(bundle.symbolic.name=com.acme.baker.impl)"：このサービスは、バンドルbundle.symbolic.name=com.acme.web（現在のモジュール）からのリソースバンドルをbundle.symbolic.name=com.acme.able.implおよびbundle.symbolic.name=com.acme.baker.implで集約します。
必要な数のバンドルを集約します。 リストされたバンドルは降順で優先されます。
bundle.symbolic.name=com.acme.web;resource.bundle.base.name="content.Language"：content.Languageという名前のcom.acme.webバンドルのリソースバンドルをオーバーライドします。service.ranking=1：リソースバンドルのサービスランキングは1です。 OSGiフレームワークは、このサービスがcom.acme.webのcontent.Languageリソースバンドルを対象とする他のすべてのリソースバンドルサービスを上回る場合、このサービスを適用します。servlet.context.name=com.acme.web：ターゲットリソースバンドルはサーブレットコンテキストcom.acme.webにあります。