BC4J WebアプリケーションのJBossへのデプロイ

このトピックでは、BC4Jランタイム・コンポーネントおよびBC4JアプリケーションをJ2EE Webモジュール(WAR)とEnterprise JavaBeans(EJB)として、Apache Tomcat 4.0.1を含むJBoss 2.4.4にデプロイするときの必要条件と手順を詳しく説明します。

注意:  このトピックに記載されている情報は、http://otn.oracle.com/products/jdev/howtos/appservers/deploy_bc4j_to_jboss.htmlからも入手できます。

BC4J WebアプリケーションをJBossにデプロイするには、次のようにします。

  1. BC4Jプロジェクトを作成します。
  2. ビジネス・コンポーネント・プロジェクト・ウィザードのステップ1で、「SQLスタイル」「SQL92」に、「型マップ」「Java」に変更します。EJBセッションBeanとしてBC4Jアプリケーションをデプロイするときには、JBossがエミュレートするXA DataSource実装を使用するため、この変更が必要になります。
  3. ビジネス・コンポーネント・ウィザードで、デフォルトのビュー・オブジェクトとデフォルトのアプリケーション・モジュールを含むエンティティ・オブジェクトを作成します。
  4. JBossを起動します。
  5. Windowsでは、setvars.batスクリプトを使用してJBossを起動します。

    UNIX(Bourne Shell)では、JAVA_HOME環境変数を設定し、Java2 SDKのbinディレクトリをPATHに追加します。次に例を示します。

    export JAVA_HOME=/usr/java/jdk1.4
    export PATH=${PATH}:${JAVA_HOME}/bin

  6. JBoss/binディレクトリにあるrun_with_catalinaスクリプト(またはrun_with_tomcatスクリプト)を実行します。次に例を示します。

    C:/JBoss-2.4.4_Tomcat-4.0.1/jboss/bin

    JBossが起動すると、コマンド・シェルにいくつかの行が表示されます。

  7. 起動したら、次のように入力して、Tomcat 4.0.1を使用するJBossが実行されていることを確認します。

    http://localhost:8080/jboss/index.html

  8. BC4JアプリケーションをJBossにデプロイするには、使用コンピュータの<JBOSS_install>/lib/extディレクトリに次のBC4Jランタイム・ライブラリをコピーする必要があります。たとえば、C:/JBoss-2.4.4_Tomcat-4.0.1/jboss/lib/extなどのディレクトリがあります。
  • %jdev_install%\bc4j\lib\bc4jct.jar
  • %jdev_install%\bc4j\lib\bc4jctejb.jar
  • %jdev_install%\bc4j\lib\bc4jdomorcl.jar
  • %jdev_install%\bc4j\lib\bc4jhtml.jar
  • %jdev_install%\bc4j\lib\bc4jimdomains.jar
  • %jdev_install%\bc4j\lib\bc4jmt.jar
  • %jdev_install%\bc4j\lib\bc4jmtejb.jar
  • %jdev_install%\bc4j\lib\bc4juixtags.jar
  • %jdev_install%\bc4j\lib\collections.jar
  • %jdev_install%\bc4j\lib\datatags.jar
  • %jdev_install%\bc4j\lib\uixtags.jar
  • %jdev_install%\bc4j\redist\cabo.war
  • %jdev_install%\jdbc\lib\classes12.jar
  • %jdev_install%\jdbc\lib\nls_charset12.jar
  • %jdev_install%\jdev\lib\jdev-rt.jar
  • %jdev_install%\jlib\jdev-cm.jar
  • %jdev_install%\jlib\uix2.jar
  • %jdev_install%\jlib\share.jar
  • %jdev_install%\jlib\regexp.jar
  • %jdev_install%\lib\xmlparserv2.jar
  • %jdev_install%\ord\jlib\ordim.jar
  • %jdev_install%\ord\jlib\ordhttp.jar
  • %jdev_install%\sqlj\lib\runtime12.jar

注意: ここで、%jdev_install%は、Oracle9i JDeveloperがインストールされているディレクトリです。これらのファイルをコピーするときに、installbc4j.batというWindowsスクリプトを使用することもできます。

  1. BC4J Webアプリケーションを使用している場合は、bc4j.earファイルを<jdev_install>/BC4J/redistから<JBOSS_install>\deployにコピーして、デプロイする必要があります。たとえば、C:\JBoss-2.4.4_Tomcat-4.0.1\jboss\deployです。このファイルには必須Webアプリケーション、およびデプロイメントに必要なUIXファイルが含まれています。このタスクは1回のみ実行します(BC4J Webアプリケーションがデプロイされるたびに実行する必要はありません)。
  2. これらのファイルをJBoss lib\extディレクトリにコピーしたら、JBossを再起動します。
  3. JBossクライアント側ライブラリについてJDeveloperでライブラリを作成し、JBoss内でデプロイしたEJBをテストします。JBossのクライアント側ライブラリは、JBossディレクトリ内のクライアント・ディレクトリ(たとえばC:\JBoss-2.4.4\client)に配置され、JBoss内でのデプロイしたEJBのテストに使用されます。「プロジェクトへのライブラリの組込み」を参照してください。

BC4JアプリケーションをWARとしてJBossにデプロイするには

BC4JアプリケーションをEJBセッションBeanとしてデプロイしている場合は、「EJBセッションとしてのBC4JのJBossへのデプロイ」を参照してください。ビジネス・コンポーネント・デプロイメント・ウィザードを使用して、BC4Jアプリケーションをデプロイします。

  1. デプロイするbc4j_project_icon <ProjectName>.bcdeployデプロイメント・プロファイルをナビゲータで選択します。
  2. 右クリックして、「すぐに配布」を選択します。

    JDeveloperによって、BC4Jシンプル・アーカイブ・ファイルが作成され、出力ディレクトリに書き込まれます。配布ログ・ウィンドウにデプロイメント・メッセージが表示されます。

BC4J JSPアプリケーションを作成したら、中間層JARファイルをWARにパッケージします。このJARファイルのデフォルト名はProject1CSMT.jarです。

BC4J JSPアプリケーションの作成

Javaに対してビジネス・コンポーネントをテストするには、ビジネス・コンポーネントを使用するJSPアプリケーションを作成します。

  1. 新しい空のプロジェクトを作成します。
  2. ビジネス・コンポーネントJSPアプリケーション・ウィザードを使用して、作成したBC4JオブジェクトについてデフォルトのJSPアプリケーションを作成します。
  3. メイン・メニューから、「ファイル」->「すべて保存」を選択します。

BC4J JSPアプリケーションのデプロイ

デフォルトのBC4J JSPアプリケーションを作成すると、デフォルトのデプロイメント・プロファイルが自動的に作成されます。このプロファイルの名前は<myappwar>.deployです。

WARファイルをデプロイする手順は次のとおりです。

  1. ナビゲータで、WAR_dep_profile_icon <myappwar>.deployを右クリックし、ポップアップ・メニューから「WARファイルにデプロイ」を選択します。
  2. 配布ログ・ウィンドウに、新たに作成されたWARファイルの場所を示すメッセージが表示されます。このファイルをJBoss\deployディレクトリにコピーします。

これで、正常に機能するBC4J JSPアプリケーションがWebモジュールとしてデプロイされました。次のようなアプリケーションURLを入力することにより、Webブラウザでアプリケーションを起動できます。

http://localhost:8080/<context root>

ここで、<context root>は、BC4J JSPアプリケーションを含むプロジェクトのJ2EEコンテキスト・ルートです。たとえば、Workspace1-Project1-context-root/などです。

参照先