*******************************************************************************
      TERASOLUNA Server Framework for Java
      フレームワーク開発用プロジェクトの適用について

      Copyright 2007 NTT DATA Corporation.
*******************************************************************************

■  対象読者

  TERASOLUNA Server Framework for Javaを導入するプロジェクト支援担当者
  （ソフトウェアアーキテクト）



■  概要

  この手順書はTERASOLUNA Server Framework for Javaの開発プロジェクトを
　導入する手順を記述する。
　開発プロジェクトを導入することにより、フレームワークの拡張を行うことが
　可能である。



■  前提条件

  導入環境には、あらかじめ下記のものが用意されている必要がある。
  また併記されているバージョンを元に動作確認を行なっているが、
  このバージョン以外の環境で動作を制限することを示すものではない。
  また、これらのインストール、及び設定の手順については省略する。
  （別途利用ガイド等を参照すること。）

  ・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はバージョン番号)



■　プロジェクトのインポート

　①terasoluna-lib-(バージョン番号).zipを任意のフォルダに展開する。
    （terasoluna-libプロジェクトはspring.jar等のterasoluna本体のプロジェクトが依存する
　　　ライブラリを集めたプロジェクトである。
　　　terasoluna本体のプロジェクトをビルドするために必須となる。）
  
    ！注意！
　　展開されたterasoluna-lib-(バージョン番号).zipのフォルダ名が「terasoluna-lib」であることを確認すること。
　　展開ツールや展開のしかたによっては、フォルダ名が「terasoluna-lib-(バージョン番号)」と
　　なる場合がある。その場合、フォルダ名を手動で「terasoluna-lib」に変更すること。

　②以下のアーカイブファイルを展開する。

　【Webブラウザ対応モジュール】
　・terasoluna-thin-(バージョン番号).zip
　・terasoluna-commons-(バージョン番号).zip
　・terasoluna-dao-(バージョン番号).zip
　・terasoluna-ibatis-(バージョン番号).zip


　③①と②で展開したフォルダが同一階層にあることを確認する。
　　（別のフォルダに展開した場合やフォルダ名にバージョン番号が入っている場合は、
　　　Eclipseのクラスパス設定と、ビルドファイルのプロパティ設定を変更する必要がある）

　（例）C:\terasolunaフォルダの中に以下のフォルダがあることを確認する。
　　　　・terasoluna-lib
　　　　・terasoluna-thin
　　　　・terasoluna-commons
　　　　・terasoluna-dao
　　　　・terasoluna-ibatis

　④Eclipseの[ファイル]-[インポート]を選択し、
　[既存プロジェクトをワークスペースへ]を選択し、「次へ」をクリックする。

　⑤[ルート・ディレクトリーの選択]にチェックが入った状態で、「参照」をクリック
　し、①・②で展開したディレクトリを指定する。
　ルートディレクトリに親フォルダ（上記例では、C:\terasoluna）を指定し、表示された
　全てのプロジェクト名にチェックが入っていることを確認し、「終了」をクリックする。

　⑥コンパイルが正常に実行されることを確認する。
　　コンパイルできない場合、JDK5.0でEclipseのコンパイルを行なっているか確認すること。
　　確認方法は本ファイルの最後を参照のこと。
　　また、「シリアライズ可能クラス XXXX は XXXX 型の static final serialVersionUID 
　　フィールドを宣言していません。」という警告が出ることがあるが、動作に問題はない。）


■　jarファイルの作成

　　各プロジェクトのjarファイルの作成方法を以下に示す。

　①プロジェクトルート/ant/build.xmlの「jar」タスクを実行する。

　②プロジェクトルート/distにjarファイルが生成されていることを確認する。



■　単体テストの実行

　①Antの実行パスにjunit-3.8.2.jarを追加する。
　（Antの実行パスの設定方法は本ファイルの最後を参照のこと）

　②プロジェクトルート/ant/testbuild.xmlの「junit」タスクを実行する。

　③テスト結果がプロジェクトルート/testcases/reportsに出力される。





====================================================================
　補足
====================================================================
■Eclipseのコンパイル設定をJDK5.0にする
①Eclipseのツールバーからウィンドウ＞設定を選択し、設定画面を出す
②左メニューからJava＞コンパイラーを選択
③画面右のコンパイラー準拠レベルに5.0を選択し、OKボタンを押す

■EclipseのAnt実行パスにjarファイルを追加する
①Eclipseのツールバーからウィンドウ＞設定を選択し、設定画面を出す
②左メニューからAnt＞ランタイムを選択
③画面右のクラスパスタブからグローバル項目を選択し、「Jarの追加」を押下し、
　以下のjarファイルを追加する。
　・junit-3.8.2.jar･･･terasoluna-libプロジェクトのルートフォルダ/lib/junit-3.8.2.jar

■servlet-api.jar、jsp-api.jarの入手
これらはterasoluna-libに同梱されていないため、一部のプロジェクトで
コンパイルエラーが発生する。
Java EE のAPIライブラリに含まれているため、利用者各自で入手する必要がある。
http://java.sun.com/


-------------------------------------------------------------------------------
Copyright 2007 NTT DATA Corporation.