A Webサービス・クライアントのAPIおよびJAR

この付録では、Webサービス・クライアントのAPIパッケージについて詳しく説明します。また、Webサービス・クライアントを実行するために必要なJARファイルも示します。

この付録の内容は、次のとおりです。

WebサービスのAPIパッケージ

表A-1は、Oracle Application Server Web Servicesの現行リリースで使用可能なパブリックOracle APIのリストです。providerパッケージは、OC4Jコンテナでのみ使用できます。その他のAPIは、コンテナまたはWebサービス・クライアントで使用できます。

関連資料

この表のAPIの詳細は、次を参照してください。

『Oracle Application Server Web Services Java API Reference』

Oracle Technology Network

http://www.oracle.com/technology/index.html

表A-1 クライアントAPIパッケージ

パッケージ名	説明
oracle.webservices	すべてのモジュールに共通するOracle固有の拡張クラスおよび拡張インタフェースが含まれます。
oracle.webservices.attachments	添付ファイルのストリーミングをサポートするクラスおよびインタフェースが含まれます。このパッケージの使用方法の詳細は、『Oracle Application Server Web Servicesアドバンスト開発者ガイド』の「メッセージ添付ファイルの処理」を参照してください。
oracle.webservices.databinding	カスタム・シリアライズ用として使用可能な`SOAPElementSerializer`インタフェースが含まれます。`databinding`パッケージに含まれている機能の使用方法の詳細は、『Oracle Application Server Web Servicesアドバンスト開発者ガイド』の「Java値タイプのカスタム・シリアライズ」を参照してください。
oracle.webservices.management-portability	Webサービスのプラットフォーム・ポータビリティ・レイヤーです。
oracle.webservices.provider	プロバイダ・ベースのエンドポイントを実装するために必要なインタフェースおよびクラスが含まれます。`provider`パッケージの使用方法の詳細は、『Oracle Application Server Web Servicesアドバンスト開発者ガイド』の「Webサービス・プロバイダの使用方法」を参照してください。
oracle.webservices.reliability	WS-Reliabilityを使用した信頼性の高いSOAPメッセージ交換を実装するために必要なインタフェースおよびクラスが含まれます。詳細は、『Oracle Application Server Web Servicesアドバンスト開発者ガイド』のクライアント・サイドの信頼性の動的な構成に関する項を参照してください。
oracle.webservices.security.callback	Webサービスのセキュリティ・コールバックをサポートするクラスを提供します。
oracle.webservices.soap	SOAP 1.2をサポートするOracleの拡張クラスおよび拡張インタフェースが含まれます。このAPIの詳細は、「OraSAAJ APIの概要」を参照してください。
oracle.webservices.transport	トランスポートの複数のバインディングをサポートするクラスおよびインタフェースが含まれます。JMSトランスポートでこのパッケージのクラスを使用する方法の詳細は、『Oracle Application Server Web Servicesアドバンスト開発者ガイド』のJMSトランスポートをサポートするクライアント・コードの記述に関する項を参照してください。
oracle.webservices.wsdl	WSDL 1.1でSOAP 1.2操作をサポートするためのOracle固有のインタフェースが含まれます。このインタフェースの詳細は、付録B「WSDL 1.1 APIのOracle実装」を参照してください。

Webサービス・プロキシのクラスパスの設定

Webサービス・クライアントを作成する場合、このクライアントを実行するには正しいクラスパスを指定する必要があります。次の各項に、クラスパスに含めることができるJARファイルをリストします。この項の各表では、Oracle Application ServerまたはスタンドアロンのOC4Jがインストールされている位置を指定するためにOC4J_HOME環境変数を使用しています。

wsclient_extended.jarによるクラスパスの単純化

J2SE環境の構成を単純化するために、OracleAS Web Servicesには、Webサービス・クライアントをコンパイルおよび実行するために必要なすべてのクラスが含まれるwsclient_extended.jarファイルが用意されています。このファイルをクラスパス上にリストすることで、個々のJARをリストしないですみます。

wsclient_extended.jarファイルには、次のクラス・ファイルが含まれます。

表A-2にリストされている個々のJARファイル内のコアWebサービス・クライアント・クラス・ファイル
表A-3にリストされているJAR内のOC4Jセキュリティ関連のクラス・ファイル
表A-4にリストされているJAR内のWS-Security関連のクラス・ファイル
表A-5にリストされているJAR内のWS-Reliability関連のクラス・ファイル
表A-6にリストされているJAR内のJMSトランスポート関連のクラス・ファイル

