Java™ Platform
Standard Ed. 8
javax.xml.soap

Interface Detail

  • All Superinterfaces:
    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();
     
    • Method Detail

      • addDetailEntry

        DetailEntry addDetailEntry(Name name)
                            throws SOAPException
        Creates a new DetailEntry object with the given name and adds it to this Detail object.
        Parameters:
        name - a Name object identifying the new DetailEntry object
        Throws:
        SOAPException - thrown when there is a problem in adding a DetailEntry object to this Detail object.
        See Also:
        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.
        Parameters:
        qname - a QName object identifying the new DetailEntry object
        Throws:
        SOAPException - thrown when there is a problem in adding a DetailEntry object to this Detail object.
        Since:
        SAAJ 1.3
        See Also:
        addDetailEntry(Name name)
      • getDetailEntries

        Iterator getDetailEntries()
        Gets an Iterator over all of the DetailEntrys in this Detail object.
        Returns:
        an Iterator object over the DetailEntry objects in this Detail object
Java™ Platform
Standard Ed. 8

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, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.

微信小程序

微信扫一扫体验

微信公众账号

微信扫一扫加关注

发表
评论
返回
顶部