Documentation

Liferay Faces Bridge

Liferay Faces Bridgeを使用すると、ポートレット固有のコードを記述せずに、JSF Webアプリをポートレットとしてデプロイできます。 また、ポートレットアプリケーション内でJSF 2.xの機能を活用できるようにする革新的な機能も含まれています。

Liferay Faces Bridgeは、.jarファイルで配布されます。 Liferay Portal 5.2、6.0、6.1、6.2、7.0などのJSR 286(Portlet 2.0)に準拠したポートレットコンテナ内にJSF Webアプリケーションをポートレットとしてデプロイするために、Liferay Faces Bridgeをポートレットプロジェクトへの依存関係として追加できます。

Liferay Faces Bridgeプロジェクトのホームページは こちら にあります。

Liferay Faces Bridgeを完全に理解するには、最初にポートレットブリッジ規格を理解する必要があります。 Portlet 1.0とJSF 1.0の仕様は基本的に同時に作成されていたため、JSF仕様のExpert Group(EG)は、ポートレットに準拠するようにJSFフレームワークを構築しました。 たとえば、 ExternalContext.getRequest() メソッドは、 javax.servlet.http.HttpServletRequest の代わりにObjectを返します。 このメソッドをポータルで使用する場合、Objectjavax.portlet.PortletRequest にキャストできます。 JSFの設計においてEGはポートレットの互換性を意識していましたが、ポートレットとJSFのライフサイクルのギャップを埋める必要がありました。

ポートレットブリッジの規格と実装は、時間の経過とともに進化しました。

2004年以降、JSF開発者がJSF Webアプリをポートレットとしてデプロイできるようにするために、いくつかの異なるJSFポートレットブリッジの実装が開発されました。 2006年、JCPは、標準のブリッジAPIと、ブリッジ実装の詳細な要件を定義するために、Portlet Bridge 1.0( JSR 301 )EGを作成しました。 JSR 301は、Portlet 1.0およびJSF 1.2を対象として2010年にリリースされました。

2008年にPortlet 2.0( JSR 286 )規格がリリースされた際、JCPはPortlet Bridge 2.0( JSR 329 )EGを形成する必要がありました。 また、JSR

  1. がPortlet 2.0とJSF 1.2を対象として2010年にリリースされました。

JSR 314 EGが2009年にJSF 2.0をリリースし、2010年にJSF 2.1をリリースした後、Portlet Bridge 3.0規格が有益であることが明らかになりました。 2015年、JCPはPortlet 3.0とJSF 2.2のブリッジを定義する JSR 378 を形成しました。 Portlet 2.0およびJSF 1.2/2.1/2.2をサポートする Liferay Faces Bridge のバリアントもあります。

Liferay Faces Bridgeは、ポートレットブリッジ規格のリファレンス実装(RI)です。 また、ポートレットアプリケーション内でJSF 2.xの機能を活用できるようにする革新的な機能も含まれています。

JSFポートレットブリッジは、JSFライフサイクルの正しいフェーズをポートレットライフサイクルの各フェーズに合わせます。 たとえば、ブラウザがJSFポートレットを含むポータルページにHTTP GETリクエストを送信する場合、RENDER_PHASEはポートレットのライフサイクルで実行されます。 次に、JSFポートレットブリッジは、JSFライフサイクルのRESTORE_VIEWフェーズとRENDER_RESPONSEフェーズを開始します。 同様に、HTTP POSTがポートレットで実行され、ポートレットがACTION_PHASEに入ると、完全なJSFライフサイクルがブリッジによって開始されます。

ポートレットライフサイクルのどのフェーズが実行されているかに応じて、JSFライフサイクルのさまざまなフェーズが実行されます。

2つのライフサイクルが正しく接続されていることを確認するだけでなく、JSFポートレットブリッジは、ポータルURLジェネレータとJSFナビゲーションルールの間のメディエーターとしても機能します。 JSFポートレットブリッジは、ポータルによって作成されたURLがJSFナビゲーションルールに準拠していることを確認し、JSFポートレットが別のビューに切り替えることができるようにします。

JSR 329/378規格では、javax.portlet.facesネームスペースのプレフィックスが付いたいくつかの構成オプションが定義されています。 Liferay Faces Bridgeは、com.liferay.faces.bridgeネームスペースのプレフィックスが付いた追加の実装固有のオプションを定義します。

Liferay Faces Bridgeは、Liferay DXP/PortalのJSF開発プロセスの重要な部分です。 詳細については、 Developing a JSF Portlet Application (Help Center) を参照してください。