src/share/jaxws_classes/javax/xml/bind/util/JAXBResult.java

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


  54  *
  55  *       // run transformation
  56  *       t.transform(new StreamSource("document.xml"),result);
  57  *
  58  *       // obtain the unmarshalled content tree
  59  *       Object o = result.getResult();
  60  *    </pre>
  61  * </blockquote>
  62  *
  63  * <p>
  64  * The fact that JAXBResult derives from SAXResult is an implementation
  65  * detail. Thus in general applications are strongly discouraged from
  66  * accessing methods defined on SAXResult.
  67  *
  68  * <p>
  69  * In particular it shall never attempt to call the setHandler,
  70  * setLexicalHandler, and setSystemId methods.
  71  *
  72  * @author
  73  *      Kohsuke Kawaguchi (kohsuke.kawaguchi@sun.com)

  74  */
  75 public class JAXBResult extends SAXResult {
  76 
  77     /**
  78      * Creates a new instance that uses the specified
  79      * JAXBContext to unmarshal.
  80      *
  81      * @param context The JAXBContext that will be used to create the
  82      * necessary Unmarshaller.  This parameter must not be null.
  83      * @exception JAXBException if an error is encountered while creating the
  84      * JAXBResult or if the context parameter is null.
  85      */
  86     public JAXBResult( JAXBContext context ) throws JAXBException {
  87         this( ( context == null ) ? assertionFailed() : context.createUnmarshaller() );
  88     }
  89 
  90     /**
  91      * Creates a new instance that uses the specified
  92      * Unmarshaller to unmarshal an object.
  93      *




  54  *
  55  *       // run transformation
  56  *       t.transform(new StreamSource("document.xml"),result);
  57  *
  58  *       // obtain the unmarshalled content tree
  59  *       Object o = result.getResult();
  60  *    </pre>
  61  * </blockquote>
  62  *
  63  * <p>
  64  * The fact that JAXBResult derives from SAXResult is an implementation
  65  * detail. Thus in general applications are strongly discouraged from
  66  * accessing methods defined on SAXResult.
  67  *
  68  * <p>
  69  * In particular it shall never attempt to call the setHandler,
  70  * setLexicalHandler, and setSystemId methods.
  71  *
  72  * @author
  73  *      Kohsuke Kawaguchi (kohsuke.kawaguchi@sun.com)
  74  * @since 1.6
  75  */
  76 public class JAXBResult extends SAXResult {
  77 
  78     /**
  79      * Creates a new instance that uses the specified
  80      * JAXBContext to unmarshal.
  81      *
  82      * @param context The JAXBContext that will be used to create the
  83      * necessary Unmarshaller.  This parameter must not be null.
  84      * @exception JAXBException if an error is encountered while creating the
  85      * JAXBResult or if the context parameter is null.
  86      */
  87     public JAXBResult( JAXBContext context ) throws JAXBException {
  88         this( ( context == null ) ? assertionFailed() : context.createUnmarshaller() );
  89     }
  90 
  91     /**
  92      * Creates a new instance that uses the specified
  93      * Unmarshaller to unmarshal an object.
  94      *