まっさらの状態からJBoss Seamを使い始めるまでの作業メモ

Seam

ちゃんとドキュメントに書いてあるけれど、一応まとめとしてのメモ。
実は前に入れたので少しうろ覚え。


＠入れたもの

＠入れ方

  1. JDK 5.0を適当にインストールする
  2. JDK 5.0を環境変数「JAVA_HOME」に設定してbinにパスを通す（JREじゃないよ）
  3. Ant 1.6.5を適当に展開する（ものぐさな人はEclipseのplugins内にあるやつにパスを通してもよい）
  4. Ant 1.6.5を環境変数「ANT_HOME」に設定してbinにパスを通す
  5. Eclipse 3.2.1を適当に展開する
  6. JBoss IDE for Eclipse 2.0.0 Beta2を展開したEclipseの上で展開する（上書きが不安なら別のところで展開してフォルダの中身を適宜Eclipseのフォルダにコピーすること）
  7. JBoss AS 4.0.5をインストールする（ここは少し注意がいるので以下に詳細を記す）
    1. jems-installer-1.2.0.CR1.jarを実行する（関連付けられてないなら「java -jar xxx」にて実行）
    2. インストールの種類を聞かれたら「ejb3」か「ejb3-clustered」を選択する（「all」だとだめ）
  8. JBoss Seam 1.1.0 CR1を適当に展開する
  9. JBoss Seam 1.1.0 CR1を展開したフォルダ内の「build.properties」の「jboss.home」にJBoss AS 4.0.5のフォルダを設定する（tomcatはどうでもよさそう。フォルダ区切りの「\」は「\\」と書く必要あり）
  10. Eclipseを立ち上げてworkspaceの設定をしたり、JBossの場所を設定したりする

＠Seamプロジェクトの作り方

  1. DOSプロンプトを開き、JBoss Seam 1.1.0 CR1を展開したフォルダに移動する
  2. コマンド「seam setup」を実行する（これは生成するSeamプロジェクト用の設定をするコマンド。JBossのフォルダとかEclipseのプロジェクト名を聞かれるので適当に答えていく）
  3. コマンド「seam new-project」を実行する（これは設定に従ってEclipseのworkspaceにSeamプロジェクトを生成するもの）
  4. コマンド「seam explode」を実行する（これは上で生成したEclipseのworkspace内のプロジェクトをビルドしてJBossにデプロイするもの。この作業をやらずにEclipseでビルドしてもよい）
  5. この段階でJBossを立ち上げ（WindowsならJBossの「bin/run.bat」を実行）、「http://localhost:8080/プロジェクト名」にアクセスすると自動生成されたページを見ることができる

＠Seamプロジェクトの開発準備

  1. 上記の「seam new-project」まででEclipseのworkspaceにプロジェクトのファイルが生成されている
  2. Eclipseを立ち上げ「Javaプロジェクト」として上記プロジェクトと同名のプロジェクトを作成する（既に設定はすべて済んでいるので、余計な設定は触らずにプロジェクト名だけ入れて「Finish」ボタンを押すこと。プロジェクトの種類も余計なものを選択せずに「Javaプロジェクト」にすること）
  3. 後はEclipse上でファイルを適当に修正して保存すると、自動的にビルドからJBossへのデプロイまでのプロセスが走る（デプロイの際、JBossは落ちたままでも立ち上げたままでもよい。ただ、保存するたびにデプロイするので面倒な場合は自動ビルドを無効にしておき、デプロイしたいときだけビルドするというのもある（ただし、ビルドするまでクラス参照の不整合で怒られ続けることもあるので、これも面倒だったりする））


↓詳細はこちら
http://docs.jboss.com/seam/1.1BETA2/reference/en/html/gettingstarted.html


自動生成されたものはJSF＋Faceletsで構成されているので事前にそれらの知識が必要。
あと、日本語を扱いたい場合はプロジェクトのプロパティでテキストファイルのデフォルトエンコードを「UTF-8」にし、自動生成されたファイルの「view/layout/template.xhtml」内にあるMETAタグのcharset指定をも「UTF-8」にするとよい。



※2006/12/04：「JAVA_HOME」「ANT_HOME」の記述を追加