******************************************
*     Japan JBoss User Group (JJBug)     *
*         http://www.jbug.jp/            *
******************************************

EJB3.0 TrailBlazerデモ和訳 README
=================================
2006年4月30日版

はじめに
--------
Japan JBoss User Groupでは、JBoss Inc.の許可を得て、TrailBlazerデモの
和訳をしています。TrailBlazerはJBoss技術の習得をハイキングに見立てたデ
モプログラムです。トレイル(小道)に沿って学習を進めていくとJBossの技術
が習得できるように工夫されています。

英単語のTrailBlazerは、「先駆者」とか「開拓者」という意味ですが、この
和訳では、親しみをこめてJBoss TrailBlazerのことを「JBoss達人への道」と
タイトルをつけています。

動作条件
--------
本デモプログラムを動作させるには以下の環境が必要です。

* J2SE 1.5
* JBoss 4.0.4 RC1
* JBoss EJB3 RC5

注意：
EJB3TrailBlazerをJBoss 4.0.4上で動作させるには、次のいずれかの方法で
JBossにEJB3をインストールしてください。

* インストーラでJBossを入れ、構成で"ejb3"を指定する
* zip版JBossを解凍後、EJB3をインストールする

テスト環境
----------
本デモプログラムは以下の環境で動作確認をしました。

* Windows XP SP2
* jdk1.5.0_06
* JBoss 4.0.4 RC1
* JBoss EJB3 RC5

注意：
JBoss 4.0.4 CR2とEJB3 RC6の組み合せでは「セッションBeanのライフサイク
ル」のサンプルアプリケーション実行中にエラーになることが報告されています。

ビルド方法
----------
Antを使ってbuild.xmlを実行するとbuild/jar/EJB3Trail.earが作成されます。

日本語版用に別のコンテキストルートを設定するには、dd/ear/application.xml
の<context-root>EJB3Trail</context-root>の"EJBTrail"の部分を"EJBTrail-JA"
のように別の値で書き換えて、再ビルドしてください。

起動方法
--------
EJB3Trail.earをJBossサーバのdeployディレクトリにコピーしてください。
ブラウザで次のURLを指定すればデモプログラムのページが開きます。
http://localhost:8080/EJB3Trail/

ライセンス
----------
本デモプログラムはLGPLで配布します。
http://www.gnu.org/licenses/lgpl.html

Q & A
------
本デモプログラムに関するご意見やご質問はJJBugメンバーMLまでお願いします。
http://lists.sourceforge.jp/mailman/listinfo/japan-jbug-members

日本語対応java2html
-------------------
TrailBlazersではAntでビルドする際にJava2Htmlを使ってJavaファイルやJSP
ファイルをHTML化しています。

しかし、オリジナルのEJB3TrailBlazerのlib/java2html.jarは出力ファイルの
charsetをiso-8859-1に固定しているために、日本語を含むJavaファイルを
HTML に変換すると文字化けが発生してしまいます。

本デモでは、java2htmlの出力結果のHTMLでcharsetに日本語エンコーディング
を指定できるように、java2htmlのソースコードを変更してビルドしたものを
lib/java2html.jarに含めています。

この日本語対応java2htmlの作成方法および修正ファイルは下記のページに書
かれています。
http://d.hatena.ne.jp/tokobayashi/20060422#p1