wsclient_extended.jarファイルを使用してクライアントを実行する場合は、これらのJARファイルをクラスパスに含める必要はありません。

wsclient_extended.jarファイルは、Oracle Technology Networkから単独のダウンロードとして入手可能です。

http://download.oracle.com/otn/java/oc4j/10131/wsclient_extended.zip

また、このファイルはOC4J Companion CDからインストールすることもできます。この場合、このファイルは、ORACLE_HOME/webservices/libディレクトリにあります。

クライアント・サイド・プロキシを使用するクライアントのクラスパス・コンポーネント

表A-2は、J2SE Webサービス・クライアントのクラスパスに含めることができるJARファイルのリストです。

注意

この表にリストされているwsclient.jarに含まれるのは、Webサービス・クライアントのコア・クラスのみです。コンパイルおよび実行時には、Webサービス・クライアントには、XMLパーサー、WSDLパーサーおよびサービスのクオリティ（QOS）用のクラスなど、他の多くのクラスが必要です。これらのすべての必須クラスは、クラスパスの設定を簡単にするためにwsclient_extended.jarにパッケージ化されています。

常にすべてのJARファイルが必要になるわけではありません。

表A-2 クライアント・サイド・プロキシを使用するクライアントのクラスパス・コンポーネント

コンポーネントJAR	説明
ORACLE_HOME/diagnostics/lib/ojdl.jarおよび ORACLE_HOME/diagnostics/lib/ojdl2.jar	ODLには、Oracle製品でエラー診断を発行するために使用されるAPIや、分析用のエラー診断ログを収集するLogLoaderツールが実装されています。
ORACLE_HOME/j2ee/home/oc4j-api.jar	パブリックOC4J APIが含まれます。
ORACLE_HOME/j2ee/home/oc4jclient.jar	OC4Jクライアントに必要となるファイルが含まれます。
ORACLE_HOME/j2ee/home/lib/activation.jar	通常、このコンポーネントはJREで使用できます。JREで使用できない場合は、クラスパスに含めてください。このJARが必要なのは、添付ファイルを処理する場合のみです。
ORACLE_HOME/j2ee/home/lib/adminclient.jar	プラットフォームの管理およびアプリケーションのデプロイを行うためのJ2EE APIが含まれます。
OC4J_HOME/j2ee/home/lib/ejb.jar	Enterprise JavaBeans用のクラス・ファイルが含まれます。
OC4J_HOME/j2ee/home/lib/http_client.jar	Oracle HTTPクライアントのトランスポート実装が含まれます。
OC4J_HOME/j2ee/home/lib/javax77.jar	J2EE管理仕様（JSR 77）のAPIが含まれます。
OC4J_HOME/j2ee/home/lib/jax-qname-namespace.jar	QName定義が含まれます。
OC4J_HOME/j2ee/home/lib/jmxri.xml	JMX APIが含まれます。
OC4J_HOME/j2ee/home/lib/jmx_remote_api.jar	JMXリモートAPIが含まれます。
OC4J_HOME/j2ee/home/lib/mail.jar	JavaMail APIおよびすべてのサービス・プロバイダが含まれます。通常、このコンポーネントはJREで使用できます。JREで使用できない場合は、クラスパスに含めてください。
OC4J_HOME/j2ee/home/lib/oc4j-schemas.jar	OracleAS Web Servicesのパブリック・スキーマが含まれます。
OC4J_HOME/j2ee/home/lib/servlet.jar	サーブレット実装が含まれます。
OC4J_HOME/lib/dms.jar	Oracle DiagnosticsおよびOracle MonitoringのDMS実装が含まれます。
OC4J_HOME/lib/xml.jar	JAXB実装が含まれます。
OC4J_HOME/lib/xmlparserv2.jar	Oracle XML ParserのJARが含まれます。
OC4J_HOME/lib/xsu12.jar	Oracle XDK SQLユーティリティが含まれます。
OC4J_HOME/webservices/lib/commons-logging.jar	ロギング・ライブラリ・パッケージが含まれます。
OC4J_HOME/webservices/lib/jaxrpc-api.jar	`javax.xml.rpc`および`java.xml.namespace`を含むJAX-RPC APIが含まれます。
OC4J_HOME/webservices/lib/orasaaj.jar	SAAJ APIのOracle実装が含まれます。
OC4J_HOME/webservices/lib/orawsdl.jar	WSDL仕様（JSR 110）用のJava APIのOracle実装（OraWSDL）が含まれます。
OC4J_HOME/webservices/lib/relaxngDatatype.jar	複数のJAX*テクノロジで共用されるRELAX NGデータ型ライブラリが含まれます。
OC4J_HOME/webservices/lib/saaj-api.jar	添付ファイル付きメッセージを処理するためのSAAJ API 1.1が含まれます。
OC4J_HOME/webservices/lib/wsclient.jar	Webサービス・クライアントのランタイムに必要となるクラスが含まれます。
OC4J_HOME/webservices/lib/wsdl-api.jar	WSDL（JSR 110）用のJava APIが含まれます。
OC4J_HOME/webservices/lib/wsif.jar	OracleによるWSIF実装が含まれます。
OC4J_HOME/webservices/lib/xsdlib.jar	複数のJAX*テクノロジで共用されるXMLスキーマ型ライブラリが含まれます。

