Detail (Java EE 5 SDK)

javax.xml.soap Interface Detail

所有父接口:

Element, Node, SOAPElement, SOAPFaultElement

public interface Detail

extends SOAPFaultElement

A container for DetailEntry objects. DetailEntry objects give detailed error information that is application-specific and related to the SOAPBody object that contains it.

A Detail object, which is part of a SOAPFault object, can be retrieved using the method SOAPFault.getDetail. The Detail interface provides two methods. One creates a new DetailEntry object and also automatically adds it to the Detail object. The second method gets a list of the DetailEntry objects contained in a Detail object.

The following code fragment, in which sf is a SOAPFault object, gets its Detail object (d), adds a new DetailEntry object to d, and then gets a list of all the DetailEntry objects in d. The code also creates a Name object to pass to the method addDetailEntry. The variable se, used to create the Name object, is a SOAPEnvelope object.

    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

Creates a new DetailEntry object with the given name and adds it to this Detail object.

参数:

name - a Name object identifying the new DetailEntry object

抛出异常:

SOAPException - thrown when there is a problem in adding a DetailEntry object to this Detail object.

另请参见:

addDetailEntry(QName qname)

addDetailEntry

DetailEntry addDetailEntry(QName qname)
                           throws SOAPException

Creates a new DetailEntry object with the given QName and adds it to this Detail object. This method is the preferred over the one using Name.

参数:

qname - a QName object identifying the new DetailEntry object

抛出异常:

SOAPException - thrown when there is a problem in adding a DetailEntry object to this Detail object.

从以下版本开始:

SAAJ 1.3

另请参见:

addDetailEntry(Name name)

getDetailEntries

Iterator getDetailEntries()

Gets an Iterator over all of the DetailEntrys in this Detail object.

返回:

an Iterator object over the DetailEntry objects in this Detail object

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。深圳电信培训中心.徐海蛟老师教学参考.