public abstract class SOAPPart extends Object implements Document, Node
SOAPMessageオブジェクトのSOAP固有の部分のコンテナ。 すべてのメッセージはSOAP部を持つよう要求されているため、SOAPMessageオブジェクトが作成されると自動的にSOAPPartオブジェクトを持ちます。
SOAPPartオブジェクトはMIME部であり、Content-Id、Content-Location、およびContent-TypeのMIMEヘッダーを持ちます。 Content-Typeの値は"text/xml"である必要があるため、SOAPPartオブジェクトは自動的にContent-Typeの値が"text/xml"に設定されたMIMEヘッダーを持ちます。 メッセージのSOAP部のコンテンツはXML形式である必要があるため、値は"text/xml"である必要があります。 タイプ"text/xml"でないコンテンツは、SOAPPartオブジェクトの中ではなくAttachmentPartオブジェクトの中に入れる必要があります。
メッセージが送信される際、メッセージのSOAP部にはMIMEヘッダーのContent-Typeを"text/xml"に設定する必要があります。 または、別の視点では、受信する任意のメッセージのSOAP部は、MIMEヘッダーのContent-Typeを"text/xml"の値で持つ必要があります。
クライアントは、SOAPMessage.getSOAPPartメソッドを呼び出してSOAPMessageオブジェクトのSOAPPartオブジェクトにアクセスできます。 次のコードでは、messageがSOAPMessageオブジェクトで、メッセージのSOAP部を取得します。
SOAPPart soapPart = message.getSOAPPart();
SOAPPartオブジェクトはSOAPEnvelopeオブジェクトを含み、順にSOAPBodyオブジェクトおよびSOAPHeaderオブジェクトを含みます。 SOAPPartメソッドgetEnvelopeを使用すると、SOAPEnvelopeオブジェクトを取得できます。
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE| コンストラクタ | 説明 |
|---|---|
SOAPPart() |
| 修飾子と型 | メソッド | 説明 |
|---|---|---|
abstract void |
addMimeHeader(String name, String value) |
指定された名前および値を含む
MimeHeaderオブジェクトを作成し、それをこのSOAPPartオブジェクトに追加します。 |
abstract Iterator |
getAllMimeHeaders() |
この
SOAPPartオブジェクトのすべてのヘッダーをMimeHeaderオブジェクトのイテレータとして取得します。 |
abstract Source |
getContent() |
SOAPEnvelopeのコンテンツをJAXP
Sourceオブジェクトとして返します。 |
String |
getContentId() |
名前が"Content-Id"であるMIMEヘッダーの値を取得します。
|
String |
getContentLocation() |
名前が"Content-Location"であるMIMEヘッダーの値を取得します。
|
abstract SOAPEnvelope |
getEnvelope() |
この
SOAPPartオブジェクトに関連付けられたSOAPEnvelopeオブジェクトを取得します。 |
abstract Iterator |
getMatchingMimeHeaders(String[] names) |
指定した配列内の名前に一致するすべての
MimeHeaderオブジェクトを取得します。 |
abstract String[] |
getMimeHeader(String name) |
指定された
Stringで識別されるこのSOAPPartオブジェクト内のMimeHeaderオブジェクトの、すべての値を取得します。 |
abstract Iterator |
getNonMatchingMimeHeaders(String[] names) |
名前が指定した配列内の名前と一致しないすべての
MimeHeaderオブジェクトを取得します。 |
abstract void |
removeAllMimeHeaders() |
この
SOAPEnvelopeオブジェクトのMimeHeaderオブジェクトをすべて削除します。 |
abstract void |
removeMimeHeader(String header) |
指定した名前に一致するMIMEヘッダーをすべて削除します。
|
abstract void |
setContent(Source source) |
SOAPEnvelopeオブジェクトのコンテンツを、指定したSourceオブジェクトからのデータに設定します。 |
void |
setContentId(String contentId) |
名前が「Content-Id」であるMIMEヘッダーの値を、指定された
Stringに設定します。 |
void |
setContentLocation(String contentLocation) |
MIMEヘッダー「Content-Location」の値を、指定された
Stringに設定します。 |
abstract void |
setMimeHeader(String name, String value) |
指定したヘッダー名に一致する最初のヘッダー・エントリを変更してその値が指定した値になるようにし、既存のヘッダーで一致するものがない場合は指定した名前の新しいヘッダーを追加します。
|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitadoptNode, createAttribute, createAttributeNS, createCDATASection, createComment, createDocumentFragment, createElement, createElementNS, createEntityReference, createProcessingInstruction, createTextNode, getDoctype, getDocumentElement, getDocumentURI, getDomConfig, getElementById, getElementsByTagName, getElementsByTagNameNS, getImplementation, getInputEncoding, getStrictErrorChecking, getXmlEncoding, getXmlStandalone, getXmlVersion, importNode, normalizeDocument, renameNode, setDocumentURI, setStrictErrorChecking, setXmlStandalone, setXmlVersiondetachNode, getParentElement, getValue, recycleNode, setParentElement, setValueappendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserDatapublic abstract SOAPEnvelope getEnvelope() throws SOAPException
SOAPPartオブジェクトに関連付けられたSOAPEnvelopeオブジェクトを取得します。 SOAPエンベロープを取得したなら、それを使用してコンテンツを取得できます。 SOAPPartオブジェクトのSOAPEnvelopeオブジェクトSOAPException - SOAPエラーが存在する場合public String getContentId()
StringsetContentId(java.lang.String)public String getContentLocation()
StringsetContentLocation(java.lang.String)public void setContentId(String contentId)
Stringに設定します。contentId - MIMEヘッダー"Content-Id"の値を示すStringIllegalArgumentException - コンテンツIDの設定時に問題が発生した場合getContentId()public void setContentLocation(String contentLocation)
Stringに設定します。contentLocation - MIMEヘッダー"Content-Location"の値を示すStringIllegalArgumentException - コンテンツの場所の設定時に問題が発生した場合。getContentLocation()public abstract void removeMimeHeader(String header)
header - 削除するMIMEヘッダーの名前を示すStringpublic abstract void removeAllMimeHeaders()
SOAPEnvelopeオブジェクトのMimeHeaderオブジェクトをすべて削除します。public abstract String[] getMimeHeader(String name)
Stringで識別されるこのSOAPPartオブジェクト内のMimeHeaderオブジェクトの、すべての値を取得します。name - ヘッダーの名前。例: "Content-Type"String配列setMimeHeader(java.lang.String, java.lang.String)public abstract void setMimeHeader(String name, String value)
RFC822ヘッダーはUS-ASCII文字だけを含むことが可能である点に注意してください。
name - 検索するヘッダー名を指定するStringvalue - 設定される値を示すString。 この値は、一致するヘッダーがある場合には最初のヘッダーの現在の値と置き換えられる。 一致がない場合、この値は新しいMimeHeaderオブジェクトの値になる。 IllegalArgumentException - 指定したMIMEヘッダー名または値に問題があった場合getMimeHeader(java.lang.String)public abstract void addMimeHeader(String name, String value)
MimeHeaderオブジェクトを作成し、それをこのSOAPPartオブジェクトに追加します。 指定された名前を持つMimeHeaderがすでに存在する場合、このメソッドは指定した値を既存の値に追加します。
RFC822ヘッダーはUS-ASCII文字だけを含むことが可能である点に注意してください。
name - ヘッダー名を指定するStringvalue - 設定または追加される値を示すStringIllegalArgumentException - 指定したMIMEヘッダー名または値に問題があった場合public abstract Iterator getAllMimeHeaders()
SOAPPartオブジェクトのすべてのヘッダーをMimeHeaderオブジェクトのイテレータとして取得します。SOAPPartオブジェクトのMIMEヘッダーすべてを含むIteratorオブジェクトpublic abstract Iterator getMatchingMimeHeaders(String[] names)
MimeHeaderオブジェクトを取得します。names - 返されるMIMEヘッダーの名前を含むString配列Iteratorオブジェクトとして返すpublic abstract Iterator getNonMatchingMimeHeaders(String[] names)
MimeHeaderオブジェクトを取得します。names - 返されないMIMEヘッダーの名前を含むString配列SOAPPartオブジェクト内のすべてのMIMEヘッダー。 一致しないMIMEヘッダーは、Iteratorオブジェクトとして返される。 public abstract void setContent(Source source) throws SOAPException
SOAPEnvelopeオブジェクトのコンテンツを、指定したSourceオブジェクトからのデータに設定します。 このSourceには、有効なSOAPドキュメントが含まれている必要があります。 source - 設定するデータを含むjavax.xml.transform.SourceオブジェクトSOAPException - sourceの設定時に問題がある場合getContent()public abstract Source getContent() throws SOAPException
Sourceオブジェクトとして返します。javax.xml.transform.SourceオブジェクトとしてのコンテンツSOAPException - 実装が、指定したSourceオブジェクトを変換できない場合setContent(javax.xml.transform.Source) バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。