このドキュメントではWebOTX V6.5を利用して、Sun Microsystems（以降、Sunと略します）がウェブサイトで提供しているJ2EEアプリケーションのサンプル「Pet Store」を動作させるまでの手順を説明します。

　Pet Storeサンプルアプリケーションの動作にはWebOTX V6.5のほかに、データベースサーバが必要です。これはアプリケーションの構成上、商品の情報や顧客の情報、取引の情報をデータベースに保存する必要があるからです。今回はOracleを使用します。

　Pet Storeは、ペットの販売サイトを模したサンプルアプリケーションです。 Pet Storeのソースコードの構成は、J2EEプラットフォームで動作する拡張性、移植性、保守性の高いアプリケーションの例となっています。

　WebOTXを用いてシステム構築を行う開発者にとって、Pet Storeには以下のような特徴があります。


１.１. ３層構成システム

　Pet Storeデモは多層構造システムをモデルにした構成例となっています。

　大規模な人員で開発を行う際、生産性を高めるために、システムを多階層に分離することが推奨されます。機能的に階層化することで、各システムを役割で切り分けることができ、複数のサブチームそれぞれで開発範囲を明確にすることができます。そして、インタフェースさえ事前に取り決めておけば、他のチームの内部実装を意識せずに平行開発を行うことができます。

　また、メインフレーム等他のプラットフォームで動作しているシステムやデータベースを多層構造システムの1層と考えれば、そのインタフェースを経由する構造を採ることによって、既存システム（Sunの文書では「エンタープライズ情報システム」と呼んでいます）とJ2EEシステムを容易に統合することが可能になります。WebOTXにはJDBC、JCAなどの既存システムとの接続を可能にするJ2EE標準APIが用意されています。

　Pet Storeデモでは、J2EEでのシステム開発に一般的に使われている3層モデルが用いられています。

• プレゼンテーション層
  HTML、JSP、サーブレットを用いて、クライアントに対話型コンテンツを提供します。
  
  
• アプリケーション層
  ビジネスロジックが動作します。EJB(Enterprise JavaBeans)が用いられます。
  
  
• データベース層
  永続データを保管します。本ドキュメントではOracleを使用します。

１.２. J2EE APIの使用例

　Pet StoreデモはEJB(Session Bean、Entity Bean、メッセージドリブンBean)、サーブレット、JSP、JMS等J2EEの主要な機能を多く使用しているため、開発者はPet Storeデモでの実装方法や使用方法を手本にしながら開発を行うことができます。

　Pet StoreデモはEJBを使用しているため、WebOTX Web Editionでは動作しません。

　EJBコンテナを備えた、WebOTX V6.5 Standard-J Edition以上をインストールします。

　なお、Standard/Enterprise Editionを利用する場合は、インストール時に「マルチプロセスモード」(Webコンテナがプロセスグループ上で動作するモード)(*)を選択してください。

　これはPet Storeのプログラムでは、サーブレットからEJBを呼び出す際、ローカルインタフェースを使用しているためであり、WebコンテナとEJBコンテナが同一プロセス上で動作している必要があるからです。

(*)マルチプロセスモードは、WebOTX V6.5から導入されました。これを使うことでWebコンテナ上で動作するWebアプリケーションを、WebOTXが提供するTPモニタ上で監視可能、かつマルチプロセスでの並列処理が可能となるため、Webシステムの信頼性・性能の向上を実現します。
　それに対しシングルプロセスモード(V6.4までの構成)では、それらの機能を使用することができません。

３.１. Pet Storeサンプル入手

　Sunのダウンロードのページの、"Samples Bundle"から入手してください。2006年11月9日現在、J2EE 1.4用の最新版は1.4_03となっています。

　ダウンロードしたzipファイルを適当なディレクトリに展開してください。以後本手順書では、展開したディレクトリをサンプルインストールディレクトリとし、

(petstore_root)
　= (サンプルインストールディレクトリ)/samples/blueprints/petstore1.4/src

として説明を進めていきます。

３.２. 提供ファイル「wo_petstore.zip」のダウンロード

　設定の書き換えを行うため、wo_petstore.zipをダウンロードしてください。その後適当なディレクトリに展開してください。次のフォルダに展開されます。

• samples

４.１. common.propertiesの設定

　(サンプルインストールディレクトリ)/samples/common.propertiesファイル内の以下の項目を設定します。

