構成の設定とアクセス
Liferayの構成フレームワークを使用して、MVCポートレットの設定UIを追加できます。
サンプルポートレットを参照する
新しいLiferay インスタンスを起動し、以下を実行します。
docker run -it -m 8g -p 8080:8080 liferay/portal:7.4.3.86-ga86。
http://localhost:8080でLiferayへのサインインします。 メールアドレス_test@liferay.com_とパスワード_test_を使用してください。 プロンプトが表示されたら、パスワードを _learn_に変更します。
次に、以下の手順を実行します。
設定とアクセス をダウンロードし、解凍します。
curl https://resources.learn.liferay.com/dxp/latest/en/building-applications/core-frameworks/configuration-framework/liferay-n2f3.zip -O
unzip liferay-n2f3.zip
モジュールのルートから、ビルドおよびデプロイします。
./gradlew deploy -Ddeploy.docker.container.id=$(docker ps -lq)
noteこのコマンドは、デプロイされたjarをDockerコンテナの
/opt/liferay/osgi/modules
にコピーするのと同じです。Liferay Dockerコンテナコンソールでデプロイを確認します。
STARTED com.acme.n2f3.web.0.0 [1650]
サンプルのモジュールが機能していることを確認します。 ブラウザで
https://localhost:8080
を開きます。N2F3ポートレットをページに追加します。 サンプルポートレットは、サンプルウィジェットの下にあります。
UIには、フォントの色、フォントファミリー、フォントサイズの3つの設定可能な属性とともにウェルカムメッセージが表示されます。
構成を変更するには、 [コントロールパネル] → [設定] → [System Settings] に移動します。 [Other]の下の category.n2f3 をクリックします。
別のフォントの色、フォントファミリー、およびフォントサイズを入力してみてください。 [アップデート] ボタンをクリックして、公開されたウィジェットのあるページに戻ります。 属性が変更されたことを確認します。
構成フレームワークの仕組みは次のとおりです。
構成インターフェイスを作成する
構成インターフェイスで構成可能な属性を定義するだけで、システム設定で構成UIを生成できます。
サンプルプロジェクトでは、N2F3WebConfiguration.java
ファイルが構成インターフェースです。
import com.liferay.portal.configuration.metatype.annotations.ExtendedObjectClassDefinition;
@ExtendedObjectClassDefinition(
category = "n2f3", scope = ExtendedObjectClassDefinition.Scope.COMPANY
)
@Meta.OCD(
id = "com.acme.n2f3.web.internal.configuration.N2F3WebConfiguration",
localization = "content/Language", name = "n2f3-configuration-name"
)
public interface N2F3WebConfiguration {
@Meta.AD(deflt = "blue", required = false)
public String fontColor();
このサンプルインターフェイスでは、スコープがScope.COMPANY
に設定されていることに注意してください。 詳細については、 スコープ設定を参照してください。
インターフェースには、フォントの色、フォントファミリー、フォントサイズの3つの設定可能な属性があります。 色とファミリーはstring
型であり、サイズはint
型であることに注意してください。
Meta.OCD
は、このクラスを特定のIDを持つ構成として登録します。
IDには、構成インターフェイスの完全修飾クラス名(FQCN)を指定する必要があることに注意してください。
Meta.AD
は、デフォルト値や属性が必須項目であるかどうかなど、属性に関する オプションのメタデータ を指定します。 属性値が必要であるがデフォルトが設定されていない場合、管理者はアプリケーションが正しく機能するように設定で値を設定する必要があることに注意してください。
次に、MVCポートレットによって構成がどのように読み取られるかを確認します。
アプリケーションから構成を読み取る
@Component
アノテーションでは、構成インターフェイスクラスはconfigurationPid
で指定されます。configurationPid = "com.acme.n2f3.web.internal.configuration.N2F3WebConfiguration"
構成にアクセスするために、
render()
メソッドはConfigurationProvider
を利用します。 構成プロバイダーAPIは、さまざまなレベルのスコープで構成を取得するためのメソッドを提供します。 サンプルプロジェクトの構成はインスタンススコープであり、getCompanyConfiguration()
メソッドを使用して構成を取得します。
catch (ConfigurationException configurationException) {
throw new PortletException(configurationException);
}
super.render(renderRequest, renderResponse);
}
@Reference
構成オブジェクトがリクエストオブジェクトに追加され、アプリケーションのJSPのリクエストから読み取ることができるようになりました。
JSPから構成にアクセスする
次のimportステートメントは、構成インターフェイスをJSPに追加します。
<%@ page import="com.acme.n2f3.web.internal.configuration.N2F3WebConfiguration" %>
リクエストオブジェクトから構成オブジェクトが取得され、構成値が読み取られます。
<% N2F3WebConfiguration n2f3WebConfiguration = (N2F3WebConfiguration)request.getAttribute(N2F3WebConfiguration.class.getName()); %>
属性
fontColor()
、fontFamily()
、fontSize()
をJSPで使用できるようになりました。
ドロップダウン選択UIを実装する
サンプルプロジェクトには、構成可能な3つの属性があります。 現在、属性はテキスト入力フィールドに手動で入力する必要がありますが、これはさらにカスタマイズできます。
たとえば、入力フィールドの代わりに、フォントファミリー属性のドロップダウンリストを使用できます。 プロジェクトの構成インターフェイスで、@Meta.AD
アノテーションを次のように置き換えます。
@Meta.AD(
optionLabels = {"Arial", "Georgia", "Helvetica", "Tahoma", "Verdana"},
optionValues = {"arial", "georgia", "helvetica", "tahoma", "verdana"},
required = false)
サンプルモジュールを再デプロイします。
これで、フォントファミリー属性はドロップダウン選択になります。
Liferayの以前のバージョンでのConfigurationBeanDeclaration
Liferay DXP 7.4 U51+とLiferay Portal 7.4 GA51+では、ConfigurationBeanDeclaration
クラスは必要ありません。 構成インターフェースは、構成プロバイダーAPIに自動的に登録されます。
7.4 Update/GA 51以前のLiferayバージョンでは、構成クラスを構成プロバイダーAPIで使用するためにはConfigurationBeanDeclaration
で構成クラスを登録する必要があります。 ConfigurationBeanDeclaration
クラスには、構成インターフェースクラスを返すメソッドが1つあります。 これにより、システムは構成の変更が生じたときにそれを追跡できるようになります。 例えば、N2F3ポートレットの場合、以下のようなクラスを作成します。
@Component(service = ConfigurationBeanDeclaration.class)
public class N2F3WebConfigurationBeanDeclaration
implements ConfigurationBeanDeclaration {
@Override
public Class<?> getConfigurationBeanClass() {
return N2F3WebConfiguration.class;
}
}
この例では、クラスをcom.acme.n2f3.web.internal.settings.definition
パッケージに配置します。