表示 SOAP 规范允许使用但未特别规定的 SOAP 消息元素的对象。此接口充当 SOAP 规范特别规定的那些对象的基本接口。
此接口中要求返回特定于 SAAJ 的对象的那些方法可以“安静地”替换树中的节点,以便按要求成功返回正确类型的对象。有关详细信息,请参见 getChildElements()
和 javax.xml.soap。
字段摘要 |
---|
方法摘要 | |
---|---|
SOAPElement |
addAttribute(Name name, String value) 将带有指定名称和值的属性添加到此 SOAPElement 对象。 |
SOAPElement |
addAttribute(QName qname, String value) 将带有指定名称和值的属性添加到此 SOAPElement 对象。 |
SOAPElement |
addChildElement(Name name) 创建使用给定 Name 对象初始化的新 SOAPElement 对象,并将该新元素添加到此 SOAPElement 对象。 |
SOAPElement |
addChildElement(QName qname) 创建使用给定 QName 对象初始化的新 SOAPElement 对象,并将该新元素添加到此 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) 创建使用指定本地名称、前缀和 URI 初始化的新 SOAPElement 对象,并将该新元素添加到此 SOAPElement 对象。 |
SOAPElement |
addNamespaceDeclaration(String prefix, String uri) 将带有指定前缀和 URI 的名称空间声明添加到此 SOAPElement 对象。 |
SOAPElement |
addTextNode(String text) 创建使用给定 String 初始化的新 Text 对象,并将其添加到此 SOAPElement 对象。 |
QName |
createQName(String localName, String prefix) 创建一个 QName ,其名称空间 URI 应与此 SOAPElement 上下文中的参数、prefix 相关联。 |
Iterator |
getAllAttributes() 返回可在此 SOAPElement 对象中所有属性 Name 对象上进行迭代的 Iterator 。 |
Iterator |
getAllAttributesAsQNames() 返回可在此 SOAPElement 对象(以 QName 对象的形式)中的所有属性上进行迭代的 Iterator 。 |
String |
getAttributeValue(Name name) 返回带有指定名称的属性值。 |
String |
getAttributeValue(QName qname) 返回带有指定 qname 的属性值。 |
Iterator |
getChildElements() 返回可在此元素的所有直接子 Node 上进行迭代的 Iterator 。 |
Iterator |
getChildElements(Name name) 返回可在带有指定名称的此元素所有直接子 Node 上进行迭代的 Iterator 。 |
Iterator |
getChildElements(QName qname) 返回可在带有指定 qname 的此元素所有直接子 Node 上进行迭代的 Iterator 。 |
Name |
getElementName() 返回此 SOAPElement 对象的名称。 |
QName |
getElementQName() 返回此 SOAPElement 对象的 qname。 |
String |
getEncodingStyle() 返回此 SOAPElement 对象的编码样式。 |
Iterator |
getNamespacePrefixes() 返回可在此元素声明的名称空间前缀 String 上进行迭代的 Iterator 。 |
String |
getNamespaceURI(String prefix) 返回带有给定前缀的名称空间的 URI。 |
Iterator |
getVisibleNamespacePrefixes() 返回在此元素可见的名称空间前缀 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 对象的编码样式设置为指定样式。 |
从接口 javax.xml.soap.Node 继承的方法 |
---|
detachNode, getParentElement, getValue, recycleNode, setParentElement, setValue |
方法详细信息 |
---|
SOAPElement addChildElement(Name name) throws SOAPException
Name
对象初始化的新
SOAPElement
对象,并将该新元素添加到此
SOAPElement
对象。
此方法在以后的 SAAJ 版本中可能会被废弃,并用 addChildElement(javax.xml.namespace.QName) 取代。
name
-
Name
对象,带有新元素的 XML 名称
SOAPElement
对象
SOAPException
- 如果在创建
SOAPElement
对象时发生错误
addChildElement(javax.xml.namespace.QName)
SOAPElement addChildElement(QName qname) throws SOAPException
QName
对象初始化的新
SOAPElement
对象,并将该新元素添加到此
SOAPElement
对象。新
SOAPElement
的
namespace、
localname 和
prefix 都取自
qname
参数。
qname
-
QName
对象,带有新元素的 XML 名称
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 addChildElement(String localName, String prefix, String uri) throws SOAPException
SOAPElement
对象,并将该新元素添加到此
SOAPElement
对象。
localName
- 给出新元素本地名称的
String
prefix
- 给出新元素名称空间前缀的
String
uri
- 给出新元素所属空间名称 URI 的
String
SOAPElement
对象
SOAPException
- 如果在创建
SOAPElement
对象时发生错误
SOAPElement addChildElement(SOAPElement element) throws SOAPException
SOAPElement
作为此
SOAPElement
实例的子级添加。应该由
SOAPFactory
来创建
SOAPElement
。调用者不应依靠此方式添加到 XML 树的元素实例。实现最后可以将传递的
SOAPElement
的内容复制到一个不同
SOAPElement
实现的实例中。例如,如果对
SOAPHeader
调用
addChildElement()
,则
element
将被复制到
SOAPHeaderElement
的实例中。
以 element
为根的片段将作为一个整体添加,如果发生错误,则不添加。
以 element
为根的片段不能包含名为 "Envelope"、"Header" 或 "Body" 且属于 SOAP 名称空间的元素。片段中出现的任何名称空间前缀都应该使用片段本身中适当的名称空间声明来完整解析。
element
- 要作为新子级添加的
SOAPElement
SOAPException
- 如果在作为子级添加此元素时出现错误
void removeContents()
SOAPElement
的所有子级。
此方法对回滚部分完成的 SOAPHeaders
和 SOAPBodys
的构造很有用,便于准备在检测到错误条件时发送错误。它对于回收 SOAP 消息中的文档各部分也很有用。
SOAPElement addTextNode(String text) throws SOAPException
String
初始化的新
Text
对象,并将其添加到此
SOAPElement
对象。
text
- 带有要添加文本内容的
String
对象
Text
对象的
SOAPElement
对象
SOAPException
- 如果在创建新
Text
时发生错误,或者将它作为子级附加到此
SOAPElement
不合法
SOAPElement addAttribute(Name name, String value) throws SOAPException
SOAPElement
对象。
name
- 带有属性名称的
Name
对象
value
- 给出属性值的
String
SOAPElement
对象
SOAPException
- 如果在创建属性时发生错误,或者在此 SOAPElement 上设置带有
Name
name
的属性无效。
addAttribute(javax.xml.namespace.QName, String)
SOAPElement addAttribute(QName qname, String value) throws SOAPException
SOAPElement
对象。
qname
- 带有属性名称的
QName
对象
value
- 给出属性值的
String
SOAPElement
对象
SOAPException
- 如果在创建属性时出现错误,如果在此 SOAPElement 上设置带有
QName
qname
的属性无效。
addAttribute(Name, String)
SOAPElement addNamespaceDeclaration(String prefix, String uri) throws SOAPException
SOAPElement
对象。
prefix
- 给出名称空间前缀的
String
uri
- 给出名称空间 URI 的
String
SOAPElement
对象。
SOAPException
- 如果在创建名称空间时发生错误
String getAttributeValue(Name name)
name
- 带有属性名称的
Name
对象
String
,如果没有这种属性,则返回 Null
getAttributeValue(javax.xml.namespace.QName)
String getAttributeValue(QName qname)
qname
- 带有属性 qname 的
QName
对象
String
,如果没有这种属性,则返回 Null
getAttributeValue(Name)
Iterator getAllAttributes()
SOAPElement
对象中所有属性
Name
对象上进行迭代的
Iterator
。迭代器可以用于获取属性名称,然后可将这些名称传递给方法
getAttributeValue
以检索每个属性的值。
getAllAttributesAsQNames()
Iterator getAllAttributesAsQNames()
SOAPElement
对象(以
QName
对象的形式)中的所有属性上进行迭代的
Iterator
。迭代器可以用于获取属性 QName,然后可将这些名称传递给方法
getAttributeValue
以检索每个属性的值。
getAllAttributes()
String getNamespaceURI(String prefix)
prefix
- 一个
String
,给出用来搜索的名称空间前缀
String
,带有给定前缀名称空间的 URI
Iterator getNamespacePrefixes()
String
上进行迭代的
Iterator
。由此迭代器返回的前缀可以传递给方法
getNamespaceURI
,以检索每个名称空间的 URI。
SOAPElement
对象的名称空间前缀上进行迭代的迭代器
Iterator getVisibleNamespacePrefixes()
String
上进行迭代的
Iterator
。由此迭代器返回的前缀可以传递给方法
getNamespaceURI
,以检索每个名称空间的 URI。
SOAPElement
对象作用域内的名称空间前缀上进行迭代的迭代器
QName createQName(String localName, String prefix) throws SOAPException
QName
,其名称空间 URI 应与此
SOAPElement
上下文中的参数、
prefix
相关联。新
QName
的其余元素都直接取自参数、
localName
和
prefix
。
localName
- 包含名称本地部分的
String
。
prefix
- 包含名称前缀的
String
。
QName
,带有指定的
localName
和
prefix
,以及与此
SOAPElement
上下文中的
prefix
关联的名称空间。如果将
prefix
作为参数提供给
getNamespaceURI(String)
,则此名称空间将与该方法返回的名称空间相同。
SOAPException
- 如果无法创建
QName
。
Name getElementName()
SOAPElement
对象的名称。
SOAPElement
对象名称的
Name
对象
QName getElementQName()
SOAPElement
对象的 qname。
SOAPElement
对象 qname 的
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
true
;否则返回
false
removeAttribute(Name)
boolean removeNamespaceDeclaration(String prefix)
prefix
- 一个
String
,给出用来搜索的前缀
true
;否则返回
false
Iterator getChildElements()
Node
上进行迭代的
Iterator
。这包括
javax.xml.soap.Text
对象以及
SOAPElement
对象。
调用此方法可能导致子 Element
、SOAPElement
和 org.w3c.dom.Text
节点被适合于此父节点类型的 SOAPElement
、SOA