Apache MyFaces の設定とテスト実行

前準備

Java 25（Temurin 25 JDK） のインストール

Eclipse Temurin（Adoptium）のインストールを行い、Javaのプログラムをコンパイル・実行する環境を整える。扱う環境は、Windows搭載パソコンである。現時点(2026年6月)での最新LTS版である Java 25（Temurin 25 JDK）を推奨する。

REM Java 25（Temurin 25 JDK） をインストール（PATH と JAVA_HOME を更新）
winget install --id EclipseAdoptium.Temurin.25.JDK -e --silent --accept-source-agreements --accept-package-agreements --override "ADDLOCAL=FeatureMain,FeatureEnvironment,FeatureJarFileRunWith,FeatureJavaHome INSTALLDIR=\"C:\Program Files\Eclipse Adoptium\jdk-25\" /quiet"

java --version

javac --version
echo %JAVA_HOME%

Eclipse のインストール

Eclipse をインストールする。扱う環境は、Windows搭載パソコンである。

REM Temurin 25 JDK をインストール
winget install --id EclipseAdoptium.Temurin.25.JDK -e --accept-source-agreements --accept-package-agreements

その他

• Eclipse の Web, XML, and Java EE Development に関するプラグインのインストールが終わっていること
• 「Tomcat インストール」の Web ページの記述に従って，Tomcat のインストールが終わっていること．
• 「Eclipse 内部の tomcat サーバ」を使えるようにするために， 「Eclipse を使用しての Java サーブレット・プログラムの開発」の Web ページに記載 の「新規サーバの定義」を行っておくこと．

Eclipse の使用にあたって，事前に決めておく事項

以下，Eclipse を使う． 動的 Web プロジェクトの作成，Apache MyFaces のインポートとテストプログラムの実行という一連の操作を，図解で説明する．

Eclipse のプロジェクト等を作る． このページでは，Eclipse のプロジェクト名は次のように記述します． （すでに同じ名前のプロジェクトがある，といったときは，プロジェクト名を変えてください）．

• Eclipse のプロジェクト名： MYFACES

Eclipse での動的 Web プロジェクトの新規作成

下記の手順で，動的 Web プロジェクトを新規に作成する．

1. （もし，プロジェクト・エクスプローラが開いていなければ）プロジェクト・エクスプローラを開く

   「ウインドウ (Window)」→「ビューの表示 (Show View)」→「プロジェクト・エクスプローラ (Project Explorer)」 と操作する．

2. プロジェクトの新規作成の開始

   「ファイル」→「新規 (New)」→「プロジェクト (Project)」
   または，プロジェクト・エクスプローラ内で，右クリック→「新規 (New)」→「プロジェクト (Project)」

3. 「Web」の展開

   新規プロジェクトのウインドウが開くので， 「Web」を展開する．

   
4. 「動的 Webプロジェクト (Dynamic Web Project)」の選択

   展開した「Web」の下にある 「動的 Webプロジェクト (Dynamic Web Project)」を選び， 「次へ」をクリック．

   * Windows での設定例

   
5. プロジェクト名の設定など

   設定用のウインドウが開くので，下記の設定を行う． 設定が終わったら，「次へ」をクリック．

   • 「プロジェクト名 (Project name)」（name）（１行目）では，プロジェクト名を付ける．

     プロジェクト名は，好きな名前でよいが，スペースや全角文字は避けること． ここでは，プロジェクト名を，「MYFACES」と付けることにする．

   • 「プロジェクト・コンテンツ (Project contents)」（2行目）では，ファイルの保存場所を指定する．

     「デフォルトの使用 (Use default)」にチェックを入れたままで良い．

   • 「ターゲット・ランタイム (Target Server)」 (3行目)は， 「Apache Tomcat v6.0」になっているはず．

     他のもの（例えば「なし」）になっていたら，「Apache Tomcat v6.0」に変更しておく

     * Ubuntu での設定例

     
     * 変更のとき，「なし (None)」だけしか無くて，「Apache Tomcat v6.0」が候補として表示されない場合は，

     1. まず、新規(New) をクリックし，
        
     2. 「Apache Tomcat v6.0」を選ぶ．
        
     3. Java, CATALINA_HOME の設定を行う

        * Ubuntu での設定例

        
6. 次はデフォルトのままでよい

   「次へ」をクリック．

   
