お客様が developerWorks に初めてサインインすると、プロフィールが作成されます。プロフィールで選択した情報は公開されますが、いつでもその情報を編集できます。お客様の姓名（非表示設定にしていない限り）とディスプレイ・ネームは、投稿するコンテンツと一緒に表示されます。

送信されたすべての情報は安全です。

developerWorks に初めてサインインするとプロフィールが作成されますので、その際にディスプレイ・ネームを選択する必要があります。ディスプレイ・ネームは、お客様が developerWorks に投稿するコンテンツと一緒に表示されます。

ディスプレイ・ネームは、3文字から31文字の範囲で指定し、かつ developerWorks コミュニティーでユニークである必要があります。また、プライバシー上の理由でお客様の電子メール・アドレスは使用しないでください。

送信されたすべての情報は安全です。

My developerWorks：

通知：

サイン・アウト

言語を選択する：

シンプルSOAPクライアント

汎用Java SOAPクライアント

Bob DuCharme (bob@snee.com), Solutions Architect, UDICo

Bob DuCharme は Innodata Isogen のソリューション・アーキテクトであり、XML が禁句であった頃には XML の「エキスパート」でした。彼は情報技術に関して 4 冊の本と100 本近くのオンライン記事や印刷記事を書いていますが、そのどれにも「機能性 (functionality)」という単語を使っていません。詳しくは http://www.snee.com/bob をご覧ください。

概要： この記事では、専用のSOAPライブラリーを使用しない、Javaによる簡単な汎用SOAPクライアントについて説明します。この簡単なSOAPクライアントでは、SOAP要求XML文書をシステムの内部で作成するのではなく、XMLエディター (またはテキスト・エディター)を使用して、要求を作成することが可能です。また、単にリモート・メソッドの戻り値を示すのではなく、このクライアントは、実際のSOAP応答のXML文書を示します。この短いJavaプログラムは、SOAPが行っていることを包み隠さずに教えてくれます。すなわち、HTTP接続を行い、リモート・メソッドを呼び出す適切なXMLを送信し、サーバーから返されるXML応答を読み込むというプロセスを見せてくれます。

タグを付ける!

日付: 2001年 5月 01日
レベル: 初級
この記事の原文: 英語
アクティビティー： 8952 ビュー
お気軽にご意見・ご感想をお寄せください：

Simple Object Access Protocol (SOAP) は、ネットワーク上の情報交換として、IBM, Microsoft, DevelopMentor，およびUserLand Softwareが開発に携わっている発展途上のW3C標準です。ますます多くのSOAPサーバーがWeb上で公開されるようになるにつれて、SOAPがさまざまな言語のプログラム(Visual BasicやJavaScript、perlなどのシンプルで一般的な言語で書かれた短く小さいプログラムまで)に対して果たす役割は、Webブラウザーに対してHTMLが果たしたものと同様になってきています。これによって、拡大を続けるWeb上のさまざまな情報ソースを簡単に利用できるようになっています。

HTMLと同様、SOAPは、HTTP (SOAP 1.1からはSMTPも) によってWeb上で送信されるさまざまな情報のそれぞれの役割をタグによって示します。しかしSOAPは、HTMLよりもはるかに強力な機能を持っています。SOAPでは、ユーザーのプログラムがSOAPサーバーへの「SOAP要求」(リモート・マシンで呼び出すメソッドとそこに送られるパラメーターを記述した短いXML文書) を送信します。SOAPサーバーは、それらのパラメーターを用いてメソッドを実行し、SOAP応答 (実行結果またはエラー・メッセージ) をユーザーのプログラムに返します。公開使用されているSOAPサーバーは、株価、最新の為替レート、FedExの貨物追跡情報、代数式の解法など、情報を求めるあらゆるSOAPクライアントに対してさまざまな情報を提供します。

