edit= Server Framework for Java（Rich版）[[br]]フレームワーク本体 導入手順 =
== 概要 ==
これはTERASOLUNA Server Framework for Java（Rich版）の開発プロジェクトを導入する手順書です。[[br]]
開発プロジェクトを導入することにより、フレームワークの拡張を行うことが可能になります。
== 前提条件 ==
導入環境には、あらかじめ下記のものが用意されている必要があります。
* Java 2 Runtime Environment Standard Edition 1.5.0
* Eclipse SDK 3.2.0 + 言語パック（日本語）
* WTPプラグイン 1.5.x(xはバージョン番号)「http://www.eclipse.org/webtools/」
* プロパティエディタ プラグイン「http://propedit.sourceforge.jp/」
* WebAPサーバ：Apache Tomcat 5.5.x(xはバージョン番号)
併記されているバージョンを元に動作確認を行っていますが、このバージョン以外の環境での動作を制限するものではありません。[[br]]
また、これらのインストール及び設定の手順については、別途Web上の利用ガイド等を参照してください。
== プロジェクトのインポート ==
以下の手順で、Eclipseにプロジェクトをインポートします。
=== 1. terasoluna-libプロジェクトの展開 ===
terasoluna-lib-rich_(バージョン番号).zip を任意のフォルダに展開します。
terasoluna-lib-richは、TERASOLUNA Server Framework for Java（Rich版）の各プロジェクトが依存するライブラリ（spring.jar等）を集めたプロジェクトです。TERASOLUNA Server Framework for Java（Rich版）のプロジェクトをビルドするために必要となります。
展開されたterasoluna-lib-rich_(バージョン番号).zipのフォルダ名が「terasoluna-lib」であることを確認します。展開ツールや展開のしかたによっては、フォルダ名が「terasoluna-lib-rich_(バージョン番号).zip」となる場合がありますが、フォルダ名を手動で「terasoluna-lib」に変更してください。
=== 2. 各プロジェクトファイルの展開 ===
同様に下記プロジェクトを展開します。
* terasoluna-commons-(バージョン番号).zip
* terasoluna-dao-(バージョン番号).zip
* terasoluna-ibatis-(バージョン番号).zip
* terasoluna-oxm-(バージョン番号).zip
* terasoluna-rich-(バージョン番号).zip
* terasoluna-validator-(バージョン番号).zip
=== 3.展開したフォルダが同一階層にあることを確認 ===
1, 2で展開したフォルダが、全て同一のフォルダ内に存在することを確認します。
別のフォルダに展開した場合や、フォルダ名にバージョン番号が入っている場合は、Eclipseのクラスパス設定と、ビルドファイルのプロパティ設定を変更する必要があります。
（例）C:\terasolunaフォルダの中に以下のフォルダがあることを確認
* terasoluna-commons
* terasoluna-dao
* terasoluna-ibatis
* terasoluna-lib
* terasoluna-oxm
* terasoluna-rich
* terasoluna-validator
=== 4. プロジェクトのインポート ===
以下の手順でEclipseに各プロジェクトをインポートします。
1. Eclipse画面にて「ファイル」＞「インポート」を選択します。
1. 「既存プロジェクトをワークスペースへ」を選択し「次へ」をクリックします。
1. 「ルート・ディレクトリーの選択」にチェックが入った状態で「参照」をクリックし、ブランクプロジェクトを展開した親フォルダ（ここではC:\terasoluna）を指定します。
1. 各プロジェクトにチェックが入っていることを確認し、「終了」をクリックします。
=== 5. コンパイル ===
各プロジェクトのコンパイルが正常に実行されることを確認します。エラーが出てコンパイルできない場合、JDK5.0でEclipseのコンパイルを行なっているか確認してください。（確認方法は本導入手順書の最後を参照してください。）
また、「シリアライズ可能クラス XXXX は XXXX 型の static final serialVersionUID フィールドを宣言していません。」という警告が出ることがありますが、動作に問題はありません。
== jarファイルの作成 ==
Antタスクを利用することで、各プロジェクトのjarファイルを作成することができます。
1. プロジェクトルート/ant/build.xmlの「jar」タスクを実行します。
1. プロジェクトルート/distにjarファイルが生成されていることを確認します。
== 備考 ==
=== Eclipseのコンパイル設定の確認 ===
1. Eclipseのツールバーから「ウィンドウ」＞「設定」を選択し、設定画面を表示します。
1. 左メニューから「Java」＞「コンパイラー」を選択します。
1. 画面右の「コンパイラー準拠レベル」に5.0を選択し、OKボタンを押します。
=== EclipseのAnt実行パスにjarファイルを追加する ===
1. Eclipseのツールバーから「ウィンドウ」＞「設定」を選択し、設定画面を表示します。
1. 左メニューから「Ant」＞「ランタイム」を選択します。
1. 画面右の「クラスパス」タブから「グローバル項目」を選択して「Jarの追加」を押下し、以下のjarファイルを追加します。
* junit-3.8.2.jar
* terasoluna-libプロジェクトのルートフォルダ/lib/junit-3.8.2.jar
=== terasoluna-libについて ===
TERASOLUNA Server Framework for Java（Rich版）以外のTERASOLUNAフレームワークを同一ワークスペース内でコンパイルする場合には、各terasoluna-lib-xxxを全て展開した上で、同一のterasoluna-libとして統合してください。
（例）[[br]]
TERASOLUNA Server Framework for Java （Rich版）とTERASOLUNA Server Framework for Java （Web版）を同一ワークスペース内で共存させる場合は、terasoluna-lib-rich.zipとterasoluna-lib-web.zipをそれぞれ解凍した後、一方のdistフォルダおよびlibフォルダ内のjarを他方に上書きコピーし、一つのterasoluna-libプロジェクトとしてマージしてください。
=== servlet-api.jar、jsp-api.jarの入手 ===
これらはterasoluna-libに同梱されていないため、一部のプロジェクトでコンパイルエラーが発生します。[[br]]
Sun Microsystems, Inc.のサイトやApache Tomcatのサイトから利用者各自で入手・導入してください。[[br]]
対応バージョンは、Servlet2.4／JSP2.0となります。
* http://java.sun.com/products/servlet/
* http://java.sun.com/products/jsp/
* http://tomcat.apache.org/index.html