Oracle® Fusion Middleware Oracle WebLogic Serverスタンドアロン・クライアントのプログラミング 11gリリース1 (10.3.6) B61622-06 |
|
![]() 前 |
![]() 次 |
この章では、WebLogicシンt3クライアントを開発および使用する方法について説明します。
WebLogicシンT3クライアントのjar (wlthint3client.jar
)は、wlfullclient.jar
およびwlclient.jar
(IIOP)リモート・クライアントのjarの軽量かつ高パフォーマンス版です。シンT3クライアントは、サイズを最小限に抑えながら、クライアントでの使用に適した豊富なAPI群へのアクセスを実現します。その名前が示すように、WebLogic T3プロトコルを使用し、IIOPプロトコルを使用するwlclient.jarに勝る大幅なパフォーマンス向上をもたらします。
シンT3クライアントは、リモート・クライアントのほとんどのユース・ケースで推奨される方式です。シンT3クライアントには、次に示すような制限があります。これらの数少ないユース・ケースでは、フル・クライアントまたはIIOPシン・クライアントを使用する必要があります。
シンT3クライアントは、スタンドアロン・アプリケーションで使用でき、WebLogic以外の外部サーバーで実行するアプリケーションで使用できるように設計されています。一般的なユース・ケースの1つは、WebLogic JMS宛先との統合です。
このリリースでは、次の機能をサポートしています。
RMI over HTTP (HTTPトンネリング)を含む、Oracle WebLogicのRemote Method Invocation (RMI)用のT3/T3Sプロトコル。WebLogic T3通信の詳細は、『Oracle WebLogic Server RMIのプログラミング』のWebLogic RMIでのT3プロトコルの使用方法に関する項を参照してください。
WebLogic Serverで使用可能なJMS、JMX、JNDI、およびEJBの各リソースへのアクセス。
JTAを使用したトランザクションの開始と終了(ロールバックまたはコミット)。
WebLogicクライアントJMS機能。順序単位、作業ユニット、メッセージ圧縮、XMLメッセージ、JMS自動クライアント再接続、Destination Availability Helper APIなどがあります。
クライアント側のクラスタリングを使用すると、クライアント・アプリケーションはフェイルオーバーやWebLogic Serverインスタンスのロード・バランシングに関与できます。『Oracle WebLogic Server RMIのプログラミング』のクラスタリングRMIアプリケーションに関する項を参照してください。
JAAS認証とJSSE SSL。「セキュリティ」を参照してください。
このリリースでは、次の機能はサポートしていません。
RMI over HTTPS (SSL上のHTTPトンネリング)。
JMS SAFクライアント、Mbeanベースのユーティリティ(JMSヘルパー、JMSモジュール・ヘルパーなど)、およびJMSマルチキャストはサポートされていません。MbeanベースのヘルパーのかわりにJMX呼出しを使用できます。
WebLogic JDBC拡張をはじめとするJDBCリソース。
クライアントでのWebLogic RMIサーバーの実行。
ネットワーク・クラスのロード。
wlthint3client.jar
を使用する一部のマルチスレッド・クライアント・アプリケーションでは、InitialContext
の取得元である同じWebLogicインスタンスですべてのプロデューサが作成されるという既知の問題があります。予期される動作は、作成したすべてのプロデューサが分散キューのすべてのメンバーに対してロード・バランシングされることです。この問題は、WebLogic Serverの次回のリリースで解決されます。回避策は、wlfullclient.jar
を使用して、分散キューのすべてのメンバーに対してプロデューサをロード・バランシングすることです。
このリリースのWebLogicシンT3クライアントは、相互運用性を次のようにサポートしています。
WebLogicシンT3クライアントにおける旧WebLogicリリースとの通信のサポートについては、Oracle WebLogic Serverインフォメーション・ロードマップのプロトコルの互換性に関する項を参照してください。
WebLogicシンT3クライアントのjarは、次のアプリケーション・サーバーでサポートされています。
Oracle OC4J: バージョン10g以降
IBM WebSphere Application Server: バージョン6.xおよび7.x
Red Hat JBoss Application Server: バージョン5.xおよび6.x
クライアントのセキュリティに関する一般情報は、次の項を参照してください。
『Oracle WebLogic Serverセキュリティの理解』のJava Secure Socket Extension (JSSE)に関する項。
『Oracle WebLogic Serverセキュリティの理解』のJava Authentication and Authorization Services (JAAS)に関する項。
『Oracle WebLogic Serverセキュリティのプログラミング』のJavaクライアントでのSSL認証の使用に関する項。
『Oracle WebLogic Serverセキュリティのプログラミング』のJavaクライアントでのJAAS認証の使用に関する項。
基本的なWebLogicシンT3クライアントを作成するには、次の手順に従います。
リモート・オブジェクトへの参照を取得します。
t3://ip address:port
またはt3s://ip address:port
という形式のT3 URLを使用して、サービスをホストするサーバーの初期コンテキストを取得します。
初期コンテキストを使用してルックアップを実行することで、サービス・オブジェクトのインスタンスを取得します。このインスタンスは、ローカル・オブジェクト参照と同じように使用できます。
リモート・オブジェクト・メソッドを呼び出します。
クライアントのクラスパスにwlthint3client.jar
を追加します。このファイルは、WebLogic ServerがインストールされているWL_HOME
\server\lib
ディレクトリにあります。
注意: 複数のクライアントを組み合せて拡張機能セットを作成することはサポートされていません。wlfullclient.jar 、wlthint3client.jar またはwlclient.jar を、WebLogic ServerのクラスパスやWebLogicフル・インストールのweblogic.jar ファイルを参照するクラスパスに追加しないでください。追加した場合の動作は不明です。WebLogic Serverアプリケーションは、すでにWebLogicクライアントの機能をすべて利用できます。 |
例3-1に、基本的なWebLogicシンT3クライアントのサンプル・コードを示します。
例3-1 WebLogic初期コンテキストの作成および使用
Hashtable env = new Hashtable(); env.put("java.naming.factory.initial", "weblogic.jndi.WLInitialContextFactory"); env.put("java.naming.provider.url","t3://host:7001"); env.put("java.naming.security.principal","user"); env.put("java.naming.security.credentials","password"); Context ctx = new InitialContext(env); try { Object homeObject = context.lookup("EmployeeBean"); //use the EmployeeBean } catch (NamingException e) { // a failure occurred } finally { try {ctx.close();} catch (Exception e) { // a failure occurred } }
外部サーバーにホストされているアプリケーションは、wlthint3client.jar
を使用すると、WebLogic Serverインスタンスのリモート・クライアントとして機能できます。JMS、サーブレット、EJB、起動クラスなどのリモート・サービスへのアクセスを可能にするには、必要なアプリケーション・コードをwlthint3client.jar
とともにアプリケーション・サーバーにデプロイします。
JNDIを使用して外部アプリケーション・サーバーからWebLogic Serverリソースに接続し、アクセスするには、ガイドラインとして次の手順に従ってください。
クライアントのクラスパスにwlthint3client.jar
を追加します。
クライアント・アプリケーションで、WebLogic初期コンテキストを作成してから、そのコンテキストを使用してリソースをルックアップし、使用します。詳細は、例3-1「WebLogic初期コンテキストの作成および使用」を参照してください。
初期コンテキスト・ファクトリをクライアント・コードのシステム・プロパティとして次の値に明示的に設定することが必要な場合もあります。
env.put("java.naming.factory.initial", "weblogic.jndi.WLInitialContextFactory");
wlthint3client.jar
ファイルをサーブレットに埋め込んだり、共有ライブラリを使用したりするなど、標準Java EEメソッドを使用してwlthint3client.jar
ファイルと共に必要なアプリケーション・コードをアプリケーション・サーバーにデプロイします。「デプロイメントの考慮事項」を参照してください。
クライアントを起動またはデプロイします。
次の項では、外部サーバーと相互運用する際に考慮すべき事項について概説します。
wlthint3client.jar
は、Java EEの標準的な方法でデプロイできます。ただし、使用するデプロイメント方法を決める際には、クライアントのサイズ、クラスのロード、パフォーマンス、およびコードの不整合が発生するリスクへの許容度を考慮する必要があります。例:
wlthint3client.jar
をサーブレットなどのアプリケーションに埋め込んだ場合、アプリケーションのサイズはwlthint3client.jar
のサイズだけ増えますが、コードの不整合が発生するリスクはアプリケーションの範囲に限定されます。
wlthint3client.jar
をlibディレクトリにデプロイした場合、アプリケーションのサイズに影響はありませんが、コードの不整合が発生するリスクは外部サーバー・コンテナ全体に及びます。
OC4J内で実行されているアプリケーションのうち、WebLogic Serverリソースを必要とするもののクラスパスにwlthint3client.jar
ファイルを追加します。http://download.oracle.com/docs/cd/E14101_01/doc.1013/e13979/classload.htm#CIHDGJGD
のOC4Jでの共有ライブラリのインストールと公開に関する項を参照してください。
次の項では、WebLogic Serverリソースのリモート・クライアントとして機能するOracle OC4Jアプリケーション・サーバーと相互運用する際の重要な考慮事項について概説します。
トランザクションの伝播: サーバー間でのトランザクション・コンテキスト・オブジェクトの伝播はサポートされていません。
セキュリティ・コンテキストの伝播: サーバー間でのセキュリティ/アイデンティティ情報の伝播はサポートされていません。
OC4Jの詳細は、『Java EEアップグレード・ガイド』のOC4Jユーザー用Oracle WebLogic Serverの紹介に関する項を参照してください。
次の項では、JNDIを使用してOC4JからWebLogic Serverリソースに接続およびアクセスする方法について、例をあげて説明します。
クライアント・アプリケーションで、WebLogic初期コンテキストを作成してから、そのコンテキストを使用してリソースをルックアップし、使用します。詳細は、例3-1「WebLogic初期コンテキストの作成および使用」を参照してください。
OC4J URLコンテキスト・ファクトリ・プロパティを設定します。http://download.oracle.com/docs/cd/E14101_01/doc.1013/e13975/jndi.htm
のサーバー側のURLコンテキスト・ファクトリの有効化に関する項、またはリモート・クライアントのURLコンテキスト・ファクトリの有効化に関する項を参照してください。
クライアントのクラスパスにwlthint3client.jar
を追加します。
JARファイルをOC4J共有ライブラリとして追加します。http://download.oracle.com/docs/cd/E14101_01/doc.1013/e13980/ascontrol.htm#BABFDHGB
の共有ライブラリの作成および管理に関する項を参照してください。
クライアントを起動またはデプロイします。
ContextScanningResourceProvider
リソース・プロバイダを使用してWebLogicサーバーのJMS宛先にアクセスする際には、resource.names
プロパティを使用して、外部サーバーが要求するJMSリソースのJNDI名のカンマ区切りリストを明示的に設定する必要があります。ContextScanningResourceProvider
リソース・プロバイダを使用してサード・パーティのJMS宛先にアクセスする方法の詳細は、http://download.oracle.com/docs/cd/E14101_01/doc.1013/e13975/jms.htm
のOracle Enterprise Messaging Serviceの使用に関する項を参照してください。
注意: resource.names の構文では、JNDI名のカンマ区切りリストのカンマと次のJNDI名との間にスペースを入れることはできません。 |
次の例は、orion-application.xml
ファイルにresource.names
プロパティを設定する方法を示しています。resource.names
プロパティは、TopicOne
,QueueOne
,TopicTwo
に設定されます。この値は、ContextScanningResourceProvider
リソース・プロバイダが外部WebLogicサーバーからルックアップしようとするJMS宛先のJNDI名のリストを表しています。
例3-2 resource.namesプロパティの設定
<resource-provider class="com.evermind.server.deployment.ContextScanningResourceProvider" name="WebLogicRP"> <property name="java.naming.factory.initial" value="weblogic.jndi.WLInitialContextFactory"/> <property name="java.naming.provider.url" value="t3://localhost:7001/"/> <property name="java.naming.security.principal" value="user_name"/> <property name="java.naming.security.credentials" value="user_password"/> ... <!-- configure the set of known JMS destinations that are required for this application --> <property name="resource.names" value="TopicOne,QueueOne,TopicTwo"/> ... </resource-provider>