SOAPが開発される以前は、このような情報を利用するには、プログラムによってWebページを開き、HTMLを「検索」してテキストを探すという作業が必要でした。しかし、Webページに表示の変更 (たとえば、最新の株価を表の2番目の欄ではなく3番目の欄に入れる) があった場合には、そのプログラムは使用できなくなってしまいました。SOAP仕様 (および、それに伴うSOAP要求 / SOAP応答に関する概要) によって、クライアント / サーバー間ルールのフレームワークが確立され、きわめて強力な情報収集ツールの基盤が作られました。

SOAPクライアントは数多くあり、一般的なプログラミング言語のほとんどに対応しています。詳細なリストは、SOAP::Lite for PerlのページのSOAP Toolkitsセクションを参照してください (参考文献を参照)。ほとんどのSOAPクライアントは、プログラムから呼び出しの対象となるクラス・ライブラリー、COMオブジェクト、またそれに相当するものを提供しますが、それらのクライアント・ライブラリーは、通常、以下のように使用されます。

呼び出しの対象となるリモート・メソッド名および必要なパラメーターを、クライアントのプログラムが送信する。
ライブラリーが、適切なSOAP要求のXML文書をアセンブルし、この情報をパッケージする。
ライブラリーが、SOAPエンドポイントURLによって識別されたSOAPサーバーへこのXML文書を送信する (サーバーのURLを指定し、ブラウザーにWebサーバー・アドレスを指し示すのと同様)。
SOAPサーバーはメソッドを実行し、その実行結果に関するSOAP応答のXML文書をアセンブルし、SOAPクライアントに返信する。
SOAP応答を受け取ると、クライアント・ライブラリーは、XMLを構文解析してメソッド呼び出しの結果を取得し、ライブラリーを用いてこの結果をプログラムへ送信する。

SOAPClient4XG

SOAPの紹介 (developerWorksのGraham Glassの「Web Servicesの進化と革命」を参照) では、常に、SOAP要求 / SOAP応答に使用されるXML文書の構造について示されていますが、私が使用したSOAPクライアントでは、XMLアセンブリー / XML構文解析の管理がシステム内部で行われるため、私自身がそれを行う必要はありませんでした。しかし、XMLのおたくである私はXMLを自分で作成したいと思いました。そして、SOAPがそれほど簡単なものであるなら、SOAP要求のXML文書を読み込むためのシンプルなSOAPクライアントを記述し、コマンド・ラインで指定されたSOAPエンドポイントURLへそれを送信して、応答の文書を読み込み、その応答を出力することができる、と私は考えました。これによって、どのSOAPサーバーのどのメソッドでも呼び出しができるようになるため、これはまさに汎用のSOAPクライアントでしょう。

リスト1 で示されているSoapClient4XG (「SOAP Client for XML Geeks」) Javaクラスは、前にも述べたSOAP Toolkitsのページ (参考文献を参照) に記載されている特別なJava SOAPクラスを使用せずに、処理を実行します。SoapClient4XGは、SOAPエンドポイントURLおよびSOAPのXML文書のファイル名がパラメーターとして送信されたことを確認した後、ファイルに読み込んでそれをSOAPサーバーへ送信し、応答を読み込んで標準出力へ出力します。

このSOAPクライアントはHTTPプロトコルによってXML SOAP要求を送信するため、主に必要となるのはHTTPの設定です。Javaには、各HTTPパラメーターを適切に設定するための数多くのメソッド「セット」を持つHttpURLConnection クラスがあり、パラメーターのほとんどは簡単な文字列によって設定できます。Content-Length は追加コードを必要とするHTTPパラメーターであり、SoapClient4XGは、XML要求を読み込んでそれをバイト配列に入れ、バイト配列のlength プロパティーを確認して、XML要求の長さを割り出します(訳注：HttpURLConnectionクラスの実装は通常Content-Lengthを自動的に計算し、ヘッダに入れてくれます。少なくとも、SunやIBMの実装はそうなっています。従ってこの部分のコードは必要ないはずです。)。

