src/share/jaxws_classes/javax/xml/soap/SOAPFault.java

Print this page
rev 507 : 8047724: @since tag cleanup in jaxws
Reviewed-by:

@@ -40,10 +40,12 @@
  * server.
  * <P>
  * Depending on the <code>protocol</code> specified while creating the
  * <code>MessageFactory</code> instance,  a <code>SOAPFault</code> has
  * sub-elements as defined in the SOAP 1.1/SOAP 1.2 specification.
+ *
+ * @since 1.6
  */
 public interface SOAPFault extends SOAPBodyElement {
 
     /**
      * Sets this <code>SOAPFault</code> object with the given fault code.

@@ -70,11 +72,11 @@
      * @see #getFaultCodeAsName
      *
      * @exception SOAPException if there was an error in adding the
      *            <i>faultcode</i> element to the underlying XML tree.
      *
-     * @since SAAJ 1.2
+     * @since 1.6, SAAJ 1.2
      */
     public void setFaultCode(Name faultCodeQName) throws SOAPException;
 
     /**
      * Sets this <code>SOAPFault</code> object with the given fault code.

@@ -89,11 +91,11 @@
      *            <code>faultcode</code> element to the underlying XML tree.
      *
      * @see #setFaultCode(Name)
      * @see #getFaultCodeAsQName()
      *
-     * @since SAAJ 1.3
+     * @since 1.6, SAAJ 1.3
      */
     public void setFaultCode(QName faultCodeQName) throws SOAPException;
 
     /**
      * Sets this <code>SOAPFault</code> object with the give fault code.

@@ -126,11 +128,11 @@
      * additional parsing.
      *
      * @return a <code>Name</code> representing the faultcode
      * @see #setFaultCode(Name)
      *
-     * @since SAAJ 1.2
+     * @since 1.6, SAAJ 1.2
      */
     public Name getFaultCodeAsName();
 
 
     /**

@@ -139,11 +141,11 @@
      *
      * @return a <code>QName</code> representing the faultcode
      *
      * @see #setFaultCode(QName)
      *
-     * @since SAAJ 1.3
+     * @since 1.6, SAAJ 1.3
      */
     public QName getFaultCodeAsQName();
 
     /**
      * Gets the Subcodes for this <code>SOAPFault</code> as an iterator over

@@ -156,11 +158,11 @@
      *      in the fault from top to bottom.
      *
      * @exception UnsupportedOperationException if this message does not
      *      support the SOAP 1.2 concept of Subcode.
      *
-     * @since SAAJ 1.3
+     * @since 1.6, SAAJ 1.3
      */
     public Iterator getFaultSubcodes();
 
     /**
      * Removes any Subcodes that may be contained by this

@@ -169,11 +171,11 @@
      * to <code>appendFaultSubcode</code> is made.
      *
      * @exception UnsupportedOperationException if this message does not
      *      support the SOAP 1.2 concept of Subcode.
      *
-     * @since SAAJ 1.3
+     * @since 1.6, SAAJ 1.3
      */
     public void removeAllFaultSubcodes();
 
     /**
      * Adds a Subcode to the end of the sequence of Subcodes contained by this

@@ -185,11 +187,11 @@
      *
      * @exception SOAPException if there was an error in setting the Subcode
      * @exception UnsupportedOperationException if this message does not
      *      support the SOAP 1.2 concept of Subcode.
      *
-     * @since SAAJ 1.3
+     * @since 1.6, SAAJ 1.3
      */
     public void appendFaultSubcode(QName subcode) throws SOAPException;
 
     /**
      * Gets the fault code for this <code>SOAPFault</code> object.

@@ -268,11 +270,11 @@
      * @see #getFaultString
      *
      * @exception SOAPException if there was an error in adding the
      *            <code>faultString</code> to the underlying XML tree.
      *
-     * @since SAAJ 1.2
+     * @since 1.6, SAAJ 1.2
      */
     public void setFaultString(String faultString, Locale locale)
         throws SOAPException;
 
     /**

@@ -313,11 +315,11 @@
      *
      * @return a <code>Locale</code> object indicating the native language of
      *          the fault string or <code>null</code> if no locale was specified
      * @see #setFaultString(String, Locale)
      *
-     * @since SAAJ 1.2
+     * @since 1.6, SAAJ 1.2
      */
     public Locale getFaultStringLocale();
 
     /**
      * Returns true if this <code>SOAPFault</code> has a <code>Detail</code>

@@ -325,11 +327,11 @@
      * <code>(getDetail()!=null)</code>.
      *
      * @return true if this <code>SOAPFault</code> has a <code>Detail</code>
      * subelement and false otherwise.
      *
-     * @since SAAJ 1.3
+     * @since 1.6, SAAJ 1.3
      */
     public boolean hasDetail();
 
     /**
      * Returns the optional detail element for this <code>SOAPFault</code>

@@ -375,11 +377,11 @@
      * @exception SOAPException if there was an error in retrieving
      * the  fault Reason locales.
      * @exception UnsupportedOperationException if this message does not
      *      support the SOAP 1.2 concept of Fault Reason.
      *
-     * @since SAAJ 1.3
+     * @since 1.6, SAAJ 1.3
      */
     public Iterator getFaultReasonLocales() throws SOAPException;
 
     /**
      * Returns an <code>Iterator</code> over a sequence of

@@ -391,11 +393,11 @@
      * @exception SOAPException if there was an error in retrieving
      * the  fault Reason texts.
      * @exception UnsupportedOperationException if this message does not
      *      support the SOAP 1.2 concept of Fault Reason.
      *
-     * @since SAAJ 1.3
+     * @since 1.6, SAAJ 1.3
      */
     public Iterator getFaultReasonTexts() throws SOAPException;
 
     /**
      * Returns the Reason Text associated with the given <code>Locale</code>.

@@ -412,11 +414,11 @@
      * @exception SOAPException if there was an error in retrieving
      * the  fault Reason text for the specified locale .
      * @exception UnsupportedOperationException if this message does not
      *      support the SOAP 1.2 concept of Fault Reason.
      *
-     * @since SAAJ 1.3
+     * @since 1.6, SAAJ 1.3
      */
     public String getFaultReasonText(Locale locale) throws SOAPException;
 
     /**
      * Appends or replaces a Reason Text item containing the specified

@@ -439,11 +441,11 @@
      * @exception SOAPException if there was an error in adding the Reason text
      * or the <code>locale</code> passed was <code>null</code>.
      * @exception UnsupportedOperationException if this message does not
      *      support the SOAP 1.2 concept of Fault Reason.
      *
-     * @since SAAJ 1.3
+     * @since 1.6, SAAJ 1.3
      */
     public void addFaultReasonText(String text, java.util.Locale locale)
         throws SOAPException;
 
     /**

@@ -455,11 +457,11 @@
      * or <code>null</code> if none
      *
      * @exception UnsupportedOperationException if this message does not
      *      support the SOAP 1.2 concept of Fault Node.
      *
-     * @since SAAJ 1.3
+     * @since 1.6, SAAJ 1.3
      */
     public String getFaultNode();
 
     /**
      * Creates or replaces any existing Node element value for

@@ -470,11 +472,11 @@
      *            Node for this  <code>SOAPFault</code> object.
      * @exception UnsupportedOperationException if this message does not
      *      support the SOAP 1.2 concept of Fault Node.
      *
      *
-     * @since SAAJ 1.3
+     * @since 1.6, SAAJ 1.3
      */
     public void setFaultNode(String uri) throws SOAPException;
 
     /**
      * Returns the optional Role element value for this

@@ -485,11 +487,11 @@
      * or <code>null</code> if none
      *
      * @exception UnsupportedOperationException if this message does not
      *      support the SOAP 1.2 concept of Fault Role.
      *
-     * @since SAAJ 1.3
+     * @since 1.6, SAAJ 1.3
      */
     public String getFaultRole();
 
     /**
      * Creates or replaces any existing Role element value for

@@ -502,10 +504,10 @@
      *            Role for this  <code>SOAPFault</code> object.
      *
      * @exception UnsupportedOperationException if this message does not
      *      support the SOAP 1.2 concept of Fault Role.
      *
-     * @since SAAJ 1.3
+     * @since 1.6, SAAJ 1.3
      */
     public void setFaultRole(String uri) throws SOAPException;
 
 }