まず最初に行うことは、アプリケーションのルートフォルダとそのwebクライアントモジュールのフォルダ構造を作成することです。 このモジュールは、ポートレットクラスとWeb UIを保持します。 モジュールのスケルトン構造の作成を開始する前に、このバージョンのアプリケーションを構成するモジュールを決定します。 アプリケーションがサービスAPIと実装クラスを提供する場合（すべてのLiferay Service Builderアプリケーションの場合）、それらに個別のモジュールを作成します。 このチュートリアルでは、Mavenプロジェクトモデルを想定していますが、ビルドツールまたはフォルダ構造は許可されます。
フォルダ構造を作成する手順は次のとおりです。
-
ルートフォルダを作成します。 これは、アプリケーションの独立したモジュールと設定ファイルの新しいホームです。 たとえば、アプリケーションの名前がTasksである場合、ルートフォルダはtasksになります。
アプリケーションがLiferay Service Builderを使用する場合、次のBlade CLIコマンドを使用して、親フォルダとサービス実装およびサービスAPIモジュールをそこで生成します。 親フォルダが既に存在する場合、そこは空でなければなりません。 このコマンドは、親フォルダに
APPLICATION_NAMEと名前を付けます。blade create -t service-builder -p [ROOT_PACKAGE] [APPLICATION_NAME]The
*-serviceおよび*-apiモジュールフォルダについては、このチュートリアルの後半で説明します。 -
Webクライアントモジュールのフォルダ構造を作成します。 Blade CLIおよびMavenは、プロジェクトテンプレートに基づいてプロジェクトフォルダ構造を生成します。
例として、ルートフォルダ（例:
tasks）に移動し、次のBlade CLIコマンドを実行して、包括的なWebクライアントモジュール構造を生成します。blade create -t mvc-portlet [APPLICATION_NAME]-web -
*-webモジュールで、/src/main/java/[APPLICATION_NAME]フォルダをルートJavaパッケージに置き換えます。 たとえば、アプリケーションのルートパッケージ名がcom.liferay.tasks.webである場合、クラスのフォルダは/src/main/java/com/liferay/tasks/webである必要があります。 さらに、init.jspおよびview.jspファイルを、src/main/resources/META-INF/resourcesフォルダから削除します。 これらの生成されたデフォルトJSPの代わりに、既存のアプリケーションのJSPを使用します。 -
*-webモジュールフォルダが（以下の[APPLICATION_NAME]でマークされた）アプリケーションのルートフォルダにあり、*-webモジュールのフォルダ構造が次のようになっていることを確認します。[APPLICATION_NAME][APPLICATION_NAME]-websrcmainjava[ROOT_PACKAGE]
resourcescontentLanguage.properties
META-INFresources
bnd.bndbuild.gradle
残りの手順は、Webクライアントモジュール（
*-webモジュール）に影響します。 -
bnd.bndファイルはプロジェクトを構築する時に、モジュールのMANIFEST.MFファイルを生成するために使用されます。 それを開き、アプリケーションに合わせて変更します。 お使いのモジュールbnd.bndの設定方法について、追加のドキュメンテーションもあります。 例として、Liferaydictionary-webモジュールのbnd.bndは次のとおりです。Bundle-Name: Liferay Dictionary Web Bundle-SymbolicName: com.liferay.dictionary.web Bundle-Version: 1.0.6
より詳しい例については、
journal-webモジュールのbnd.bndを調べてください。Bundle-Name: Liferay Journal Web Bundle-SymbolicName: com.liferay.journal.web Bundle-Version: 2.0.0 Export-Package:
com.liferay.journal.web.asset,
com.liferay.journal.web.dynamic.data.mapping.util,
com.liferay.journal.web.social,
com.liferay.journal.web.util Liferay-JS-Config: /META-INF/resources/js/config.js Liferay-Releng-Module-Group-Description: Liferay-Releng-Module-Group-Title: Web Content Web-ContextPath: /journal-web -
build.gradleファイルを開きます。 ここでモジュールのすべての依存関係を指定します。 生成されたものには、コンテンツとデフォルトの依存関係が事前に入力されています。dependencies {...}ブロックにモジュールの依存関係を追加します。Finding Liferay API Modulesでは、一般的なLiferay APIモジュールのシンボル名をリストしています。 Liferay DXP 7.1およびLiferayアプリケーション向けのJavadoc概要では、各モジュールのシンボル名とバージョンをリストしています。 Configuring Dependencies tutorialでは、アーティファクト情報の検索と依存関係の指定について説明しています。 Liferay DXPは、多くのJavaパッケージと全体のアーティファクトをOSGiコンテナのランタイムで提供します。 すべての依存関係が解決すると、インストール後にモジュールがアクティブになります。 ログには未解決の依存関係が表示されます。 メッセージの例は次のとおりです。
! could not resolve the bundles: … Unresolved requirement: Import-Package: … Unresolved requirement: Require-Capability …
-
従来のアプリケーションのJSPファイルを
/src/main/resources/META-INF/resourcesフォルダの中にコピーします。 ほとんどの場合、アプリケーションのすべてのJSPファイルはWebクライアントモジュールに属します。 -
Service Builderに関連しないポートレットクラスとサポートクラスを、Webクライアントモジュールのそれぞれのパッケージフォルダにコピーします。 クラスをサブパッケージに整理すると管理しやすくなります。
例として、
journal-webモジュールのJavaソースフォルダ構造は次のとおりです。journal-web- …
src/main/java/com/liferay/journal/web/asset- [classes]
configuration- [classes]
dynamic/data/mapping/util- [classes]
internalapplication/list- [classes]
custom/attributes- [classes]
dao/search- [classes]
- …
social- [classes]
util- [classes]
- …
-
必要なクラスがクライアントモジュールにあるので、OSGiに準拠させる必要があります。 初心者の場合はLiferay DXPが使用するため、宣言型サービスコンポーネントフレームワークを使用することをお勧めします。 このチュートリアルでは、宣言型サービスの使用を前提としています。 ただし、他のOSGiコンポーネントフレームワークを使用することは可能です。
従来のアプリケーションのXMLファイルを確認し、設定およびメタデータ情報をコンポーネントプロパティとしてポートレットクラスに移行します。 これを行うには、
@Component注釈をポートレットクラスに追加し、その注釈に必要なプロパティを追加します。 コンポーネントプロパティへのポートレット記述子のマッピングを調べます。 最終結果は、次の例のようになります。@Component( immediate = true, property = { “com.liferay.portlet.display-category=category.sample”, “com.liferay.portlet.icon=/icon.png”, “javax.portlet.name=1”, “javax.portlet.display-name=Tasks Portlet”, “javax.portlet.security-role-ref=administrator,guest,power-user”, “javax.portlet.init-param.clear-request-parameters=true”, “javax.portlet.init-param.view-template=/view.jsp”, “javax.portlet.expiration-cache=0”, “javax.portlet.supports.mime-type=text/html”, “javax.portlet.resource-bundle=content.Language”, “javax.portlet.info.title=Tasks Portlet”, “javax.portlet.info.short-title=Tasks”, “javax.portlet.info.keywords=Tasks”, }, service = Portlet.class ) public class TasksPortlet extends MVCPortlet
-
portletId（例:58_INSTANCE_4gtH）のすべての参照をポートレットのクラス名に変換し、すべての期間をアンダースコア（例:com_liferay_web_proxy_portlet_WebProxyPortlet）に置き換えます。 -
従来のアプリケーションのリソース操作（ある場合）をクライアントモジュールに移行します。
/src/main/resources/resource-actions/default.xmlファイルを作成し、そこへリソース操作をコピーします。src/portlet.propertiesファイルを作成し、次のプロパティを追加してください。resource.actions.configs=resource-actions/default.xml例として、ディレクトリアプリケーションの
default.xmlを参照してください。7.1では権限APIが変更されていることに注意してください。それに応じて権限ヘルパーを調整します。
-
src/main/resources/content/Language.propertiesファイルに言語キーを追加します。 アプリケーションに固有の言語キーのみを含めます。 Liferay DXPの言語キーは、すべてのポートレットアプリケーションで使用できます。
アプリケーションのWebクライアントモジュールを作成し、ポートレットクラスとUIをモジュール化するための最も一般的なタスクのいくつかを完了しました。 このチュートリアルでは取り上げていない、アプリケーションの他の部分の変換に関しては、Liferay DXP developer tutorialsを参照し、それらの部分がどのようにアプリケーションモジュールに適合するかを確認してください。 チュートリアルは関心ごとの分野に分かれているため、必要なトピックの情報を簡単に見つけることができます。
最後に以下の表は、従来のポートレットプラグインからtasks-portletという架空のアプリケーション用のモジュールに、ファイルとJavaパッケージをマップする、クイックリファレンスガイドです。
| 従来のプラグイン | モジュール |
|---|---|
tasks-portlet/docroot/WEB-INF/src/com.liferay.tasks.asset | tasks-web/src/main/java/com.liferay.tasks.asset |
tasks-portlet/docroot/WEB-INF/src/com.liferay.tasks.portlet | tasks-web/src/main/java/com.liferay.tasks.portlet |
tasks-portlet/docroot/WEB-INF/src/content | tasks-web/src/main/resources/content |
tasks-portlet/docroot/WEB-INF/src/resource-actions | tasks-web/src/main/resources/resource-actions |
tasks-portlet/docroot/WEB-INF/src/portlet.properties | tasks-web/src/main/resources/portlet.properties |
tasks-portlet/docroot/init.jsp | tasks-web/src/main/resources/META-INF/resources/init.jsp |
tasks-portlet/docroot/tasks | tasks-web/src/main/resources/META-INF/resources/tasks |
tasks-portlet/docroot/upcoming_tasks | tasks-web/src/main/resources/META-INF/resources/upcoming_tasks |
多くのアプリケーションにはWebクライアントモジュールしかありません。 Liferay Service Builderアプリケーションなどの、より大規模で複雑なアプリケーションでは、サービスAPIとサービス実装ロジックを保持するために追加のモジュールが必要です。 次に、これらのモジュールを作成する方法を学習します。