Examples of org.codehaus.stax2.XMLInputFactory2.configureForConvenience()

Method to call to make Reader created be as "convenient" to use as possible; ie try to avoid having to deal with some of things like segmented text chunks. This may incur some slight performance penalties, but should not affect XML conformance.

Regarding the default StAX property settings, implementations are suggested to do following:

Enable IS_COALESCING (text coalescing)
Enable IS_REPLACING_ENTITY_REFERENCES
Disable P_REPORT_PROLOG_WHITESPACE (StAX2); so that the application need not skip possible SPACE (and COMMENT, PROCESSING_INSTRUCTION) events.
Enable P_REPORT_ALL_TEXT_AS_CHARACTERS (StAX2)
Enable P_PRESERVE_LOCATION (StAX2)

All the other standard settings should be left as is.

In addition, implementations should set implementation-dependant settings appropriately as well.