History: HowToUseBlankWeb - TERASOLUNA Framework - TERASOLUNA Framework

Server Framework for Java（Webブラウザ対応版）
ブランクプロジェクト 導入手順

◆概要

これはTERASOLUNA Server Framework for Java（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プラグインだけでも問題ない。)

◆Antタスク一覧

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

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

◆サーバーの追加（WTP環境）

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

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

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

1.　ZIPファイルの展開

1. terasoluna-spring-thin-blank.zipを「C:\」直下に展開する。
   • 例「C:\terasoluna-spring-thin-blank\」
   • （※）指定されたディレクトリは固定ではないため、適宜読み替えて実行すること。

ここでは、（Windows XPの）C:\に展開すると仮定し、手順を進めていきます。

2.　Eclipseへのインポート

1. Eclipse画面にて「ファイル＞インポート」を実行し、「既存プロジェクトをワークスペースへ」を選択し「次へ」をクリックする。
2. プロジェクト内容のブラウズから上記で展開したディレクトリを指定し、「終了」をクリックする。

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

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

3.　サーバーの追加

1. サーバービューで「terasoluna-spring-thin-blank」のプロジェクトを追加する。

4.　Tomcatの起動および、実行確認

1. サーバーを始動する。
2. http://localhost:8080/terasoluna-spring-thin-blank/にアクセスし、「-- ようこそTERASOLUNAへ --」という画面が表示されれば、デプロイ成功

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

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

3.　antタスクの実行

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

4.　Tomcatの起動および、実行確認

1. デプロイ先のTomcatを起動し、以下のアドレスにアクセスする。
   • http://localhost:8080/<context.name>/

（※）「<context.name>」は、build.properties内に記述した値。デフォルトはblankとなっている。

「-- ようこそTERASOLUNAへ --」という画面が表示されていればデプロイ成功