ORACLE JAPAN Server Release 6.1

 

  |  

  WebLogic Server ホーム   |     アプリケーションの開発   |   前へ   |   次へ   |   目次   |   索引   |   PDF 版

WebLogic Server J2EE アプリケーションの開発

 

以下の節では、エンタープライズ アプリケーション、Web アプリケーション、エンタープライズ JavaBean など、さまざまな WebLogic Server J2EE アプリケーションを作成する方法について説明します。

WebLogic Server アプリケーションは、Java プログラマ、Web デザイナ、およびアプリケーション アセンブラによって作成されます。プログラマとデザイナは、アプリケーションのビジネス ロジックとプレゼンテーション ロジックを実装するコンポーネントを作成します。アプリケーション アセンブラは、コンポーネントをアセンブルして、WebLogic Server にデプロイ可能なアプリケーションを作成します。

 


アプリケーションの作成 : 主な手順

Web アプリケーションを作成するには、HTML ページ、JSP、サーブレット、JSP taglibs、および 2 つのデプロイメント記述子を作成してから、それらをすべて *.war ファイルにパッケージ化する必要があります。*.war ファイルは、Web アプリケーションとして WebLogic Server にデプロイされます。

Web アプリケーション作成の主な手順は次のとおりです。

  1. Web アプリケーションの Web インタフェースを構成する HTML ページおよび JSP を作成します。通常、Web デザイナは、Web アプリケーションのこの部分を作成します。

    JSP 作成の詳細については、『WebLogic JSP プログラマーズ ガイド』を参照してください。

  2. サーブレットと、JavaServer Pages(JSP) で参照される JSP taglibs 用の Java コードを記述します。通常、Java プログラマは、Web アプリケーションのこの部分を作成します。

    サーブレット作成の詳細については、『WebLogic HTTP サーブレット プログラマーズ ガイド』を参照してください。

  3. クラス ファイルへのサーブレットのコンパイル

    コンパイルの詳細については、 コンパイルの準備を参照してください。

  4. web.xml および weblogic.xml デプロイメント記述子を作成します。

    web.xml ファイルは各サーブレットと JSP ページを定義し、Web アプリケーションで参照されるエンタープライズ Bean を列挙します。weblogic.xml ファイルは、WebLogic Server 用の補足デプロイメント情報を追加します。

    手動で web.xml および weblogic.xml デプロイメント記述子を作成することも、WebLogic Server に含まれる Java ベース ユーティリティを使用して自動的に生成することもできます。これらのファイルの自動生成の詳細については、 デプロイメント記述子の自動生成を参照してください。

    デプロイメント記述子の要素、および手動で作成する方法については、『Web アプリケーションのアセンブルとコンフィグレーション』を参照してください。

  5. HTML ページ、サーブレット クラス ファイル、JSP ファイル、web.xml、および weblogic.xml を Web アーカイブ(*.war)ファイルにパッケージ化します。

    *.war ファイル作成の最初の手順は、Web アプリケーションのステージング ディレクトリを作成することです。JSP ページ、HTML ページ、およびそれらのページによって参照されるマルチメディア ファイルは、ステージング ディレクトリの最上位に保存されます。コンパイルされたサーブレット クラス、taglibs、および JSP ページからコンパイルされたサーブレット(必要な場合)は、ステージング ディレクトリの WEB-INF ディレクトリに格納されます。すべての Web アプリケーション コンポーネントをステージング ディレクトリに配置したら、JAR コマンドを実行して、*.war ファイルを作成します。

    *.war ファイル作成の詳細については、 Web アプリケーションのパッケージ化を参照してください。

  6. *.war ファイルをテスト目的で WebLogic Server に自動デプロイします。

    Web アプリケーションをテストしているときに、web.xml および weblogic.xml デプロイメント記述子を編集しなければならない場合があります。これは手動で編集することも、Administration Console のデプロイメント記述子エディタで編集することもできます。デプロイメント記述子エディタの使用方法の詳細については、 デプロイメント記述子の編集を参照してください。

    コンポーネントおよびアプリケーションの自動デプロイメントの詳細については、『BEA WebLogic Server 管理者ガイド』を参照してください。

  7. プロダクション用に WebLogic Server に *.war ファイルをデプロイするか、エンタープライズ アプリケーションの一部としてデプロイするためにエンタープライズ アーカイブ(*.ear)ファイルに含めます。Administration Console を使用してアプリケーションおよびコンポーネントをデプロイします。

    コンポーネントおよびアプリケーションのデプロイメントの詳細については、『BEA WebLogic Server 管理者ガイド』を参照してください。

 


エンタープライズ JavaBean の作成 : 主な手順

エンタープライズ JavaBean を作成するには、特定の EJB(セッション、エンティティ、またはメッセージ駆動型)のクラスおよび EJB 固有のデプロイメント記述子を作成してから、それらをすべて *.ear ファイルにパッケージ化する必要があります。

