クラス SOAPPart
- java.lang.ObjectSE
-
- jakarta.xml.soap.SOAPPart
- 実装されたすべてのインターフェース:
Node
、DocumentSE
、NodeSE
public abstract class SOAPPart extends ObjectSE implements DocumentSE, Node
SOAPMessage
オブジェクトの SOAP 固有の部分のコンテナー。すべてのメッセージには SOAP 部分が必要であるため、SOAPMessage
オブジェクトが作成されると、自動的にSOAPPart
オブジェクトが含まれます。SOAPPart
オブジェクトは MIME パーツであり、MIME ヘッダー Content-Id、Content-Location、Content-Type を持っています。Content-Type の値は "text/xml" でなければならないため、SOAPPart
オブジェクトには、値が "text/xml" に設定された Content-Type の MIME ヘッダーが自動的に含まれます。メッセージの SOAP 部分のコンテンツは XML 形式である必要があるため、値は "text/xml" である必要があります。"text/xml" 型ではないコンテンツは、SOAPPart
オブジェクトではなくAttachmentPart
オブジェクトに存在する必要があります。メッセージが送信されるとき、その SOAP 部分には、MIME ヘッダーの Content-Type が "text/xml" に設定されている必要があります。または、別の観点から見ると、受信するメッセージの SOAP 部分には、"text/xml" の値を持つ MIME ヘッダー Content-Type が必要です。
クライアントは、メソッド
SOAPMessage.getSOAPPart
を呼び出すことにより、SOAPMessage
オブジェクトのSOAPPart
オブジェクトにアクセスできます。message
がSOAPMessage
オブジェクトである次のコード行は、メッセージの SOAP 部分を取得します。SOAPPart soapPart = message.getSOAPPart();
SOAPPart
オブジェクトにはSOAPEnvelope
オブジェクトが含まれ、SOAPEnvelope
オブジェクトにはSOAPBody
オブジェクトとSOAPHeader
オブジェクトが含まれます。SOAPPart
メソッドgetEnvelope
を使用して、SOAPEnvelope
オブジェクトを取得できます。- 導入:
- 1.6
フィールドサマリー
インターフェース org.w3c.dom.NodeSE から継承されたフィールド
ATTRIBUTE_NODESE, CDATA_SECTION_NODESE, COMMENT_NODESE, DOCUMENT_FRAGMENT_NODESE, DOCUMENT_NODESE, DOCUMENT_POSITION_CONTAINED_BYSE, DOCUMENT_POSITION_CONTAINSSE, DOCUMENT_POSITION_DISCONNECTEDSE, DOCUMENT_POSITION_FOLLOWINGSE, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFICSE, DOCUMENT_POSITION_PRECEDINGSE, DOCUMENT_TYPE_NODESE, ELEMENT_NODESE, ENTITY_NODESE, ENTITY_REFERENCE_NODESE, NOTATION_NODESE, PROCESSING_INSTRUCTION_NODESE, TEXT_NODESE
コンストラクターのサマリー
コンストラクター 修飾子 コンストラクター 説明 protected
SOAPPart()
デフォルトコンストラクター。
メソッドのサマリー
すべてのメソッド インスタンスメソッド 抽象メソッド 具象メソッド 修飾子と型 メソッド 説明 abstract void
addMimeHeader(StringSE name, StringSE value)
指定された名前と値でMimeHeader
オブジェクトを作成し、それをこのSOAPPart
オブジェクトに追加します。abstract IteratorSE<MimeHeader>
getAllMimeHeaders()
このSOAPPart
オブジェクトのすべてのヘッダーを、MimeHeader
オブジェクトのイテレーターとして取得します。abstract SourceSE
getContent()
SOAPEnvelope のコンテンツを JAXPSource
オブジェクトとして返します。StringSE
getContentId()
名前が "Content-Id" である MIME ヘッダーの値を取得します。StringSE
getContentLocation()
名前が "Content-Location" である MIME ヘッダーの値を取得します。abstract SOAPEnvelope
getEnvelope()
このSOAPPart
オブジェクトに関連付けられているSOAPEnvelope
オブジェクトを取得します。abstract IteratorSE<MimeHeader>
getMatchingMimeHeaders(StringSE[] names)
指定された配列の名前に一致するすべてのMimeHeader
オブジェクトを取得します。abstract StringSE[]
getMimeHeader(StringSE name)
指定されたString
によって識別されるこのSOAPPart
オブジェクト内のMimeHeader
オブジェクトのすべての値を取得します。abstract IteratorSE<MimeHeader>
getNonMatchingMimeHeaders(StringSE[] names)
指定された配列の名前と名前が一致しないすべてのMimeHeader
オブジェクトを取得します。abstract void
removeAllMimeHeaders()
このSOAPEnvelope
オブジェクトのすべてのMimeHeader
オブジェクトを削除します。abstract void
removeMimeHeader(StringSE header)
指定された名前に一致するすべての MIME ヘッダーを削除します。abstract void
setContent(SourceSE source)
指定されたSource
オブジェクトからのデータを使用してSOAPEnvelope
オブジェクトのコンテンツを設定します。void
setContentId(StringSE contentId)
"Content-Id" という名前の MIME ヘッダーの値を指定されたString
に設定します。void
setContentLocation(StringSE contentLocation)
MIME ヘッダー "Content-Location" の値を指定されたString
に設定します。abstract void
setMimeHeader(StringSE name, StringSE value)
指定されたヘッダー名に一致する最初のヘッダーエントリを変更して、その値が指定された値になるようにします。既存のヘッダーが一致しない場合は、指定された名前と値で新しいヘッダーを追加します。クラス java.lang.ObjectSE から継承されたメソッド
clone, equalsSE, finalize, getClass, hashCode, notify, notifyAll, toString, wait, waitSE, waitSE
インターフェース org.w3c.dom.DocumentSE から継承されたメソッド
adoptNodeSE, createAttributeSE, createAttributeNSSE, createCDATASectionSE, createCommentSE, createDocumentFragment, createElementSE, createElementNSSE, createEntityReferenceSE, createProcessingInstructionSE, createTextNodeSE, getDoctype, getDocumentElement, getDocumentURI, getDomConfig, getElementByIdSE, getElementsByTagNameSE, getElementsByTagNameNSSE, getImplementation, getInputEncoding, getStrictErrorChecking, getXmlEncoding, getXmlStandalone, getXmlVersion, importNodeSE, normalizeDocument, renameNodeSE, setDocumentURISE, setStrictErrorCheckingSE, setXmlStandaloneSE, setXmlVersionSE
インターフェース jakarta.xml.soap.Node から継承されたメソッド
detachNode, getParentElement, getValue, recycleNode, setParentElement, setValue
インターフェース org.w3c.dom.NodeSE から継承されたメソッド
appendChildSE, cloneNodeSE, compareDocumentPositionSE, getAttributes, getBaseURI, getChildNodes, getFeatureSE, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserDataSE, hasAttributes, hasChildNodes, insertBeforeSE, isDefaultNamespaceSE, isEqualNodeSE, isSameNodeSE, isSupportedSE, lookupNamespaceURISE, lookupPrefixSE, normalize, removeChildSE, replaceChildSE, setNodeValueSE, setPrefixSE, setTextContentSE, setUserDataSE
メソッドの詳細
getEnvelope
public abstract SOAPEnvelope getEnvelope() throws SOAPException
このSOAPPart
オブジェクトに関連付けられているSOAPEnvelope
オブジェクトを取得します。SOAP エンベロープが取得されると、その内容を取得するために使用できます。- 戻り値:
- この
SOAPPart
オブジェクトのSOAPEnvelope
オブジェクト - 例外:
SOAPException
- SOAP エラーがある場合
getContentId
public StringSE getContentId()
名前が "Content-Id" である MIME ヘッダーの値を取得します。- 戻り値:
- "Content-Id" という名前の MIME ヘッダーの値を提供する
String
- 関連事項:
setContentId(java.lang.String)
getContentLocation
public StringSE getContentLocation()
名前が "Content-Location" である MIME ヘッダーの値を取得します。- 戻り値:
- 名前が "Content-Location" である MIME ヘッダーの値を与える
String
- 関連事項:
setContentLocation(java.lang.String)
setContentId
public void setContentId(StringSE contentId)
"Content-Id" という名前の MIME ヘッダーの値を指定されたString
に設定します。- パラメーター:
contentId
- MIME ヘッダー "Content-Id" の値を提供するString
- 例外:
IllegalArgumentExceptionSE
- コンテンツ ID の設定に問題がある場合- 関連事項:
getContentId()
setContentLocation
public void setContentLocation(StringSE contentLocation)
MIME ヘッダー "Content-Location" の値を指定されたString
に設定します。- パラメーター:
contentLocation
- MIME ヘッダー "Content-Location" の値を指定するString
- 例外:
IllegalArgumentExceptionSE
- コンテンツの場所の設定に問題がある場合。- 関連事項:
getContentLocation()
removeMimeHeader
public abstract void removeMimeHeader(StringSE header)
指定された名前に一致するすべての MIME ヘッダーを削除します。- パラメーター:
header
- 削除する MIME ヘッダーの名前を指定するString
removeAllMimeHeaders
public abstract void removeAllMimeHeaders()
このSOAPEnvelope
オブジェクトのすべてのMimeHeader
オブジェクトを削除します。
getMimeHeader
public abstract StringSE[] getMimeHeader(StringSE name)
指定されたString
によって識別されるこのSOAPPart
オブジェクト内のMimeHeader
オブジェクトのすべての値を取得します。- パラメーター:
name
- ヘッダーの名前。例: 「コンテンツ型」- 戻り値:
- 指定されたヘッダーのすべての値を示す
String
配列 - 関連事項:
setMimeHeader(java.lang.String, java.lang.String)
setMimeHeader
public abstract void setMimeHeader(StringSE name, StringSE value)
指定されたヘッダー名に一致する最初のヘッダーエントリを変更して、その値が指定された値になるようにします。既存のヘッダーが一致しない場合は、指定された名前と値で新しいヘッダーを追加します。一致する場合、このメソッドは一致する最初のヘッダーの既存の値をすべてクリアし、代わりに指定された値を設定します。複数のヘッダーに指定された名前がある場合、このメソッドは最初のヘッダーの後に一致するすべてのヘッダーを削除します。RFC822 ヘッダーには、US-ASCII 文字のみを含めることができることに注意してください。
- パラメーター:
name
- 検索するヘッダー名を指定するString
value
- 設定する値を指定するString
。この値は、一致する最初のヘッダーの現在の値 (存在する場合) に置き換えられます。一致するものがない場合、この値は新しいMimeHeader
オブジェクトの値になります。- 例外:
IllegalArgumentExceptionSE
- 指定された mime ヘッダーの名前または値に問題があった場合- 関連事項:
getMimeHeader(java.lang.String)
addMimeHeader
public abstract void addMimeHeader(StringSE name, StringSE value)
指定された名前と値でMimeHeader
オブジェクトを作成し、このSOAPPart
オブジェクトに追加します。指定された名前のMimeHeader
がすでに存在する場合、このメソッドは指定された値を既存の値に追加します。RFC822 ヘッダーには、US-ASCII 文字のみを含めることができることに注意してください。
- パラメーター:
name
- ヘッダー名を指定するString
value
- 設定または追加する値を指定するString
- 例外:
IllegalArgumentExceptionSE
- 指定された mime ヘッダーの名前または値に問題があった場合
getAllMimeHeaders
public abstract IteratorSE<MimeHeader> getAllMimeHeaders()
このSOAPPart
オブジェクトのすべてのヘッダーを、MimeHeader
オブジェクトのイテレーターとして取得します。- 戻り値:
- この
SOAPPart
オブジェクトのすべての Mime ヘッダーを含むIterator
オブジェクト
getMatchingMimeHeaders
public abstract IteratorSE<MimeHeader> getMatchingMimeHeaders(StringSE[] names)
指定された配列の名前に一致するすべてのMimeHeader
オブジェクトを取得します。- パラメーター:
names
- 返される MIME ヘッダーの名前を持つString
配列- 戻り値:
- 指定された配列内の名前のいずれかに一致するすべての MIME ヘッダー。
Iterator
オブジェクトとして返されます
getNonMatchingMimeHeaders
public abstract IteratorSE<MimeHeader> getNonMatchingMimeHeaders(StringSE[] names)
指定された配列の名前と名前が一致しないすべてのMimeHeader
オブジェクトを取得します。- パラメーター:
names
- 返されない MIME ヘッダーの名前を持つString
配列- 戻り値:
- 指定された配列内の名前のいずれかに一致するものを除く、この
SOAPPart
オブジェクト内のすべての MIME ヘッダー。一致しない MIME ヘッダーは、Iterator
オブジェクトとして返されます。
setContent
public abstract void setContent(SourceSE source) throws SOAPException
指定されたSource
オブジェクトからのデータでSOAPEnvelope
オブジェクトのコンテンツを設定します。このSource
には、有効な SOAP ドキュメントが含まれている必要があります。- パラメーター:
source
- データを設定するjavax.xml.transform.Source
オブジェクト- 例外:
SOAPException
- ソースの設定に問題がある場合- 関連事項:
getContent()
getContent
public abstract SourceSE getContent() throws SOAPException
SOAPEnvelope のコンテンツを JAXPSource
オブジェクトとして返します。- 戻り値:
javax.xml.transform.Source
オブジェクトとしてのコンテンツ- 例外:
SOAPException
- 実装が指定されたSource
オブジェクトを変換できない場合- 関連事項:
setContent(javax.xml.transform.Source)