public interface SOAPElement extends Node, Element
返回SAAJ特定对象所需的此接口中的方法可以根据需要“静默地”替换树中的节点,以成功返回正确类型的对象。 参见getChildElements()
和javax.xml.soap for details.
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
Modifier and Type | Method and Description |
---|---|
SOAPElement |
addAttribute(Name name, String value)
将具有指定名称和值的属性添加到此
SOAPElement 对象。
|
SOAPElement |
addAttribute(QName qname, String value)
将具有指定名称和值的属性添加到此
SOAPElement 对象。
|
SOAPElement |
addChildElement(Name name)
创建一个新的
SOAPElement 对象,使用给定的
Name 对象初始化,并将新元素添加到此
SOAPElement 对象。
|
SOAPElement |
addChildElement(QName qname)
创建一个新的
SOAPElement 对象,使用给定的
QName 对象初始化,并将新元素添加到此
SOAPElement 对象。
|
SOAPElement |
addChildElement(SOAPElement element)
添加一个
SOAPElement 作为这个
SOAPElement 实例的孩子。
|
SOAPElement |
addChildElement(String localName)
创建一个新的
SOAPElement 对象,使用指定的本地名称初始化,并将新元素添加到此
SOAPElement 对象。
|
SOAPElement |
addChildElement(String localName, String prefix)
创建一个新的
SOAPElement 对象,使用指定的本地名称和前缀进行初始化,并将新元素添加到此
SOAPElement 对象。
|
SOAPElement |
addChildElement(String localName, String prefix, String uri)
创建一个新的
SOAPElement 对象,该对象使用指定的本地名称,前缀和URI
SOAPElement ,并将新元素添加到此
SOAPElement 对象。
|
SOAPElement |
addNamespaceDeclaration(String prefix, String uri)
向此
SOAPElement 对象添加具有指定前缀和URI的
SOAPElement 。
|
SOAPElement |
addTextNode(String text)
创建一个新的
Text 对象,使用给定的
String 并将其添加到此
SOAPElement 对象。
|
QName |
createQName(String localName, String prefix)
创建
QName ,其命名空间URI是与参数,相关联的一个
prefix ,在此的上下文中
SOAPElement 。
|
Iterator |
getAllAttributes()
返回一个
Iterator 在所有的属性
Name 对象在此
SOAPElement 对象。
|
Iterator |
getAllAttributesAsQNames()
返回此
Iterator 所有属性的
SOAPElement 作为
QName 对象。
|
String |
getAttributeValue(Name name)
返回具有指定名称的属性值。
|
String |
getAttributeValue(QName qname)
返回具有指定qname的属性值。
|
Iterator |
getChildElements()
返回一个 Iterator 了所有直接子Node s此元素。
|
Iterator |
getChildElements(Name name)
返回一个 Iterator 了所有直接子Node s的指定名称的此元素。
|
Iterator |
getChildElements(QName qname)
使用指定的 Iterator 返回该Iterator 的所有直接子级Node 的Iterator。
|
Name |
getElementName()
返回此
SOAPElement 对象的名称。
|
QName |
getElementQName()
返回此
SOAPElement 对象的qname。
|
String |
getEncodingStyle()
返回此
SOAPElement 对象的编码样式。
|
Iterator |
getNamespacePrefixes()
返回一个
Iterator 在命名空间前缀
String 此元素声明秒。
|
String |
getNamespaceURI(String prefix)
返回具有给定前缀的命名空间的URI。
|
Iterator |
getVisibleNamespacePrefixes()
返回此
Iterator 空间前缀
String 对该元素可见的Iterator。
|
boolean |
removeAttribute(Name name)
删除具有指定名称的属性。
|
boolean |
removeAttribute(QName qname)
使用指定的qname删除属性。
|
void |
removeContents()
分离这个
SOAPElement 所有孩子。
|
boolean |
removeNamespaceDeclaration(String prefix)
删除与给定前缀相对应的命名空间声明。
|
SOAPElement |
setElementQName(QName newName)
如果可能,将此
Element 的名称更改为
newName 。
|
void |
setEncodingStyle(String encodingStyle)
将此
SOAPElement 对象的编码样式设置为一个指定的。
|
detachNode, getParentElement, getValue, recycleNode, setParentElement, setValue
getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getElementsByTagName, getElementsByTagNameNS, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNS
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
SOAPElement addChildElement(Name name) throws SOAPException
SOAPElement
给定初始化的对象Name
对象,并将该新元素添加到此SOAPElement
对象。
在未来的SAAJ发行版中可能会弃用此方法,以支持addChildElement(javax.xml.namespace.QName)
name
- 具有新元素的XML名称的
Name
对象
SOAPElement
对象
SOAPException
- 创建
SOAPElement
对象是否有错误
addChildElement(javax.xml.namespace.QName)
SOAPElement addChildElement(QName qname) throws SOAPException
SOAPElement
对象,使用给定的QName
对象初始化,并将新元素添加到此SOAPElement
对象。
新的命名空间 ,和的localName 前缀 SOAPElement
都取自qname
说法。
qname
- 具有新元素的XML名称的
QName
对象
SOAPElement
对象
SOAPException
- 创建
SOAPElement
对象是否有错误
addChildElement(Name)
SOAPElement addChildElement(String localName) throws SOAPException
SOAPElement
对象,使用指定的本地名称初始化,并将新元素添加到此SOAPElement
对象。
新的SOAPElement
继承任何范围内的默认命名空间。
localName
-
String
给出元素的本地名称
SOAPElement
对象
SOAPException
- 创建
SOAPElement
对象是否有错误
SOAPElement addChildElement(String localName, String prefix) throws SOAPException
SOAPElement
对象,使用指定的本地名称和前缀进行初始化,并将新元素添加到此
SOAPElement
对象。
localName
- 一个
String
给出新元素的本地名称
prefix
- 一个
String
给出新元素的命名空间前缀
SOAPElement
对象
SOAPException
- 如果
prefix
在此
SOAPElement
的上下文中
SOAPElement
或创建
SOAPElement
对象时出错
SOAPElement addChildElement(String localName, String prefix, String uri) throws SOAPException
SOAPElement
对象,并将新元素添加到此
SOAPElement
对象。
localName
- 一个
String
给出新元素的本地名称
prefix
- 一个
String
给出新元素的命名空间前缀
uri
- 一个
String
给出新元素所属的命名空间的URI
SOAPElement
对象
SOAPException
- 如果创建
SOAPElement
对象时出错
SOAPElement addChildElement(SOAPElement element) throws SOAPException
SOAPElement
作为这个SOAPElement
实例的孩子。
SOAPElement
预计将由SOAPFactory
创建。
调用者不应该将元素实例添加到XML树中。
实现最后可以复制的内容SOAPElement
传递到不同的实例SOAPElement
实现。
例如,如果在addChildElement()
上调用了SOAPHeader
, element
将被复制到一个SOAPHeaderElement
一个实例中。
根据element
的片段,如果出现错误,或者全部添加,或者根本不添加。
基于element
的片段不能包含名为“Envelope”,“Header”或“Body”的元素和SOAP命名空间中的元素。 片段中存在的任何命名空间前缀应使用片段本身中适当的命名空间声明进行完全解析。
element
- 要加入的
SOAPElement
作为一个新的孩子
SOAPException
- 如果在将此元素添加为子代时出现错误
void removeContents()
SOAPElement
所有孩子。
此方法是用于回滚的部分完成的结构有用SOAPHeaders
和SOAPBodys
在制备用于在检测到错误条件时发送的故障。 它也可用于在SOAP消息中回收文档的部分。
SOAPElement addTextNode(String text) throws SOAPException
Text
对象,使用给定的
String
并将其添加到此
SOAPElement
对象。
text
- 具有要添加的文本内容的
String
对象
SOAPElement
新到哪个对象
Text
插入对象
SOAPException
-如果有一个错误在创建新
Text
对象,如果它是不合法的,将其连接为一个孩子这个
SOAPElement
SOAPElement addAttribute(Name name, String value) throws SOAPException
SOAPElement
对象。
name
- 具有
Name
名称的
Name
对象
value
- 一个
String
给出属性的值
SOAPElement
属性的
SOAPElement
对象
SOAPException
- 如果在创建属性时出现错误,或者在此SOAPElement上设置Name
Name
name
无效。
addAttribute(javax.xml.namespace.QName, String)
SOAPElement addAttribute(QName qname, String value) throws SOAPException
SOAPElement
对象。
qname
- 具有
QName
名称的
QName
对象
value
- 一个
String
给出属性的值
SOAPElement
属性的
SOAPElement
对象
SOAPException
- 如果在创建属性时出现错误,或者在此SOAPElement上设置QName
QName
qname
无效。
addAttribute(Name, String)
SOAPElement addNamespaceDeclaration(String prefix, String uri) throws SOAPException
SOAPElement
对象添加具有指定前缀和URI的
SOAPElement
。
prefix
- 一个
String
给出
String
的前缀
uri
- 一个
String
给出
String
的uri
SOAPElement
空间声明被插入的
SOAPElement
对象。
SOAPException
- 创建命名空间是否有错误
String getAttributeValue(Name name)
name
- 具有
Name
名称的
Name
对象
String
给出指定属性的值,如果没有这样的属性,则为空
getAttributeValue(javax.xml.namespace.QName)
String getAttributeValue(QName qname)
qname
- 一个
QName
对象与该属性的qname
String
给出指定属性的值,如果没有这样的属性,则为空
getAttributeValue(Name)
Iterator getAllAttributes()
Iterator
在所有的属性Name
对象在此SOAPElement
对象。
迭代器可以用于获取属性名称,然后可以将其传递给方法getAttributeValue
以检索每个属性的值。
getAllAttributesAsQNames()
Iterator getAllAttributesAsQNames()
Iterator
的所有属性的SOAPElement
作为QName
对象。
迭代器可用于获取属性QName,然后可以将其传递给方法getAttributeValue
以检索每个属性的值。
getAllAttributes()
String getNamespaceURI(String prefix)
prefix
- 一个
String
给出要搜索的命名空间的前缀
String
与具有给定前缀名称空间的URI
Iterator getNamespacePrefixes()
Iterator
在命名空间前缀String
此元素声明秒。
该迭代器返回的前缀可以传递给方法getNamespaceURI
以检索每个命名空间的URI。
SOAPElement
对象中的命名空间前缀的迭代器
Iterator getVisibleNamespacePrefixes()
Iterator
在命名空间前缀String
有形之到此元素。
该迭代器返回的前缀可以传递给方法getNamespaceURI
以检索每个命名空间的URI。
SOAPElement
对象的范围内
QName createQName(String localName, String prefix) throws SOAPException
QName
,其命名空间URI是与参数,相关联的一个prefix
,在此的上下文中SOAPElement
。
新的QName
的其余元素直接来自参数localName
和prefix
。
localName
- 一个
String
本地部分名称的String。
prefix
- 一个
String
名称前缀的
String
。
QName
具有指定localName
和prefix
,并用与该相关联的命名空间prefix
在此的上下文中SOAPElement
。
这个命名空间将是一样会被返回的一个getNamespaceURI(String)
,如果它被赋予prefix
,因为它的参数。
SOAPException
- 如果无法创建
QName
。
Name getElementName()
SOAPElement
对象的名称。
Name
对象与这个
SOAPElement
对象的名称
QName getElementQName()
SOAPElement
对象的qname。
QName
对象与这个
SOAPElement
对象的qname
getElementName()
SOAPElement setElementQName(QName newName) throws SOAPException
Element
的名称更改为newName
。
SOAP定义的元素(如SOAPEnvelope,SOAPHeader,SOAPBody等)不能使用此方法更改其名称。
任何尝试这样做将导致抛出SOAPException。
来电者不应该依赖于重命名的元素实例。 实现最后可以复制的内容SOAPElement
到重命名实例。
newName
- 新名称为
Element
。
SOAPException
- 如果更改此
Element
的名称是不允许的。
boolean removeAttribute(Name name)
name
- 要删除的属性名称的
Name
对象
true
如果属性被成功删除;
false
如果不是
removeAttribute(javax.xml.namespace.QName)
boolean removeAttribute(QName qname)
qname
- 要
QName
属性的qname的
QName
对象
true
如果属性被成功删除;
false
如果不是
removeAttribute(Name)
boolean removeNamespaceDeclaration(String prefix)
prefix
- 一个
String
给出要搜索的前缀
true
如果命名空间声明成功删除;
false
如果不是
Iterator getChildElements()
Iterator
了所有直接子Node
s此元素。
这包括javax.xml.soap.Text
对象以及SOAPElement
对象。
调用此方法可能会导致儿童Element
, SOAPElement
和org.w3c.dom.Text
节点被替换为SOAPElement
, SOAPHeaderElement
, SOAPBodyElement
或javax.xml.soap.Text
节点作为适合这种父节点的类型。 因此,调用应用程序必须将通过DOM API获取的这些子节点的任何现有引用视为无效,并将其丢弃或使用此Iterator
返回的值刷新它们。 可以通过调用相应的DOM API来避免此行为。 见javax.xml.soap for more details.
SOAPElement
对象的内容的迭代器
Iterator getChildElements(Name name)
Iterator
的所有直接孩子Node
s这个元素与指定的名称。
所有这些孩子将会有SOAPElement
个节点。
调用此方法可能会导致儿童Element
, SOAPElement
和org.w3c.dom.Text
节点被替换为SOAPElement
, SOAPHeaderElement
, SOAPBodyElement
或javax.xml.soap.Text
节点作为适合这种父节点的类型。 因此,调用应用程序必须将通过DOM API获取的这些子节点的任何现有引用视为无效,并将其丢弃或使用此Iterator
返回的值刷新它们。 可以通过调用相应的DOM API来避免此行为。 见javax.xml.soap for more details.
Iterator getChildElements(QName qname)
Iterator
返回该Iterator
的所有直接子级Node
的Iterator。
所有这些孩子将会有SOAPElement
个节点。
调用此方法可能会导致儿童Element
, SOAPElement
和org.w3c.dom.Text
节点被替换为SOAPElement
, SOAPHeaderElement
, SOAPBodyElement
或javax.xml.soap.Text
节点作为适合这种父节点的类型。 因此,调用应用程序必须将通过DOM API获取的这些子节点的任何现有引用视为无效,并将其丢弃或使用此Iterator
返回的值刷新它们。 可以通过调用相应的DOM API来避免此行为。 见javax.xml.soap for more details.
void setEncodingStyle(String encodingStyle) throws SOAPException
SOAPElement
对象的编码样式设置为一个指定的。
encodingStyle
- 一个
String
给出编码风格
IllegalArgumentException
- 如果设置编码风格有问题。
SOAPException
- 如果设置encodingStyle对此SOAPElement无效。
getEncodingStyle()
String getEncodingStyle()
SOAPElement
对象的编码样式。
String
给出编码风格
setEncodingStyle(java.lang.String)
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.