純粋な HTML ページ (Web デザイナが作成したモックアップなど) がある場合は、JSP (JSF) タグを使用する形式にそれを変換することが必要になる場合があります。Workshop の製品グループでは、HTML ページを JSF に移行する変換ウィザードが用意されています。変換ウィザードは、JSF 管理対象 Bean を使用するように <form> タグを変換します。HTML タグは、単純に出力ファイルへコピーされます。
入力ファイルは、HTML の <form> タグが少なくとも 1 つ含まれる、HTML ファイルまたは JSP ファイルです。
変換ウィザードの起動
HTML ページを変換するには、サブメニューから [ファイル｜新規｜その他] を選択します。Java Server Faces (JSF) を展開して [HTML から JSF への変換] を選択し、[次へ] をクリックして続行します。
ファイルの場所の指定
次に表示されるダイアログで、入力されるファイルと出力 (変換) されるファイルの名前を指定する必要があります。
[入力ファイルの場所] で、プロジェクト名から始まる変換されるファイルのパスを指定します。以下のスクリーン ショット例では、プロジェクト名は JSFHTMLConvert であり、ファイル form.html が WebContent/pages サブフォルダ内に置かれています。変換するファイルを右クリックして変換ウィザードを起動した場合、このフィールドは自動的に入力されます。他の方法としては、[参照] をクリックして、変換するファイルを指定することもできます。
[出力ファイル名] には、変換プロセスで生成される新しいファイルの名前を指定します。新しいファイルは、元のファイルと同じフォルダ内に置かれます。
[次へ] をクリックして続行します。
変換オプションの指定
次に表示される画面では、いくつかのオプションを設定できます。
- [<f:view> タグの挿入] - 出力ファイルに、<f:view> タグが追加されることを指定します。
- [<f:loadBundle> タグの挿入] - リソース バンドルへのパスを指定できます。[ベース名] ボックスで、使用可能なバンドルのうち 1 つを選択できます。
- [<a> タグの変換] - <a> タグを JSF の <h:outputLink> タグに変換します。このオプションのチェックをはずしておくと、<a> タグは単に出力ファイルにコピーされます。
- [<img> タグの変換] - <img> タグを JSF の <h:graphicImage> タグに変換します。このオプションのチェックをはずしておくと、<img> タグは単に出力ファイルにコピーされます。
オプションを選択したら、[次へ] をクリックして進みます。
HTML フォームの変換
入力される HTML ファイルの各 <form> タグについて、フォーム内の各データ収集 <input> タグのための管理対象 Bean と、各 <input> のための JSF タグおよび値を指定できます。
次の 2 つの画面は、入力される各 <form> タグについて繰り返し表示されます。
<form> タグと関連付けられた Bean を指定する
次に表示される画面では、<form> タグの変換時に指定される管理対象 Bean を指定できます。
アイコンをクリックして [Bean/プロパティの選択] ダイアログを開き、Bean を選択してから [OK] をクリックして続行します。[次へ] をクリックして続行します。
変換する <form> タグを指定する
次に表示される画面では、HTML の <form> 内にある各データ収集フィールドの関連付けを行えます。左側のカラムには、現在の <form> 内にあるすべての <input> タグが表示されます。2 つ目のカラムで JSF タグを指定し、3 つ目のカラムのプルダウンを使って各 <input> タグの値を指定できます。
変換の完了
<form> タグがすべて変換されたら、[完了] をクリックして変換を完了し、出力ファイルを作成します。