This package provides SAX Tree: a tree model optimized for creation from SAX events and replay as SAX events.

Design Principles

1. Preserve information exposed through ContentHandler, LexicalHandler and Locator.
2. Creation from SAX events or as part of the parse of a conforming HTML5 document should be fast.
3. Emitting SAX events based on the tree should be fast.
4. Mutations should be possible but should not make the above "fast" cases slower.
5. Concurrent reads should work without locking when there are no concurrent mutations.
6. The user of the API has the responsibility of using the API properly: for the sake of performance, the model does not check if it is being used properly. Improper use may, therefore, put the model in and inconsistent state.