パッケージ javax.xml.soap

SOAPメッセージを作成および構築するためのAPIを提供します。

参照: 説明

インタフェースのサマリー

インタフェース	説明
Detail	DetailEntryオブジェクトのコンテナです。
DetailEntry	SOAPFaultオブジェクトの詳細を提供するDetailオブジェクトのコンテンツです。
Name	XML名の表現です。
Node	XMLドキュメント内のノード(要素)の表現です。
SOAPBody	SOAPメッセージ内のSOAP本体要素のコンテンツを表すオブジェクトです。
SOAPBodyElement	SOAPBodyオブジェクトのコンテンツを表すSOAPBodyElementオブジェクトです。
SOAPConstants	SOAPプロトコルに関連した定数の定義です。
SOAPElement	SOAPメッセージの要素を示すオブジェクトです。SOAPの仕様で許可されていますが、明確に規定されているわけではありません。
SOAPEnvelope	SOAPPartオブジェクトのSOAPHeaderとSOAPBody部分のコンテナです。
SOAPFault	エラー情報またはステータス情報、あるいはその両方を格納するSOAPBodyオブジェクト内の要素です。
SOAPFaultElement	SOAPFaultオブジェクト内のコンテンツの表現です。
SOAPHeader	SOAPヘッダー要素の表現です。
SOAPHeaderElement	SOAPエンベロープのSOAPヘッダー部のコンテンツを表現するオブジェクトです。
Text	値がテキストであるノードの表現です。

クラスのサマリー

クラス	説明
AttachmentPart	SOAPMessageオブジェクトへの個々の添付です。
MessageFactory	SOAPMessageオブジェクトを作成するためのファクトリです。
MimeHeader	MIMEヘッダー名とその値を保存するオブジェクトです。
MimeHeaders	MimeHeaderオブジェクトのコンテナで、メッセージのMIME部分にあるMIMEヘッダーを表します。
SAAJMetaFactory	SAAJ APIで定義されたファクトリの実装クラスのアクセス・ポイントです。
SAAJResult	SAAJツリー形式で、JAXP変換、またはJAXB整列化の結果のホルダーとして動作します。
SOAPConnection	クライアントがリモート側に直接メッセージを送信するのに使用するポイントツーポイント接続です(URLなどで表示)。
SOAPConnectionFactory	SOAPConnectionオブジェクトを作成するためのファクトリです。
SOAPElementFactory	非推奨 - SOAPElementの作成にはjavax.xml.soap.SOAPFactoryを使用してください。
SOAPFactory	SOAPFactoryは、SOAP XMLツリーに存在するさまざまなオブジェクトを作成するためのファクトリです。
SOAPMessage	すべてのSOAPメッセージのルート・クラスです。
SOAPPart	SOAPMessageオブジェクトのSOAP固有の部分のコンテナです。

例外のサマリー

例外	説明
SOAPException	SOAP例外が発生したことを通知する例外です。

パッケージjavax.xml.soapの説明

SOAPメッセージを作成および構築するためのAPIを提供します。このパッケージは、SOAP with Attachments API for Java^TM (SAAJ) 1.3の仕様で定義されています。

javax.xml.soapパッケージのAPIを使用すると、次の内容を実行できます。

• 指定の端点へのポイントツーポイント接続の作成
• SOAPメッセージの作成
• XMLフラグメントの作成
• SOAPメッセージのヘッダーにコンテンツを追加
• SOAPメッセージの本文にコンテンツを追加
• 添付部分の作成とその添付へのコンテンツの追加
• SOAPメッセージ部分のアクセス、追加、修正
• SOAPエラー情報の作成、追加、修正
• SOAPメッセージからのコンテンツ抽出
• SOAP要求応答メッセージの送信

さらに、javax.xml.soapパッケージのAPIにより、org.w3c.domパッケージのそれらに対応する部分も拡張されます。これは、SOAPMessageのSOAPPartもDOM Level 2 Documentであり、DOM (詳細はhttp://www.w3.org/DOM/を参照)を使用するアプリケーションやツール、ライブラリなどで操作できることを意味します。DOM APIを使用して通常のDOMノードをSAAJツリーに追加できますが、SAAJ APIはツリーの検査時または操作時に、SAAJタイプを返す必要があります。この処理を実行できるように、SAAJ API (特にSOAPElement.getChildElements())では、通知することなくSAAJ要件に関連する不正な型のオブジェクトを、要求されている型の同等のオブジェクトに置き換えることができます。この置換処理により、ツリーの論理構造が変わることはありません。そのため、DOM APIから見ても、ツリーに変更はありません。ただし、物理的なツリー構造は変更されるため、置き換えられたノードを参照する場合、すでにツリーの一部ではなくなったノードを参照することになります。以降、必要がなければ、SAAJP APIはSAAJ APIへの将来の呼出しによって、置き換えられたオブジェクトを通知なく置き換えることはできません。

つまり、実質的に、DOM APIからの操作のあとツリー上のSAAJ APIを使用して開始するアプリケーションは、ツリーがすでにSAAJツリーに変換されており、DOM APIを使用して取得したツリー内のオブジェクトへの参照は無効であると見なします。参照が無効になるだけでなく、どちらもSAAJ APIを排他的に使用できないため、SAAJ APIからDOM APIへの切替えは実行できません。特定のSAAJツリーでDOM APIからSAAJ APIの使用に切り替えるだけで、参照が無効になる危険が伴います。