![]() |
![]() |
|
|
| |
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 アプリケーション作成の主な手順は次のとおりです。
JSP 作成の詳細については、『WebLogic JSP プログラマーズ ガイド』を参照してください。
サーブレット作成の詳細については、『WebLogic HTTP サーブレット プログラマーズ ガイド』を参照してください。
コンパイルの詳細については、 コンパイルの準備を参照してください。
web.xml
および weblogic.xml
デプロイメント記述子を作成します。
web.xml
ファイルは各サーブレットと JSP ページを定義し、Web アプリケーションで参照されるエンタープライズ Bean を列挙します。weblogic.xml
ファイルは、WebLogic Server
用の補足デプロイメント情報を追加します。
手動で web.xml
および weblogic.xml
デプロイメント記述子を作成することも、WebLogic Server に含まれる Java ベース ユーティリティを使用して自動的に生成することもできます。これらのファイルの自動生成の詳細については、
デプロイメント記述子の自動生成を参照してください。
デプロイメント記述子の要素、および手動で作成する方法については、『Web アプリケーションのアセンブルとコンフィグレーション』を参照してください。
*.war
)ファイルにパッケージ化します。
*.war
ファイル作成の最初の手順は、Web アプリケーションのステージング ディレクトリを作成することです。JSP ページ、HTML ページ、およびそれらのページによって参照されるマルチメディア ファイルは、ステージング ディレクトリの最上位に保存されます。コンパイルされたサーブレット クラス、taglibs、および JSP ページからコンパイルされたサーブレット(必要な場合)は、ステージング ディレクトリの WEB-INF
ディレクトリに格納されます。すべての Web アプリケーション コンポーネントをステージング ディレクトリに配置したら、JAR コマンドを実行して、*.war
ファイルを作成します。
*.war
ファイル作成の詳細については、
Web アプリケーションのパッケージ化を参照してください。
*.war
ファイルをテスト目的で WebLogic Server に自動デプロイします。
Web アプリケーションをテストしているときに、web.xml
および weblogic.xml
デプロイメント記述子を編集しなければならない場合があります。これは手動で編集することも、Administration Console のデプロイメント記述子エディタで編集することもできます。デプロイメント記述子エディタの使用方法の詳細については、
デプロイメント記述子の編集を参照してください。
コンポーネントおよびアプリケーションの自動デプロイメントの詳細については、『BEA WebLogic Server 管理者ガイド』を参照してください。
*.war
ファイルをデプロイするか、エンタープライズ アプリケーションの一部としてデプロイするためにエンタープライズ アーカイブ(*.ear
)ファイルに含めます。Administration Console を使用してアプリケーションおよびコンポーネントをデプロイします。
コンポーネントおよびアプリケーションのデプロイメントの詳細については、『BEA WebLogic Server 管理者ガイド』を参照してください。
エンタープライズ JavaBean を作成するには、特定の EJB(セッション、エンティティ、またはメッセージ駆動型)のクラスおよび EJB 固有のデプロイメント記述子を作成してから、それらをすべて *.ear
ファイルにパッケージ化する必要があります。
エンタープライズ JavaBean 作成の主な手順は次のとおりです。
コンパイルの詳細については、 コンパイルの準備を参照してください。
ejb-jar.xml
は、Sun Microsystems の標準 DTD を使用して、EJB のタイプとそのデプロイメント プロパティを記述します。
weblogic.xml
ファイルは、WebLogic Server 固有のデプロイメント情報を追加します。
weblogic-cmp-rdbms-jar.xml
は、コンテナ管理のエンティティ EJB をデータベース上のテーブルにマップします。このファイルは、JAR ファイルにパッケージ化される CMP Bean ごとに異なる名前を持たなければなりません。このファイル名は、weblogic-ejb.jar
ファイル内の Bean のエントリに指定されます。
手動で EJB のデプロイメント記述子を作成することも、WebLogic Server に含まれる Java ベース ユーティリティを使用して自動的に生成することもできます。これらのファイルの自動生成の詳細については、 デプロイメント記述子の自動生成を参照してください。
EJB 固有のデプロイメント記述子の要素、およびファイルの手動作成の方法については、『WebLogic エンタープライズ JavaBeans プログラマーズ ガイド』を参照してください。
*.jar
にパッケージ化します。
*.jar
ファイル作成の最初の手順は、EJB のステージング ディレクトリを作成することです。コンパイルした Java クラスをステージング ディレクトリに置き、デプロイメント記述子を META-INF
というサブディレクトリに置きます。次に、weblogic.ejbc
EJB コンパイラを実行して、スタブおよびスケルトン クラスを生成してステージング ディレクトリに格納します。次に、ステージング ディレクトリで次のように jar
コマンドを実行して、EJB アーカイブを作成します。
jar cvf myEJB.jar *
*.jar
アーカイブ ファイル作成の詳細については、
エンタープライズ JavaBeans のパッケージ化を参照してください。
*.jar
をテスト目的で WebLogic Server に自動デプロイします。
EJB をテストしているときに、EJB デプロイメント記述子を編集しなければならない場合があります。これは手動で編集することも、Administration Console のデプロイメント記述子エディタで編集することもできます。デプロイメント記述子エディタの使用方法の詳細については、 デプロイメント記述子の編集を参照してください。
コンポーネントおよびアプリケーションの自動デプロイメントの詳細については、『BEA WebLogic Server 管理者ガイド』を参照してください。
*.jar
ファイルをデプロイするか、エンタープライズ アプリケーションの一部としてデプロイするためにエンタープライズ アーカイブ(*.ear
)ファイルに含めます。Administration Console を使用してアプリケーションおよびコンポーネントをデプロイします。
コンポーネントおよびアプリケーションのデプロイメントの詳細については、『BEA WebLogic Server 管理者ガイド』を参照してください。
WebLogic Server エンタープライズ アプリケーションの作成 : 主な手順
WebLogic Server エンタープライズ アプリケーションの作成では、Web コンポーネントと EJB コンポーネント、デプロイメント記述子、およびアーカイブ ファイルの作成が必要です。最終的にはエンタープライズ アプリケーション アーカイブ(.ear
ファイル)になり、WebLogic Server
にデプロイできます。
WebLogic Server エンタープライズ アプリケーション作成の主な手順は次のとおりです。
プログラマは、J2EE API を使用して、これらのコンポーネント用のサーブレットと EJB を作成します。Web デザイナは、HTML または XML、および JavaServer Pages を使用して Web ページを作成します。
Web コンポーネントおよび EJB コンポーネント作成の詳細については、 アプリケーションの作成 : 主な手順および エンタープライズ JavaBean の作成 : 主な手順を参照してください。
Web コンポーネントおよび EJB コンポーネントを構成する Java コード作成の詳細については、『WebLogic エンタープライズ JavaBeans プログラマーズ ガイド』、『WebLogic HTTP サーブレット プログラマーズ ガイド』、および『WebLogic JSP プログラマーズ ガイド』を参照してください。
コンポーネントのデプロイメント記述子は、WebLogic Server でのアプリケーションのデプロイメントに必要な情報を提供する XML ドキュメントです。J2EE 仕様では、ejb-jar.xml
や web.xml
などのデプロイメント記述子の内容を定義しています。追加のデプロイメント記述子では、WebLogic Server でのコンポーネントのデプロイメントに必要な情報が提供され、J2EE 仕様の記述子を補足します。
手動でこれらのデプロイメント記述子を作成することも、WebLogic Server に含まれる Java ベース ユーティリティを使用して自動的に生成することもできます。これらのファイルの自動生成の詳細については、 デプロイメント記述子の自動生成を参照してください。
Web コンポーネントのデプロイメント記述子を手動で記述する際の詳細については、『Web アプリケーションのアセンブルとコンフィグレーション』、EJB コンポーネントのデプロイメント記述子を手動で記述する際の詳細については、『WebLogic エンタープライズ JavaBeans プログラマーズ ガイド』を参照してください。
コンポーネント アーカイブは、デプロイメント記述子など、すべてのコンポーネント ファイルが含まれる JAR ファイルです。Web コンポーネントを *.war
ファイルに、EJB コンポーネントを EJB *.jar
ファイルにパッケージ化します。
コンポーネント アーカイブ作成の詳細については、 Web アプリケーションのパッケージ化および エンタープライズ JavaBeans のパッケージ化を参照してください。
エンタープライズ アプリケーションのデプロイメント記述子である application.xml
では、アプリケーションに一緒にアセンブルされる個々のコンポーネントを示します。
手動で application.xml
のデプロイメント記述子を作成することも、WebLogic Server に含まれている Java ベース ユーティリティを使用して自動的に生成することもできます。このファイルの自動生成の詳細については、
デプロイメント記述子の自動生成を参照してください。
application.xml
ファイルの要素の詳細については、
application.xml デプロイメント記述子の要素を参照してください。
エンタープライズ アプリケーションのデプロイメント記述子とともに、Web コンポーネントおよび EJB コンポーネントのアーカイブをエンタープライズ アーカイブ(*.ear
)ファイルにパッケージ化します。これは WebLogic Server にデプロイされるファイルです。WebLogic Server では application.xml
デプロイメント記述子を使用して、EAR ファイルにパッケージ化された個々のコンポーネントを見つけてデプロイします。
エンタープライズ アプリケーションの *.ear
アーカイブ ファイル作成の詳細については、
エンタープライズ アプリケーションのパッケージ化を参照してください。
*.ear
エンタープライズ アプリケーションをテスト目的で WebLogic Server に自動デプロイします。
エンタープライズ アプリケーションをテストしているときに、application.xml
デプロイメント記述子を編集しなければならない場合があります。これは手動で編集することも、Administration Console のデプロイメント記述子エディタで編集することもできます。デプロイメント記述子エディタの使用方法の詳細については、
デプロイメント記述子の編集を参照してください。
コンポーネントおよびアプリケーションの自動デプロイメントの詳細については、『BEA WebLogic Server 管理者ガイド』を参照してください。
*.ear
ファイルをプロダクション用に WebLogic Server にデプロイします。Administration Console を使用してアプリケーションおよびコンポーネントをデプロイします。
コンポーネントおよびアプリケーションのデプロイメントの詳細については、『BEA WebLogic Server 管理者ガイド』を参照してください。
図 2-1 に、WebLogic Server エンタープライズ アプリケーションの開発とパッケージ化の手順を示します。
図2-1 エンタープライズ アプリケーションの作成
リソース アダプタを作成するには、リソース アダプタのクラスおよびコネクタ固有のデプロイメント記述子を作成してから、WebLogic Server にデプロイするために、それらをすべて .rar
ファイルにパッケージ化する必要があります。
リソース アダプタ(.rar
)を作成する主な手順を以下に説明します。
リソース アダプタを実装する場合は、以下のように ra.xml
ファイルでクラスを指定しなければなりません。
<managedconnectionfactory-class>com.sun.connector.blackbox.LocalTxManagedConnectionFactory</managedconnectionfactory-class>
<connectionfactory-interface>javax.sql.DataSource</connectionfactory-interface>
<connectionfactory-impl-class>com.sun.connector.blackbox.JdbcDataSource</connectionfactory-impl-class>
<connection-interface>java.sql.Connection</connection-interface>
<connection-impl-class>com.sun.connector.blackbox.JdbcConnection</connection-impl-class>
.jar
)にパッケージ化します。
*.jar
ファイル作成の最初の手順は、コネクタのステージング ディレクトリを作成することです。.jar
ファイルをステージング ディレクトリに置き、デプロイメント記述子を META-INF
というサブディレクトリに置きます。
次に、ステージング ディレクトリで次のように jar
コマンドを実行して、リソース アダプタ アーカイブを作成します。
jar cvf myRAR.rar *
リソース アダプタの .jar
アーカイブ ファイルの作成については、
リソース アダプタのパッケージ化を参照してください。
ra.xml
は、Sun Microsystems の標準 DTD を使用して、リソース アダプタ関連の属性タイプとそのデプロイメント プロパティを記述します。
weblogic-ra.xml
ファイルは、WebLogic Server 固有のデプロイメント情報を追加します。
コネクタ固有のデプロイメント記述子の作成の詳細については、『WebLogic J2EE コネクタ アーキテクチャ』を参照してください。
.rar
ファイル)を作成します。
.rar
ファイルをステージング ディレクトリに格納します。
META-INF
というサブディレクトリに格納します。
jar
コマンドを実行して、リソース アダプタ アーカイブを作成します。
jar cvf myRAR.rar *
リソース アダプタ アーカイブ ファイルの作成の詳細については、 リソース アダプタのパッケージ化を参照してください。
.rar
をテスト目的で WebLogic Server に自動デプロイします。
リソース アダプタをテストしているときに、デプロイメント記述子を編集しなければならない場合があります。これは手動で編集することも、Administration Console のデプロイメント記述子エディタで編集することもできます。デプロイメント記述子エディタの使用方法の詳細については、 デプロイメント記述子の編集を参照してください。
コンポーネントおよびアプリケーションの自動デプロイメントの詳細については、『BEA WebLogic Server 管理者ガイド』を参照してください。
.rar
リソース アダプタ ファイルを WebLogic Server にデプロイするか、またはエンタープライズ アプリケーションの一部としてデプロイするエンタープライズ アーカイブ(.ear
)に含めます。
コンポーネントおよびアプリケーションのデプロイメントの詳細については、『BEA WebLogic Server 管理者ガイド』を参照してください。
既存のリソース アダプタ(.rar)の変更
以下は、既存のリソース アダプタ(.rar
)を、WebLogic Server にデプロイするために変更する方法の例です。この場合、デプロイメント記述子 weblogic-ra.xml
を追加し、再パッケージ化する必要があります。
mkdir c:\stagedir
cp blackbox-notx.rar c:\stagedir
cd c:\stagedir
jar xf blackbox-notx.rar
ステージング ディレクトリには、以下のものが格納されます。
jar
ファイル
Manifest.mf
および ra.xml
ファイルが入った META-INF
ディレクトリ
以下のコマンドを実行してこれらのファイルを確認します。
c:\stagedir> ls
blackbox-notx.jar
META-INF
c:\stagedir> ls META-INF
Manifest.mf
ra.xml
weblogic-ra.xml
ファイルを作成します。このファイルは、リソース アダプタ用の WebLogic 固有のデプロイメント記述子です。このファイルには、接続ファクトリ、接続プール、およびセキュリティ マッピングのパラメータを指定します。
weblogic-ra.xml DTD の詳細については、『WebLogic J2EE コネクタ アーキテクチャ』を参照してください。
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
jar cvf blackbox-notx.jar -C c:\stagedir
WebLogic Server アプリケーションを開発するには、ソフトウェア ツールをアセンブルし、コードを作成、コンパイル、デプロイ、テスト、およびデバッグするための環境を設定しておく必要があります。この節では、ツールキットを構築し、開発用コンピュータにコンパイラ関連の環境を設定する方法について説明します。
この節では、WebLogic Server アプリケーションの開発に必要なソフトウェア、および開発とデバッグに使用するオプション ツールについて説明します。
Java ソース ファイル、コンフィグレーション ファイル、HTML/XML ページ、および JavaServer Pages の編集には、テキスト エディタが必要です。Windows と UNIX の行末の違いを適切に処理するエディタが望ましいですが、それ以外に特別な要件は何もありません。
WebGain VisualCaf などの Java 統合開発環境(IDE)には、通常 Java のカスタム サポートと共にプログラマ用エディタが付属しています。また IDE は、WebLogic Server でのサーブレットとエンタープライズ JavaBean の作成とデプロイをサポートしている場合もあります。その場合、アプリケーションの開発、テスト、およびデバッグが非常に簡単になります。
HTML/XML ページと JavaServer Pages は、通常のテキスト エディタか、または DreamWeaver などの Web ページ エディタで編集できます。
EJB および Web アプリケーション デプロイメント記述子、config.xml ファイルなど、WebLogic Server で使用される XML ファイルを編集するには、XML エディタを使用します。WebLogic Server には、次の 2 つの XML エディタが付属しています。
これらの XML エディタの使用方法の詳細については、 デプロイメント記述子の編集を参照してください。
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 は、編集とコンパイルを行うコンピュータで実行することも、ネットワークのどこかにデプロイされているコンピュータで実行することもできます。
Java はプラットフォームに依存しないので、任意のプラットフォームでコードの編集とコンパイルを行い、別のプラットフォームで稼働する開発用 WebLogic Server でアプリケーションをテストできます。たとえば、WebLogic Server アプリケーションを Windows または Linux が動作している PC で開発する場合、そのアプリケーションが最終的にどこにデプロイされるかを考慮する必要はありません。
開発用コンピュータで開発用 WebLogic Server を実行しない場合でも、WebLogic Server 配布キットにアクセスできなければプログラムをコンパイルできません。WebLogic または J2EE API を使用してコードをコンパイルするには、Java コンパイラが配布ディレクトリ内の weblogic.jar
ファイルとその他の JAR ファイルにアクセスする必要があります。開発用コンピュータに WebLogic Server をインストールすると、これらのファイルがローカルに使用できます。
データベース システムは、ほぼすべての 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 のフェイルオーバ)を実現します。必要に応じて、ロードバランシングにも対応するようにマルチプールをコンフィグレーションすることができます。
ほとんどの 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)ファイルがあります。
オペレーティング システムがコンパイラとその他の 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
ファイル以外にも、以下のものをコンパイラのクラスパスに組み込みます。
j2ee12.jar
ファイルを CLASSPATH に入れてから、weblogic.jar
ファイルを指定する必要があります。j2ee12.jar
ファイルは、CLASSPATH の先頭に入れることをお勧めします。
WebLogic Server インスタンスで実装する J2EE のバージョン(1.2 または 1.3)の詳細については、 J2EE プラットフォームを参照してください。
lib
\tools.jar
ファイル、または使用する Java 開発キットに必要なその他の標準 Java クラス。
weblogic_sp.jar
ファイル。
この jar
ファイルは、クラスパス内で weblogic.jar
より前に指定する必要があります。これにより、サービス パック クラスはそれらに取って代わられる weblogic.jar
内のクラスより先に検索されるようになります。
クラスパスには、コンパイラによってコンパイルされたクラスの書き出し先となるディレクトリを指定します。これにより、コンパイラはアプリケーション内で依存し合うクラスをすべて検索できるようになります。次の節では、この出力ディレクトリについて詳しく説明します。
コンパイルされたクラスの出力ディレクトリを指定しない場合、Java コンパイラは Java ソースと同じディレクトリにクラス ファイルを書き出します。出力ディレクトリを指定した場合、コンパイラはパッケージ名と同じディレクトリ構造にクラス ファイルを格納します。これにより、Java クラスはアプリケーションのパッケージ化に使用するステージング ディレクトリ内の適切な場所にコンパイルされます。出力先ディレクトリを指定しなかった場合、ファイルを移動してからでなければ、パッケージ化されたコンポーネントを含む jar
ファイルを作成できません。
J2EE アプリケーションは、1 つのアプリケーションにアセンブルされ、1 つまたは複数の WebLogic Server または WebLogic クラスタにデプロイされるモジュールから構成されています。各モジュールは、独自のステージング ディレクトリを持つ必要があります。これにより、他のモジュールとは別個にコンパイル、パッケージ化、およびデプロイできるようになります。たとえば、EJB、Web コンポーネント、およびその他のサーバサイド クラスをそれぞれ独立したモジュールにパッケージ化できます。
コンパイラの出力ディレクトリの設定例については、WebLogic Server
配布キットの config
\examples
ディレクトリにある setExamplesEnv
スクリプトを参照してください。このスクリプトは、以下の変数を設定します。
CLIENT_CLASSES
SERVER_CLASSES
EX_WEBAPP_CLASSES
APPLICATIONS
applications
ディレクトリ。他の変数とは異なり、この変数は Java コンパイラの対象の指定には使用しません。この変数は、ファイルをソース ディレクトリから applications
ディレクトリへ移動するコピー コマンドで、applications
ディレクトリへの便利な参照として使用します。たとえば、ソース ツリーの中に .html
、.jsp
、および画像ファイルがある場合、コピー コマンドでこの変数を使用して、それらのファイルを開発用サーバにインストールできます。
これらの環境変数は、次のようなコマンドで(Windows の場合)コンパイラに渡されます。
javac -d %SERVER_CLASSES% *.java
IDE を使用しない場合、メイク ファイル、シェル スクリプト、またはコマンド ファイルを記述して、コンポーネントとアプリケーションをコンパイルおよびパッケージ化することを検討してください。構築スクリプトに変数を設定して、1 つのコマンドでコンポーネントを再構築できるようにします。
以下のツールのいずれか 1 つを使用して、WebLogic アプリケーションおよびコンポーネントのデプロイメント記述子を編集できます。
いずれかのエディタを使用して、以下のデプロイメント記述子に対して、既存の要素の更新、新しい要素の追加、既存の要素の削除を行うことができます。
web.xml
weblogic.xml
ejb-jar.xml
weblogic-ejb-jar.xml
weblogic-cmp-rdbms-jar.xml
ra.xml
weblogic-ra.xml
application.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 を終了して再起動すると、変更は失われます。
この節では、Administration Console のデプロイメント記述子エディタを使用して以下の EJB デプロイメント記述子を編集する手順を説明します。
EJB 固有のデプロイメント記述子の要素の詳細については、『WebLogic エンタープライズ JavaBeans プログラマーズ ガイド』を参照してください。
EJB デプロイメント記述子を編集するには、次の手順に従います。
http://
host:port
/console
host
は、WebLogic Server が稼働するコンピュータの名前、port
は WebLogic Server がリスンするポートの番号です。
左側のペインでは、3 つの EJB デプロイメント記述子のすべての要素がツリー形式で表示され、右側のペインには、ejb-jar.xml
ファイルの説明要素のためのフォームがあります。
ejb-jar.xml
デプロイメント記述子の要素があります。
weblogic-ejb-jar.xml
デプロイメント記述子の要素があります。
weblogic-cmp-rdbms-jar.xml
デプロイメント記述子の要素があります。
*.jar
アーカイブ ファイルの名前または EJB の表示名です。
この節では、Administration Console のデプロイメント記述子エディタを使用して以下の Web アプリケーション デプロイメント記述子を編集する手順を説明します。
Web アプリケーション デプロイメント記述子の要素の詳細については、『Web アプリケーションのアセンブルとコンフィグレーション』を参照してください。
Web アプリケーション デプロイメント記述子を編集するには、次の手順に従います。
http://
host:port
/console
host
は、WebLogic Server が稼働するコンピュータの名前、port
は WebLogic Server がリスンするポートの番号です。
左側のペインでは、2 つの Web アプリケーション デプロイメント記述子のすべての要素がツリー形式で表示され、右側のペインには、web.xml
ファイルの説明要素のためのフォームがあります。
web.xml
デプロイメント記述子の要素があります。
weblogic.xml
デプロイメント記述子の要素があります。
*.war
アーカイブ ファイルの名前または Web アプリケーションの表示名です。
この節では、Administration Console のデプロイメント記述子エディタを使用して以下のリソース アダプタのデプロイメント記述子を編集する手順を説明します。
リソース アダプタのデプロイメント記述子の要素の詳細については、『WebLogic J2EE コネクタ アーキテクチャ』を参照してください。
リソース アダプタのデプロイメント記述子を編集するには、次の手順に従います。
http://
host:port
/console
host
は、WebLogic Server が稼働するコンピュータの名前、port
は WebLogic Server がリスンするポートの番号です。
左側のペインでは、2 つのリソース アダプタのデプロイメント記述子のすべての要素がツリー形式で表示され、右側のペインには、ra.xml
ファイルの説明要素のためのフォームがあります。
*.rar
アーカイブ ファイルの名前またはリソース アダプタの表示名です。
エンタープライズ アプリケーションのデプロイメント記述子の編集
この節では、Administration Console のデプロイメント記述子エディタを使用してエンタープライズ アプリケーション デプロイメント記述子(application.xml
)を編集する手順を説明します。
application.xml
ファイルの要素の詳細については、
application.xml デプロイメント記述子の要素を参照してください。
注意: 以下の手順は、application.xml
ファイルの編集方法のみを説明するものです。エンタープライズ アプリケーションを構成するコンポーネントのデプロイメント記述子を編集する場合は、
EJB デプロイメント記述子の編集、
Web アプリケーションのデプロイメント記述子の編集、または
リソース アダプタのデプロイメント記述子の編集を参照してください。
エンタープライズ アプリケーション デプロイメント記述子を編集するには、次の手順に従います。
http://
host:port
/console
host
は、WebLogic Server が稼働するコンピュータの名前、port
は WebLogic Server がリスンするポートの番号です。
左側のペインでは、application.xml
ファイルのすべての要素がツリー構造で表示され、右側のペインには、表示名やアイコン ファイル名などの説明要素のためのフォームがあります。
application.xml
デプロイメント記述子の既存の要素を編集するには、次の手順に従います。
application.xml
デプロイメント記述子に新しい要素を追加するには、次の手順に従います。
application.xml
デプロイメント記述子の既存の要素を削除するには、次の手順に従います。
application.xml
デプロイメント記述子への変更がすべて完了したら、左側のペインでツリーのルート要素をクリックします。ルート要素は、エンタープライズ アプリケーションの *.ear
アーカイブ ファイルの名前またはエンタープライズ アプリケーションの表示名です。
application.xml
デプロイメント記述子のエントリが有効かどうかを確認する場合は、[検証] をクリックします。
![]() |
![]() |
![]() |