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

MVCリソースコマンド

MVCリソースコマンドのクラスは、アクションやレンダーをトリガーせずに、DXP / Portalインスタンスからリソース（画像、XML、またはその他の種類のリソース）を取得します。リクエストまたはポートレットリソースURLは、MVCリソースコマンドを呼び出します。

MVCリソースコマンドを使用するサンプルポートレットをデプロイしてから、それを調べます。

MVCリソースコマンドを呼び出す

サンプルポートレットは、MVCリソースコマンドを使用して単純なファイルをダウンロードします。

Liferay の新しいインスタンスを起動するには、次のコマンドを実行します。

docker run -it -m 8g -p 8080:8080 liferay/portal:7.4.3.132-ga132

http://localhost:8080 で Liferay にサインインしてください。メールアドレス test@liferay.com とパスワード test を使用してください。プロンプトが表示されたら、パスワードを learn に変更してください。

次に、以下の手順に従ってください。

サンプルをダウンロードして解凍してください。

curl https://resources.learn.liferay.com/examples/liferay-p8v5.zip -O

unzip liferay-p8v5.zip

サンプルをビルドしてデプロイします。
```
cd liferay-p8v5
```
```
./gradlew deploy -Ddeploy.docker.container.id=$(docker ps -lq)
```
注記

このコマンドは、モジュール JAR を Docker コンテナ上の /opt/liferay/osgi/modules にコピーすることと同じです。
Dockerコンテナコンソールでデプロイを確認してください。
```
com.acme.p8v5.web_1.0.0 を開始しました
```
P8V5 ポートレット ウィジェットを サンプル カテゴリからウィジェットページに追加します。 P8V5ポートレットが表示されます。

このリンクは、MVCリソースコマンドを呼び出して、シンプルなテキストファイルをダウンロードします。
をクリックしてダウンロードをダウンロードしてください。 p8v5.txt という名前のファイルがコンピュータにダウンロードされます。
p8v5.txt ファイルを開きます。内容は以下のとおりです。
```
こんにちは、P8V5さん！
```

MVCリソースコマンドを使用してファイルをダウンロードしました。それでは、その仕組みを見ていきましょう。

ポートレットを調べる

P8V5Portlet は最小限の MVCPortlet です。

@Component(
	property = {
		"com.liferay.portlet.display-category=category.sample",
		"jakarta.portlet.display-name=P8V5 Portlet",
		"jakarta.portlet.init-param.view-template=/p8v5/view.jsp",
		"jakarta.portlet.name=com_acme_p8v5_web_internal_portlet_P8V5Portlet"
	},
	service = Portlet.class
)
public class P8V5Portlet extends MVCPortlet {
}

@Component javax.portlet.name プロパティはポートレットの名前を設定します。

"jakarta.portlet.name=com_acme_p8v5_web_internal_portlet_P8V5Portlet"

注記

MVCResourceCommandは、ポートレット名 (たとえば、ポートレットコンポーネント javax.portlet.name プロパティ値) によってポートレットにバインドされます。

次は、ポートレットのMVCリソースコマンドクラスです。

MVCResourceCommand クラスを調べます

MVC リソースコマンドクラスは、 MVCResourceCommand を直接実装するか、 BaseMVCResourceCommand を拡張して間接的に実装できます。 P8V5DownloadMVCResourceCommand は、 MVCResourceCommand を直接実装します。

@Component(
	property = {
		"jakarta.portlet.name=com_acme_p8v5_web_internal_portlet_P8V5Portlet",
		"mvc.command.name=/p8v5/download"
	},
	service = MVCResourceCommand.class
)
public class P8V5DownloadMVCResourceCommand implements MVCResourceCommand {

	@Override
	public boolean serveResource(
			ResourceRequest resourceRequest, ResourceResponse resourceResponse)
		throws PortletException {

		try {
			PortletResponseUtil.sendFile(
				resourceRequest, resourceResponse, "p8v5.txt"、
				"Hello P8V5!".getBytes()、 "text");

			return false;
		}
		catch (IOException ioException) {
			_log.error(ioException, ioException);

			return true;
		}
	}

	private static final Log _log = LogFactoryUtil.getLog(
		P8V5DownloadMVCResourceCommand.class);

}

P8V5DownloadMVCResourceCommand は、 コンポーネント であり、 MVCResourceCommand サービスを提供します。コンポーネントのプロパティは、 P8V5DownloadMVCResourceCommand を com_acme_p8v5_web_internal_portlet_P8V5Portlet という名前のポートレットに適用し、 P8V5DownloadMVCResourceCommand を MVC コマンド名 /p8v5/download にマッピングします。ここで指定する名前は、ポートレット内で宣言されている名前と一致している必要があります。

注記

各ポートレットに対して個別の javax.portlet.name プロパティを宣言することで、 MVCResourceCommand コンポーネントを複数のポートレットに関連付けることができます。

@Component(
    property = {
        "javax.portlet.name=com_acme_p8v5_web_internal_portlet_P8V5Portlet",
        "javax.portlet.name=com_acme_p8v5_web_internal_portlet_P8V6Portlet",
        "mvc.command.name=/p8v5/download"
    },
    service = MVCResourceCommand.class
)

例の serveResource メソッドは、シンプルなテキストファイルを作成し、それを PortletResponseUtil を介してユーザーに送信します。このメソッドは、エラーが発生した場合は true を返し、それ以外の場合は false を返します。

次に、ポートレットのJSPがUIコンポーネントのアクションをコマンドにマッピングする方法を学びます。

ポートレットリソースURLを確認する

ポートレットの view.jsp ファイルは、MVC リソースコマンドを呼び出すためのリンクをレンダリングします。

<%@ taglib uri="http://java.sun.com/portlet_2_0" prefix="portlet" %>

<h4>P8V5 Portlet</h4>

<a href="<portlet:resourceURL id="/p8v5/download" />">ダウンロード</a>

最初の行は、 ポートレット プレフィックスを介して Portlet 2.0 タグライブラリを利用可能にします。この JSP は、タグライブラリの portlet:resourceURL タグを使用して、アクションを UI コンポーネントにバインドします。タグの id 属性は、MVC リソースコマンドの mvc.command.name プロパティ値を使用します。以下の表は相関関係を示しています。