• webotx.home=(WebOTXインストールディレクトリ)
• com.sun.aas.javaRoot= (javaインストールディレクトリ)
• sample.dir=(サンプルインストールディレクトリ)/samples

• mailHost=(メールサーバホスト名)
• mailuser1=(メールユーザ名)
• mailFrom=(送信元メールアドレス)
  このアドレスはメールヘッダのFromアドレスに使われます

４.２. ビルドファイルのファイル名変更

　インストールしたエディションに応じて、ビルドファイルのファイル名を変更します。(petstore_root)ディレクトリにはすでにオリジナルのbuild.xmlファイルが配置されています。ここではWebOTX用に置換しますので、元のbuild.xmlファイルをbuild.xml.bak等にリネームしておいてください。

• Standard/Enterprise Editionの場合
  (petstore_root)ディレクトリ配下のbuild_for_STD.xmlを、build.xmlに変更してください。
  
  
• Standard-J Editionの場合
  (petstore_root)ディレクトリ配下のbuild_for_STDJ.xmlを、build.xmlに変更してください。

４.３. データベースサーバの設定

　まず「database.properties」の設定についてですが、次の項目(Info for Oracle thin)について、Oracleの環境に合わせて設定してください。

• oracle.dbName
• oracle.server
• oracle.port
• oracle.user
• oracle.passwd

４.４. メール通知の設定（任意）

　PetStoreで商品を選択して購入した際に、アプリケーションが利用するJavaMail APIを経由して、SMTPプロトコルでメールを送信することができます。WebOTXより通知メールを行う場合は、以下のメールサーバとメールアドレスの設定、および受信するメッセージの種類を選択します。

　この作業は必須ではありません。

　まず、メールサーバとメールアドレスの設定を行います。(petstore_root)/src/build.propertiesファイルに対して、以下の値を環境に合わせて書き換えてください。

• mail.host=(メールサーバ名)
• mail.username=petstore
• mail.fromaddress=(送信元メールアドレス)

対象ファイル：(petstore_root)/apps/opc/src/ejb-jar.xml

• 受信受付通知書

  244:  <env-entry>
  245:    <env-entry-name>param/SendApprovalMail</env-entry-name>
  246:    <env-entry-type>java.lang.Boolean</env-entry-type>
  247:    <env-entry-value>false</env-entry-value>
  248:  </env-entry>
  

• 注文確認通知書

  52:  <env-entry>
  53:    <env-entry-name>param/SendConfirmationMail</env-entry-name>
  54:    <env-entry-type>java.lang.Boolean</env-entry-type>
  55:    <env-entry-value>false</env-entry-value>
  56:  </env-entry>
  

• 商品送付完了通知書

  128:  <env-entry>
  129:    <env-entry-name>param/SendCompletedOrderMail</env-entry-name>
  130:    <env-entry-type>java.lang.Boolean</env-entry-type>
  131:    <env-entry-value>false</env-entry-value>
  132:  </env-entry>
  

　(petstore_root)/sql/oracleにあるSQL文を以下の順で実行してください。

1. oracle.createUser.sql
2. oracle.petstoredb.sql
3. oracle.opcdb.sql
4. oracle.supplierdb.sql

　コマンドプロンプトを開き、(petstore_root)ディレクトリに移動して、「asant」コマンドを実行してください。BUILD SUCCESSFULと表示されればコンパイル成功です。

　コンパイルにより生成されるclassファイルは、配備記述子とともにJarファイル形式でパッケージされ、さらに複数のJarファイルがEarファイル形式にパッケージされます。

　配備とはアプリケーションをWebOTXにインストールして利用可能な状態にすることを言います。

ここからは、WebOTXのドメインが起動した状態で作業を行います。(petstore_root)ディレクトリで、「asant deploy」コマンドを実行してください。JNDI、JMS、メールの設定およびアプリケーションの配備が行われます。

　その他のコマンドは以下を参照してください。

　正常に配備されなかった場合は、コンソールに表示されたメッセージを見るか、ログを参照してください。ログは以下のファイルに出力されます。

(WebOTXインストールディレクトリ)/domains/domain1/lib/logs/webotx_agent.log

　ブラウザから以下のURLにアクセスしてください。

　http://localhost/petstore/

　中ほどにある「enter the store」のリンクをクリックすると、データベースの初期化作業後、以下の画面に遷移します。