OC4Jセキュリティ関連のクライアントJARファイル

表A-3は、J2SE Webサービス・クライアントでOC4Jセキュリティをサポートする際にクラスパスに含める必要があるJARファイルのリストです。wsclient_extended.jarファイルには、この表にリストされているJAR内のOC4Jセキュリティ関連のクラス・ファイルが含まれています。wsclient_extended.jarファイルを使用してクライアントを実行する場合は、これらのJARを含める必要はありません。

表A-3 クライアント・サイド・プロキシを使用するクライアント用OC4JセキュリティCLASSPATHコンポーネント

コンポーネント名	説明
OC4J_HOME/j2ee/home/lib/jta.jar	JTA（Java Transaction API）仕様APIが含まれます。
OC4J_HOME/j2ee/home/lib/jaas.jar	Java Authorization and Authentication Specification（JAAS）APIが含まれます。
OC4J_HOME/j2ee/home/lib/jazn.jar	JAZN（Oracle JAASプロバイダ）実装が含まれます。
OC4J_HOME/j2ee/home/lib/jazncore.jar	JAZN（Oracle JAASプロバイダ）実装が含まれます。

WS-Security関連のクライアントJARファイル

表A-4は、J2SE Webサービス・クライアントでWS-Securityをサポートする際にクラスパスに含める必要があるJARファイルのリストです。wsclient_extended.jarファイルには、この表にリストされているJAR内のWS-Security関連のクラス・ファイルが含まれています。wsclient_extended.jarファイルを使用してクライアントを実行する場合は、これらのJARを含める必要はありません。

表A-4 クライアント・サイド・プロキシを使用するクライアント用WS-Security CLASSPATHコンポーネント

コンポーネント名	説明
OC4J_HOME/jlib/javax-ssl-1_1.jar	トランスポート・レベルのセキュリティのサポートが含まれます。
OC4J_HOME/jlib/jaxen.jar	Jaxen（dom4jやJDOMなどの複数のモードでXPath式を評価できるJava XPathエンジン）を定義するクラスが含まれます。
OC4J_HOME/jlib/ojpse.jar	コアである暗号化実装が含まれます。
OC4J_HOME/jlib/oraclepki.jar	Oracle orapkiのkeytoolユーティリティが含まれます。
OC4J_HOME/jlib/osdt_core.jar	Oracle Security Developer's Toolkit（OSDT）APIが含まれます。
OC4J_HOME/jlib/osdt_cert.jar	Oracle Security Developer's Toolkitの暗号化APIが含まれます。
OC4J_HOME/jlib/osdt_saml.jar	Oracle Security Developer's ToolkitのSecurity Assertion Markup Language（SAML）APIが含まれます。
OC4J_HOME/jlib/osdt_wss.jar	Oracle Security Developer's ToolkitのWeb Services Security（WS-Security）APIが含まれます。
OC4J_HOME/jlib/osdt_xmlsec.jar	Oracle Security Developer's ToolkitのXML署名および暗号化のAPIが含まれます。
OC4J_HOME/webservices/lib/wssecurity.jar	WS-Security APIが含まれます。

信頼性関連のクライアントJARファイル

表A-5は、J2SE Webサービス・クライアントでWS-Reliabilityをサポートする際にクラスパスに含める必要があるJARファイルのリストです。wsclient_extended.jarファイルには、この表にリストされているJAR内のWS-Reliability関連のクラス・ファイルが含まれています。wsclient_extended.jarファイルを使用してクライアントを実行する場合、このJARを含める必要はありません。

表A-5 クライアント・サイド・プロキシを使用するクライアント用の信頼性関連のCLASSPATHコンポーネント

コンポーネント名	説明
OC4J_HOME/webservices/lib/orawsrm.jar	Web Services Reliability（WS-Reliability）APIおよびその実装が含まれます。

JMSトランスポート関連のクライアントJARファイル