エンタープライズ JavaBean 作成の主な手順は次のとおりです。

  1. EJB の仕様に従って、各タイプの EJB(セッション、エンティティ、メッセージ駆動型)で必要なクラスの Java コードを記述します。たとえば、セッションおよびエンティティ EJB では、以下の 3 つのクラスが必要です。

  2. インタフェースと実装の Java コードをクラス ファイルにコンパイルします。

    コンパイルの詳細については、 コンパイルの準備を参照してください。

  3. EJB 固有のデプロイメント記述子を作成します。

  4. クラス ファイルおよびデプロイメント記述子を Java アーカイブ ファイル *.jar にパッケージ化します。

    *.jar ファイル作成の最初の手順は、EJB のステージング ディレクトリを作成することです。コンパイルした Java クラスをステージング ディレクトリに置き、デプロイメント記述子を META-INF というサブディレクトリに置きます。次に、weblogic.ejbc EJB コンパイラを実行して、スタブおよびスケルトン クラスを生成してステージング ディレクトリに格納します。次に、ステージング ディレクトリで次のように jar コマンドを実行して、EJB アーカイブを作成します。

    jar cvf myEJB.jar *

    *.jar アーカイブ ファイル作成の詳細については、 エンタープライズ JavaBeans のパッケージ化を参照してください。

  5. EJB アーカイブ ファイル *.jar をテスト目的で WebLogic Server に自動デプロイします。

    EJB をテストしているときに、EJB デプロイメント記述子を編集しなければならない場合があります。これは手動で編集することも、Administration Console のデプロイメント記述子エディタで編集することもできます。デプロイメント記述子エディタの使用方法の詳細については、 デプロイメント記述子の編集を参照してください。

    コンポーネントおよびアプリケーションの自動デプロイメントの詳細については、『BEA WebLogic Server 管理者ガイド』を参照してください。

  6. プロダクション用に WebLogic Server に *.jar ファイルをデプロイするか、エンタープライズ アプリケーションの一部としてデプロイするためにエンタープライズ アーカイブ(*.ear)ファイルに含めます。Administration Console を使用してアプリケーションおよびコンポーネントをデプロイします。

    コンポーネントおよびアプリケーションのデプロイメントの詳細については、『BEA WebLogic Server 管理者ガイド』を参照してください。

 


WebLogic Server エンタープライズ アプリケーションの作成 : 主な手順

WebLogic Server エンタープライズ アプリケーションの作成では、Web コンポーネントと EJB コンポーネント、デプロイメント記述子、およびアーカイブ ファイルの作成が必要です。最終的にはエンタープライズ アプリケーション アーカイブ(.ear ファイル)になり、WebLogic Server にデプロイできます。

WebLogic Server エンタープライズ アプリケーション作成の主な手順は次のとおりです。

  1. アプリケーションの Web コンポーネントと EJB コンポーネントを作成します。

    プログラマは、J2EE API を使用して、これらのコンポーネント用のサーブレットと EJB を作成します。Web デザイナは、HTML または XML、および JavaServer Pages を使用して Web ページを作成します。

    Web コンポーネントおよび EJB コンポーネント作成の詳細については、 アプリケーションの作成 : 主な手順および エンタープライズ JavaBean の作成 : 主な手順を参照してください。

    Web コンポーネントおよび EJB コンポーネントを構成する Java コード作成の詳細については、『WebLogic エンタープライズ JavaBeans プログラマーズ ガイド』、『WebLogic HTTP サーブレット プログラマーズ ガイド』、および『WebLogic JSP プログラマーズ ガイド』を参照してください。

  2. Web コンポーネントと EJB コンポーネントのデプロイメント記述子を作成します。

    コンポーネントのデプロイメント記述子は、WebLogic Server でのアプリケーションのデプロイメントに必要な情報を提供する XML ドキュメントです。J2EE 仕様では、ejb-jar.xmlweb.xml などのデプロイメント記述子の内容を定義しています。追加のデプロイメント記述子では、WebLogic Server でのコンポーネントのデプロイメントに必要な情報が提供され、J2EE 仕様の記述子を補足します。

    手動でこれらのデプロイメント記述子を作成することも、WebLogic Server に含まれる Java ベース ユーティリティを使用して自動的に生成することもできます。これらのファイルの自動生成の詳細については、 デプロイメント記述子の自動生成を参照してください。

    Web コンポーネントのデプロイメント記述子を手動で記述する際の詳細については、『Web アプリケーションのアセンブルとコンフィグレーション』、EJB コンポーネントのデプロイメント記述子を手動で記述する際の詳細については、『WebLogic エンタープライズ JavaBeans プログラマーズ ガイド』を参照してください。

  3. Web コンポーネントおよび EJB コンポーネントをコンポーネント アーカイブ ファイルにパッケージ化します。

    コンポーネント アーカイブは、デプロイメント記述子など、すべてのコンポーネント ファイルが含まれる JAR ファイルです。Web コンポーネントを *.war ファイルに、EJB コンポーネントを EJB *.jar ファイルにパッケージ化します。

    コンポーネント アーカイブ作成の詳細については、 Web アプリケーションのパッケージ化および エンタープライズ JavaBeans のパッケージ化を参照してください。

  4. エンタープライズ アプリケーションのデプロイメント記述子を作成します。

    エンタープライズ アプリケーションのデプロイメント記述子である application.xml では、アプリケーションに一緒にアセンブルされる個々のコンポーネントを示します。

    手動で application.xml のデプロイメント記述子を作成することも、WebLogic Server に含まれている Java ベース ユーティリティを使用して自動的に生成することもできます。このファイルの自動生成の詳細については、 デプロイメント記述子の自動生成を参照してください。

    application.xml ファイルの要素の詳細については、 application.xml デプロイメント記述子の要素を参照してください。

  5. エンタープライズ アプリケーションをパッケージ化します。

    エンタープライズ アプリケーションのデプロイメント記述子とともに、Web コンポーネントおよび EJB コンポーネントのアーカイブをエンタープライズ アーカイブ(*.ear)ファイルにパッケージ化します。これは WebLogic Server にデプロイされるファイルです。WebLogic Server では application.xml デプロイメント記述子を使用して、EAR ファイルにパッケージ化された個々のコンポーネントを見つけてデプロイします。

    エンタープライズ アプリケーションの *.ear アーカイブ ファイル作成の詳細については、 エンタープライズ アプリケーションのパッケージ化を参照してください。

  6. *.ear エンタープライズ アプリケーションをテスト目的で WebLogic Server に自動デプロイします。

    エンタープライズ アプリケーションをテストしているときに、application.xml デプロイメント記述子を編集しなければならない場合があります。これは手動で編集することも、Administration Console のデプロイメント記述子エディタで編集することもできます。デプロイメント記述子エディタの使用方法の詳細については、 デプロイメント記述子の編集を参照してください。

    コンポーネントおよびアプリケーションの自動デプロイメントの詳細については、『BEA WebLogic Server 管理者ガイド』を参照してください。

  7. *.ear ファイルをプロダクション用に WebLogic Server にデプロイします。Administration Console を使用してアプリケーションおよびコンポーネントをデプロイします。

    コンポーネントおよびアプリケーションのデプロイメントの詳細については、『BEA WebLogic Server 管理者ガイド』を参照してください。

