Document and fix DOMSourceAnydata streaming 21/82321/2
authorRobert Varga <robert.varga@pantheon.tech>
Wed, 29 May 2019 23:50:00 +0000 (01:50 +0200)
committerRobert Varga <robert.varga@pantheon.tech>
Thu, 30 May 2019 08:58:23 +0000 (10:58 +0200)
commit03bcbdbc553d15ed53e88d1b5f40d2ca1e9398d0
tree772425edab5f055733813d83f2328518fbd630cd
parent12b2b83c5529c61ab1e5cf260f4ec6c01d809cef
Document and fix DOMSourceAnydata streaming

W3C DOM requires each document to have a single root element, and
we are using the anydata element as the container. This is required
because anydata (and anyxml) can hold a list, in which case we would
be faced with a document which has multiple root elements.

Document this fact and adjust streaming interfaces/handling to take
this into account.

JIRA: YANGTOOLS-993
Change-Id: Ifcc7777d60359c942b8f033307ab63295525ca1e
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>
yang/yang-data-codec-xml/src/main/java/org/opendaylight/yangtools/yang/data/codec/xml/DOMSourceAnydata.java
yang/yang-data-codec-xml/src/main/java/org/opendaylight/yangtools/yang/data/codec/xml/SchemaAwareXMLStreamNormalizedNodeStreamWriter.java
yang/yang-data-codec-xml/src/main/java/org/opendaylight/yangtools/yang/data/codec/xml/StreamWriterFacade.java
yang/yang-data-codec-xml/src/test/java/org/opendaylight/yangtools/yang/data/codec/xml/AbstractAnydataTest.java