7. 次の「Web モジュール」は，デフォルトのままでよい

   「完了 (Finish)」をクリック．

   
8. もし「関連付けられたパースペクティブを開きますか？」 と聞いてきたら「はい」をクリック
   
9. 作成されたプロジェクトの確認

   プロジェクト・エクスプローラで，いま作成した動的 Web プロジェクト MYFACES が表示されていることを確認する．

   

Apache MyFaces バージョン 2.0 に関するファイル群 jsf-blank のインポート

Apache MyFaces の動作確認のため， 公開されている jsf-blank プログラム (jsf-blank.zip) を実行してみる．

1. JSF チュートリアルの Web ページを開く

   https://www.tutorialspoint.com/jsf/index.htm をクリック．

   
2. 「JSF 2.0 Tutorial」をクリック
   
3. 「Installation, Setup, and Getting Started」をクリック
   
4. jsf-blank.zip のダウンロード

   今開いている Web ページの「jsf-blank.zip」をダウンロード．

   
5. 解凍

   展開（解凍）してできたファイルのうち，WEB-INF/web.xml, WEB-INF/struts-config.xml, WEB-INF/lib, css/styles.css, index.jsp, welcome.jsp を使う (要するに全部を使う)．

   
6. Eclipse で，インポート開始

   プロジェクト・エクスプローラで， プロジェクト名 MYFACES を右クリックし，「インポート (import)」を選ぶ．

   
7. インポート・ソースの選択

   「一般」→「ファイル・システム」と操作した後， 「次へ」をクリック．

   
8. ソース・ディレクトリの指定
   1. ソース・ディレクトリとして，先ほど解凍した jsf-blank を指定
   2. すると，ソース・ディレクトリの下に，ファイルの一覧が表示される． ここで，インポートすべきファイルを選ぶ． 「すべて選択」をクリック．
   3. 以上の操作の後，「完了」をクリック．
   
9. 「上書きしますか？」に対しては「すべてはい」と答える
   
10. インポートの結果，ファイルが増える
    

jsf-blank に同封のプログラム見本のテスト実行

1. 「index.jsp」を右クリック．

   index.jspは，プロジェクト MYFACES の WebContent の下にある．

   * 「index.jsp」が現れていないときは， WebContent の左横の「+」をクリックして，展開．

   
2. 「実行 (Run As)」→「サーバーで実行 (Run on Server)」と操作
3. サーバの選択

   ウインドウが開くので， 「ローカルホストの Tomcat v6.0 サーバ」が選択されていることを確認の後，「終了」をクリック．

   
   * 下記のエラーが出て，Eclipse 内部の Tomcat サーバが起動しない場合には，公開 Tomcat サーバが稼働中である可能性がある。もしそうなら公開 Tomcat サーバを停止する

   「公開 Tomcat サーバを稼働させている」ときは， Eclipse 内部の Tomcat サーバが起動しない（ポートを奪い合うので）ので， 公開 Tomcat サーバを停止させて下さい

   • Ubuntu の場合: /usr/sbin/service tomcat6 stop で公開 Tomcat サーバを停止

   
4. Tomcat のサーバが起動（または，再起動）するので確認する

   コンソール・ビューの表示を確認する．

5. 実行結果の確認

   Eclipse の 組み込み Web ブラウザ (Internal Web ブラウザ)が開き，そこに実行結果が出る． しばらく待つ．「welcome to JSF」という画面が現れたら，うまく動作している．

   

   * 実行で，エラーが出る場合，tomcat5w.exe を実行してみる． サーバが stop できる状態（STOP ボタンが有効になっている状態）になって いたら， エラーが当然なので， STOP ボタンを押して，もう1度，上記の操作を行う．

   それでもうまく動かない場合は，Eclipse を再起動してみる．

Tomahawk バージョン 1.1.11 のダウンロードとインポート

ファイルのダウンロード

1. Apache MyFaces Project の ダウンロード用 Web ページを開く

   https://myfaces.apache.org/#/

2. MyFaces Tomahawkをクリック
   
3. 先ほどの Web ページに戻り，MyFaces Tomahawk バージョン 1.1.11 バイナリ・リリースの選択

   zip 形式ファイル tomahawk-1.1.11-bin.zip をクリック．

   
4. ミラーサイトの選択

   URL をクリック．

   
