javax.xml.soap

Class SOAPPart

java.lang.Object

javax.xml.soap.SOAPPart

All Implemented Interfaces:

Document， Node

public abstract class SOAPPart
extends Object
implements Document, Node

对一个对象的特定部分 SOAPMessage肥皂容器。所有的信息都需要有一个肥皂的一部分，所以当一个 SOAPMessage对象被创建，它会自动有一个 SOAPPart对象。

一个SOAPPart对象是一个MIME部分具有MIME标头的内容ID、内容定位、内容类型。因为内容类型的值必须是“text/xml”，一SOAPPart对象自动有一个MIME标头的内容类型，其值设置为“text/xml”。值必须是“文本/ XML”，因为消息的SOAP部分的内容必须是XML格式的。内容类型不是“text/xml”必须在一个AttachmentPart对象而不是在SOAPPart对象。

当一个消息发送，其皂部分必须有MIME标头的内容类型设置为“text/xml”。或者，从另一个角度，即收到任何消息的SOAP部分必须具有MIME标头的内容类型和值“text/xml”。

客户端可以通过调用该方法SOAPMessage.getSOAPPart访问一个对象的SOAPPart SOAPMessage对象。下面这行代码，其中message是SOAPMessage对象，检索消息的SOAP的一部分。

soappart soappart =消息。getsoappart()；

一个SOAPPart对象包含一个SOAPEnvelope对象，其中又包含一个SOAPBody对象和一个SOAPHeader对象。SOAPPart getEnvelope的方法可用于检索SOAPEnvelope对象。

Field Summary

Fields inherited from interface org.w3c.dom.Node

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

构造方法摘要

构造方法

Constructor and Description
SOAPPart()

方法摘要

Modifier and Type	Method and Description
abstract void	addMimeHeader(String name, String value) 创建一个具有指定名称和值 MimeHeader对象并将其添加到这个 SOAPPart对象。
abstract Iterator	getAllMimeHeaders() 检索所有这 SOAPPart对象的标题在 MimeHeader对象迭代器。
abstract Source	getContent() 作为一个使用 Source对象返回的soapenvelope内容。
String	getContentId() 检索MIME标头的名称是“内容身份的价值”。
String	getContentLocation() 检索值的MIME标头的名称是“内容的位置”。
abstract SOAPEnvelope	getEnvelope() 获取与该 SOAPPart对象相关的 SOAPEnvelope对象。
abstract Iterator	getMatchingMimeHeaders(String[] names) 检索匹配的名字在给定的数组对象的所有 MimeHeader。
abstract String[]	getMimeHeader(String name) 得到这 SOAPPart对象是由给定的 String确定 MimeHeader对象的所有值。
abstract Iterator	getNonMatchingMimeHeaders(String[] names) 检索所有 MimeHeader对象的名字不在给定的数组名字匹配。
abstract void	removeAllMimeHeaders() 删除所有的 MimeHeader对象这 SOAPEnvelope对象。
abstract void	removeMimeHeader(String header) 移除给定的名称匹配所有MIME标头。
abstract void	setContent(Source source) 套与给定的 Source对象数据的 SOAPEnvelope对象的内容。
void	setContentId(String contentId) 设置MIME头命名为“内容身份”给定的 String价值。
void	setContentLocation(String contentLocation) 设置MIME标头”内容定位”给定的 String价值。
abstract void	setMimeHeader(String name, String value) 改变与给定的头名称相匹配的第一头文件，以便它的值是给定的值，如果没有现有的头是一个匹配的给定的名称和值，添加一个新的头。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.w3c.dom.Document

adoptNode, 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, setXmlVersion

Methods inherited from interface javax.xml.soap.Node

detachNode, getParentElement, getValue, recycleNode, setParentElement, setValue

Methods inherited from interface org.w3c.dom.Node

appendChild, 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, setUserData

Constructor Detail

SOAPPart

public SOAPPart()

方法详细信息

getEnvelope

public abstract SOAPEnvelope getEnvelope()
                                  throws SOAPException

获取与该 SOAPPart对象相关的 SOAPEnvelope对象。一旦得到肥皂信封，它可以被用来获取它的内容。

结果

这 SOAPPart对象的 SOAPEnvelope对象

异常

SOAPException -如果有一个SOAP错误

getContentId

public String getContentId()

检索MIME标头的名称是“内容身份的价值”。

结果

一个 String对MIME头命名为“内容身份的价值”

