Architecture
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、 こちら までご連絡ください。

モジュールライフサイクル

OSGiでは、すべてのコンポーネント、Javaクラス、リソース、および記述子はモジュール(OSGiバンドル)を介してデプロイされます。 MANIFEST.MF ファイルは、モジュールがエクスポートおよびインポートするパッケージなどの物理的な特性を記述します。モジュールのコンポーネント記述ファイルには、その機能特性(つまり、コンポーネントが提供および利用するサービス)が規定されています。モジュールとその構成要素には、それぞれ独自のライフサイクルと管理APIがあります。宣言型サービスとシェルツールを使用すると、モジュールとコンポーネントのデプロイをきめ細かく制御できます。

モジュールのコンテンツはそのアクティブ化に依存するため、アクティブ化の手順を検討してください。

  1. インストール: モジュール JAR を [Liferay Home]/deploy フォルダーにコピーすると、モジュールが OSGi フレームワークにインストールされ、モジュールが インストール済み とマークされます。

  2. 解決: モジュールのすべての要件が満たされると (たとえば、インポートするすべてのパッケージが利用可能になると)、フレームワークはモジュールのエクスポートされたパッケージを公開し、モジュールを 解決済み とマークします。

  3. アクティベーション: モジュールはデフォルトで 積極的に アクティベートされます。つまり、それらはフレームワーク内で開始され、解決時に ACTIVE とマークされます。アクティブなモジュールのコンポーネントが有効になっています。モジュールが、以下のマニフェスト ヘッダーに示されているように、 遅延 アクティベーション ポリシーを指定している場合、別のモジュールがそのクラスの 1 つを要求した後にのみアクティブ化されます。

    Bundle-ActivationPolicy: lazy
    

次の図は、モジュールのライフサイクルを示しています。

この状態図は、モジュールのライフサイクルを示しています。

Apache Felix Gogo Shell を使用してライフサイクルを管理できます。モジュールをインストール/アンインストールして、それらを開始/停止することができます。モジュールを更新し、依存モジュールに更新を使用するように通知できます。 Liferay のツールには、 Liferay Workspace、 Blade CLI、 Liferay IDEなどがあり、OSGi Admin API を使用する同様のシェル コマンドを提供しています。

モジュールをアクティブ化すると、そのコンポーネントが有効になります。ただし、 が有効化された コンポーネントのみが使用できます。コンポーネントをアクティブ化するには、参照されているすべてのサービスが満たされている必要があります。つまり、コンポーネントが参照するすべてのサービスが登録されている必要があります。参照に一致する最高ランクのサービスがコンポーネントにバインドされます。コンテナは、コンポーネントが参照するすべてのサービスを見つけてバインドすると、コンポーネントを登録します。これで、アクティブ化の準備が整いました。

コンポーネントは、 遅延 (デフォルト) または 即時 アクティベーション ポリシーを使用できます。即時アクティブ化を指定するには、開発者は属性immediate=trueを@Componentアノテーションに追加します。

@Component(
    immediate = true,
    ...
)

即時アクティベーションが指定されていない限り、コンポーネントのアクティベーションは遅延されます。つまり、コンポーネントが要求されると、コンポーネントのオブジェクトが作成され、そのクラスがロードされます。このように、アクティベーションを遅らせることで、起動時間を短縮し、リソースを節約することができます。

Gogo シェルのサービスコンポーネントランタイムコマンドを使用すると、コンポーネントを管理できます。

  • scr:list [bundleID]: モジュール (バンドル) のコンポーネントを一覧表示します。

  • scr:info [componentID|fullClassName]: コンポーネントの状態や提供するサービスなど、コンポーネントについて説明します。

  • scr:enable [componentID|fullClassName]: コンポーネントを有効にします。

  • scr:disable [componentID|fullClassName]: コンポーネントを無効にします。サーバーが再起動されるまで、サーバー(またはクラスタ内の現在のサーバーノード)上で無効になっています。

サービス参照は、デフォルトでは静的であり、非推奨となっています。つまり、注入されたサービスは、サービスが無効になるまで参照コンポーネントにバインドされたままになります。あるいは、参照に対して 貪欲な サービス ポリシーを指定することもできます。上位のマッチングサービスが登録されるたびに、フレームワークは下位のサービスを(サービスポリシーがgreedyの)コンポーネントからバインド解除し、その場所に新しいサービスを自動的にバインドします。 greedyポリシーを使用する@Referenceアノテーションは次のとおりです。

@Reference(policyOption = ReferencePolicyOption.GREEDY)

Declarative Serviceアノテーションを使用して、コンポーネントのアクティブ化とサービスポリシーを指定します。 Gogo シェルコマンドを使用して、モジュールとコンポーネントを制御します。