src/share/jaxws_classes/javax/xml/bind/Unmarshaller.java
Print this page
rev 507 : 8047724: @since tag cleanup in jaxws
Reviewed-by:
@@ -402,11 +402,11 @@
*
* @author <ul><li>Ryan Shoemaker, Sun Microsystems, Inc.</li><li>Kohsuke Kawaguchi, Sun Microsystems, Inc.</li><li>Joe Fialli, Sun Microsystems, Inc.</li></ul>
* @see JAXBContext
* @see Marshaller
* @see Validator
- * @since JAXB1.0
+ * @since 1.6, JAXB 1.0
*/
public interface Unmarshaller {
/**
* Unmarshal XML data from the specified file and return the resulting
@@ -472,11 +472,11 @@
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Unmarshaller</tt> is unable to perform the XML to Java
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If the InputStream parameter is null
- * @since JAXB2.0
+ * @since 1.6, JAXB 2.0
*/
public Object unmarshal( Reader reader ) throws JAXBException;
/**
* Unmarshal XML data from the specified URL and return the resulting
@@ -569,11 +569,11 @@
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Unmarshaller</tt> is unable to perform the XML to Java
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If any parameter is null
- * @since JAXB2.0
+ * @since 1.6, JAXB 2.0
*/
public <T> JAXBElement<T> unmarshal( org.w3c.dom.Node node, Class<T> declaredType ) throws JAXBException;
/**
* Unmarshal XML data from the specified XML Source and return the
@@ -658,11 +658,11 @@
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Unmarshaller</tt> is unable to perform the XML to Java
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If any parameter is null
- * @since JAXB2.0
+ * @since 1.6, JAXB 2.0
*/
public <T> JAXBElement<T> unmarshal( javax.xml.transform.Source source, Class<T> declaredType )
throws JAXBException;
/**
@@ -694,11 +694,11 @@
* @throws IllegalArgumentException
* If the <tt>reader</tt> parameter is null
* @throws IllegalStateException
* If <tt>reader</tt> is not pointing to a START_DOCUMENT or
* START_ELEMENT event.
- * @since JAXB2.0
+ * @since 1.6, JAXB 2.0
* @see #unmarshal(javax.xml.stream.XMLStreamReader, Class)
*/
public Object unmarshal( javax.xml.stream.XMLStreamReader reader )
throws JAXBException;
@@ -729,11 +729,11 @@
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Unmarshaller</tt> is unable to perform the XML to Java
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If any parameter is null
- * @since JAXB2.0
+ * @since 1.6, JAXB 2.0
*/
public <T> JAXBElement<T> unmarshal( javax.xml.stream.XMLStreamReader reader, Class<T> declaredType ) throws JAXBException;
/**
* Unmarshal XML data from the specified pull parser and return the
@@ -764,11 +764,11 @@
* @throws IllegalArgumentException
* If the <tt>reader</tt> parameter is null
* @throws IllegalStateException
* If <tt>reader</tt> is not pointing to a START_DOCUMENT or
* START_ELEMENT event.
- * @since JAXB2.0
+ * @since 1.6, JAXB 2.0
* @see #unmarshal(javax.xml.stream.XMLEventReader, Class)
*/
public Object unmarshal( javax.xml.stream.XMLEventReader reader )
throws JAXBException;
@@ -800,11 +800,11 @@
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Unmarshaller</tt> is unable to perform the XML to Java
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If any parameter is null
- * @since JAXB2.0
+ * @since 1.6, JAXB 2.0
*/
public <T> JAXBElement<T> unmarshal( javax.xml.stream.XMLEventReader reader, Class<T> declaredType ) throws JAXBException;
/**
* Get an unmarshaller handler object that can be used as a component in
@@ -960,11 +960,11 @@
*
* @param schema Schema object to validate unmarshal operations against or null to disable validation
* @throws UnsupportedOperationException could be thrown if this method is
* invoked on an Unmarshaller created from a JAXBContext referencing
* JAXB 1.0 mapped classes
- * @since JAXB2.0
+ * @since 1.6, JAXB 2.0
*/
public void setSchema( javax.xml.validation.Schema schema );
/**
* Get the JAXP 1.3 {@link javax.xml.validation.Schema Schema} object
@@ -984,11 +984,11 @@
* @return the Schema object being used to perform unmarshal-time
* validation or null if not present
* @throws UnsupportedOperationException could be thrown if this method is
* invoked on an Unmarshaller created from a JAXBContext referencing
* JAXB 1.0 mapped classes
- * @since JAXB2.0
+ * @since 1.6, JAXB 2.0
*/
public javax.xml.validation.Schema getSchema();
/**
* Associates a configured instance of {@link XmlAdapter} with this unmarshaller.
@@ -999,11 +999,11 @@
* @see #setAdapter(Class,XmlAdapter)
* @throws IllegalArgumentException
* if the adapter parameter is null.
* @throws UnsupportedOperationException
* if invoked agains a JAXB 1.0 implementation.
- * @since JAXB2.0
+ * @since 1.6, JAXB 2.0
*/
public void setAdapter( XmlAdapter adapter );
/**
* Associates a configured instance of {@link XmlAdapter} with this unmarshaller.
@@ -1028,11 +1028,11 @@
* the current adapter set for this type.
* @throws IllegalArgumentException
* if the type parameter is null.
* @throws UnsupportedOperationException
* if invoked agains a JAXB 1.0 implementation.
- * @since JAXB2.0
+ * @since 1.6, JAXB 2.0
*/
public <A extends XmlAdapter> void setAdapter( Class<A> type, A adapter );
/**
* Gets the adapter associated with the specified type.
@@ -1041,11 +1041,11 @@
*
* @throws IllegalArgumentException
* if the type parameter is null.
* @throws UnsupportedOperationException
* if invoked agains a JAXB 1.0 implementation.
- * @since JAXB2.0
+ * @since 1.6, JAXB 2.0
*/
public <A extends XmlAdapter> A getAdapter( Class<A> type );
/**
* <p>Associate a context that resolves cid's, content-id URIs, to
@@ -1079,11 +1079,11 @@
* See <a href="Unmarshaller.html#unmarshalEventCallback">Unmarshal Event Callbacks</a> for an overview.
* <p/>
* (@link #setListener(Listener)}
* (@link #getListener()}
*
- * @since JAXB2.0
+ * @since 1.6, JAXB 2.0
*/
public static abstract class Listener {
/**
* <p/>
* Callback method invoked before unmarshalling into <tt>target</tt>.
@@ -1126,17 +1126,17 @@
* <p>
* There is only one Listener per Unmarshaller. Setting a Listener replaces the previous set Listener.
* One can unregister current Listener by setting listener to <tt>null</tt>.
*
* @param listener provides unmarshal event callbacks for this {@link Unmarshaller}
- * @since JAXB2.0
+ * @since 1.6, JAXB 2.0
*/
public void setListener(Listener listener);
/**
* <p>Return {@link Listener} registered with this {@link Unmarshaller}.
*
* @return registered {@link Listener} or <code>null</code> if no Listener is registered with this Unmarshaller.
- * @since JAXB2.0
+ * @since 1.6, JAXB 2.0
*/
public Listener getListener();
}