マスカット サンプルアプリケーション (Java 版) 2.0.0
README - はじめにお読みください

最終更新日: 2008/7/16

マスカットプロジェクト
http://maskat.sourceforge.jp/


1. 概要
───────────────────────────────────

この文書では、マスカットサンプルアプリケーション (Java 版) の動作手順
について説明します。


2. 動作環境
───────────────────────────────────

2.1 想定する動作環境

このサンプルアプリケーションを実行するためには以下の開発環境および実行
環境が必要です。

・Java 開発環境 (JDK)
JDK 6 以降がインストールされており、環境変数 JAVA_HOME が適切に設
定されていること。

・開発ツール
Apache Ant 1.7.0 以降がインストールされており、環境変数 ANT_HOME
が適切に設定されていること。

・AP サーバ
Apache Tomcat 5.5 以降がインストールされており、環境変数
CATALINA_HOME が適切に設定されていること。


2.2 動作確認済み環境

マスカットプロジェクトでは、以下の環境及びバージョンを元にサンプルアプ
リケーション (Java 版) の動作確認を行なっています。この環境およびバー
ジョン以外の動作を制限するものではありませんが、開発／運用環境に応じて
動作確認をお願いします。

・OS : Windows XP Professional SP2（x86, 32bit）
・JDK : Sun JDK 6.0 Update 7 (1.6.0_07)
・AP サーバ : Apache Tomcat 5.5.26
・開発ツール : Apache Ant 1.7.1


3. インストール手順
───────────────────────────────────

以下の手順に従ってサンプルアプリケーションを設置してください。

1) マスカットプロジェクトの公式サイトから、サンプルアプリケーション
(Java 版) の配布アーカイブをダウンロードして展開します。
以下では展開したフォルダを ${basedir} として説明します。

2) ${basedir}/src/jdbc.properties ファイルを開き、データベースとして
使用するフォルダの位置を指定します。指定されたフォルダは自動的に
生成されるため、事前に作成しておく必要はありません。

以下の例では C:\maskat\db を使用するための設定を行っています。
--------------------------------------------------
jdbc.url=jdbc:derby:C:/maskat/db;create=true
--------------------------------------------------

3) ant コマンドにターゲット「schema」を指定して実行すると、2) で指定
したフォルダに Apache Derby データベースのスキーマを生成し、初期
データをインポートします。
--------------------------------------------------
% ant schema
--------------------------------------------------

4) ant コマンドを引数なしで実行すると Java ソースコードがコンパイル
されて ${basedir}/web フォルダ以下がデプロイ可能な Web アプリケー
ションとして構成されます。

デプロイのために Web アプリケーションアーカイブ (war ファイル) が
必要な場合には ant コマンドにターゲット「dist」を指定して実行する
と ${basedir}/dist フォルダに maskat.war が作成されます。
--------------------------------------------------
% ant
% ant dist
--------------------------------------------------

5) Tomcat のベースフォルダ (CATALINA_HOME) 内の webapps フォルダに
maskat.war をコピーします。


4. 動作確認
───────────────────────────────────

Tomcat を起動後、Web ブラウザからメニュー画面にアクセスします。

ローカル環境で Tomcat をデフォルト設定のまま実行した場合、メニュー画面
は以下のURL で表示されます。

http://localhost:8080/maskat/sample/

それ以外の場合には、Web アプリケーションのコンテキスト URL に /sample/
を追加した URL がメニュー画面の URL になります。メニュー画面には以下の
アプリケーションへのリンクが表示されます:

・四則演算
・ペットストア
・フルーツショップ
・レストラン検索


以上

───────────────────────────────────
Copyright(C) 2006-2008 マスカットプロジェクト