*******************************************************************************
      TERASOLUNA Server Framework for Java (Rich版)
      チュートリアルプロジェクト 導入手順

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


■  概要：

  このreadmeは、TERASOLUNA Server Framework for Java (Rich版)
  のチュートリアルプロジェクトを導入する手順書です。
  下記手順に従うことで、チュートリアルプロジェクトを実行することができます。 
  


■  前提条件：

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

  ・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上の利用ガイド等を
  参照してください。 
  


■  Antタスク一覧：

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


  ・clean
      作成したwarファイル、コンパイルされたクラスファイルの削除を行う。
  ・compile
      コンパイルを行う。
  ・native2ascii
      native2asciiにてプロパティファイルのコード変換を行う。
  ・deploy
      プロジェクトのデプロイを行う。
  ・createJavaDoc
      JavaDocの生成を行う。


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

  EclipseにWTPプラグインが導入されている場合、以下の手順でサーバーを追加します。 

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



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

  チュートリアルプロジェクトをEclipseにインポートします。また、H2Databaseに初期データ
  を設定します。

  ①ZIPファイルの展開
  
    terasoluna-server4jrich-tutorial_(バージョン番号).zipを任意のフォルダに展開します。 

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

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

    エラーが出る場合は「■備考」を参照し、設定を変更してください。 

  ③H2Databaseに初期データを設定

    1.チュートリアルプロジェクト内の「h2db/h2db_start.bat」を実行します。
      ブラウザが起動し、H2Database Consoleのログイン画面が表示されます。
    2.続けて、「h2db/h2db_init.bat」を実行します。（scriptが実行され初期データが設定されます）
    3.データベースへの接続
      H2Database Consoleのログイン画面で、以下を入力します。 

      保存済設定     ： Generic H2 (Server)
      ドライバクラス ： org.h2.Driver
      JDBC URL       ： jdbc:h2:tcp://localhost/~/terasoluna
      User           ： sa
      Password       ： 

    4.データベースの確認
      データベースの接続後、画面左のテーブル一覧に以下が存在することを確認します。 
      
      テーブル名  ：“USERTABLE”、
      カラム      ：“ID”、“NAME”、“AGE”、“BIRTH”
      
      このままH2Database Consoleは起動したままにしておきます。

      ※1の後、H2Database Consoleが起動しない場合は、「h2db/h2db_console.bat」を実行してください。

  
■  プロジェクトの実行（WTP環境）：
 
  WTPプラグインを利用する場合、以下の手順でプロジェクトを実行します。

  ④サーバーへの追加
  
    サーバービューで「tutorial-rich」のプロジェクトを追加します。
      
  ⑤Tomcatの起動および、実行確認
  
    1.サーバーを始動します。 
    2.http://localhost:8080/tutorial-richにアクセスします。
    3.アクセスするとテストデータを送信する画面が表示されます。
   
　⑥単純なデータの送受信の確認
　  非WTP環境用の手順の⑥を参照してください。


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

  WTPプラグインを利用しない場合、以下の手順でプロジェクトを実行します。 


  ④antタスクの実行
  
    1.プロジェクトの「/ant/build.properties」を自端末の環境に合った値に書き換え
      ます。 
      ・詳細はbuild.propertiesを参照してください。特にパス関連に関しては十分確認
        してください。 
    2.「build.properties」の修正後、「/ant/build.xml」を右クリックしantタスクの
      「deploy」を選択して実行します。 

  ⑤Tomcatの起動および、実行確認
  
    1.デプロイ先のTomcatを起動します。 
    2.http://localhost:8080/<context.name>/にアクセスします。 
      ・「<context.name>」は、build.properties内に記述した値であり、デフォルトは
        tutorial-richとなっています。      
    3.アクセスするとテストデータを送信する画面が表示されます。

　⑥単純なデータの送受信の確認
   
    1.画面上側のリクエストヘッダに「requestName」と入力します。（デフォルト値のまま）
    2.画面上側の値に「simple」と入力します。
    3.要求電文に以下のようにid,name,age,birthを入力します。

　-----------------入力内容-------------------
    <UserBean>
  　　<id>1</id>
  　　<name>テラソルナユーザ１</name>
  　　<age>29</age>
  　　<birth>1978-01-14T12:34:56</birth>
　　</UserBean>
　--------------------------------------------

    4.URLにhttp://localhost:8080/tutorial-rich/secure/blogic.doを入力します。
    5.「送信」ボタンをクリックすると、サーバにリクエストを送信します。
    　リクエスト結果が画面下側（応答電文）に反映されています。
    （その他のリクエストについても、実行方法は同じです。）
    
    他のリクエストを行なう場合、「TERASOLUNA Server Framework for Java（Rich版） チュートリアル」
    を参考にして、手順2と3で記述する内容を差し替えて行います。


■  備考：

  インポート後にエラーが出る場合
  ・「インポートされた ～～ は見つかりません。」
    ⇒WEB-INF/libフォルダ以下にあるWebアプリケーションライブラリーが認識されて
      ない状態です。Eclipseを再起動することで解決します。 
    
  サーバー始動後にエラーが出る場合
  ・「リソース ～～はファイル・システムと同期がとれていません。」
    ⇒Eclipse上のキャッシュと実ファイルの同期が取れていない状態です。該当のプロ
      ジェクトを「右クリック」＞「更新」すると解決します。


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