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

このトピックでは、BC4Jランタイム・コンポーネントおよびBC4JアプリケーションをJ2EE Webモジュール(WAR)とEnterprise JavaBeans(EJB)として、Apache Tomcat 4.1.12を含むJBoss 3.0.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-3.0.4_Tomcat-4.1.12/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-3.0.4_Tomcat-4.1.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%は、JDeveloperがインストールされているディレクトリです。これらのファイルをコピーするときに、installbc4j.batというWindowsスクリプトを使用することもできます。

  1. BC4J Webアプリケーションを使用している場合は、bc4j.earファイルを<jdev_install>/BC4J/redistから<JBOSS_install>/deployにコピーして、デプロイする必要があります。たとえば、次のようなディレクトリにコピーします。
    C:\JBoss-3.0.4_Tomcat-4.1.12\jboss\deploy
    このファイルには必須Webアプリケーション、およびデプロイメントに必要なUIXファイルが含まれています。このタスクは1回のみ実行します。BC4J Webアプリケーションがデプロイされるたびに実行する必要はありません。
  2. これらのファイルをJBoss lib/extディレクトリにコピーしたら、JBossを再起動します。
  3. JBossクライアント側ライブラリについてJDeveloperでライブラリを作成し、JBoss内でデプロイしたEJBをテストします。 JBossのクライアント側ライブラリは、JBossディレクトリ内のクライアント・ディレクトリ(たとえばC:¥JBoss-3.0.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/などです。

参照先