モジュールライフサイクル
OSGiでは、すべてのコンポーネント、Javaクラス、リソース、および記述子はモジュール(OSGiバンドル)を介してデプロイされます。 MANIFEST.MF ファイルは、モジュールがエクスポートおよびインポートするパッケージなどの物理的な特性を記述します。モジュールのコンポーネント記述ファイルには、その機能特性(つまり、コンポーネントが提供および利用するサービス)が規定されています。モジュールとその構成要素には、それぞれ独自のライフサイクルと管理APIがあります。宣言型サービスとシェルツールを使用すると、モジュールとコンポーネントのデプロイをきめ細かく制御できます。
モジュールのコンテンツはそのアクティブ化に依存するため、アクティブ化の手順を検討してください。
-
インストール: モジュール JAR を
[Liferay Home]/deployフォルダーにコピーすると、モジュールが OSGi フレームワークにインストールされ、モジュールがインストール済みとマークされます。 -
解決: モジュールのすべての要件が満たされると (たとえば、インポートするすべてのパッケージが利用可能になると)、フレームワークはモジュールのエクスポートされたパッケージを公開し、モジュールを
解決済みとマークします。 -
アクティベーション: モジュールはデフォルトで 積極的に アクティベートされます。つまり、それらはフレームワーク内で開始され、解決時に
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 シェルコマンドを使用して、モジュールとコンポーネントを制御します。