Interface ISimpleMarkupParser

All Known Implementing Classes:
SimpleMarkupParser

public interface ISimpleMarkupParser

Interface to be implemented by all simple Markup Parsers. Default implementation is SimpleMarkupParser.

AttoParser simple markup parsers work as SAX-style parsers that need a markup handler object for handling parsing events. These handlers implement the ISimpleMarkupHandler interface, and are normally developed by users in order to perform the operations they require for their applications.

See the documentation of the ISimpleMarkupHandler interface for more information on the event handler methods.

Note that this parser interface and its corresponding handlers are actually a simplified version of the full-blown IMarkupParser infrastructure.

Sample usage:


   // Obtain a java.io.Reader on the document to be parsed
   final Reader documentReader = ...;

   // Create the handler instance. Extending the no-op AbstractSimpleMarkupHandler is a good start
   final ISimpleMarkupHandler handler = new AbstractSimpleMarkupHandler() {
       ... // some events implemented
   };

   // Create or obtain the parser instance (can be reused). Example uses the default configuration for HTML
   final ISimpleMarkupParser parser = new SimpleMarkupParser(ParseConfiguration.htmlConfiguration());

   // Parse it!
   parser.parse(documentReader, handler);
 

Note that implementations of this interface should be thread-safe, and therefore parsers should be reusable through several parsing operations and any number of concurrent threads.

Since:
2.0.0