org.opendaylight.yangtools.yang.data.codec.xml

Class XmlParserStream

java.lang.Object

org.opendaylight.yangtools.yang.data.codec.xml.XmlParserStream

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable

@Beta
 @NotThreadSafe
public final class XmlParserStream
extends Object
implements Closeable, Flushable

This class provides functionality for parsing an XML source containing YANG-modeled data. It disallows multiple instances of the same element except for leaf-list and list entries. It also expects that the YANG-modeled data in the XML source are wrapped in a root element.

Method Summary

Modifier and Type	Method and Description
void	close()
static XmlParserStream	create(NormalizedNodeStreamWriter writer, SchemaContext schemaContext) Deprecated. Use create(NormalizedNodeStreamWriter, SchemaContext, SchemaNode) instead.
static XmlParserStream	create(NormalizedNodeStreamWriter writer, SchemaContext schemaContext, SchemaNode parentNode) Utility method for use when caching XmlCodecFactory is not feasible.
static XmlParserStream	create(NormalizedNodeStreamWriter writer, XmlCodecFactory codecs, SchemaNode parentNode) Construct a new XmlParserStream.
void	flush()
XmlParserStream	parse(XMLStreamReader reader) This method parses the XML source and emits node events into a NormalizedNodeStreamWriter based on the YANG-modeled data contained in the XML source.

Methods inherited from class java.lang.Object

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

Method Detail

create

public static XmlParserStream create(NormalizedNodeStreamWriter writer,
                                     XmlCodecFactory codecs,
                                     SchemaNode parentNode)

Construct a new XmlParserStream.

Parameters:

writer - Output write

codecs - Shared codecs

parentNode - Parent root node

Returns:

A new stream instance

create

@Deprecated
public static XmlParserStream create(NormalizedNodeStreamWriter writer,
                                                 SchemaContext schemaContext)

Deprecated. Use create(NormalizedNodeStreamWriter, SchemaContext, SchemaNode) instead.

create

public static XmlParserStream create(NormalizedNodeStreamWriter writer,
                                     SchemaContext schemaContext,
                                     SchemaNode parentNode)

Utility method for use when caching XmlCodecFactory is not feasible. Users with high performance requirements should use create(NormalizedNodeStreamWriter, XmlCodecFactory, SchemaNode) instead and maintain a XmlCodecFactory to match the current SchemaContext.

parse

public XmlParserStream parse(XMLStreamReader reader)
                      throws XMLStreamException,
                             URISyntaxException,
                             IOException,
                             ParserConfigurationException,
                             SAXException

This method parses the XML source and emits node events into a NormalizedNodeStreamWriter based on the YANG-modeled data contained in the XML source.

Parameters:

reader - StAX reader which is to used to walk through the XML source

Returns:

instance of XmlParserStream

Throws:

XMLStreamException - if a well-formedness error or an unexpected processing condition occurs while parsing the XML

URISyntaxException - if the namespace URI of an XML element contains a syntax error

IOException - if an error occurs while parsing the value of an anyxml node

ParserConfigurationException - if an error occurs while parsing the value of an anyxml node

SAXException - if an error occurs while parsing the value of an anyxml node

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

flush

public void flush()
           throws IOException

Specified by:

flush in interface Flushable

Throws:

IOException