表A-6は、J2SE Webサービス・クライアントでトランスポート・メカニズムとしてJMSをサポートする際にクラスパスに含める必要があるJARファイルのリストです。wsclient_extended.jarファイルには、この表にリストされているJAR内のJMSトランスポート関連のクラス・ファイルが含まれています。wsclient_extended.jarファイルを使用してクライアントを実行する場合、このJARを含める必要はありません。

表A-6 トランスポート・メカニズムとしてJMSを使用するクライアント用のCLASSPATHコンポーネント

コンポーネント名	説明
J2EE_HOME/j2ee/home/lib/jms.jar	JMS APIが含まれます。

データベースWebサービス関連のクライアントJARファイル

表A-7にリストされているJARファイルをクラスパスに含める必要があるのは、J2SE Webサービス・クライアントが、SQL/XML書式またはWebRowSet型であるパラメータまたは戻り値を使用するサービスを起動する場合です。また、ネイティブのWSIFバインディングを使用してデータベースWebサービスを起動する場合も、クライアントにこれらのライブラリを含める必要があります。

注意
この表にリストされているJAR内のクラス・ファイルは、wsclient_extended.jarファイルには含まれていません。これらのファイルで提供される機能がクライアントに必要となる場合は、これらのファイルをクラスパスに明示的に含める必要があります。

表A-7 クライアント・サイド・プロキシを使用するクライアント用のデータベース関連のCLASSPATHコンポーネント

コンポーネント名	説明
ORACLE_HOME/rdbms/jlib/aqapi.jar	Oracleアドバンスト・キューイングのAPIが含まれます。
ORACLE_HOME/jdbc/lib/ocrs12.jar	OracleによるWebRowSet実装が含まれます。
ORACLE_HOME/jdbc/lib/ojdbc14dms.jar	Oracle JDBCドライバが含まれます。
OC4J_HOME/lib/xsu12.jar	OracleによるSQL/XML書式実装が含まれます。

CLASSPATHコマンドのサンプル

例A-1は、すべてのOracle Application Server Web ServicesクライアントJARファイルを対象とした、Windowsプラットフォームのset CLASSPATHコマンドのサンプルです。UNIXプラットフォームのクラスパスも同じ方法で設定されます。

例A-1 Windowsプラットフォームのset CLASSPATHコマンド

set CLASSPATH=%ORACLE_HOME%¥j2ee¥home¥oc4jclient.jar;%CLASSPATH%
set CLASSPATH=%ORACLE_HOME%¥j2ee¥home¥lib¥adminclient.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥j2ee¥home¥lib¥ejb.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥j2ee¥home¥lib¥mail.jar;%CLASSPATH%
set CLASSPATH=%ORACLE_HOME%¥j2ee¥home¥lib¥activation.jar;%CLASSPATH%
set CLASSPATH=%J2EE_HOME%¥j2ee¥home¥lib¥jms.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥j2ee¥home¥lib¥http_client.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥j2ee¥home¥lib¥jaas.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥j2ee¥home¥lib¥jazn.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥j2ee¥home¥lib¥javax77.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥j2ee¥home¥lib¥jax-qname-namespace.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥j2ee¥home¥lib¥jta.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥j2ee¥home¥lib¥jazncore.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥j2ee¥home¥lib¥servlet.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥j2ee¥home¥lib¥jmx_remote_api.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥j2ee¥home¥lib¥jmxri.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥j2ee¥home¥lib¥oc4j-schemas.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥lib¥xmlparserv2.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥xdk¥lib¥xml.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥webservices¥lib¥orawsrm.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥webservices¥lib¥xsdlib.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥webservices¥lib¥relaxngDatatype.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥lib¥dms.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥webservices¥lib¥commons-logging.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥webservices¥lib¥jaxrpc-api.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥webservices¥lib¥wsclient.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥webservices¥lib¥wsdl-api.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥webservices¥lib¥wsif.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥webservices¥lib¥wssecurity.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥webservices¥lib¥saaj-api.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥webservices¥lib¥orasaaj.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥webservices¥lib¥orawsdl.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥jlib¥osdt_wss.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥jlib¥osdt_xmlsec.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥jlib¥ojpse.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥jlib¥osdt_saml.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥jlib¥oraclepki.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥jlib¥osdt_core.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥jlib¥osdt_cert.jar;%CLASSPATH% 
set CLASSPATH=%OC4J_HOME%¥jlib¥jaxen.jar;%CLASSPATH%
set CLASSPATH=%OC4J_HOME%¥jlib¥javax-ssl-1_1.jar;%CLASSPATH%