< prev index next >
src/java.xml.bind/share/classes/javax/xml/bind/Binder.java
Print this page
*** 93,106 ****
* and its descendants is validated during this operation.
*
* <p>
* This method throws {@link UnmarshalException} when the Binder's
* {@link JAXBContext} does not have a mapping for the XML element name
! * or the type, specifiable via <tt>@xsi:type</tt>, of <tt>xmlNode</tt>
* to a JAXB mapped class. The method {@link #unmarshal(Object, Class)}
* enables an application to specify the JAXB mapped class that
! * the <tt>xmlNode</tt> should be mapped to.
*
* @param xmlNode
* the document/element to unmarshal XML data from.
*
* @return
--- 93,106 ----
* and its descendants is validated during this operation.
*
* <p>
* This method throws {@link UnmarshalException} when the Binder's
* {@link JAXBContext} does not have a mapping for the XML element name
! * or the type, specifiable via {@code @xsi:type}, of {@code xmlNode}
* to a JAXB mapped class. The method {@link #unmarshal(Object, Class)}
* enables an application to specify the JAXB mapped class that
! * the {@code xmlNode} should be mapped to.
*
* @param xmlNode
* the document/element to unmarshal XML data from.
*
* @return
*** 108,127 ****
*
* @throws JAXBException
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
! * returns false from its <tt>handleEvent</tt> method or the
! * <tt>Binder</tt> is unable to perform the XML to Java
* binding.
* @throws IllegalArgumentException
* If the node parameter is null
*/
public abstract Object unmarshal( XmlNode xmlNode ) throws JAXBException;
/**
! * Unmarshal XML root element by provided <tt>declaredType</tt>
* to a JAXB object tree.
*
* <p>
* Implements <a href="Unmarshaller.html#unmarshalByDeclaredType">Unmarshal by Declared Type</a>
*
--- 108,127 ----
*
* @throws JAXBException
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
! * returns false from its {@code handleEvent} method or the
! * {@code Binder} is unable to perform the XML to Java
* binding.
* @throws IllegalArgumentException
* If the node parameter is null
*/
public abstract Object unmarshal( XmlNode xmlNode ) throws JAXBException;
/**
! * Unmarshal XML root element by provided {@code declaredType}
* to a JAXB object tree.
*
* <p>
* Implements <a href="Unmarshaller.html#unmarshalByDeclaredType">Unmarshal by Declared Type</a>
*
*** 136,157 ****
* and its descendants is validated during this operation.
*
* @param xmlNode
* the document/element to unmarshal XML data from.
* @param declaredType
! * appropriate JAXB mapped class to hold <tt>node</tt>'s XML data.
*
* @return
* <a href="JAXBElement.html">JAXB Element</a> representation
! * of <tt>node</tt>
*
* @throws JAXBException
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
! * returns false from its <tt>handleEvent</tt> method or the
! * <tt>Binder</tt> is unable to perform the XML to Java
* binding.
* @throws IllegalArgumentException
* If any of the input parameters are null
* @since 1.6, JAXB 2.0
*/
--- 136,157 ----
* and its descendants is validated during this operation.
*
* @param xmlNode
* the document/element to unmarshal XML data from.
* @param declaredType
! * appropriate JAXB mapped class to hold {@code node}'s XML data.
*
* @return
* <a href="JAXBElement.html">JAXB Element</a> representation
! * of {@code node}
*
* @throws JAXBException
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
! * returns false from its {@code handleEvent} method or the
! * {@code Binder} is unable to perform the XML to Java
* binding.
* @throws IllegalArgumentException
* If any of the input parameters are null
* @since 1.6, JAXB 2.0
*/
*** 180,192 ****
*
* @throws JAXBException
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
! * returns false from its <tt>handleEvent</tt> method or the
! * <tt>Binder</tt> is unable to marshal <tt>jaxbObject</tt> (or any
! * object reachable from <tt>jaxbObject</tt>).
*
* @throws IllegalArgumentException
* If any of the method parameters are null
*/
public abstract void marshal( Object jaxbObject, XmlNode xmlNode ) throws JAXBException;
--- 180,192 ----
*
* @throws JAXBException
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
! * returns false from its {@code handleEvent} method or the
! * {@code Binder} is unable to marshal {@code jaxbObject} (or any
! * object reachable from {@code jaxbObject}).
*
* @throws IllegalArgumentException
* If any of the method parameters are null
*/
public abstract void marshal( Object jaxbObject, XmlNode xmlNode ) throws JAXBException;
*** 341,353 ****
* @return the Schema object for validation or null if not present
*/
public abstract Schema getSchema();
/**
! * Allow an application to register a <tt>ValidationEventHandler</tt>.
* <p>
! * The <tt>ValidationEventHandler</tt> will be called by the JAXB Provider
* if any validation errors are encountered during calls to any of the
* Binder unmarshal, marshal and update methods.
*
* <p>
* Calling this method with a null parameter will cause the Binder
--- 341,353 ----
* @return the Schema object for validation or null if not present
*/
public abstract Schema getSchema();
/**
! * Allow an application to register a {@code ValidationEventHandler}.
* <p>
! * The {@code ValidationEventHandler} will be called by the JAXB Provider
* if any validation errors are encountered during calls to any of the
* Binder unmarshal, marshal and update methods.
*
* <p>
* Calling this method with a null parameter will cause the Binder
*** 371,381 ****
public abstract ValidationEventHandler getEventHandler() throws JAXBException;
/**
*
* Set the particular property in the underlying implementation of
! * <tt>Binder</tt>. This method can only be used to set one of
* the standard JAXB defined unmarshal/marshal properties
* or a provider specific property for binder, unmarshal or marshal.
* Attempting to set an undefined property will result in
* a PropertyException being thrown. See
* <a href="Unmarshaller.html#supportedProps">Supported Unmarshal Properties</a>
--- 371,381 ----
public abstract ValidationEventHandler getEventHandler() throws JAXBException;
/**
*
* Set the particular property in the underlying implementation of
! * {@code Binder}. This method can only be used to set one of
* the standard JAXB defined unmarshal/marshal properties
* or a provider specific property for binder, unmarshal or marshal.
* Attempting to set an undefined property will result in
* a PropertyException being thrown. See
* <a href="Unmarshaller.html#supportedProps">Supported Unmarshal Properties</a>
*** 395,405 ****
abstract public void setProperty( String name, Object value ) throws PropertyException;
/**
* Get the particular property in the underlying implementation of
! * <tt>Binder</tt>. This method can only
* be used to get one of
* the standard JAXB defined unmarshal/marshal properties
* or a provider specific property for binder, unmarshal or marshal.
* Attempting to get an undefined property will result in
* a PropertyException being thrown. See
--- 395,405 ----
abstract public void setProperty( String name, Object value ) throws PropertyException;
/**
* Get the particular property in the underlying implementation of
! * {@code Binder}. This method can only
* be used to get one of
* the standard JAXB defined unmarshal/marshal properties
* or a provider specific property for binder, unmarshal or marshal.
* Attempting to get an undefined property will result in
* a PropertyException being thrown. See
< prev index next >