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;
}