Documentation

リソースバンドルの集約

ローカライズされたメッセージを共有するモジュールを操作する場合、bndヘッダは、モジュールに関連付けるリソースバンドルを指定する必要があります。 Liferayは、リソースバンドルを集約するために必要なパラメーターを自動的に指定するbnd命令を提供します。

  1. bnd.bndファイルを開きます。

  2. -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つの部分があります。

  1. liferay.resource.bundle;resource.bundle.base.name="content.Language"は、モジュールがベース名がcontent.languageのリソースバンドルを提供することを宣言します。

  2. 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.webcontent.Languageリソースバンドルを対象とする他のすべてのリソースバンドルサービスを上回る場合、このサービスを適用します。

    • servlet.context.name=com.acme.web:ターゲットリソースバンドルはサーブレットコンテキストcom.acme.webにあります。