図 2-1 に、WebLogic Server エンタープライズ アプリケーションの開発とパッケージ化の手順を示します。

図2-1 エンタープライズ アプリケーションの作成


 

 


リソース アダプタの作成 : 主な手順

リソース アダプタを作成するには、リソース アダプタのクラスおよびコネクタ固有のデプロイメント記述子を作成してから、WebLogic Server にデプロイするために、それらをすべて .rar ファイルにパッケージ化する必要があります。

新しいリソース アダプタ(.rar)の作成

リソース アダプタ(.rar)を作成する主な手順を以下に説明します。

  1. 「J2EE コネクタ仕様、バージョン 1.0、最終草案 2」(http://java.sun.com/j2ee/download.html#connectorspec)に準拠して、リソース アダプタ(ConnectionFactory や Connection など)に必要な各種クラスの Java コードを記述します。

    リソース アダプタを実装する場合は、以下のように ra.xml ファイルでクラスを指定しなければなりません。

  2. インタフェースと実装の Java コードをクラス ファイルにコンパイルします。

  3. Java クラスを Java アーカイブ ファイル(.jar)にパッケージ化します。

    *.jar ファイル作成の最初の手順は、コネクタのステージング ディレクトリを作成することです。.jar ファイルをステージング ディレクトリに置き、デプロイメント記述子を META-INF というサブディレクトリに置きます。

    次に、ステージング ディレクトリで次のように jar コマンドを実行して、リソース アダプタ アーカイブを作成します。

    jar cvf myRAR.rar *

    リソース アダプタの .jar アーカイブ ファイルの作成については、 リソース アダプタのパッケージ化を参照してください。

  4. リソース コネクタ固有のデプロイメント記述子を作成します。

  5. リソース アダプタ アーカイブ ファイル(.rar ファイル)を作成します。

    1. 最初に、空のステージング ディレクトリを作成します。

    2. リソース アダプタの Java クラスが入った .rar ファイルをステージング ディレクトリに格納します。

    3. デプロイメント記述子を META-INF というサブディレクトリに格納します。

    4. 次に、ステージング ディレクトリで次のように jar コマンドを実行して、リソース アダプタ アーカイブを作成します。

      jar cvf myRAR.rar *

      リソース アダプタ アーカイブ ファイルの作成の詳細については、 リソース アダプタのパッケージ化を参照してください。

  6. リソース アダプタ アーカイブ ファイル .rar をテスト目的で WebLogic Server に自動デプロイします。

    リソース アダプタをテストしているときに、デプロイメント記述子を編集しなければならない場合があります。これは手動で編集することも、Administration Console のデプロイメント記述子エディタで編集することもできます。デプロイメント記述子エディタの使用方法の詳細については、 デプロイメント記述子の編集を参照してください。

    コンポーネントおよびアプリケーションの自動デプロイメントの詳細については、『BEA WebLogic Server 管理者ガイド』を参照してください。

  7. .rar リソース アダプタ ファイルを WebLogic Server にデプロイするか、またはエンタープライズ アプリケーションの一部としてデプロイするエンタープライズ アーカイブ(.ear)に含めます。

    コンポーネントおよびアプリケーションのデプロイメントの詳細については、『BEA WebLogic Server 管理者ガイド』を参照してください。

既存のリソース アダプタ(.rar)の変更

以下は、既存のリソース アダプタ(.rar)を、WebLogic Server にデプロイするために変更する方法の例です。この場合、デプロイメント記述子 weblogic-ra.xml を追加し、再パッケージ化する必要があります。

  1. リソース アダプタをステージングするための一時ディレクトリを作成します。

    mkdir c:\stagedir

  2. 一時ディレクトリにデプロイするリソース アダプタをコピーします。

    cp blackbox-notx.rar c:\stagedir

  3. リソース アダプタ アーカイブの中身を展開します。

    cd c:\stagedir

    jar xf blackbox-notx.rar

    ステージング ディレクトリには、以下のものが格納されます。

  4. weblogic-ra.xml ファイルを作成します。このファイルは、リソース アダプタ用の WebLogic 固有のデプロイメント記述子です。このファイルには、接続ファクトリ、接続プール、およびセキュリティ マッピングのパラメータを指定します。

    weblogic-ra.xml DTD の詳細については、『WebLogic J2EE コネクタ アーキテクチャ』を参照してください。

  5. weblogic-ra.xml ファイルを一時ディレクトリの META-INF サブディレクトリにコピーします。META-INF ディレクトリは、.rar ファイルを展開した一時ディレクトリ、またはリソース アダプタを展開ディレクトリ形式で格納しているディレクトリ内にあります。次のコマンドを使用します。

    cp weblogic-ra.xml c:\stagedir\META-INF

    c:\stagedir> ls META-INF

    Manifest.mf

    ra.xml

    weblogic-ra.xml

  6. リソース アダプタ アーカイブを作成します。

    jar cvf blackbox-notx.jar -C c:\stagedir

  7. WebLogic Server にリソース アダプタをデプロイします。リソース アダプタの WebLogic Server へのデプロイメントについては、『WebLogic J2EE コネクタ アーキテクチャ』を参照してください。

 


開発環境の構築

WebLogic Server アプリケーションを開発するには、ソフトウェア ツールをアセンブルし、コードを作成、コンパイル、デプロイ、テスト、およびデバッグするための環境を設定しておく必要があります。この節では、ツールキットを構築し、開発用コンピュータにコンパイラ関連の環境を設定する方法について説明します。

ソフトウェア ツール

この節では、WebLogic Server アプリケーションの開発に必要なソフトウェア、および開発とデバッグに使用するオプション ツールについて説明します。

ソース コード エディタまたは IDE

Java ソース ファイル、コンフィグレーション ファイル、HTML/XML ページ、および JavaServer Pages の編集には、テキスト エディタが必要です。Windows と UNIX の行末の違いを適切に処理するエディタが望ましいですが、それ以外に特別な要件は何もありません。

WebGain VisualCaf などの Java 統合開発環境(IDE)には、通常 Java のカスタム サポートと共にプログラマ用エディタが付属しています。また IDE は、WebLogic Server でのサーブレットとエンタープライズ JavaBean の作成とデプロイをサポートしている場合もあります。その場合、アプリケーションの開発、テスト、およびデバッグが非常に簡単になります。

HTML/XML ページと JavaServer Pages は、通常のテキスト エディタか、または DreamWeaver などの Web ページ エディタで編集できます。

XML エディタ

EJB および Web アプリケーション デプロイメント記述子、config.xml ファイルなど、WebLogic Server で使用される XML ファイルを編集するには、XML エディタを使用します。WebLogic Server には、次の 2 つの XML エディタが付属しています。

これらの XML エディタの使用方法の詳細については、 デプロイメント記述子の編集を参照してください。

Java コンパイラ

Java コンパイラは、ポータブル バイト コードで構成される Java クラス ファイルを Java ソースから生成します。Java コンパイラは、アプリケーション用に記述した Java コードと、WebLogic RMI、EJB、および JSP コンパイラによって生成されたコードをコンパイルします。

Sun Microsystems の Java 2, Standard Edition には、javac という Java コンパイラが付属しています。WebLogic Server をインストールしたときに付属の JRE をインストールした場合、javac コンパイラがインストールされます。

これ以外にも、さまざまなプラットフォームに対応した Java コンパイラを使用できます。標準 Java .class ファイルを生成する Java コンパイラであれば、どのようなコンパイラでも WebLogic Server アプリケーションの開発に使用できます。ほとんどの Java コンパイラは javac より何倍も高速であり、また IDE と緊密に統合されている Java コンパイラもあります。

コンパイラによって生成された最適化済みコードが、すべての Java 仮想マシン(JVM)で正常に動作しない場合もあります。問題をデバッグする場合は、最適化を無効にするか、異なる最適化セットを選択するか、または javac でコンパイルしてみて、使用している Java コンパイラが原因かどうかを調べてください。また、デプロイする前に、常に対象となる各 JVM でコードをテストしてください。

開発用 WebLogic Server

テストされていないコードを、製品アプリケーションのサーバとなる WebLogic Server にデプロイしないでください。つまり、開発用 WebLogic Server が環境に必要です。開発用 WebLogic Server は、編集とコンパイルを行うコンピュータで実行することも、ネットワークのどこかにデプロイされているコンピュータで実行することもできます。

Java はプラットフォームに依存しないので、任意のプラットフォームでコードの編集とコンパイルを行い、別のプラットフォームで稼働する開発用 WebLogic Server でアプリケーションをテストできます。たとえば、WebLogic Server アプリケーションを Windows または Linux が動作している PC で開発する場合、そのアプリケーションが最終的にどこにデプロイされるかを考慮する必要はありません。

開発用コンピュータで開発用 WebLogic Server を実行しない場合でも、WebLogic Server 配布キットにアクセスできなければプログラムをコンパイルできません。WebLogic または J2EE API を使用してコードをコンパイルするには、Java コンパイラが配布ディレクトリ内の weblogic.jar ファイルとその他の JAR ファイルにアクセスする必要があります。開発用コンピュータに WebLogic Server をインストールすると、これらのファイルがローカルに使用できます。

データベース システムと JDBC ドライバ

データベース システムは、ほぼすべての WebLogic Server アプリケーションで必要となります。標準 JDBC ドライバを介してアクセスできる任意の DBMS を使用できますが、WebLogic JMS などのサービスでは、Oracle、Sybase、Informix、Microsoft SQL Server、IBM DB2、または Cloudscape をサポートする JDBC ドライバが必要です。サポートされるデータベース システムと JDBC ドライバについては、プラットフォーム サポートの Web ページを参照してください。

JDBC 接続プールは非常に高いパフォーマンスを提供するので、2 層 JDBC ドライバを直接使用するアプリケーションの作成を検討する必要はほとんどありません。接続プールは、使用の準備ができたデータベース接続のコレクションです。接続プールはその起動時に、指定された数の同じ物理データベース接続を作成します。起動時に接続を確立することにより、接続プールは各アプリケーション用にデータベース接続を作成するオーバーヘッドを軽減します。BEA では、クライアント側とサーバ側の両方のアプリケーションが、JDBC ツリー上のデータ ソースを通じて接続プールから接続を取得する構成を推奨しています。接続を使った処理が終了したら、アプリケーションは接続を接続プールに返却します。

マルチプールは基本の接続プールを多重化したものです。 マルチプールはアプリケーションにとっては基本のプールと同じように機能しますが、マルチプールを使用すると、接続プールのプールを確立できるようになります。そのとき、接続属性は接続プールごとに異なります。1 つの接続プール内の接続はすべて等質ですが、あるプールに予測される障害がマルチプール内の別のプールを巻き添えにしたりしないように、マルチプール内の接続プールごとに接続の性質はある程度異なっているのが一般的です。これらのプールは通常、同じデータベースの異なったインスタンスを接続先とします。

マルチプールが効果を発揮するのは、アプリケーションの接続を同じように処理する複数の異なったデータベース インスタンスが存在し、アプリケーションの作業が複数のデータベース間に分散されるときにアプリケーション システムがデータベースの同期を正しく処理する場合に限られます。まれに、同じデータベース インスタンスを指す複数のプールを異なったユーザとして用意すると役に立つ場合があります。これは、DBA が他のユーザを有効にしたままある特定のユーザを無効にする場合などに役立ちます。

デフォルトでは、クラスタ化されるマルチプールは高可用性(DBMS のフェイルオーバ)を実現します。必要に応じて、ロードバランシングにも対応するようにマルチプールをコンフィグレーションすることができます。

Web ブラウザ

ほとんどの J2EE アプリケーションは、Web ブラウザ クライアントによって実行されるように設計されています。WebLogic Server は HTTP 1.1 仕様をサポートしており、Netscape Communicator および Microsoft Internet Explorer ブラウザの現行バージョンでテストされています。

作成するアプリケーションの条件を書き出す場合、どの Web ブラウザ バージョンをサポートするかに留意してください。テスト プランは、サポートするバージョンごとに作成します。バージョン番号とブラウザ コンフィグレーションは明確に指定します。作成するアプリケーションは SSL をサポートしますか ?ブラウザの代替セキュリティ設定をテストして、サポートしているセキュリティをユーザに知らせることができるようにします。

アプリケーションがアプレットを使用する場合、さまざまなブラウザに埋め込まれている JVM の違いのために、サポートするブラウザのコンフィグレーションをテストすることが特に重要です。解決策の 1 つは、Sun から Java Plug-in をインストールするようユーザに指示して、すべてのユーザが同じ Java ランタイム バージョンを持つようにすることです。

サードパーティ ソフトウェア

WebGain Studio、WebGain StructureBuilder、および BEA WebLogic Integration Kit for VisualAge for Java などのサードパーティ ソフトウェア製品を使用して、WebLogic Server 開発環境を強化できます。

詳細については、「BEA WebLogic Developer Tools Resources」Web ページを参照してください。BEA アプリケーション サーバをサポートする製品の開発者ツール情報を確認できます。

このツールの一部をダウンロードするには、「BEA WebLogic Server Downloads」Web ページを参照してください。

注意: ソフトウェア ベンダに問い合わせて、使用しているプラットフォームと WebLogic Server バージョンにソフトウェアが対応しているかどうかを確認してください。

 


コンパイルの準備

WebLogic Server 用の Java プログラムのコンパイルは、他の Java プログラムのコンパイルと同じです。適切にコンパイルを行うには、以下の準備が必要です。

環境を設定する方法の 1 つは、コマンド ファイルまたはシェル スクリプトを作成して環境変数を設定し、それをコンパイラに渡すことです。この方法の例として、config\examples ディレクトリに setExamplesEnv.cmd(Windows)ファイルと setExamplesEnv.sh(UNIX)ファイルがあります。

検索パスへの Java ツールの指定

オペレーティング システムがコンパイラとその他の JDK ツールを検索できるようにするには、そのコンパイラをコマンド シェルの PATH 環境変数に追加します。JDK を使用している場合、ツールは JDK ディレクトリの bin サブディレクトリに置かれています。javac 以外のコンパイラ(WebGain VisualCafé の sj コンパイラなど)を使用するには、そのコンパイラが格納されているディレクトリを検索パスに追加します。

たとえば、JDK が UNIX ファイル システムの /usr/local/java/java130 にインストールされている場合、Bourne シェルまたはシェル スクリプトで次のようなコマンドを使用して javac を検索パスに追加します。

PATH=/usr/local/java/java130/bin:$PATH; export PATH

WebGain sj コンパイラを Windows NT または Windows 2000 のパスに追加するには、コマンド シェルまたはコマンド ファイルで次のようなコマンドを使用します。

PATH=c:\VisualCafe\bin;%PATH%

IDE を使用している場合は、その IDE のドキュメントを参照して、検索パスの設定方法を調べてください。

コンパイル用のクラスパスの設定

ほとんどの WebLogic サービスは J2EE 仕様に基づいており、標準 J2EE パッケージを通じてアクセスします。WebLogic サービスを使用するプログラムのコンパイルに必要な Sun、WebLogic、およびその他の Java クラスは、インストールした WebLogic Server の lib ディレクトリの weblogic.jar ファイルにパッケージ化されます。weblogic.jar ファイル以外にも、以下のものをコンパイラのクラスパスに組み込みます。

コンパイルされたクラスの出力ディレクトリの設定

コンパイルされたクラスの出力ディレクトリを指定しない場合、Java コンパイラは Java ソースと同じディレクトリにクラス ファイルを書き出します。出力ディレクトリを指定した場合、コンパイラはパッケージ名と同じディレクトリ構造にクラス ファイルを格納します。これにより、Java クラスはアプリケーションのパッケージ化に使用するステージング ディレクトリ内の適切な場所にコンパイルされます。出力先ディレクトリを指定しなかった場合、ファイルを移動してからでなければ、パッケージ化されたコンポーネントを含む jar ファイルを作成できません。

J2EE アプリケーションは、1 つのアプリケーションにアセンブルされ、1 つまたは複数の WebLogic Server または WebLogic クラスタにデプロイされるモジュールから構成されています。各モジュールは、独自のステージング ディレクトリを持つ必要があります。これにより、他のモジュールとは別個にコンパイル、パッケージ化、およびデプロイできるようになります。たとえば、EJB、Web コンポーネント、およびその他のサーバサイド クラスをそれぞれ独立したモジュールにパッケージ化できます。

コンパイラの出力ディレクトリの設定例については、WebLogic Server 配布キットの config\examples ディレクトリにある setExamplesEnv スクリプトを参照してください。このスクリプトは、以下の変数を設定します。

CLIENT_CLASSES

コンパイルされたクライアント クラスが書き出されるディレクトリ。これらのクラスは通常、WebLogic Server に接続するスタンドアロンの Java プログラムです。これらのクラスは WebLogic Server クラスパスに配置する必要はありません。

SERVER_CLASSES

サーバサイド クラスが書き出されるディレクトリ。これらのクラスにはスタートアップ クラスとその他の Java クラスがあり、サーバの起動時に WebLogic Server クラスパスに配置されている必要があります。このディレクトリのクラスは WebLogic Server を再起動しないと再デプロイされないため、通常は、アプリケーション クラスをこのディレクトリにコンパイルしないでください。

EX_WEBAPP_CLASSES

Web アプリケーションによって使用されるクラスが書き出されるディレクトリ。

APPLICATIONS

サンプル ドメイン用の applications ディレクトリ。他の変数とは異なり、この変数は Java コンパイラの対象の指定には使用しません。この変数は、ファイルをソース ディレクトリから applications ディレクトリへ移動するコピー コマンドで、applications ディレクトリへの便利な参照として使用します。たとえば、ソース ツリーの中に .html.jsp、および画像ファイルがある場合、コピー コマンドでこの変数を使用して、それらのファイルを開発用サーバにインストールできます。

これらの環境変数は、次のようなコマンドで(Windows の場合)コンパイラに渡されます。

javac -d %SERVER_CLASSES% *.java

IDE を使用しない場合、メイク ファイル、シェル スクリプト、またはコマンド ファイルを記述して、コンポーネントとアプリケーションをコンパイルおよびパッケージ化することを検討してください。構築スクリプトに変数を設定して、1 つのコマンドでコンポーネントを再構築できるようにします。

 


デプロイメント記述子の編集

以下のツールのいずれか 1 つを使用して、WebLogic アプリケーションおよびコンポーネントのデプロイメント記述子を編集できます。

いずれかのエディタを使用して、以下のデプロイメント記述子に対して、既存の要素の更新、新しい要素の追加、既存の要素の削除を行うことができます。

BEA XML エディタの使い方

XML ファイルを編集するには、BEA XML エディタを使います。これは、完全に Java ベースの XML スタンドアロン エディタで、XML ファイルの作成と編集のためのシンプルでユーザフレンドリなツールです。このツールでは、XML ファイルの内容を、階層的な XML ツリー構造と実際の XML コードの両方で表示します。ドキュメントを 2 通りに表示することにより、以下の 2 つの方法で XML ドキュメントを編集できます。

BEA XML エディタは、指定した DTD または XML スキーマを基に XML コードを検証します。

BEA XML エディタの使用方法の詳細については、オンライン ヘルプを参照してください。

BEA XML エディタは、BEA dev2devからダウンロードできます。

Administration Console のデプロイメント記述子エディタの使用方法

Administration Console のデプロイメント記述子エディタは、メインの Administration Console に非常に似ています。左側のペインでは、デプロイメント記述子ファイルの要素がツリー形式で表示され、右側のペインには、特定の要素を更新するためのフォームがあります。

エディタを使用する場合、インメモリ デプロイメント記述子のみを更新するか、またはインメモリおよびディスク ファイルの両方を更新することができます。特定の要素を更新してから [適用] ボタンをクリックするか、[作成] ボタンをクリックして新しい要素を作成すると、WebLogic Server のメモリ内のデプロイメント記述子のみが更新されます。変更はまだディスクには書き込まれていません。変更をディスクに書き込むためには、明示的に [永続化] ボタンをクリックする必要があります。変更を明示的にディスクに永続化しない場合、WebLogic Server を終了して再起動すると、変更は失われます。

EJB デプロイメント記述子の編集

この節では、Administration Console のデプロイメント記述子エディタを使用して以下の EJB デプロイメント記述子を編集する手順を説明します。

EJB 固有のデプロイメント記述子の要素の詳細については、『WebLogic エンタープライズ JavaBeans プログラマーズ ガイド』を参照してください。

EJB デプロイメント記述子を編集するには、次の手順に従います。

  1. ブラウザで次の URL を指定して、Administration Console を起動します。

    http://host:port/console

    host は、WebLogic Server が稼働するコンピュータの名前、port は WebLogic Server がリスンするポートの番号です。

  2. 左ペインの [デプロイメント] ノードをクリックして展開します。

  3. [デプロイメント] ノードの [EJB] ノードをクリックして展開します。

  4. 編集対象のデプロイメント記述子がある EJB の名前を右クリックし、ドロップダウン メニューから [EJB 記述子の編集] を選択します。Administration Console ウィンドウが新しいブラウザに表示されます。

    左側のペインでは、3 つの EJB デプロイメント記述子のすべての要素がツリー形式で表示され、右側のペインには、ejb-jar.xml ファイルの説明要素のためのフォームがあります。

  5. EJB デプロイメント記述子の要素を編集、削除、または追加するには、以下のリストで説明されているように、左側のペインで編集対象のデプロイメント記述子に対応するノードをクリックして展開します。

  6. いずれかの EJB デプロイメント記述子の既存の要素を編集するには、次の手順に従います。

    1. 左側のペインでツリーをナビゲートし、編集対象の要素が見つかるまで親要素をクリックします。

    2. 要素をクリックします。右側のペインに、属性または下位要素のどちらかをリストするフォームが表示されます。

    3. 右側のペインのフォームで、テキストを編集します。

    4. [適用] をクリックします。

  7. いずれかの EJB デプロイメント記述子の新しい要素を追加するには、次の手順に従います。

    1. 左側のペインでツリーをナビゲートし、作成対象の要素の名前が見つかるまで親要素をクリックします。

    2. 要素を右クリックして、ドロップダウン メニューから [新しい(要素名)のコンフィグレーション] を選択します。

    3. 右側のペインに表示されるフォームで、要素情報を入力します。

    4. [作成] をクリックします。

  8. いずれかの EJB デプロイメント記述子の既存の要素を削除するには、次の手順に従います。

    1. 左側のペインでツリーをナビゲートし、削除対象の要素の名前が見つかるまで親要素をクリックします。

    2. 要素を右クリックして、ドロップダウン メニューから [(要素名)の削除] を選択します。

    3. [はい] をクリックすると、要素の削除が確定されます。

  9. EJB デプロイメント記述子への変更がすべて完了したら、左側のペインでツリーのルート要素をクリックします。ルート要素は、EJB の *.jar アーカイブ ファイルの名前または EJB の表示名です。

  10. EJB デプロイメント記述子のエントリが有効かどうかを確認する場合は、[検証] をクリックします。

  11. [永続化] をクリックして、デプロイメント記述子ファイルの編集を、WebLogic Server のメモリだけでなくディスクに書き込みます。

Web アプリケーションのデプロイメント記述子の編集

この節では、Administration Console のデプロイメント記述子エディタを使用して以下の Web アプリケーション デプロイメント記述子を編集する手順を説明します。

Web アプリケーション デプロイメント記述子の要素の詳細については、『Web アプリケーションのアセンブルとコンフィグレーション』を参照してください。

Web アプリケーション デプロイメント記述子を編集するには、次の手順に従います。

  1. ブラウザで次の URL を指定して、Administration Console を起動します。

    http://host:port/console

    host は、WebLogic Server が稼働するコンピュータの名前、port は WebLogic Server がリスンするポートの番号です。

  2. 左ペインの [デプロイメント] ノードをクリックして展開します。

  3. [デプロイメント] ノードの [Web アプリケーション] ノードをクリックして展開します。

  4. 編集対象のデプロイメント記述子がある Web アプリケーションの名前を右クリックし、ドロップダウン メニューから [Web アプリケーション記述子の編集] を選択します。Administration Console ウィンドウが新しいブラウザに表示されます。

    左側のペインでは、2 つの Web アプリケーション デプロイメント記述子のすべての要素がツリー形式で表示され、右側のペインには、web.xml ファイルの説明要素のためのフォームがあります。

  5. Web アプリケーション デプロイメント記述子の要素を編集、削除、または追加するには、以下のリストで説明されているように、左側のペインで編集対象のデプロイメント記述子に対応するノードをクリックして展開します。

  6. いずれかの Web アプリケーション デプロイメント記述子の既存の要素を編集するには、次の手順に従います。

    1. 左側のペインでツリーをナビゲートし、編集対象の要素が見つかるまで親要素をクリックします。

    2. 要素をクリックします。右側のペインに、属性または下位要素のどちらかをリストするフォームが表示されます。

    3. 右側のペインのフォームで、テキストを編集します。

    4. [適用] をクリックします。

  7. いずれかの Web アプリケーション デプロイメント記述子の新しい要素を追加するには、次の手順に従います。

    1. 左側のペインでツリーをナビゲートし、作成対象の要素の名前が見つかるまで親要素をクリックします。

    2. 要素を右クリックして、ドロップダウン メニューから [新しい(要素名)のコンフィグレーション] を選択します。

    3. 右側のペインに表示されるフォームで、要素情報を入力します。

    4. [作成] をクリックします。

  8. いずれかの Web アプリケーション デプロイメント記述子の既存の要素を削除するには、次の手順に従います。

    1. 左側のペインでツリーをナビゲートし、削除対象の要素の名前が見つかるまで親要素をクリックします。

    2. 要素を右クリックして、ドロップダウン メニューから [(要素名)の削除] を選択します。

    3. [はい] をクリックすると、要素の削除が確定されます。

  9. Web アプリケーション デプロイメント記述子への変更がすべて完了したら、左側のペインでツリーのルート要素をクリックします。ルート要素は、Web アプリケーションの *.war アーカイブ ファイルの名前または Web アプリケーションの表示名です。

  10. Web アプリケーション デプロイメント記述子のエントリが有効かどうかを確認する場合は、[検証] をクリックします。

  11. [永続化] をクリックして、デプロイメント記述子ファイルの編集を、WebLogic Server のメモリだけでなくディスクに書き込みます。

リソース アダプタのデプロイメント記述子の編集

この節では、Administration Console のデプロイメント記述子エディタを使用して以下のリソース アダプタのデプロイメント記述子を編集する手順を説明します。

リソース アダプタのデプロイメント記述子の要素の詳細については、『WebLogic J2EE コネクタ アーキテクチャ』を参照してください。

リソース アダプタのデプロイメント記述子を編集するには、次の手順に従います。

  1. ブラウザで次の URL を指定して、Administration Console を起動します。

    http://host:port/console

    host は、WebLogic Server が稼働するコンピュータの名前、port は WebLogic Server がリスンするポートの番号です。

  2. 左ペインの [デプロイメント] ノードをクリックして展開します。

  3. [デプロイメント] ノードの [コネクタ] ノードをクリックして展開します。

  4. 編集対象のデプロイメント記述子があるリソース アダプタの名前を右クリックし、ドロップダウン メニューから [コネクタ記述子の編集] を選択します。Administration Console ウィンドウが新しいブラウザに表示されます。

    左側のペインでは、2 つのリソース アダプタのデプロイメント記述子のすべての要素がツリー形式で表示され、右側のペインには、ra.xml ファイルの説明要素のためのフォームがあります。

  5. リソース アダプタのデプロイメント記述子の要素を編集、削除、または追加するには、以下のリストで説明されているように、左側のペインで編集対象のデプロイメント記述子に対応するノードをクリックして展開します。

  6. いずれかのリソース アダプタ デプロイメント記述子の既存の要素を編集するには、次の手順に従います。

    1. 左側のペインでツリーをナビゲートし、編集対象の要素が見つかるまで親要素をクリックします。

    2. 要素をクリックします。右側のペインに、属性または下位要素のどちらかをリストするフォームが表示されます。

    3. 右側のペインのフォームで、テキストを編集します。

    4. [適用] をクリックします。

  7. いずれかのリソース アダプタ デプロイメント記述子の新しい要素を追加するには、次の手順に従います。

    1. 左側のペインでツリーをナビゲートし、作成対象の要素の名前が見つかるまで親要素をクリックします。

    2. 要素を右クリックして、ドロップダウン メニューから [新しい(要素名)のコンフィグレーション] を選択します。

    3. 右側のペインに表示されるフォームで、要素情報を入力します。

    4. [作成] をクリックします。

  8. いずれかのリソース アダプタ デプロイメント記述子の既存の要素を削除するには、次の手順に従います。

    1. 左側のペインでツリーをナビゲートし、削除対象の要素の名前が見つかるまで親要素をクリックします。

    2. 要素を右クリックして、ドロップダウン メニューから [(要素名)の削除] を選択します。

    3. [はい] をクリックすると、要素の削除が確定されます。

  9. リソース アダプタ デプロイメント記述子への変更がすべて完了したら、左側のペインでツリーのルート要素をクリックします。ルート要素は、リソース アダプタの *.rar アーカイブ ファイルの名前またはリソース アダプタの表示名です。

  10. リソース アダプタ デプロイメント記述子のエントリが有効かどうかを確認する場合は、[検証] をクリックします。

  11. [永続化] をクリックして、デプロイメント記述子ファイルの編集を、WebLogic Server のメモリだけでなくディスクに書き込みます。

エンタープライズ アプリケーションのデプロイメント記述子の編集

この節では、Administration Console のデプロイメント記述子エディタを使用してエンタープライズ アプリケーション デプロイメント記述子(application.xml)を編集する手順を説明します。

application.xml ファイルの要素の詳細については、 application.xml デプロイメント記述子の要素を参照してください。

注意: 以下の手順は、application.xml ファイルの編集方法のみを説明するものです。エンタープライズ アプリケーションを構成するコンポーネントのデプロイメント記述子を編集する場合は、 EJB デプロイメント記述子の編集 Web アプリケーションのデプロイメント記述子の編集、または リソース アダプタのデプロイメント記述子の編集を参照してください。

エンタープライズ アプリケーション デプロイメント記述子を編集するには、次の手順に従います。

  1. ブラウザで次の URL を指定して、Administration Console を起動します。

    http://host:port/console

    host は、WebLogic Server が稼働するコンピュータの名前、port は WebLogic Server がリスンするポートの番号です。

  2. 左ペインの [デプロイメント] ノードをクリックして展開します。

  3. [デプロイメント] ノードの [アプリケーション] ノードをクリックして展開します。

  4. 編集対象のデプロイメント記述子があるエンタープライズ アプリケーションの名前を右クリックし、ドロップダウン メニューから [アプリケーション記述子の編集] を選択します。Administration Console ウィンドウが新しいブラウザに表示されます。

    左側のペインでは、application.xml ファイルのすべての要素がツリー構造で表示され、右側のペインには、表示名やアイコン ファイル名などの説明要素のためのフォームがあります。

  5. application.xml デプロイメント記述子の既存の要素を編集するには、次の手順に従います。

    1. 左側のペインでツリーをナビゲートし、編集対象の要素が見つかるまで親要素をクリックします。

    2. 要素をクリックします。右側のペインに、属性または下位要素のどちらかをリストするフォームが表示されます。

    3. 右側のペインのフォームで、テキストを編集します。

    4. [適用] をクリックします。

  6. application.xml デプロイメント記述子に新しい要素を追加するには、次の手順に従います。

    1. 左側のペインでツリーをナビゲートし、作成対象の要素の名前が見つかるまで親要素をクリックします。

    2. 要素を右クリックして、ドロップダウン メニューから [新しい(要素名)のコンフィグレーション] を選択します。

    3. 右側のペインに表示されるフォームで、要素情報を入力します。

    4. [作成] をクリックします。

  7. application.xml デプロイメント記述子の既存の要素を削除するには、次の手順に従います。

    1. 左側のペインでツリーをナビゲートし、削除対象の要素の名前が見つかるまで親要素をクリックします。

    2. 要素を右クリックして、ドロップダウン メニューから [(要素名)の削除] を選択します。

    3. [はい] をクリックすると、要素の削除が確定されます。

  8. application.xml デプロイメント記述子への変更がすべて完了したら、左側のペインでツリーのルート要素をクリックします。ルート要素は、エンタープライズ アプリケーションの *.ear アーカイブ ファイルの名前またはエンタープライズ アプリケーションの表示名です。

  9. application.xml デプロイメント記述子のエントリが有効かどうかを確認する場合は、[検証] をクリックします。

  10. [永続化] をクリックして、デプロイメント記述子ファイルの編集を、WebLogic Server のメモリだけでなくディスクに書き込みます。

 

back to top previous page next page