SOAPの仕掛けはどうなっている？：SOAPの仕掛け（1）（2/3 ページ）

SOAP V1.1に規定されていること

■SOAPメッセージの構造

　SOAPで規定しているのは、郵便でいうところの封筒の仕様である。封筒には、あて名を書きなさい、送り主を書きなさい、中身を入れなさい、といった具合である。SOAPメッセージは、次のような構造をしている（図1）。

図1　SOAPメッセージの構造

　実は、この中身に関してはまだあまり議論がされていないといっていいだろう。とりあえず封筒だけでもきちんと決めて、郵便が届くようにしよう、ということなのである。

　図1中のカッコ（　）内は、実際にSOAPメッセージがXML文書として作成されるときのタグ名であり、名前空間を使っている。当然ながら、SOAPの実装をするときには、XMLプロセッサは名前空間をサポートしている必要がある。

　Envelope要素の中には、HeaderとBodyの2つの要素のみが入れられる。Headerはオプションであり、必要に応じて入れる。Bodyは必ず1つだけ入れなければならない。

■宛先情報を付加するSOAPエンベロープ

　SOAPエンベロープは、SOAPメッセージの一番外側の要素となる。名前空間として「XML Schema for SOAP v 1.1 Envelope（http://schemas.xmlsoap.org/soap/envelope/）」を使う。次の属性を持っている。

　ちなみに、この属性はほかの要素に指定することもできる。その場合には、指定した要素とその子どもにそれがあてはめられることになる。

　ここに規定されていない（別の名前空間に規定されている）属性を指定することもできるが、その場合は名前空間の修飾を明示する必要がある。同様に、Envelope要素の下に、Header、およびBody以外の要素を置く場合にも、名前空間の修飾をする必要がある。

■メッセージングの機構を実現するSOAPヘッダ

　SOAPエンベロープの子どもとしてオプションで入れることのできる要素で、メッセージの受信者（処理する人）に対して、どう扱うべきか、ということを知らせるために使う。どう扱うべきか、というのは、次の属性によって表現することになる。

■XML文書で構成されるSOAPボディ

　封筒の中身に関しては、基本的に規定はない。自由にXML文書をこの中に含めることができる。ただし、SOAPメッセージの処理においてエラーが発生したときには、このBody要素の中にFaultという要素を入れてレスポンスを送り返すことが決められている。また、RPCとして使う場合には、あとに基本的な規定がされている。

■エラー記述のためのSOAP Fault

　SOAP Faultは、SOAPメッセージの取り扱い中に発生したエラーを記述するためのSOAPメッセージである。これは、メッセージを受け取った人が作るものとそうでないものとがある。SOAP Faultの構造は以下のようになる。

以上の内容を図示すると、次のようになる（図2、図3）。まず、うまく交換ができた場合には、図2のようになる。

図2　SOAPメッセージの交換に成功した場合

　失敗した場合には、図3のようになる。

図3　SOAPメッセージの交換に失敗した場合

■SOAP符号化

　SOAP符号化（SOAPエンコーディング）は、SOAPを使ってメソッドの引数や戻り値を搬送するために、さまざまな型のデータをXML文書に変換して元に戻すためのルールを規定している。しかし、実のところ、これらのルールは、XML Schemaに規定されている内容をそのまま採用しており、その名前空間を使うことになる。規定されているのは次の型である。

　詳細は仕様を読んでいただくことにするが、これらのルールに準拠することによりSOAP同士で正しく会話が成り立つはずである。

■HTTP-SOAP

　SOAPは、トランスポートに何を使うかを規定していない。つまり、何を使っても構わない。郵便の封筒を運ぶとき、郵便局の人が大きな袋に入れようが、箱に入れようが、車で運ぼうが、バイクで運ぼうが構わないということである（ただし、SOAPメッセージは同時に複数のものを送ることにはなっていない）。

　しかし、HTTPを使ってSOAPの交換を行う例に関しては、Noteの中で規定している。

　HTTPをトランスポートとして使う場合、HTTPSのように暗号化して使うことが一般的に考えられる。しかし、ファイアウォールやプロキシサーバにまったく情報が読めないと困ることから、目的のURIのみ、ヘッダ部分に書き込むことができることになっている。SOAPActionというヘッダにこれを指定することになる。これは、リクエストにのみ必要である。

　また、エラーが発生したときにはHTTPコードの500を返し、レスポンスとしてSOAP FaultをBodyに含んだSOAPメッセージを返すことが決められている。

■SOAPによるRPC

　SOAPでRPC（Remote Procedure Call）を行う場合の構造化の形式についていくつか規定していることがある。まず、RPCを行うために必要な情報は

である。そして、Bodyに入れるRPCのメソッドのデータをどうするかを決めている。

以上が、SOAPによって規定されている内容である。

　SOAPに規定されていることを理解する必要があるのは、SOAPのランタイムを実装する技術者だけだろう。SOAPを使ってRPCをやろうとするためには、そのランタイムの使い方を覚えればよい。ランタイムがメソッド・インターフェイスをSOAPに変換してサーバと通信をしてくれるからである。

　後半は、JavaプログラムによってSOAPを使うためのランタイムであるApache-SOAPを紹介し、簡単にその使い方を解説する。