jaxws/src/java.xml.bind/share/classes/javax/xml/bind/Marshaller.java
changeset 33547 e4c76ac38b12
parent 32795 5a5710ee05a0
child 47210 1edad689f56c
equal deleted inserted replaced
33390:d131f4b8433a 33547:e4c76ac38b12
   370      * @throws JAXBException
   370      * @throws JAXBException
   371      *      If any unexpected problem occurs during the marshalling.
   371      *      If any unexpected problem occurs during the marshalling.
   372      * @throws MarshalException
   372      * @throws MarshalException
   373      *      If the {@link ValidationEventHandler ValidationEventHandler}
   373      *      If the {@link ValidationEventHandler ValidationEventHandler}
   374      *      returns false from its {@code handleEvent} method or the
   374      *      returns false from its {@code handleEvent} method or the
   375      *      {@code Marshaller} is unable to marshal {@code obj} (or any
   375      *      {@code Marshaller} is unable to marshal {@code jaxbElement} (or any
   376      *      object reachable from {@code obj}).  See <a href="#elementMarshalling">
   376      *      object reachable from {@code jaxbElement}).  See <a href="#elementMarshalling">
   377      *      Marshalling a JAXB element</a>.
   377      *      Marshalling a JAXB element</a>.
   378      * @throws IllegalArgumentException
   378      * @throws IllegalArgumentException
   379      *      If any of the method parameters are null
   379      *      If any of the method parameters are null
   380      */
   380      */
   381     public void marshal( Object jaxbElement, javax.xml.transform.Result result )
   381     public void marshal( Object jaxbElement, javax.xml.transform.Result result )
   392      * @throws JAXBException
   392      * @throws JAXBException
   393      *      If any unexpected problem occurs during the marshalling.
   393      *      If any unexpected problem occurs during the marshalling.
   394      * @throws MarshalException
   394      * @throws MarshalException
   395      *      If the {@link ValidationEventHandler ValidationEventHandler}
   395      *      If the {@link ValidationEventHandler ValidationEventHandler}
   396      *      returns false from its {@code handleEvent} method or the
   396      *      returns false from its {@code handleEvent} method or the
   397      *      {@code Marshaller} is unable to marshal {@code obj} (or any
   397      *      {@code Marshaller} is unable to marshal {@code jaxbElement} (or any
   398      *      object reachable from {@code obj}).  See <a href="#elementMarshalling">
   398      *      object reachable from {@code jaxbElement}).  See <a href="#elementMarshalling">
   399      *      Marshalling a JAXB element</a>.
   399      *      Marshalling a JAXB element</a>.
   400      * @throws IllegalArgumentException
   400      * @throws IllegalArgumentException
   401      *      If any of the method parameters are null
   401      *      If any of the method parameters are null
   402      */
   402      */
   403     public void marshal( Object jaxbElement, java.io.OutputStream os )
   403     public void marshal( Object jaxbElement, java.io.OutputStream os )
   414      * @throws JAXBException
   414      * @throws JAXBException
   415      *      If any unexpected problem occurs during the marshalling.
   415      *      If any unexpected problem occurs during the marshalling.
   416      * @throws MarshalException
   416      * @throws MarshalException
   417      *      If the {@link ValidationEventHandler ValidationEventHandler}
   417      *      If the {@link ValidationEventHandler ValidationEventHandler}
   418      *      returns false from its {@code handleEvent} method or the
   418      *      returns false from its {@code handleEvent} method or the
   419      *      {@code Marshaller} is unable to marshal {@code obj} (or any
   419      *      {@code Marshaller} is unable to marshal {@code jaxbElement} (or any
   420      *      object reachable from {@code obj}).  See <a href="#elementMarshalling">
   420      *      object reachable from {@code jaxbElement}).  See <a href="#elementMarshalling">
   421      *      Marshalling a JAXB element</a>.
   421      *      Marshalling a JAXB element</a>.
   422      * @throws IllegalArgumentException
   422      * @throws IllegalArgumentException
   423      *      If any of the method parameters are null
   423      *      If any of the method parameters are null
   424      * @since 1.6, JAXB 2.1
   424      * @since 1.6, JAXB 2.1
   425      */
   425      */
   437      * @throws JAXBException
   437      * @throws JAXBException
   438      *      If any unexpected problem occurs during the marshalling.
   438      *      If any unexpected problem occurs during the marshalling.
   439      * @throws MarshalException
   439      * @throws MarshalException
   440      *      If the {@link ValidationEventHandler ValidationEventHandler}
   440      *      If the {@link ValidationEventHandler ValidationEventHandler}
   441      *      returns false from its {@code handleEvent} method or the
   441      *      returns false from its {@code handleEvent} method or the
   442      *      {@code Marshaller} is unable to marshal {@code obj} (or any
   442      *      {@code Marshaller} is unable to marshal {@code jaxbElement} (or any
   443      *      object reachable from {@code obj}).  See <a href="#elementMarshalling">
   443      *      object reachable from {@code jaxbElement}).  See <a href="#elementMarshalling">
   444      *      Marshalling a JAXB element</a>.
   444      *      Marshalling a JAXB element</a>.
   445      * @throws IllegalArgumentException
   445      * @throws IllegalArgumentException
   446      *      If any of the method parameters are null
   446      *      If any of the method parameters are null
   447      */
   447      */
   448     public void marshal( Object jaxbElement, java.io.Writer writer )
   448     public void marshal( Object jaxbElement, java.io.Writer writer )
   459      * @throws JAXBException
   459      * @throws JAXBException
   460      *      If any unexpected problem occurs during the marshalling.
   460      *      If any unexpected problem occurs during the marshalling.
   461      * @throws MarshalException
   461      * @throws MarshalException
   462      *      If the {@link ValidationEventHandler ValidationEventHandler}
   462      *      If the {@link ValidationEventHandler ValidationEventHandler}
   463      *      returns false from its {@code handleEvent} method or the
   463      *      returns false from its {@code handleEvent} method or the
   464      *      {@code Marshaller} is unable to marshal {@code obj} (or any
   464      *      {@code Marshaller} is unable to marshal {@code jaxbElement} (or any
   465      *      object reachable from {@code obj}).  See <a href="#elementMarshalling">
   465      *      object reachable from {@code jaxbElement}).  See <a href="#elementMarshalling">
   466      *      Marshalling a JAXB element</a>.
   466      *      Marshalling a JAXB element</a>.
   467      * @throws IllegalArgumentException
   467      * @throws IllegalArgumentException
   468      *      If any of the method parameters are null
   468      *      If any of the method parameters are null
   469      */
   469      */
   470     public void marshal( Object jaxbElement, org.xml.sax.ContentHandler handler )
   470     public void marshal( Object jaxbElement, org.xml.sax.ContentHandler handler )
   508      * @throws JAXBException
   508      * @throws JAXBException
   509      *      If any unexpected problem occurs during the marshalling.
   509      *      If any unexpected problem occurs during the marshalling.
   510      * @throws MarshalException
   510      * @throws MarshalException
   511      *      If the {@link ValidationEventHandler ValidationEventHandler}
   511      *      If the {@link ValidationEventHandler ValidationEventHandler}
   512      *      returns false from its {@code handleEvent} method or the
   512      *      returns false from its {@code handleEvent} method or the
   513      *      {@code Marshaller} is unable to marshal {@code obj} (or any
   513      *      {@code Marshaller} is unable to marshal {@code jaxbElement} (or any
   514      *      object reachable from {@code obj}).  See <a href="#elementMarshalling">
   514      *      object reachable from {@code jaxbElement}).  See <a href="#elementMarshalling">
   515      *      Marshalling a JAXB element</a>.
   515      *      Marshalling a JAXB element</a>.
   516      * @throws IllegalArgumentException
   516      * @throws IllegalArgumentException
   517      *      If any of the method parameters are null
   517      *      If any of the method parameters are null
   518      * @since 1.6, JAXB 2.0
   518      * @since 1.6, JAXB 2.0
   519      */
   519      */
   532      * @throws JAXBException
   532      * @throws JAXBException
   533      *      If any unexpected problem occurs during the marshalling.
   533      *      If any unexpected problem occurs during the marshalling.
   534      * @throws MarshalException
   534      * @throws MarshalException
   535      *      If the {@link ValidationEventHandler ValidationEventHandler}
   535      *      If the {@link ValidationEventHandler ValidationEventHandler}
   536      *      returns false from its {@code handleEvent} method or the
   536      *      returns false from its {@code handleEvent} method or the
   537      *      {@code Marshaller} is unable to marshal {@code obj} (or any
   537      *      {@code Marshaller} is unable to marshal {@code jaxbElement} (or any
   538      *      object reachable from {@code obj}).  See <a href="#elementMarshalling">
   538      *      object reachable from {@code jaxbElement}).  See <a href="#elementMarshalling">
   539      *      Marshalling a JAXB element</a>.
   539      *      Marshalling a JAXB element</a>.
   540      * @throws IllegalArgumentException
   540      * @throws IllegalArgumentException
   541      *      If any of the method parameters are null
   541      *      If any of the method parameters are null
   542      * @since 1.6, JAXB 2.0
   542      * @since 1.6, JAXB 2.0
   543      */
   543      */