OSGiとモジュール性
モジュール性があることで、特にチームとしてソフトウェアを作成することが楽しくなります。 Liferayでのモジュール開発の利点は次のとおりです。
- Liferayのランタイムフレームワークは、軽量、高速、安全です。
- このフレームワークは OSGi 規格を使用します。 他のプロジェクトでOSGiを使用した経験がある場合は、既存の知識を生かすことができます。
- モジュールは、サービスレジストリにサービスを公開し、サービスレジストリからサービスを利用します。 サービス契約はサービス・プロバイダーとコンシューマから疎結合されており、レジストリが契約を自動的に管理します。
- モジュールの依存関係は、コンテナによって自動的に、かつ動的に管理されます(再起動は必要ありません)。
- コンテナはモジュールのライフサイクルを動的に管理します。 Liferayの実行中にモジュールのインストール、開始、更新、停止、およびアンインストールができるため、デプロイメントを簡単に行うことができます。
- パッケージが明示的にエクスポートされているモジュールのクラスのみが公開されます。 OSGiは、デフォルトで他のすべてのクラスを非表示にします。
- モジュールとパッケージはセマンティックにバージョン管理され、他のパッケージの特定のバージョンへの依存関係を宣言します。 これにより、同じパッケージの異なるバージョンに依存する2つのアプリケーションが、それぞれ独自のバージョンのパッケージに依存することができます。
- チームメンバーは、モジュールを並行して開発、テスト、および改善できます。
- 既存の開発者ツールと環境を使用してモジュールを開発できます。
OSGiによるモジュール型ソフトウェア開発には多くのメリットがありますが、ここではその一部をご紹介します。 一度モジュール開発を始めると、他の方法での開発には戻れなくなるかもしれません。
Liferayでは、一般的に3種類のモジュールを使用します。
-
API モジュールはインターフェイスを定義します。
-
実装 モジュールは、インターフェイスを実装する具象クラスを提供します。
-
クライアント モジュールはAPIを消費します。
Gogo シェルでユーザーが名前を入力したときにあいさつ文を表示する簡単なコマンドを開発することで、それぞれを作成する方法を学習します。
モジュールプロジェクトがどのように見えるかを確認し、Liferayのモジュール開発機能が実際に動作しているのを見てみましょう。
Gogo シェルコマンドの例をデプロイする
新しいLiferay インスタンスを起動し、以下を実行します。
docker run -it -m 8g -p 8080:8080 。
http://localhost:8080でLiferayへのサインインします。 メールアドレス test@liferay.com とパスワード test を使用してください。 プロンプトが表示されたら、パスワードを learn に変更します。
次に、次の手順に従ってサンプルをデプロイします。
-
liferay-r9u2.zip
をダウンロードして解凍します。curl https://resources.learn.liferay.com/dxp/latest/en/liferay-internals/architecture/liferay-r9u2.zip -O
unzip liferay-r9u2.zip
-
サンプルモジュールをデプロイします。
cd liferay-r9u2.zip
./gradlew deploy -Ddeploy.docker.container.id=$(docker ps -lq)
-
Dockerコンテナコンソールでデプロイを確認します。
STARTED com.acme.r9u2.api_1.0.0 STARTED com.acme.r9u2.impl_1.0.0 STARTED com.acme.r9u2.osgi.commands_1.0.0
-
Gogo シェルを開きます。
-
Gogo シェルコマンドフィールドに、
r9u2:greet
コマンドを入力して、あいさつ文を生成します。r9u2:greet "Captain Kirk"
-
出力を確認します。
Hello Captain Kirk!
この例のクライアントモジュールは、APIおよび実装モジュールを利用して、r9u2:greet
Gogo シェルコマンドから返されるコンテンツを生成します。 次に、各モジュールを調べます。
API
APIモジュールが最初です。 これは、プロバイダーが実装し、コンシューマが使用する契約を定義します。 その構造は次のとおりです。
[project root]
└── r9u2-api
│ ├── bnd.bnd
│ ├── build.gradle
│ └── src
│ └── main
│ └── java
│ └── com/acme/r9u2
│ └── Greeter.java
│
└── [Gradle files]
r9u2-api
モジュールフォルダには、bnd.bnd
メタデータファイル、 build.gradle
スクリプト、およびJavaコードが含まれています。
非常にシンプルです。 Javaソースファイル以外には、Gradleビルドスクリプト(任意のビルドシステムを使用できます)とbnd.bnd
という構成ファイルの2つのファイルしかありません。 bnd.bnd
ファイルは、モジュールの説明と設定を行います。
Bundle-Name: Acme R9U2 API
Bundle-SymbolicName: com.acme.r9u2.api
Bundle-Version: 1.0.0
Export-Package: com.acme.r9u2
The build.gradle
file specifies the module’s dependencies.
dependencies {
compileOnly group: "com.liferay.portal", name: "release.portal.api"
}
これは、LiferayリリースのAPI JARという1つのアーティファクトに依存しています。 これは、Liferay製品のリリースに関連するLiferay、Bnd、OSGiのアーティファクトを詰め込んだ大きなJARです。
モジュールの名前は Acme R9U2 API です。 そのシンボリック名(一意性を確保するための名前)は com.acme.r9u2.api
です。 次にそのセマンティックバージョンが宣言され、そのパッケージが エクスポート されます。つまり、他のモジュールで使用できるようになります。 このモジュールのパッケージは、他のモジュールが実装できるAPIに過ぎません。
最後に、Javaクラスがあります。この場合はインターフェイスです。
@ProviderType
public interface Greeter {
public void greet(String name);
}
インターフェイスの@ProviderType
アノテーションは、インターフェイスを実装しているものがプロバイダーであることをサービスレジストリに通知します。 インターフェイスの1つのメソッドはString
を要求し、何も返しません。
これで完了です。 ご覧のとおり、モジュールの作成は他のJavaプロジェクトの作成と大差ありません。
実装
インターフェイスはAPIを定義しているだけです。何かをするためには、それを実装する必要があります。 これが、実装(またはプロバイダー)モジュールの目的です。 Greeter APIの実装モジュールは次のようになります。
[project root]
└── r9u2-impl
│ ├── bnd.bnd
│ ├── build.gradle
│ └── src
│ └── main
│ └── java
│ └── com/acme/r9u2/internal
│ └── R9U2Greeter.java
│
└── [Gradle files]
APIモジュールと同じ構造、つまりビルドスクリプト、bnd.bnd
構成ファイル、および実装クラスがあります。 唯一の違いはファイルのコンテンツです。 bnd.bnd
ファイルが少し異なります。
Bundle-Name: Acme R9U2 Implementation
Bundle-SymbolicName: com.acme.r9u2.impl
Bundle-Version: 1.0.0
バンドル名、シンボル名、バージョンはすべて API と同様に設定される。
最後に、Export-Package
宣言はない。クライアント(これはプロジェクトの3番目のモジュールである)はAPIを使いたいだけである。APIが返すべきものを返す限り、その実装がどのように動作するかは気にしない。クライアントはAPIへの依存を宣言するだけでよく、サービスレジストリは実行時に適切な実装を注入する。
なかなかクールだろう?
あとは、実装を提供するクラスだけだ:
@Component(service = Greeter.class)
public class R9U2Greeter implements Greeter {
@Override
public void greet(String name) {
System.out.println("Hello " + name + "!");
}
}
greet
メソッドの例では、指定された名前を使用して熱烈な挨拶文を出力します。
実装モジュールのbuild.gradle
ファイルは以下のとおりです。
dependencies {
compileOnly group: "com.liferay.portal", name: "release.portal.api"
compileOnly project(":r9u2-api")
}
このファイルには、モジュールのGreeter
クラスが必要なため、r9u2-api
モジュールプロジェクトへのコンパイル時の依存関係が含まれています。
実装モジュールについてはこれですべてです。
クライアント
コンシューマまたはクライアントは、APIモジュールが定義し実装モジュールが実装するAPIを使用します。 Liferayにはさまざまな種類のコンシューマモジュールがあります。 ポートレットは最も一般的なコンシューマモジュールタイプですが、それ自体がトピックであるため、この例ではApache Felix Gogoシェルのコマンドを作成することでシンプルなままにしています。 もちろん、コンシューマはさまざまなAPIを利用して機能を提供することができます。
コンシューマモジュールは、他のモジュールタイプと同じ構造を持っています。
[project root]
└── r9u2-osgi-commands
│ ├── bnd.bnd
│ ├── build.gradle
│ └── src
│ └── main
│ └── java
│ └── com/acme/r9u2/internal/osgi/commands
│ └── R9U2OSGiCommands.java
│
└── [Gradle files]
ここでも、ビルドスクリプト、bnd.bnd
ファイル、およびJavaクラスがあります。 このモジュールのbnd.bnd
ファイルは、プロバイダーのものとほとんど同じです。
Bundle-Name: Acme R9U2 OSGi Commands
Bundle-SymbolicName: com.acme.r9u2.osgi.commands
Bundle-Version: 1.0.0
プロバイダーで宣言したことと同じことを宣言するのだ。
クライアントモジュールはAPIモジュールと release.portal.api
アーティファクトに依存する。以下は r9u2-osgi-commands
モジュールの build.gradle
ファイルである:
dependencies {
compileOnly group: "com.liferay.portal", name: "release.portal.api"
compileOnly project(":r9u2-api")
}
Javaクラスでは、もう少し続きがあります。
@Component(
property = {"osgi.command.function=greet", "osgi.command.scope=r9u2"},
service = R9U2OSGiCommands.class
)
public class R9U2OSGiCommands {
public void greet(String name) {
_greeter.greet(name);
}
@Reference
private Greeter _greeter;
}
上記のメソッドは、Greeter
のgreet
メソッドを呼び出します。 com.acme.r9u2.Greeter
は、実装モジュールが登録するOSGiサービスタイプです。 レジストリからGreeter
サービスを取得するには、Greeter
フィールド_greeter
に @Reference
アノテーションを追加する必要があります。
R9U2OSGiCommands
クラスは、独自のタイプのOSGiサービスを提供します。 2つのプロパティは、r9u2
というスコープでgreet
というコマンド関数を使用してGogoシェルコマンドを定義します。 デプロイされたR9U2OSGiCommands
コンポーネントは、String
を入力として受け取るGogo シェルコマンドr9u2:greet
を提供します。
この最も基本的な例を見れば、モジュールベースの開発が簡単で分かりやすいことがわかるでしょう。 API-Provider-Consumer契約によって疎結合が促進され、ソフトウェアの管理、拡張、およびサポートが容易になります。
典型的なLiferayアプリケーション
Liferayのソースから典型的なアプリケーションを見てみると、通常は少なくとも4つのモジュールがあります。
- APIモジュール
- サービス(プロバイダー)モジュール
- テストモジュール
- Web(コンシューマ)モジュール
これは、ユーザーがコメント、ブログ、または他のアプリケーションで@username
の命名法を使用して他のユーザーに言及できるようにする、Mentionsアプリケーションなど、一部の小さなアプリケーションで見られるものとまったく同じです。 ドキュメントとメディアライブラリなどの大規模なアプリケーションには、さらに多くのモジュールがあります。 ドキュメントとメディアライブラリの場合、ドキュメントストレージバックエンドごとに個別のモジュールがあります。 Wikiの場合、Wikiエンジンごとに個別のモジュールがあります。
モジュールとして機能のバリエーションをカプセル化すると、拡張性が向上します。 Liferayがまだサポートしていないドキュメントストレージバックエンドがある場合は、モジュールを開発することでLiferayのドキュメントストレージAPIをソリューション用に実装し、Liferayのドキュメントとメディアライブラリを拡張できます。 Liferayのwikiが提供する言語よりも気に入ったWiki言語がある場合は、そのモジュールを作成してLiferayのwikiを拡張できます。
開発を始める準備はできましたか。 さらに学習するためのリソースのいくつかを以下に紹介します。