[DOXIA-711] Introduce SinkWrapper with factory

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 2.0.0, 2.0.0-M9
• Component/s: Core
• Assignee: Konrad Windszus
• Reporter: Konrad Windszus
• Created: 23/Dec/23 18:45
• Updated: 20/May/24 09:33
• Resolved: 24/Dec/23 09:49

Description

Similar to HttpServletRequestWrapper in Servlet API one should have a SinkWrapper helper for Doxia. That allows to easily implement some post/preprocessing and even modifying or skipping the underlying sink. All Sink wrappers and the original sink should form a pipeline.
Registering a SinkWrapper should optionally be done automatically (via JSR330 annotations) or manually.

Issue Links

• blocks: DOXIA-699 Xhtml5Parser may emit sectionX() without sectionX_() when using both <hX> and <section>
• blocks: DOXIA-722 Optionally create anchors for indexable entries (used in TOC macro)
• blocks: DOXIA-712 Add validation capability to Sink API
• breaks: DOXIA-724 Sink pipeline returned by AbstractParser.getWrappedSink(...) has wrong order
• links to: GitHub Pull Request #184