Unmarshaller StAX API clarification

[Tomas-Kraus]

The new StAX APIs on javax.xml.bind.Unmarshaller need to specify that
START_DOCUMENT is a legal state for the XMLStreamReader or XMLEventReader
passed into the unmarshal() method.

The javadoc currently says that the methods throw IllegalStateException
for anything other than START_ELEMENT.

Environment

Operating System: All
Platform: All
URL: https://jsr222.dev.java.net/nonav/api/javax/xml/bind/Unmarshaller.html

Affected Versions

[2.0 v0.4]

[Tomas-Kraus]

@glassfishrobot Commented
Reported by ryan_shoemaker

[Tomas-Kraus]

@glassfishrobot Commented
Was assigned to ryan_shoemaker

[Tomas-Kraus]

@glassfishrobot Commented
ryan_shoemaker said:
Added link to javadoc and updated release info.

[Tomas-Kraus]

@glassfishrobot Commented
ryan_shoemaker said:
proposed changes have been integrated.

[Tomas-Kraus]

@glassfishrobot Commented
This issue was imported from java.net JIRA JSR222-33

[Tomas-Kraus]

• Issue Imported From: Unmarshaller StAX API clarification javaee/jaxb-spec#33
• Original Issue Raised By:@glassfishrobot
• Original Issue Assigned To: @glassfishrobot

[lukasj]

javadoc contains:

This method assumes that the parser is on a START_DOCUMENT or START_ELEMENT event.