另请参见：

setContentId(java.lang.String)

getContentLocation

public String getContentLocation()

检索值的MIME标头的名称是“内容的位置”。

结果

一个 String赋予价值的MIME标头的名称是“内容的位置”

另请参见：

setContentLocation(java.lang.String)

setContentId

public void setContentId(String contentId)

设置MIME头命名为“内容身份”给定的 String价值。

参数

contentId - String对MIME标头”内容的ID的值”

异常

IllegalArgumentException -如果在内容设置ID的问题

另请参见：

getContentId()

setContentLocation

public void setContentLocation(String contentLocation)

设置MIME标头”内容定位”给定的 String价值。

参数

contentLocation - String赋予价值的MIME标头“内容的位置”

异常

IllegalArgumentException -如果在设置内容定位问题。

另请参见：

getContentLocation()

removeMimeHeader

public abstract void removeMimeHeader(String header)

移除给定的名称匹配所有MIME标头。

参数

header - String给出MIME标头的名称（S）被移除

removeAllMimeHeaders

public abstract void removeAllMimeHeaders()

删除所有的 MimeHeader对象这 SOAPEnvelope对象。

getMimeHeader

public abstract String[] getMimeHeader(String name)

得到这 SOAPPart对象是由给定的 String确定 MimeHeader对象的所有值。

参数

name -标头的名称；例如：“内容类型”

结果

一个 String阵列给所有指定的标头的值

另请参见：

setMimeHeader(java.lang.String, java.lang.String)

setMimeHeader

public abstract void setMimeHeader(String name,
                                   String value)

改变与给定的头名称相匹配的第一头文件，以便它的值是给定的值，如果没有现有的头是一个匹配的给定的名称和值，添加一个新的头。如果有一个匹配，这种方法清除了第一个匹配和设置给定值的所有现有的值，而不是。如果一个以上的头有给定的名称，这个方法将删除第一个后的所有匹配的头。

注意RFC822头只能包含US-ASCII字符。

参数

name - String给这头名称搜索

value - String给定值。此值将被替换为第一头的当前值（S），这是一个匹配的，如果有一个。如果没有匹配的值，这将是一个新 MimeHeader对象的值。

异常

IllegalArgumentException -如果有指定的MIME标头名称或值的问题

另请参见：

getMimeHeader(java.lang.String)

addMimeHeader

public abstract void addMimeHeader(String name,
                                   String value)

创建一个具有指定名称和值 MimeHeader对象并将其添加到这个 SOAPPart对象。如果指定的名称已经存在 MimeHeader，这种方法已经存在的价值添加指定的值（S）。

注意RFC822头只能包含US-ASCII字符。

参数

name - String给标题名称

value - String给被设置或附加价值

异常

IllegalArgumentException -如果有指定的MIME标头名称或值的问题

getAllMimeHeaders

public abstract Iterator getAllMimeHeaders()

检索所有这 SOAPPart对象的标题在 MimeHeader对象迭代器。

结果

一个 Iterator对象所有的MIME标头这 SOAPPart对象

getMatchingMimeHeaders

public abstract Iterator getMatchingMimeHeaders(String[] names)

检索匹配的名字在给定的数组对象的所有 MimeHeader。

参数

names -一个叫 String阵列（S）的MIME标头被退回

结果

所有的MIME标头的名称匹配一个给定的数组，作为一个 Iterator对象返回

getNonMatchingMimeHeaders

public abstract Iterator getNonMatchingMimeHeaders(String[] names)

检索所有 MimeHeader对象的名字不在给定的数组名字匹配。

参数

names -一个叫 String阵列（S）的MIME头不回

结果

除了那些匹配一个在给定数组的名字都在这 SOAPPart对象的MIME标头。这种不匹配的MIME标头是 Iterator对象返回。

setContent

public abstract void setContent(Source source)
                         throws SOAPException

套与给定的 Source对象数据的 SOAPEnvelope对象的内容。这 Source必须包含一个有效的SOAP文档。

参数

source - javax.xml.transform.Source对象将数据集

异常

SOAPException -如果在设置源问题

另请参见：

getContent()

getContent

public abstract Source getContent()
                           throws SOAPException

作为一个使用 Source对象返回的soapenvelope内容。

结果

内容为 javax.xml.transform.Source对象

异常

SOAPException -如果实现无法转换指定的 Source对象

另请参见：

setContent(javax.xml.transform.Source)