Module com.sun.xml.bind
Class UnmarshallerImpl
- java.lang.Object
-
- jakarta.xml.bind.helpers.AbstractUnmarshallerImpl
-
- org.glassfish.jaxb.runtime.v2.runtime.unmarshaller.UnmarshallerImpl
-
- All Implemented Interfaces:
jakarta.xml.bind.Unmarshaller,jakarta.xml.bind.ValidationEventHandler,Closeable,AutoCloseable
public final class UnmarshallerImpl extends jakarta.xml.bind.helpers.AbstractUnmarshallerImpl implements jakarta.xml.bind.ValidationEventHandler, Closeable
Default Unmarshaller implementation.This class can be extended by the generated code to provide type-safe unmarshall methods.
- Author:
- Kohsuke KAWAGUCHI
-
-
Field Summary
Fields Modifier and Type Field Description protected JAXBContextImplcontextOwningJAXBContextUnmarshallingContextcoordinatorstatic StringFACTORY
-
Constructor Summary
Constructors Constructor Description UnmarshallerImpl(JAXBContextImpl context, AssociationMap assoc)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description voidclose()Must be called from same thread which created the UnmarshallerImpl instance.jakarta.xml.bind.UnmarshalExceptioncreateUnmarshalException(SAXException e)XmlVisitorcreateUnmarshallerHandler(InfosetScanner scanner, boolean inplace, JaxBeanInfo expectedType)Creates and configures a new unmarshalling pipe line.protected voidfinalize()<A extends jakarta.xml.bind.annotation.adapters.XmlAdapter>
AgetAdapter(Class<A> type)jakarta.xml.bind.attachment.AttachmentUnmarshallergetAttachmentUnmarshaller()<T> JaxBeanInfo<T>getBeanInfo(Class<T> clazz)UnmarshallingContextgetContext()jakarta.xml.bind.ValidationEventHandlergetEventHandler()jakarta.xml.bind.Unmarshaller.ListenergetListener()ObjectgetProperty(String name)SchemagetSchema()jakarta.xml.bind.UnmarshallerHandlergetUnmarshallerHandler()protected XMLReadergetXMLReader()Obtains a configured XMLReader.booleanhandleEvent(jakarta.xml.bind.ValidationEvent event)Default error handling behavior forUnmarshaller.booleanhasEventHandler()Returns true if an event handler is installed.booleanisValidating()Deprecated.since 2.0static booleanneedsInterning(XMLReader reader)<A extends jakarta.xml.bind.annotation.adapters.XmlAdapter>
voidsetAdapter(Class<A> type, A adapter)voidsetAttachmentUnmarshaller(jakarta.xml.bind.attachment.AttachmentUnmarshaller au)voidsetListener(jakarta.xml.bind.Unmarshaller.Listener listener)voidsetProperty(String name, Object value)voidsetSchema(Schema schema)voidsetValidating(boolean validating)Deprecated.since 2.0Objectunmarshal(XMLEventReader reader)<T> jakarta.xml.bind.JAXBElement<T>unmarshal(XMLEventReader reader, Class<T> expectedType)Objectunmarshal(XMLStreamReader reader)<T> jakarta.xml.bind.JAXBElement<T>unmarshal(XMLStreamReader reader, Class<T> expectedType)Objectunmarshal(SAXSource source)Deprecated.<T> jakarta.xml.bind.JAXBElement<T>unmarshal(Source source, Class<T> expectedType)Objectunmarshal(Node node)<T> jakarta.xml.bind.JAXBElement<T>unmarshal(Node node, Class<T> expectedType)protected Objectunmarshal(XMLReader reader, InputSource source)protected <T> jakarta.xml.bind.JAXBElement<T>unmarshal(XMLReader reader, InputSource source, Class<T> expectedType)Objectunmarshal0(InputStream input, JaxBeanInfo expectedType)Objectunmarshal0(XMLStreamReader reader, JaxBeanInfo expectedType)Objectunmarshal0(Source source, JaxBeanInfo expectedType)Objectunmarshal0(Node node, JaxBeanInfo expectedType)
-
-
-
Field Detail
-
context
protected final JAXBContextImpl context
OwningJAXBContext
-
coordinator
public final UnmarshallingContext coordinator
-
FACTORY
public static final String FACTORY
- See Also:
- Constant Field Values
-
-
Constructor Detail
-
UnmarshallerImpl
public UnmarshallerImpl(JAXBContextImpl context, AssociationMap assoc)
-
-
Method Detail
-
getUnmarshallerHandler
public jakarta.xml.bind.UnmarshallerHandler getUnmarshallerHandler()
- Specified by:
getUnmarshallerHandlerin interfacejakarta.xml.bind.Unmarshaller
-
getXMLReader
protected XMLReader getXMLReader() throws jakarta.xml.bind.JAXBException
Obtains a configured XMLReader. This method is used when the client-specifiedSAXSourceobject doesn't have XMLReader.Unmarshalleris not re-entrant, so we will only use one instance of XMLReader. Overriden in order to fix potential security issue.- Overrides:
getXMLReaderin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl- Throws:
jakarta.xml.bind.JAXBException
-
createUnmarshallerHandler
public final XmlVisitor createUnmarshallerHandler(InfosetScanner scanner, boolean inplace, JaxBeanInfo expectedType)
Creates and configures a new unmarshalling pipe line. Depending on the setting, we put a validator as a filter.- Returns:
- A component that implements both
UnmarshallerHandlerandValidationEventHandler. All the parsing errors should be reported to this error handler for the unmarshalling process to work correctly. Also, returned handler expects all the XML names to be interned.
-
needsInterning
public static boolean needsInterning(XMLReader reader)
-
unmarshal
protected Object unmarshal(XMLReader reader, InputSource source) throws jakarta.xml.bind.JAXBException
- Specified by:
unmarshalin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl- Throws:
jakarta.xml.bind.JAXBException
-
unmarshal
protected <T> jakarta.xml.bind.JAXBElement<T> unmarshal(XMLReader reader, InputSource source, Class<T> expectedType) throws jakarta.xml.bind.JAXBException
- Throws:
jakarta.xml.bind.JAXBException
-
unmarshal
public <T> jakarta.xml.bind.JAXBElement<T> unmarshal(Source source, Class<T> expectedType) throws jakarta.xml.bind.JAXBException
- Specified by:
unmarshalin interfacejakarta.xml.bind.Unmarshaller- Overrides:
unmarshalin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl- Throws:
jakarta.xml.bind.JAXBException
-
unmarshal0
public Object unmarshal0(Source source, JaxBeanInfo expectedType) throws jakarta.xml.bind.JAXBException
- Throws:
jakarta.xml.bind.JAXBException
-
getEventHandler
public final jakarta.xml.bind.ValidationEventHandler getEventHandler()
- Specified by:
getEventHandlerin interfacejakarta.xml.bind.Unmarshaller- Overrides:
getEventHandlerin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl
-
hasEventHandler
public final boolean hasEventHandler()
Returns true if an event handler is installed.The default handler ignores any errors, and for that this method returns false.
-
unmarshal
public <T> jakarta.xml.bind.JAXBElement<T> unmarshal(Node node, Class<T> expectedType) throws jakarta.xml.bind.JAXBException
- Specified by:
unmarshalin interfacejakarta.xml.bind.Unmarshaller- Overrides:
unmarshalin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl- Throws:
jakarta.xml.bind.JAXBException
-
unmarshal
public final Object unmarshal(Node node) throws jakarta.xml.bind.JAXBException
- Specified by:
unmarshalin interfacejakarta.xml.bind.Unmarshaller- Throws:
jakarta.xml.bind.JAXBException
-
unmarshal
@Deprecated public final Object unmarshal(SAXSource source) throws jakarta.xml.bind.JAXBException
Deprecated.- Throws:
jakarta.xml.bind.JAXBException
-
unmarshal0
public final Object unmarshal0(Node node, JaxBeanInfo expectedType) throws jakarta.xml.bind.JAXBException
- Throws:
jakarta.xml.bind.JAXBException
-
unmarshal
public Object unmarshal(XMLStreamReader reader) throws jakarta.xml.bind.JAXBException
- Specified by:
unmarshalin interfacejakarta.xml.bind.Unmarshaller- Overrides:
unmarshalin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl- Throws:
jakarta.xml.bind.JAXBException
-
unmarshal
public <T> jakarta.xml.bind.JAXBElement<T> unmarshal(XMLStreamReader reader, Class<T> expectedType) throws jakarta.xml.bind.JAXBException
- Specified by:
unmarshalin interfacejakarta.xml.bind.Unmarshaller- Overrides:
unmarshalin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl- Throws:
jakarta.xml.bind.JAXBException
-
unmarshal0
public Object unmarshal0(XMLStreamReader reader, JaxBeanInfo expectedType) throws jakarta.xml.bind.JAXBException
- Throws:
jakarta.xml.bind.JAXBException
-
unmarshal
public <T> jakarta.xml.bind.JAXBElement<T> unmarshal(XMLEventReader reader, Class<T> expectedType) throws jakarta.xml.bind.JAXBException
- Specified by:
unmarshalin interfacejakarta.xml.bind.Unmarshaller- Overrides:
unmarshalin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl- Throws:
jakarta.xml.bind.JAXBException
-
unmarshal
public Object unmarshal(XMLEventReader reader) throws jakarta.xml.bind.JAXBException
- Specified by:
unmarshalin interfacejakarta.xml.bind.Unmarshaller- Overrides:
unmarshalin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl- Throws:
jakarta.xml.bind.JAXBException
-
unmarshal0
public Object unmarshal0(InputStream input, JaxBeanInfo expectedType) throws jakarta.xml.bind.JAXBException
- Throws:
jakarta.xml.bind.JAXBException
-
getProperty
public Object getProperty(String name) throws jakarta.xml.bind.PropertyException
- Specified by:
getPropertyin interfacejakarta.xml.bind.Unmarshaller- Overrides:
getPropertyin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl- Throws:
jakarta.xml.bind.PropertyException
-
setProperty
public void setProperty(String name, Object value) throws jakarta.xml.bind.PropertyException
- Specified by:
setPropertyin interfacejakarta.xml.bind.Unmarshaller- Overrides:
setPropertyin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl- Throws:
jakarta.xml.bind.PropertyException
-
setSchema
public void setSchema(Schema schema)
- Specified by:
setSchemain interfacejakarta.xml.bind.Unmarshaller- Overrides:
setSchemain classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl
-
getSchema
public Schema getSchema()
- Specified by:
getSchemain interfacejakarta.xml.bind.Unmarshaller- Overrides:
getSchemain classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl
-
getAttachmentUnmarshaller
public jakarta.xml.bind.attachment.AttachmentUnmarshaller getAttachmentUnmarshaller()
- Specified by:
getAttachmentUnmarshallerin interfacejakarta.xml.bind.Unmarshaller- Overrides:
getAttachmentUnmarshallerin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl
-
setAttachmentUnmarshaller
public void setAttachmentUnmarshaller(jakarta.xml.bind.attachment.AttachmentUnmarshaller au)
- Specified by:
setAttachmentUnmarshallerin interfacejakarta.xml.bind.Unmarshaller- Overrides:
setAttachmentUnmarshallerin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl
-
isValidating
public boolean isValidating()
Deprecated.since 2.0- Specified by:
isValidatingin interfacejakarta.xml.bind.Unmarshaller- Overrides:
isValidatingin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl
-
setValidating
public void setValidating(boolean validating)
Deprecated.since 2.0- Specified by:
setValidatingin interfacejakarta.xml.bind.Unmarshaller- Overrides:
setValidatingin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl
-
setAdapter
public <A extends jakarta.xml.bind.annotation.adapters.XmlAdapter> void setAdapter(Class<A> type, A adapter)
- Specified by:
setAdapterin interfacejakarta.xml.bind.Unmarshaller- Overrides:
setAdapterin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl
-
getAdapter
public <A extends jakarta.xml.bind.annotation.adapters.XmlAdapter> A getAdapter(Class<A> type)
- Specified by:
getAdapterin interfacejakarta.xml.bind.Unmarshaller- Overrides:
getAdapterin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl
-
createUnmarshalException
public jakarta.xml.bind.UnmarshalException createUnmarshalException(SAXException e)
- Overrides:
createUnmarshalExceptionin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl
-
handleEvent
public boolean handleEvent(jakarta.xml.bind.ValidationEvent event)
Default error handling behavior forUnmarshaller.- Specified by:
handleEventin interfacejakarta.xml.bind.ValidationEventHandler
-
getBeanInfo
public <T> JaxBeanInfo<T> getBeanInfo(Class<T> clazz) throws jakarta.xml.bind.JAXBException
- Throws:
jakarta.xml.bind.JAXBException
-
getListener
public jakarta.xml.bind.Unmarshaller.Listener getListener()
- Specified by:
getListenerin interfacejakarta.xml.bind.Unmarshaller- Overrides:
getListenerin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl
-
setListener
public void setListener(jakarta.xml.bind.Unmarshaller.Listener listener)
- Specified by:
setListenerin interfacejakarta.xml.bind.Unmarshaller- Overrides:
setListenerin classjakarta.xml.bind.helpers.AbstractUnmarshallerImpl
-
getContext
public UnmarshallingContext getContext()
-
finalize
protected void finalize() throws Throwable
-
close
public void close() throws IOExceptionMust be called from same thread which created the UnmarshallerImpl instance.- Specified by:
closein interfaceAutoCloseable- Specified by:
closein interfaceCloseable- Throws:
IOException
-
-