5. ダウンロードしたファイルの解凍

   どこに解凍しても良いが，後で分かりやすい ディレクトリに展開（解凍）すること．

MyFaces Tomahawk のインポート

上記と同様の手順で，MyFaces Tomahawk を，プロジェクトの WebContent\WEB-INF\lib にインポートします．

1. Eclipse で，インポートの開始

   プロジェクト・エクスプローラで，WebContent\Web-INF\lib を右クリックし，「インポート」を選ぶ

   
2. インポート・ソースの選択

   「一般」→「ファイルシステム」と操作した後， 「次へ」をクリック．

3. Tomahawk ファイルの指定
   1. ソース・ディレクトリとして，先ほど解凍したディレクトリ（ほにゃらら/tomahawk-1.1.11//lib を指定
   2. すると，ソース・ディレクトリの下に，ファイルの一覧が表示される． ここで，インポートすべきファイルを選べる． 「すべて選択」をクリック．
   3. 以上の操作の後，「完了」をクリック．
   
4. WebContent\WEB-INF\lib のファイルの確認

   「lib」を展開

   

テスト実行

1. 「index.jsp」を右クリック．

   index.jspは，プロジェクト MYFACES の WebContent の下にある．

   * 「index.jsp」が現れていないときは， WebContent の左横の「+」をクリックして，展開．

   
2. 「実行 (Run As)」→「サーバーで実行 (Run on Server)」と操作
3. 「新規サーバの定義」が現れたら，「ローカルホストの Tomcat v6.0 サーバ」になっていることを確認の後，「完了」をクリック．
   
4. 実行結果の確認

   Eclipse の 組み込み Web ブラウザ (Internal Web ブラウザ)が開き，そこに実行結果が出る． しばらく待つ． 下のような画面が現れたら，うまく動作している．

   

Apache MyFaces 使用上の注意点

タグについて

JSF のタグを使うときは，JSP ファイルに，次の２行を追加することになっています．

<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h"%>
<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f"%>

Aapche MyFaces 固有の拡張タグを使うときは，JSP ファイルに，さらに次の2行を追加することになっています．

<%@ taglib uri="https://myfaces.apache.org/tomahawk" prefix="t"%>
<%@ taglib uri="https://myfaces.apache.org/wap" prefix="wap" %>

上記に紹介した jsf-blank サンプルプログラムは，ごく簡単なもので， JSF タグが入っていませんし， 上に書いた2行も入っていません． このことを注意しておいてください．

(オプション) 新しい版の MyFaces Core に入れ替え(書きかけ)

さきほど作成したプロジェクト MYFACES の lib を展開すると， MyFaces Core のバージョンが分かります． 古いバージョンになっているでしょう． バージョンアップしたいときの手順は次の通りです．

ファイルのダウンロード

1. Apache MyFaces Project の ダウンロード用 Web ページを開く

   https://myfaces.apache.org/#/

2. MyFaces Core バージョン 2.1.1 バイナリ・リリースの選択

   Apache MyFaces Project の ダウンロード用 Web ページで，zip 形式ファイル myfaces-core-assembly-2.1.1-bin.zip をクリック．

   
3. ミラーサイトの選択

   一番上の URL をクリック．

   
4. ダウンロードしたファイルの解凍

   どこに解凍しても良いが，後で分かりやすい ディレクトリに展開（解凍）すること．

MyFaces Core のインポート

MyFaces Core を， 先ほど作ったプロジェクト MYFACES の WebContent\WEB-INF\lib にインポートします．

1. Eclipse で，インポートの開始

   プロジェクト・エクスプローラで，WebContent\Web-INF\lib を右クリックし，「インポート」を選ぶ．

   
2. インポート・ソースの選択

   「一般」→「ファイルシステム」と操作した後， 「次へ」をクリック．

   
3. MyFaces Core ファイルの指定
   1. ソース・ディレクトリとして，先ほど解凍したディレクトリ（ほにゃらら/myfaces-core-2.1.1-bin/lib を指定
   2. すると，ソース・ディレクトリの下に，ファイルの一覧が表示される． ここで，インポートすべきファイルを選べる． 「すべて選択」をクリック．
   3. 以上の操作の後，「完了」をクリック．
   
4. （オプション)もし，「上書きしますか？」と表示されたときは「すべてはい」と答える