JSFおよびJSTLの使用

5 JSFおよびJSTLの使用

WebLogic ServerでJavaServer Faces (JSF)およびJSP Standard Tag Library (JSTL)を使用する方法を学習します。

この章の内容は以下のとおりです。

WebアプリケーションでのJSFおよびJSTLの使用

JSFおよびJSTLはJava EE の必須の部分で、それ自体はWebLogic Serverに直接組み込まれます。すべてのJava EE テクノロジはWebLogic Serverクラスパスに存在します。アプリケーションでJava EE テクノロジのどの機能を使用するにも追加の構成は必要ありません。WebLogic Serverにデプロイされたアプリケーションは、JSF 2.3およびJSTL 1.2をシームレスに活用できます。個別の共有ライブラリをデプロイして参照する必要はありません。

Java EE APIのJARファイルはWL_HOME\wlserver\server\lib\javax.javaee-api.jarに置かれます。WL_HOMEはWebLogic Serverのインストール先の最上位ディレクトリを表します。

Webアプリケーションでのこれらの共有ライブラリの参照については、『Oracle WebLogic Serverアプリケーションの開発』の「共有Java EEライブラリおよびオプション・パッケージの作成」を参照してください。

JavaServer Faces (JSF)

JavaServer Facesは、JavaServerアプリケーションのユーザー・インタフェースの構築を容易にするための技術です。ページ内で再利用可能なUIコンポーネントを組み立て、それらのコンポーネントとアプリケーションのデータ・ソースを結合し、クライアント生成のイベントをサーバー側のイベント・ハンドラに関連付けることで、開発者はそのスキル・レベルに関係なく、Webアプリケーションを迅速に構築できます。

