©
本文档使用 PHP中文网手册 发布
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object javax.xml.soap.SOAPPart
public abstract class SOAPPart
SOAPMessage
对象中特定于 SOAP 部分的容器。所有消息都必须有一个 SOAP 部分,因此 SOAPMessage
对象在创建之后将自动获得一个 SOAPPart
对象。
SOAPPart
对象是一个 MIME 部分,并具有 MIME 头 Content-Id、Content-Location 和 Content-Type。因为 Content-Type 的值必须为 "text/xml",所以 SOAPPart
对象自动获得 Content-Type 的 MIME 头,且 Content-Type 值已设置为 "text/xml"。消息 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
对象。
字段摘要 |
---|
从接口 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 |
构造方法摘要 | |
---|---|
SOAPPart()
|
方法摘要 | |
---|---|
abstract void |
addMimeHeader(String name,
String value)
使用指定名称和值创建 MimeHeader 对象,并将其添加到此 SOAPPart 对象。 |
abstract Iterator |
getAllMimeHeaders()
以可在 MimeHeader 对象上进行迭代的迭代器形式,检索此 SOAPPart 对象的所有头。 |
abstract Source |
getContent()
以 JAXP Source 对象的形式返回 SOAPEnvelope 的内容。 |
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)
获取此 SOAPPart 对象中所有由给定 String 标识的 MimeHeader 对象的值。 |
abstract Iterator |
getNonMatchingMimeHeaders(String[] names)
检索名称与给定数组中任一名称不匹配的所有 MimeHeader 对象。 |
abstract void |
removeAllMimeHeaders()
移除此 SOAPEnvelope 对象的所有 MimeHeader 对象。 |
abstract void |
removeMimeHeader(String header)
移除所有与给定名称匹配的 MIME 头。 |
abstract void |
setContent(Source source)
使用取自给定 Source 对象的数据设置 SOAPEnvelope 对象的内容。 |
void |
setContentId(String contentId)
将名为 "Content-Id" 的 MIME 头的值设置为给定 String 。 |
void |
setContentLocation(String contentLocation)
将 MIME 头 "Content-Location" 的值设置为给定 String 。 |
abstract void |
setMimeHeader(String name,
String value)
将与给定头名称匹配的第一个头条目的值更改为给定值,如果现有头都不匹配,则添加一个带有给定名称和值的新头。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
从接口 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 |
从接口 javax.xml.soap.Node 继承的方法 |
---|
detachNode, getParentElement, getValue, recycleNode, setParentElement, setValue |
从接口 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 |
构造方法详细信息 |
---|
public SOAPPart()
方法详细信息 |
---|
public abstract SOAPEnvelope getEnvelope() throws SOAPException
SOAPPart
对象关联的 SOAPEnvelope
对象。获取 SOAP 信封后,可以用此方法来获取它的内容。
SOAPPart
对象的 SOAPEnvelope
对象
SOAPException
- 如果存在 SOAP 错误public String getContentId()
String
,给出名为 "Content-Id" 的 MIME 头的值setContentId(java.lang.String)
public String getContentLocation()
String
,给出名为 "Content-Location" 的 MIME 头的值setContentLocation(java.lang.String)
public void setContentId(String contentId)
String
。
contentId
- 一个 String
,给出 MIME 头 "Content-Id" 的值
IllegalArgumentException
- 如果在设置内容 id 时出现问题getContentId()
public void setContentLocation(String contentLocation)
String
。
contentLocation
- 一个 String
,给出 MIME 头 "Content-Location" 的值
IllegalArgumentException
- 如果在设置内容位置时出现问题。getContentLocation()
public abstract void removeMimeHeader(String header)
header
- 一个 String
,给出要移除的 MIME 头的名称public abstract void removeAllMimeHeaders()
SOAPEnvelope
对象的所有 MimeHeader
对象。
public abstract String[] getMimeHeader(String name)
SOAPPart
对象中所有由给定 String
标识的 MimeHeader
对象的值。
name
- 头的名称;示例:"Content-Type"
String
数组,给出所有指定头的值setMimeHeader(java.lang.String, java.lang.String)
public abstract void setMimeHeader(String name, String value)
注意,RFC822 头只能包含 US-ASCII 字符。
name
- 一个 String
,给出要搜索的头的名称value
- 一个 String
,给出要设置的值。此值将替换第一个匹配头(如果有)的当前值。如果没有匹配的头,则此值将是新 MimeHeader
对象的值。
IllegalArgumentException
- 如果指定的 mime 头名称或值存在问题getMimeHeader(java.lang.String)
public abstract void addMimeHeader(String name, String value)
MimeHeader
对象,并将其添加到此 SOAPPart
对象。如果已经存在带有指定名称的 MimeHeader
,则此方法将指定值添加到已经存在的值中。
注意,RFC822 头只能包含 US-ASCII 字符。
name
- 一个 String
,给出头名称value
- 一个 String
,给出要设置或要添加的值
IllegalArgumentException
- 如果指定的 mime 头名称或值存在问题public abstract Iterator getAllMimeHeaders()
MimeHeader
对象上进行迭代的迭代器形式,检索此 SOAPPart
对象的所有头。
Iterator
对象,具有此 SOAPPart
对象的所有 Mime 头public abstract Iterator getMatchingMimeHeaders(String[] names)
MimeHeader
对象。
names
- 一个 String
数组,带有要返回的 Mime 头的名称
Iterator
对象形式返回的与给定数组中任一名称匹配的所有 MIME 头public abstract Iterator getNonMatchingMimeHeaders(String[] names)
MimeHeader
对象。
names
- 一个 String
数组,带有不要返回的 Mime 头的名称
SOAPPart
对象中与给定数组中任一名称匹配的 MIME 头之外的所有 MIME 头。以 Iterator
对象的形式返回不匹配的 MIME 头。public abstract void setContent(Source source) throws SOAPException
Source
对象的数据设置 SOAPEnvelope
对象的内容。此 Source
必须包含一个有效的 SOAP 文档。
source
- javax.xml.transform.Source
对象,带有要发送的数据
SOAPException
- 如果在设置源时出现错误。getContent()
public abstract Source getContent() throws SOAPException
Source
对象的形式返回 SOAPEnvelope 的内容。
javax.xml.transform.Source
对象形式的内容
SOAPException
- 如果实现无法转换指定的 Source
对象setContent(javax.xml.transform.Source)
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。