javax.xml.soap
接口 Detail

所有超级接口：

Element, Node, SOAPElement, SOAPFaultElement

public interface Detail
     

      extends 
      SOAPFaultElement
     

DetailEntry 对象的容器。DetailEntry 对象给出特定于应用程序的详细错误信息，以及与包含该对象的 SOAPBody 对象相关的详细错误信息。

可以使用方法 SOAPFault.getDetail 来检索 Detail 对象（SOAPFault 对象的一部分）。该 Detail 接口提供两个方法。第一种方法创建一个新 DetailEntry 对象，且自动将其添加到 Detail 对象。第二种方法获取 Detail 对象中包含的 DetailEntry 对象列表。

以下代码片段（其中 sf 是 SOAPFault 对象）获取它的 Detail 对象 (d)，将新的 DetailEntry 对象添加到 d，然后获取 d 中所有 DetailEntry 对象列表。该代码片段还创建要传递给方法 addDetailEntry 的 Name 对象。变量 se（用于创建 Name 对象）是一个 SOAPEnvelope 对象。

Detail d = sf.getDetail();
Name name = se.createName("GetLastTradePrice", "WOMBAT",
"http://www.wombat.org/trader");
d.addDetailEntry(name);
Iterator it = d.getDetailEntries();
 

addDetailEntry

DetailEntry addDetailEntry(Name name)
                           throws SOAPException

使用给定名称创建新的 DetailEntry 对象，并将其添加到此 Detail 对象。

参数：

name - 标识新 DetailEntry 对象的 Name 对象

抛出：

SOAPException - 当将 DetailEntry 对象添加到此 Detail 对象过程中存在问题时，抛出该异常。

另请参见：

addDetailEntry(QName qname)

addDetailEntry

DetailEntry addDetailEntry(QName qname)
                           throws SOAPException

使用给定 QName 创建新的 DetailEntry 对象，并将其添加到此 Detail 对象。与使用 Name 的方法相比，应优先考虑此方法。

参数：

qname - 标识新 DetailEntry 对象的 QName 对象

抛出：

SOAPException - 当将 DetailEntry 对象添加到此 Detail 对象过程中存在问题时，抛出该异常。

从以下版本开始：

SAAJ 1.3

另请参见：

addDetailEntry(Name name)

getDetailEntries

Iterator getDetailEntries()

获取在此 Detail 对象中所有 DetailEntry 上进行迭代的迭代器。

返回：

一个 Iterator 对象，可在此 Detail 对象中的 DetailEntry 对象上进行迭代