*******************************************************************************
      TERASOLUNA Server Framework for Java（Spring版）
      機能網羅サンプル WEBブラウザ対応版 適用手順について

      Copyright 2006-2007 NTT DATA Corporation.
*******************************************************************************



■  対象読者：

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

■  概要：

  このreadmeは、TERASOLUNA Server Framework for Java（Spring版）の
  機能網羅サンプル WEBブラウザ対応版を導入する手順を記述する。
  下記手順に従うことにより、TERASOLUNAフレームワークの機能網羅サンプルの
  実行環境を準備することができる。

■  前提条件：

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

  ・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プラグインだけでも問題ない。)
  ・PostgreSQL Database Server 8.2
  　または
  ・Oracle10g

■  Antタスク一覧：

  プロジェクトの「\ant」フォルダには、antタスクが記述された
  「build.xml」が存在する。以下にantタスクの一覧を記述する。

  ・clean
      作成したwarファイル、コンパイルされたクラスファイルの削除を行う。
  ・compile
      コンパイルを行う。
  ・native2ascii
      native2asciiにてプロパティファイルのコード変換を行う。
  ・deploy
      プロジェクトのデプロイを行う。
  ・createJavaDoc
      JavaDocの生成を行う。
  ・testcase
      機能テスト実行用のアプリケーションをデプロイする。
  ・native2ascii_testcase
  　　機能テスト用にプロパティファイルのコード変換を行う。
  ・compile_testcase
  　　機能テスト用にコンパイルを行う。


■  サーバーの追加（WTP環境）：

    ・Eclipse画面にて「ウィンドウ＞ビューの表示＞その他」を実行し、
    　「サーバー」を選択し「OK」をクリックする。
    ・サーバービューで右クリック「新規＞サーバー」を実行する。
    ・「Apache＞Tomcat v5.5 サーバー」を選択し、「次へ」をクリックする。
    ・「Tomcat」を選択し、「次へ」をクリックする。
    ・自端末の環境に合った「Tomcat インストール･ディレクトリー」を選択し、
     「終了」をクリックする。


■  プロジェクトの実行（共通）：

  ①JDBCドライバの配置
    TomcatがDB接続できるようにJDBCドライバを「＜TOMCATホーム＞/common/lib」に
    コピーする。
    JDBCドライバは付属していないので、別途調達する。
    ・Oracle
    http://otn.oracle.co.jp/software/tech/java/jdbc/index.html
    ・PostgreSQL
    http://jdbc.postgresql.org/download.html
    ※バージョンさえあっていればクライアント等をインストールした際に付属している
      ものを利用してよい。

  ②ZIPファイルの展開
    functionsample-thin.zipを「C:\」直下に展開する。
      ・例「C:\functionsample-thin\」
    （※）指定されたディレクトリは固定ではないため、適宜読み替えて実行すること。
    ここでは、（Windows XPの）C:\に展開すると仮定し、手順を進めていく。

  ③データベース環境の設定
   ◇Oracleの場合
    1.前提条件(環境により変更可能)
        インスタンス名･･･functionsampledb
        DBユーザー名/パスワード･･･sample/sample
        ネットサービス名･･･SAMPLEDB

    2.「setup_for_Oracle.bat」の編集
        「/sql/oracle/setup_for_Oracle.bat」を自端末の環境に合った値に書き換える。
        詳細は「/sql/oracle/setup_for_Oracle.bat」を参照のこと。

    3.テーブル、サンプルデータの作成
      「/sql/oracle/setup_for_Oracle.bat」を実行する。(eclipseから実行不可)
      「SQL> 」が表示されたら exitと入力して終了する。
      ※実行時パスの整合性のため、必ず 当該ファイルが存在するフォルダで実行すること。

   ◇PostgreSQLの場合
    1.前提条件(環境により変更可能)
      pgAdminを起動し、新しいデータベースを作成する。
        名前･･･functionsampledb
        オーナー･･･postgres
        エンコーディング･･･UTF8
        Template･･･（なし）
        テーブル空間･･･pg_default

    2.「setup_for_PostgreSQL.bat」の編集
        「/sql/postgresql/setup_for_PostgreSQL.bat」を自端末の環境に合った値に書き換える。
        詳細は「/sql/postgresql/setup_for_PostgreSQL.bat」を参照のこと。

    3.テーブル、サンプルデータの作成
      「/sql/postgresql/setup_for_PostgreSQL.bat」を実行する。(eclipseから実行不可)
      ※実行時パスの整合性のため、必ず 当該ファイルが存在するフォルダで実行すること。

  ④Eclipseへのインポート
    ・Eclipse画面にて「ファイル＞インポート」を実行し、
      「既存プロジェクトをワークスペースへ」を選択し「次へ」をクリックする。
    ・プロジェクト内容のブラウズから１で展開したディレクトリを指定し、
      「終了」をクリックする。
    ・エラーが出る場合は「■備考」を参照し、設定を変更する。 

  ⑤設定ファイルの編集（データソース）
    ・「context.xml」の編集
      「/webapps/META-INF/context.xml」を自端末の環境に合った値に書き換える。
      詳細は「context.xml」を参照のこと。
    ・Tomcatがタグのインスタンスをプールすることによって発生する不具合を防ぐため、
      TOMCAT_HOME/conf/web.xmlのJspServletのinit-paramに
      enablePoolingという変数名でfalseを設定する。

■  プロジェクトの実行（WTP環境）：

  ⑥サーバーの追加
    ・サーバービューで「functionsample-thin」のプロジェクトを
      追加する。
    
  ⑦Tomcatの起動および、実行確認
    ・サーバーを始動する。エラーダイアログが出る場合は「■備考」を参照のこと。
  
■  プロジェクトの実行（非WTP環境）：

  ⑥antタスクの実行
    ・Eclipseのプロジェクトが作られたら、インポートしたプロジェクトの
      「/ant/build.properties」を自端末の環境に合った値に書き換える。
      詳細はbuild.propertiesを参照のこと。
      とくにパス関連に関しては再確認を行うこと。
    ・「build.properties」の修正後、「/ant/build.xml」を
      右クリックしantのdeployを選択して実行する。

  ⑦Tomcatの起動および、実行確認
    ・デプロイ先のTomcatを起動する。

■備考

  ■インポート後にエラーが出る場合
    1.「インポートされた ～～ は見つかりません。」
    WEB-INF/libフォルダ以下にあるWebアプリケーションライブラリーが認識されてない状態。
    Eclipseを再起動することで解決する。
    
    2. 「～～ を解決できません。」
    JSPのスクリプト変数を認識できてないために出ているエラー。
    プロジェクトを右クリック＞プロパティ＞妥当性検査＞妥当性検査の設定の指定変更
    をチェックし、JSP構文バリデーターのチェックをはずす。その後、Eclipseを再起動すると
    解決する。
    
  ■サーバー始動後にエラーが出る場合
    「リソース ～～はファイル・システムと同期がとれていません。」
    Eclipse上のキャッシュと実ファイルの同期が取れていない状態。
    該当のプロジェクトを「右クリック＞更新」すると解決する。

  ■「context.xml」の変更が反映されない場合（非WTP環境）
    非WTP環境で「context.xml」を修正しても 変更が反映されない場合は、
    「＜TOMCATホーム＞/conf/Catalina/localhost/functionsample-thin.xml」
    を削除後に Tomcatを起動する。



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