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

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


■  概要

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



■  前提条件

  導入環境には、あらかじめ下記のものが用意されている必要があります。

  ・Java 2 Runtime Environment Standard Edition 1.5.0
  ・Eclipse SDK 3.2.2 + WTP 1.5.5
  ・WebAPサーバ：Apache Tomcat 5.5.23
  ・Apache Ant 1.6.5 (EclipseのAntプラグインのみでも可)

  併記されているバージョンを元に動作確認を行っていますが、このバージョン
  以外の環境での動作を制限するものではありません。
  また、これらのインストール及び設定の手順については、別途Web上の利用ガイド等
  を参照してください。 



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

  以下の手順で、Eclipseにプロジェクトをインポートします。

  ①terasoluna-libプロジェクトの展開
    
    terasoluna-lib-web_(バージョン番号).zip を任意のフォルダに展開します。
    terasoluna-lib-webは、TERASOLUNA Server Framework for Java（Web版）の
    各プロジェクトが依存するライブラリ（spring.jar等）を集めたプロジェクトです。
    TERASOLUNA Server Framework for Java（Web版）のプロジェクトをビルドするために
    必要となります。 

    展開されたterasoluna-lib-web_(バージョン番号).zipのフォルダ名が「terasoluna-lib」
    であることを確認します。
    展開ツールや展開のしかたによっては、フォルダ名が
   「terasoluna-lib-web_(バージョン番号)」となる場合がありますが、
   フォルダ名を手動で「terasoluna-lib」に変更してください。 

  ②各プロジェクトファイルの展開

    同様に下記プロジェクトを展開します。 

  ・terasoluna-commons-(バージョン番号).zip
  ・terasoluna-dao-(バージョン番号).zip
  ・terasoluna-ibatis-(バージョン番号).zip
  ・terasoluna-thin-(バージョン番号).zip


  ③展開したフォルダが同一階層にあることを確認

    ①, ②で展開したフォルダが、全て同一のフォルダ内に存在することを確認します。

    別のフォルダに展開した場合や、フォルダ名にバージョン番号が入っている場合は、
    Eclipseのクラスパス設定と、ビルドファイルのプロパティ設定を変更する必要が
    あります。 

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

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

    以下の手順でEclipseに各プロジェクトをインポートします。 

    1.Eclipse画面にて「ファイル」＞「インポート」を選択します。 
    2.既存プロジェクトをワークスペースへ」を選択し「次へ」をクリックします。 
    3.「ルート・ディレクトリーの選択」にチェックが入った状態で「参照」をクリック
       し、ブランクプロジェクトを展開した親フォルダ（ここではC:\terasoluna）を
       指定します。
    4.各プロジェクトにチェックが入っていることを確認し、「終了」をクリックします。


  ⑤コンパイル

    各プロジェクトのコンパイルが正常に実行されることを確認します。エラーが出て
    コンパイルできない場合、JDK5.0でEclipseのコンパイルを行なっているか確認して
    ください。（確認方法はreadmeの最後を参照してください。） 

    また、「シリアライズ可能クラス XXXX は XXXX 型の static final serialVersion
    UID フィールドを宣言していません。」という警告が出ることがありますが、動作に
    問題はありません。 



■  jarファイルの作成

  Antタスクを利用することで、各プロジェクトのjarファイルを作成することができます。

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

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



■  備考

 ・Eclipseのコンパイル設定の確認

  ①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 )

 ・terasoluna-libについて
 　TERASOLUNA Server Framework for Java（Web版）以外のTERASOLUNAフレームワークを
   同一ワークスペース内でコンパイルする場合には、各terasoluna-lib-xxxを
   全て展開した上で、同一のterasoluna-libとして統合してください。
     
  （例）TERASOLUNA Server Framework for Java （Web版）とTERASOLUNA Server Framework for Java （Rich版）
     　 を同一ワークスペース内で共存させる場合は、terasoluna-lib-rich.zipと
     　 terasoluna-lib-web.zipをそれぞれ解凍した後、一方のdistフォルダおよび
     　 libフォルダ内のjarを他方に上書きコピーし、一つのterasoluna-libプロジェクト
     　 としてマージしてください。
        
 ・servlet-api.jar、jsp-api.jarの入手

    これらはterasoluna-libに同梱されていないため、一部のプロジェクトでコンパイル
    エラーが発生します。
    Sun Microsystems, Inc.のサイトやApache Tomcatのサイトから利用者各自で入手・
    導入してください。
    対応バージョンは、Servlet2.4／JSP2.0となります。 

    ・http://java.sun.com/products/servlet/ 
    ・http://java.sun.com/products/jsp/ 
    ・http://tomcat.apache.org/index.html


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