org.glassfish.hk2.xml.internal

Class DomXmlParser

java.lang.Object

org.glassfish.hk2.xml.internal.DomXmlParser

All Implemented Interfaces:

XmlServiceParser

@Singleton
@Visibility(value=LOCAL)
public class DomXmlParser
extends Object
implements XmlServiceParser

Author:

jwells

Field Summary

Fields inherited from interface org.glassfish.hk2.xml.spi.XmlServiceParser

DEFAULT_PARSING_SERVICE

Constructor Summary

Constructors

Constructor and Description
DomXmlParser()

Method Summary

Methods

Modifier and Type	Method and Description
PreGenerationRequirement	getPreGenerationRequirement() This tells the system whether or not it needs to pregenerate all proxies prior to parsing a document or if the proxies can be generated lazily
<T> void	marshall(OutputStream outputStream, XmlRootHandle<T> root) Marshalls this tree into the given stream.
<T> T	parseRoot(Model rootModel, URI location, Unmarshaller.Listener listener) This method must return an instance of the given class as the root of an XML graph

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DomXmlParser

public DomXmlParser()

Method Detail

parseRoot

public <T> T parseRoot(Model rootModel,
              URI location,
              Unmarshaller.Listener listener)
            throws Exception

Description copied from interface: XmlServiceParser

This method must return an instance of the given class as the root of an XML graph

Specified by:

parseRoot in interface XmlServiceParser

Parameters:

rootModel - The Model object of the root to be parsed

location - The location of the file to parse

listener - A listener that must be called via the contract of Unmarshaller.Listener

Returns:

The root object with all fields filled in from the given document

Throws:

Exception

getPreGenerationRequirement

public PreGenerationRequirement getPreGenerationRequirement()

Description copied from interface: XmlServiceParser

This tells the system whether or not it needs to pregenerate all proxies prior to parsing a document or if the proxies can be generated lazily

Specified by:

getPreGenerationRequirement in interface XmlServiceParser

Returns:

The value that indicates whether or not the proxies can be loaded lazily or must be pre-generated prior to parsing a document

marshall

public <T> void marshall(OutputStream outputStream,
                XmlRootHandle<T> root)
              throws IOException

Description copied from interface: XmlServiceParser

Marshalls this tree into the given stream. Will hold the WRITE lock of this tree while it does so that the tree cannot change underneath while it is being written out. It will use a basic indentation and new-line scheme

Specified by:

marshall in interface XmlServiceParser

Parameters:

outputStream - A non-closed output stream. This method will not close the output stream

root - The root of the tree to marshall

Throws:

IOException - On any exception that might happen