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
オブジェクトを取得できます。
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
コンストラクターと説明 |
---|
SOAPPart() |
修飾子と型 | メソッドと説明 |
---|---|
abstract void | addMimeHeader(StringSE name, StringSE value) 指定された名前と値で MimeHeader オブジェクトを作成し、それをこの SOAPPart オブジェクトに追加します。 |
abstract IteratorSE<MimeHeader> | getAllMimeHeaders() この SOAPPart オブジェクトのすべてのヘッダーを、MimeHeader オブジェクトのイテレーターとして取得します。 |
abstract SourceSE | getContent() SOAPEnvelope のコンテンツを JAXP Source オブジェクトとして返します。 |
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) 指定されたヘッダー名に一致する最初のヘッダーエントリを変更して、その値が指定された値になるようにします。既存のヘッダーが一致しない場合は、指定された名前と値で新しいヘッダーを追加します。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
adoptNodeSE, createAttributeSE, createAttributeNSSE, createCDATASectionSE, createCommentSE, createDocumentFragmentSE, createElementSE, createElementNSSE, createEntityReferenceSE, createProcessingInstructionSE, createTextNodeSE, getDoctypeSE, getDocumentElementSE, getDocumentURISE, getDomConfigSE, getElementByIdSE, getElementsByTagNameSE, getElementsByTagNameNSSE, getImplementationSE, getInputEncodingSE, getStrictErrorCheckingSE, getXmlEncodingSE, getXmlStandaloneSE, getXmlVersionSE, importNodeSE, normalizeDocumentSE, renameNodeSE, setDocumentURISE, setStrictErrorCheckingSE, setXmlStandaloneSE, setXmlVersionSE
detachNode, getParentElement, getValue, recycleNode, setParentElement, setValue
appendChildSE, cloneNodeSE, compareDocumentPositionSE, getAttributesSE, getBaseURISE, getChildNodesSE, getFeatureSE, getFirstChildSE, getLastChildSE, getLocalNameSE, getNamespaceURISE, getNextSiblingSE, getNodeNameSE, getNodeTypeSE, getNodeValueSE, getOwnerDocumentSE, getParentNodeSE, getPrefixSE, getPreviousSiblingSE, getTextContentSE, getUserDataSE, hasAttributesSE, hasChildNodesSE, insertBeforeSE, isDefaultNamespaceSE, isEqualNodeSE, isSameNodeSE, isSupportedSE, lookupNamespaceURISE, lookupPrefixSE, normalizeSE, removeChildSE, replaceChildSE, setNodeValueSE, setPrefixSE, setTextContentSE, setUserDataSE
public abstract SOAPEnvelope getEnvelope() throws SOAPException
SOAPPart
オブジェクトに関連付けられている SOAPEnvelope
オブジェクトを取得します。SOAP エンベロープが取得されると、その内容を取得するために使用できます。SOAPPart
オブジェクトの SOAPEnvelope
オブジェクト SOAPException
- SOAP エラーがある場合 public StringSE getContentId()
String
setContentId(java.lang.String)
public StringSE getContentLocation()
String
setContentLocation(java.lang.String)
public void setContentId(StringSE contentId)
String
に設定します。contentId
- MIME ヘッダー "Content-Id" の値を提供する String
IllegalArgumentExceptionSE
- コンテンツ ID の設定に問題がある場合 getContentId()
public void setContentLocation(StringSE contentLocation)
String
に設定します。contentLocation
- MIME ヘッダー "Content-Location" の値を指定する String
IllegalArgumentExceptionSE
- コンテンツの場所の設定に問題がある場合。getContentLocation()
public abstract void removeMimeHeader(StringSE header)
header
- 削除する MIME ヘッダーの名前を指定する String
public abstract void removeAllMimeHeaders()
SOAPEnvelope
オブジェクトのすべての MimeHeader
オブジェクトを削除します。public abstract StringSE[] getMimeHeader(StringSE name)
String
によって識別されるこの SOAPPart
オブジェクト内の MimeHeader
オブジェクトのすべての値を取得します。name
- ヘッダーの名前。例: 「コンテンツ型」String
配列 setMimeHeader(java.lang.String, java.lang.String)
public abstract void setMimeHeader(StringSE name, StringSE value)
RFC822 ヘッダーには、US-ASCII 文字のみを含めることができることに注意してください。
name
- 検索するヘッダー名を指定する String
value
- 設定する値を指定する String
。この値は、一致する最初のヘッダーの現在の値 (存在する場合) に置き換えられます。一致するものがない場合、この値は新しい MimeHeader
オブジェクトの値になります。IllegalArgumentExceptionSE
- 指定された mime ヘッダーの名前または値に問題があった場合 getMimeHeader(java.lang.String)
public abstract void addMimeHeader(StringSE name, StringSE value)
MimeHeader
オブジェクトを作成し、この SOAPPart
オブジェクトに追加します。指定された名前の MimeHeader
がすでに存在する場合、このメソッドは指定された値を既存の値に追加します。RFC822 ヘッダーには、US-ASCII 文字のみを含めることができることに注意してください。
name
- ヘッダー名を指定する String
value
- 設定または追加する値を指定する String
IllegalArgumentExceptionSE
- 指定された mime ヘッダーの名前または値に問題があった場合 public abstract IteratorSE<MimeHeader> getAllMimeHeaders()
SOAPPart
オブジェクトのすべてのヘッダーを、MimeHeader
オブジェクトのイテレーターとして取得します。SOAPPart
オブジェクトのすべての Mime ヘッダーを含む Iterator
オブジェクト public abstract IteratorSE<MimeHeader> getMatchingMimeHeaders(StringSE[] names)
MimeHeader
オブジェクトを取得します。names
- 返される MIME ヘッダーの名前を持つ String
配列 Iterator
オブジェクトとして返されます public abstract IteratorSE<MimeHeader> getNonMatchingMimeHeaders(StringSE[] names)
MimeHeader
オブジェクトを取得します。names
- 返されない MIME ヘッダーの名前を持つ String
配列 SOAPPart
オブジェクト内のすべての MIME ヘッダー。一致しない MIME ヘッダーは、Iterator
オブジェクトとして返されます。public abstract void setContent(SourceSE source) throws SOAPException
Source
オブジェクトからのデータで SOAPEnvelope
オブジェクトのコンテンツを設定します。この Source
には、有効な SOAP ドキュメントが含まれている必要があります。source
- データを設定する javax.xml.transform.Source
オブジェクト SOAPException
- ソースの設定に問題がある場合 getContent()
public abstract SourceSE getContent() throws SOAPException
Source
オブジェクトとして返します。javax.xml.transform.Source
オブジェクトとしてのコンテンツ SOAPException
- 実装が指定された Source
オブジェクトを変換できない場合 setContent(javax.xml.transform.Source)
Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.