Package Summary  Overview Summary

class:UnmarshallerHandler [CHANGED]

  • All Superinterfaces:
    ContentHandler


    public interface UnmarshallerHandler
    extends ContentHandler
    
    Unmarshaller implemented as SAX ContentHandler.

    Applications can use this interface to use their JAXB provider as a component in an XML pipeline. For example:

           JAXBContext context = JAXBContext.newInstance( "org.acme.foo" );
    
           Unmarshaller unmarshaller = context.createUnmarshaller();
    
           UnmarshallerHandler unmarshallerHandler = unmarshaller.getUnmarshallerHandler();
    
           SAXParserFactory spf = SAXParserFactory.newInstance();
           spf.setNamespaceAware( true );
    
           XMLReader xmlReader = spf.newSAXParser().getXMLReader();
           xmlReader.setContentHandler( unmarshallerHandler );
           xmlReader.parse(new InputSource( new FileInputStream( XML_FILE ) ) );
    
           MyObject myObject= (MyObject)unmarshallerHandler.getResult();
     

    This interface is reusable: even if the user fails to unmarshal an object, s/he can still start a new round of unmarshalling.

    Since:
    JAXB11.6, JAXB 1.0
    See Also:
    Unmarshaller.getUnmarshallerHandler()
  • All Superinterfaces:
    ContentHandler


    public interface UnmarshallerHandler
    extends ContentHandler
    
    Unmarshaller implemented as SAX ContentHandler.

    Applications can use this interface to use their JAXB provider as a component in an XML pipeline. For example:

           JAXBContext context = JAXBContext.newInstance( "org.acme.foo" );
    
           Unmarshaller unmarshaller = context.createUnmarshaller();
    
           UnmarshallerHandler unmarshallerHandler = unmarshaller.getUnmarshallerHandler();
    
           SAXParserFactory spf = SAXParserFactory.newInstance();
           spf.setNamespaceAware( true );
    
           XMLReader xmlReader = spf.newSAXParser().getXMLReader();
           xmlReader.setContentHandler( unmarshallerHandler );
           xmlReader.parse(new InputSource( new FileInputStream( XML_FILE ) ) );
    
           MyObject myObject= (MyObject)unmarshallerHandler.getResult();
     

    This interface is reusable: even if the user fails to unmarshal an object, s/he can still start a new round of unmarshalling.

    Since:
    JAXB1.0
    See Also:
    Unmarshaller.getUnmarshallerHandler()
  • All Superinterfaces:
    ContentHandler


    public interface UnmarshallerHandler
    extends ContentHandler
    
    Unmarshaller implemented as SAX ContentHandler.

    Applications can use this interface to use their JAXB provider as a component in an XML pipeline. For example:

           JAXBContext context = JAXBContext.newInstance( "org.acme.foo" );
    
           Unmarshaller unmarshaller = context.createUnmarshaller();
    
           UnmarshallerHandler unmarshallerHandler = unmarshaller.getUnmarshallerHandler();
    
           SAXParserFactory spf = SAXParserFactory.newInstance();
           spf.setNamespaceAware( true );
    
           XMLReader xmlReader = spf.newSAXParser().getXMLReader();
           xmlReader.setContentHandler( unmarshallerHandler );
           xmlReader.parse(new InputSource( new FileInputStream( XML_FILE ) ) );
    
           MyObject myObject= (MyObject)unmarshallerHandler.getResult();
     

    This interface is reusable: even if the user fails to unmarshal an object, s/he can still start a new round of unmarshalling.

    Since:
    1.6, JAXB 1.0
    See Also:
    Unmarshaller.getUnmarshallerHandler()

method:getResult() [NONE]

  • getResult

    Object getResult()
              throws JAXBException,
                     IllegalStateException
    
    Obtains the unmarshalled result. This method can be called only after this handler receives the endDocument SAX event.
    Returns:
    always return a non-null valid object which was unmarshalled.
    Throws:
    IllegalStateException - if this method is called before this handler receives the endDocument event.
    JAXBException - if there is any unmarshalling error. Note that the implementation is allowed to throw SAXException during the parsing when it finds an error.

© 2017 Oracle Corporation and/or its affiliates