2 開発およびドキュメント・ロードマップ

次の各項では、Webサービスの開発手順を示すこのドキュメント内の推奨ロードマップを示します。

• 環境の設定

• ベスト・コーディング・プラクティス

• Webサービスのアーチファクトのアセンブル

• Webサービスのデプロイ

• デプロイされたWebサービスのテスト

• Webサービス・クライアントのアセンブル

• Webサービスへのサービスのクオリティ機能の追加

• Webサービスの拡張機能の追加

• Webサービスの代替方針

• 参照用の章および付録

環境の設定

この章には、OracleAS Web Servicesに用意されている機能を使用できるように環境を設定する方法が説明されています。

• 第4章「始める前に」

ベスト・コーディング・プラクティス

この項に記載されている各章には、Webサービス設計時の考慮事項が記載されています。

次の章には、OracleAS Web Servicesで使用可能な様々なメッセージ書式が説明されています。その章では、メッセージ書式ごとに長所と短所を説明し、クライアントの機能に応じて使用する書式を提案しています。

• 第5章「OracleAS Web Servicesメッセージ」

『Oracle Application Server Web Servicesアドバンスト開発者ガイド』の次の章には、相互運用性に関する問題がよく発生する可能性がある領域のいくつかが指摘されています。その章には、様々なプラットフォーム上のアプリケーションとWebサービスとの相互運用性を向上させるための設計上の提案やプログラミング上のガイドラインが記載されています。

• 「相互運用可能なWebサービスの実現」

Webサービスのアーチファクトのアセンブル

OracleAS Web Servicesを使用すると、Webサービスのアーチファクトをアセンブルする際、Javaクラス、EJB、JMS宛先、データベース・リソース、またはJ2SE 5.0 JDKのWebサービス注釈機能を使用するソース・ファイルからボトムアップ方式でアセンブルを開始できます。また、トップダウン方式でWSDLからアーチファクトをアセンブルし始めることもできます。OracleAS Web Servicesでは、WebServicesAssemblerツールを使用してアセンブリを実行します。ツールのリファレンス・ガイドについては、第18章「WebServicesAssemblerの使用方法」を参照してください。

次の各章には、WebServicesAssemblerツールを使用してOracleAS Web Servicesで可能な様々なタイプのWebサービスのアセンブリを実行する方法が説明されています。

• 第6章「WSDLからのWebサービスのアセンブル」

• 第7章「Javaクラスを使用したWebサービスのアセンブル」

• 第8章「EJBを使用したWebサービスのアセンブル」

• 第9章「JMS宛先を使用したWebサービスのアセンブル」

• 第10章「データベースWebサービスのアセンブル」

• 第11章「注釈を使用したWebサービスのアセンブル」

Webサービスのデプロイ

WebServicesAssemblerツールは、デプロイは実行しませんが、Webサービスを、デプロイ可能なEARまたはWARファイルにパッケージ化します。このファイルのデプロイは、他のEARファイルまたはWARファイルをOC4Jの実行中インスタンスにデプロイすることとよく似ています。OC4Jには、デプロイの実行方法を説明したマニュアルが別途用意されています。

• 『Oracle Containers for J2EEデプロイメント・ガイド』

次の章には、パッケージ化のフォーマットやデプロイに必要なファイルに関する追加情報が説明されています。また、Oracle JDeveloperおよびApplication Server Controlツールによるデプロイのサポートも簡単に説明されています。

• 第19章「Webサービスのパッケージ化およびデプロイ」

デプロイされたWebサービスのテスト

次の章には、Webサービスのテスト・ページが記載されています。このページを使用すると、コードを記述しなくても、デプロイが正常かどうかをテストできます。

• 第13章「Webサービス・デプロイのテスト」

Webサービス・クライアントのアセンブル

次の各章には、WebServicesAssemblerツールを使用してJ2SEおよびJ2EEプラットフォーム用のWebサービス・クライアントをアセンブルする方法が説明されています。

• 第14章「J2EE Webサービス・クライアントのアセンブル」

• 第15章「J2SE Webサービス・クライアントのアセンブル」

Webサービスへのサービスのクオリティ機能の追加

OracleAS Web Servicesは、セキュリティ、信頼性、メッセージ・ロギングおよび監査など、サービスのクオリティ機能をサポートしています。次の各章には、これらの機能の実装方法が説明されています。これらの機能を使用するには、Oracle JDeveloperやApplication Server Controlなど、他のツールを使用します。次の各章は、『Oracle Application Server Web Servicesアドバンスト開発者ガイド』にあります。

• 「Webサービスの管理」

• 「Webサービスのセキュリティの確保」

  この章には、『Oracle Application Server Web Servicesセキュリティ・ガイド』の内容の概要のみが記載されています。このセキュリティ・ガイドには、メッセージ・レベルのセキュリティによるWebサービスの実装が説明されています。

• 「Webサービスの信頼性の確保」

• 「監査メッセージおよびロギング・メッセージ」

Webサービスの拡張機能の追加

次の各章には、Webサービスのパフォーマンスと機能を拡張する追加機能が記載されています。

• 第16章「JAX-RPCハンドラの使用方法」

• 第17章「SOAPヘッダーの処理」

『Oracle Application Server Web Servicesアドバンスト開発者ガイド』の次の各章も参照してください。

• 「メッセージ添付ファイルの処理」

• 「Java値タイプのカスタム・シリアライズ」

Webサービスの代替方針

次の各章には、Webサービスの実装の代替モードが説明されています。

たとえば、Webサービス・コールの実行、SOAP以外のプロトコル用のクライアントの作成、またはHTTP以外のトランスポート・メカニズムの使用などを行う、独自のインフラストラクチャを記述することができます。

• 第12章「REST Webサービスのアセンブル」

『Oracle Application Server Web Servicesアドバンスト開発者ガイド』の次の各章も参照してください。

• 「Webサービス・トランスポートとしてのJMSの使用方法」

• 「Webサービス起動フレームワークの使用方法」

• 「Webサービス・プロバイダの使用方法」

参照用の章および付録

次の各章および付録には、このマニュアルで説明する実装および開発タスクを補足する情報が記載されています。

• 第1章「Webサービスの概要」

• 第3章「OracleAS Web Servicesアーキテクチャとライフ・サイクル」

• 第18章「WebServicesAssemblerの使用方法」

• 付録A「Webサービス・クライアントのAPIおよびJAR」

• 付録B「WSDL 1.1 APIのOracle実装」

• 付録C「oracle-webservices.xmlデプロイメント・ディスクリプタ・スキーマ」

• 付録D「service-ref-mappingスキーマ」

• 付録E「エラー・メッセージ接頭辞」

『Oracle Application Server Web Servicesアドバンスト開発者ガイド』の次の参照用の章および付録も参照してください。

• 「Webサービス管理スキーマの概要」

• 「OracleAS Web Servicesのクライアント・スキーマ」

• 「OracleAS Web Servicesの信頼性スキーマ」

• 「OracleAS Web Servicesの監査スキーマ」

• 「OracleAS Web Servicesのトレース・スキーマ」

• 「JAX-RPCマッピング・ファイル記述子」

• 「WebサービスMbean」

• 「Java型のXMLおよびWSDL型へのマッピング」