WebLogic Serverでは、JSF 2.3仕様(https://jcp.org/en/jsr/detail?id=372)をサポートしています。このリリースのテーマは、他のAPIとの統合の改善およびJava SE 8機能の活用です。WebLogic Serverでは次のことがサポートされています:

CDI統合の改善: CDI互換の@ManagedPropertyアノテーション。
WebSocket統合の改善: 新しい<f:websocket>タグを使用したWebSocketの直接サポート。
Ajaxメソッドの起動。
新しい<f:validateWholeBean>タグを使用した、クラス・レベルのBean検証。
Javaの日付と時刻のサポート。
拡張されたコンポーネント検索式フレームワーク。

これらの機能の詳細は、『Java EE Tutorial』(https://javaee.github.io/tutorial/toc.html)および『What's new in JSF 2.3?』(https://javaserverfaces.github.io/whats-new-in-jsf23.html)を参照してください。

WebLogic Serverインストールとともにサーバーのサンプルをインストールするよう選択した場合は、サンプル・アプリケーションにJSF 2.3の次の主要機能が示されます:

新しい<h:commandScript>コンポーネントを使用したAjaxメソッドの起動
CDIコンバータ
反復可能h:dataTable
JSF固有のEL暗黙オブジェクトの評価用CDI
CDIインジェクション
新しいJavaの日付と時刻
@ManagedProperty
反復可能ui:repeat
f:validateWholeBeanを使用した、クラス・レベルのBean検証
CDIバリデータ
f:websocketを使用したWebSocket

JSF 2.3サンプルは、ORACLE_HOME\wlserver\samples\server\examples\src\examples\javaee8\jsfディレクトリにあります。ORACLE_HOMEはWebLogic Serverをインストールしたディレクトリです。

WebLogic Serverサンプル・コードの詳細は、『Oracle WebLogic Serverの理解』のサンプル・アプリケーションおよびサンプル・コードに関する項を参照してください。

JavaServer Pages Standard Tag Libraries (JSTL)

JavaServer Pages Standard Tag Library (JSTL)は、多くのWebアプリケーションに共通の中核機能を単純なタグとしてカプセル化するための技術です。JSTLは、次のような一般的な構造化されたタスクをサポートします。

反復および条件
XMLドキュメントを操作するタグ
国際化タグ
SQLタグ

また、JSTLは既存のカスタム・タグとJSTLタグを統合するためのフレームワークも提供されています。

WebLogic Serverでは、JSTL 1.2仕様(http://jcp.org/en/jsr/detail?id=52)をサポートしています。JSTLテクノロジの全般情報は、製品概要(http://www.oracle.com/technetwork/java/jstl-137486.html)を参照してください。

JSF下位互換性

JSFはJava Community Processを使用して作成されており、そのため、実行時およびコンパイルされる際にJSF 1.0を通じて後方互換となります。

バンドルされているJSF実装をアプリケーション構成から削除すると、JSF 1.2用に作成されたアプリケーションは、変更なしでWebLogic Server 14.1.1で実行できます。この処理を実行してもアプリケーションが実行できない場合には、WebLogic Serverには、アプリケーションからデプロイおよび参照できるJSFおよびJSTLライブラリが用意されています。次の項を参照してください。

ノート:

JSF 2.0用に作成されたアプリケーションは、WebLogic Server 14.1.1のビルトインJSF 2.3実装を使用して変更なしで実行し続けられるため、WebLogic Serverに含まれるjsf-2.0.warのデプロイ可能ライブラリは空です。

WebLogic Serverは、ライブラリの存在に依存しているソフトウェアのために、空のjsf-2.0.warライブラリをインクルードします。ライブラリへの参照をそのまま残すことは、支障はありません。ただし、こうした参照は何の機能も付加しないため、この空のライブラリへの参照は削除することをお薦めします。

JSFおよびJSTLライブラリのデプロイメント

ノート:

このリリースのWebLogic Serverでは、JSF 2.3およびJSTL 1.2アプリケーションを直接デプロイできます。後方互換性のために、JSF 1.xおよびJSTL 1.1アプリケーションをデプロイする際は次のディレクトリを使用してください。

JSF 1.2アプリケーションをデプロイする際は、Webアプリケーション・ライブラリとして提供されているJSFおよびJSTLライブラリを使用してください。JSF 1.2またはJSTLの機能を使用するWebアプリケーションをデプロイする前に、これらのライブラリをデプロイする必要があります。これらのライブラリをデプロイするには、WebLogic Server管理コンソールを使用するか、コマンドラインでweblogic.Deployerユーティリティを使用します。

次に、weblogic.Deployerコマンド・ライン・ツールを使用してJSF 1.2ライブラリをデプロイする例を示します。

  java weblogic.Deployer -adminurl t3://localhost:7001 
  -user weblogic -password weblogic
  -deploy -library
   d:/oracle_home/wlserver/common/deployable-libraries/jsf-1.2.war

このコマンドでは、ライブラリのMANIFEST.MFで定義されているデフォルトのlibrary-name、specification-version、およびimplementation-versionを使用してJSF 1.2ライブラリがデプロイされます。

ライブラリのデプロイ後は、WebLogic Server管理コンソールにライブラリのextension-name、specification-versionおよびimplementation-versionが表示されます。こうした情報は、ライブラリWARファイルのMANIFEST.MFファイルでも確認できます。

Webモジュールのデプロイメントの詳細は、『Oracle WebLogic Serverへのアプリケーションのデプロイ』の「アプリケーションおよびモジュールのデプロイメント準備」を参照してください。

JSFまたはJSTLライブラリの参照

JSFまたはJSTLライブラリを参照するには、標準のWebアプリケーションでは、アプリケーションのweblogic.xmlファイルで<library-ref>記述子を定義します。次に例を示します。

  <library-ref>
    <library-name>jsf</library-name>
    <specification-version>1.2</specification-version>
    <implementation-version>1.2</implementation-version>
    <exact-match>false</exact-match>
  </library-ref>

Webアプリケーション・ライブラリの参照の詳細は、『Oracle WebLogic Serverアプリケーションの開発』の「共有Java EEライブラリおよびオプション・パッケージの作成」を参照してください。