JSF 1.2 から JSF 2.0 に移行する際の課題は何ですか?また、これらの課題は使用するビュー テクノロジによってどのように異なりますか?

JSF 1.2 から JSF 2.0 への移行時の痛み

JSF 1.2 から 2.0 にアップグレードする際の痛みは、現在使用しているビュー技術と今後使用する予定のビュー技術によって異なります。

• JSP 2.x から JSP 2.x = ほとんど手間がかかりません。
• Facelets 1.x から Facelets 2.0 = 手間は少なめです。
• JSP 2.x から Facelets 2.0 = 大量の手間がかかります。カスタムコンポーネントがある場合はさらに倍になります。

基本変更

ビュー技術の切り替えに関係なく、少なくとも次の手順を実行する必要があります。

• JSF 1.2 JAR を /WEB-INF/lib から削除します（ある場合）。
• JSF 2.0 JAR を /WEB-INF/lib にドロップします（JSF 1.2 がサーブレットコンテナによって提供されていた場合は、サーブレットコンテナのライブラリよりも最初に Web アプリケーションライブラリを読み込むようにクラスローディングポリシーを変更することを検討してください。アプリケーションサーバーの JSF2 クラスローディングの問題も参照）。
• faces-config.xml のルート宣言を JSF 2.0 仕様に合わせて更新します。

  <faces-config
      xmlns="http://java.sun.com/xml/ns/javaee"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facesconfig_2_0.xsd"
      version="2.0">

メモ: JSF 2.2 以降を使用している場合は、上記の XML スニペット全体で http://java.sun.com の代わりに http://xmlns.jcp.org 名前空間ドメインを使用します。

• web.xml のルート宣言が最低でも Servlet 2.5 に準拠していることを確認します。JSF 2.0 は 2.4 以下では動作しません（ただし、ハックは可能です）。

  <web-app 
      xmlns="http://java.sun.com/xml/ns/javaee"
      xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
      xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
     >

メモ: Servlet 3.0 以上を使用している場合は、上記の XML スニペット全体で http://java.sun.com の代わりに http://xmlns.jcp.org 名前空間ドメインを使用します。

JSP 2.x から JSP 2.x

JSP 2.x を使用しており、引き続き 使用する場合は、基本的に他に何も変更する必要はありません。

段階的なアップグレード

FacesServlet にサフィックス URL パターン（.jsf など）をすで​​に使用していて、そのまま 使用したい場合は、FacesServlet はまず .xhtml ファイルのスキャンを行い、存在しない場合は *.jsp ファイルのスキャンを行うことを覚えておくとよいでしょう。これにより、URL を変更せずに、JSP から Facelets への段階的な変換を行うことができます。

ただし、プレフィックス URL パターン（/faces/ など）を使用しており、JSP から Facelets に段階的にアップグレードする場合は、それを .jsf に変更し、場合によっては既存の JSP ページのすべてのリンクも変更する必要があります。

新しい JSF 2.0 提供の暗黙的なナビゲーションはファイルの存在をスキャンせず、とにかく outcome.xhtml に移動するという点に注意してください。したがって、.jsp から移動する場合や .jsp に移動する場合は、相変わらず JSF 1.x の方法でビュー ID にそれを含める必要があります。

Facelets 1.x から Facelets 2.0

ビュー技術として Facelets 1.x を使用していて、JSF 2.0 に付属する Facelets 2.0 を使用したい場合は、次の追加手順を実行する必要があります。

• Facelets 1.x JAR を /WEB-INF/lib から削除します。
• Facelets 1.x FaceletViewHandler を faces-config.xml から削除します。
• カスタム FaceletViewHandler 実装がある場合は、ViewHandlerWrapper を拡張するように更新する必要があります。
• 不要ですが、クリーンアップのため、web.xml から Facelets 1.x 関連の 値（javax.faces.DEFAULT_SUFFIX の値は *.xhtml など）を削除します。これは Facelets 2.0 では既にデフォルトです。
• 既存の Facelet タグライブラリ XML のルート宣言を Facelets 2.0 に準拠するように更新します。

  <faces-config
      xmlns="http://java.sun.com/xml/ns/javaee"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facesconfig_2_0.xsd"
      version="2.0">

メモ: JSF 2.2 以降を使用している場合は、上記の XML スニペット全体で http://java.sun.com の代わりに http://xmlns.jcp.org 名前空間ドメインを使用します。

これらで基本的に事足ります。

JSP 2.x から Facelets 2.0

ビュー技術として JSP 2.x を使用しており、Facelets 2.0 にすぐにアップグレードしたい場合は、サイトを公開する前に多くの変更を行う必要があります。ここでは基本的にビュー技術を変更しています。

マスターページの変更

すべてのマスターページで、次の基本的な JSP テンプレートを変更する必要があります。

  <web-app 
      xmlns="http://java.sun.com/xml/ns/javaee"
      xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
      xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
     >

次の基本的な Facelets テンプレートに変更します。

  <facelet-taglib 
      xmlns="http://java.sun.com/xml/ns/javaee"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facelettaglibrary_2_0.xsd"
      version="2.0">

メモ: JSF 2.2 以降を使用している場合は、上記の XHTML スニペット全体で http://java.sun.com の代わりに http://xmlns.jcp.org 名前空間ドメインを使用します。

Include ページの変更

既存の JSP ページが適切に設計されている場合は、scriptlet コードの行はなく、唯一の JSP 固有のタグは のみがあるはずです。それらは次のものから変更する必要があります。

  <faces-config
      xmlns="http://java.sun.com/xml/ns/javaee"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facesconfig_2_0.xsd"
      version="2.0">

次のように変更します。

  <web-app 
      xmlns="http://java.sun.com/xml/ns/javaee"
      xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
      xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
     >

基本的な JSP インクルードページのテンプレート...

  <facelet-taglib 
      xmlns="http://java.sun.com/xml/ns/javaee"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facelettaglibrary_2_0.xsd"
      version="2.0">

...を次の基本的な Facelets インクルードページのテンプレートに変更する必要があります。

<%@page contentType="text/html" pageEncoding="UTF-8"%>
<%@taglib prefix="f" uri="http://java.sun.com/jsf/core"%>
<%@taglib prefix="h" uri="http://java.sun.com/jsf/html"%>
<!DOCTYPE html>
<f:view>
    <html lang="en">
        <head>
            <title>JSP page</title>
        </head>
        <body>
            <h:outputText value="JSF components here." />
        </body>
    </html>
</f:view>

以上がJSF 1.2 から JSF 2.0 に移行する際の課題は何ですか?また、これらの課題は使用するビュー テクノロジによってどのように異なりますか?の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。