また、その他の方法によるこのようなHTTPパラメーターの設定管理も可能です。Sunが提供するオープン・ソースのBrazil Webアプリケーション・フレームワーク (参考文献を参照) は、Javaアプレットによるイメージおよびその他のWebリソースの負荷軽減のために特別に書かれたものではない汎用のHTTPクラスであり (以前のHttpURLConnection クラスとは異なり)、HTTP問題の処理を自動化し、適切なSOAPエラー処理をより容易なものとします。

完全なSOAPクライアントは、リスト1を参照してください。

上に戻る

実行

Xmethods.com (参考文献を参照) では、拡大を続けるSOAPサービスのリストが公開されています。その多くには、SOAP Actionパラメーターを必要とするかどうかの情報と共に、XML要求のサンプルが記載されており、私は気温情報のSOAPサーバーのサンプル要求をコピーし、若干空白を追加してそのzipcode エレメントを私独自のzipコードに置き換えました。これは、リスト2 に示されています。

weattherreq.xml として保存されたこのファイルによって、リスト3 のコマンド・ラインは、私がXMLサンプルを見つけたXMethods Webページで指定されているSOAPエンドポイントURLへその内容を送信します。

リスト4 に示されているように、SOAPサーバーは、response エレメントに保存されている現在の気温情報を持ったSOAP応答を返信します。

このSOAPクライアントでは、システムの内部でXML文書が作成されるのではなく、自分自身で作成したXML文書によってSOAP要求をSOAPクライアントへ送信でき、XMLエディターやテキスト・エディターによってXML文書を直接編集することができます。さらに重要なことは、拡大を続けるSOAPサービスをこのSOAPクライアントによってより簡単に利用することができるようになるという点です。その方法は簡単です。利用するサービスのSOAPエンドポイントURLに名前を付け、HTTPパラメーターを設定し、呼び出しメソッドとそれらを送信するためのパラメーターを示すXMLを送信して、あとは応答を待つだけです。

ぜひ、使いたいプログラミング言語のSOAPライブラリーを調べてみてください。エラー処理や堅固なアプリケーション開発のための基盤という点では、通常、私のSOAPクライアントよりもSOAPライブラリーの方が優れた機能を提供しています。しかし、最終的にはシンプルさがものを言うこと、そしてこの簡単なプロトコルがきわめて大きな力を持っていることも忘れないでください。

(HTTPに関して、Michael Brennan氏の助力に特別な感謝の意を表します。)

参考文献

SOAP::Lite for PerlのページのSOAP Toolkits セクションで、さまざまなプログラミング言語のツールキットが提供されています。また、Joe Johnston氏がdeveloperWorksの新しい記事の中で、PerlでのSOAP::Liteの使用について説明しています。
developerWorksのGraham Glass氏によるシリーズ「Web Servicesの進化と革命」(特に第2回と第3回) では、SOAP開発をわかりやすく紹介しています。
James Snell氏のWeb Servicesインサイダー：第1回: SOAPについての随想は、業界におけるSOAPの役割に関する最新情報を示し、また、いくつかのSOAPツールキットの機能を比較しています。
Uche Ogbuji氏のSOAPアプリケーションでWSDLを活用する方法は、Web Services Description LanguageおよびSOAP開発におけるそのメリットを説明しています。
XMethods.com には、リスト2の作成に際して私が使用した気温情報のサーバーなどを含む、公開使用されているSOAPサービスのリストが掲載されています。
W3CサイトのSOAP 1.1仕様ドラフトには、現在の技術に関する詳細が掲載されています。
Apache XML Projectには、W3Cへ提出されているSOAP標準のインプリメンテーションであるApache SOAP が含まれています。
Sunの、オープン・ソースのBrazil Webアプリケーション・フレームワークのページでは、SOAPメッセージングのサポートについて示されています。
IBM's SOAP security extensions のページには、SOAPの実装が示されています。
IBMのWeb Services fact sheet は、SOAPがWeb Servicesにどのように対応するかを簡潔に示しており、また、他の参考文献へのリンクもあります。