public interface TagHandler
TagHandlerProvider
according to tag/attribute matching rules and receive callbacks from
the HTMLContentHandler
while it is handling the SAX events.
Tag Handlers work in a chain of responsibility with each tag handler creating a new instance of a nested tag handler and delegating to it. Majority of the tag handlers don't have a standalone existence and work nested within other tag handlers. The tag handlers which are capable of working stand alone need to implement this interface.
Modifier and Type | Method and Description |
---|---|
void |
beginHandling(java.lang.String uri,
java.lang.String localName,
java.lang.String qName,
org.xml.sax.Attributes atts)
Callback to signal the start of handling giving the tag handler a chance for running intialization routines.
|
void |
characters(char[] ch,
int start,
int length)
Callback to signal the encounter of character content within tags.
|
void |
endElement(java.lang.String uri,
java.lang.String localName,
java.lang.String qName)
Callback to signal the encounter of a tag end.
|
void |
endHandling(java.lang.String uri,
java.lang.String localName,
java.lang.String qName)
Callback to signal the end of handling giving the tag handler a chance for finalizing things.
|
void |
setDesignImporterContext(DesignImporterContext designImporterContext)
Sets the design importer context
|
void |
setTagHandlerProvider(TagHandlerProvider tagHandlerProvider) |
void |
startElement(java.lang.String uri,
java.lang.String localName,
java.lang.String qName,
org.xml.sax.Attributes atts)
Callback to signal the encounter of a tag start.
|
void beginHandling(java.lang.String uri, java.lang.String localName, java.lang.String qName, org.xml.sax.Attributes atts) throws DesignImportException
TagHandler
s are registered against tag+attribute combination and are invoked by the HTMLContentHandler
as and when it
encounters a tag matching the tag attribute combination the tag handler is registered with.
uri
- localName
- qName
- atts
- DesignImportException
void characters(char[] ch, int start, int length) throws DesignImportException
ch
- start
- length
- org.xml.sax.SAXException
DesignImportException
void endElement(java.lang.String uri, java.lang.String localName, java.lang.String qName) throws DesignImportException
uri
- localName
- qName
- org.xml.sax.SAXException
DesignImportException
void endHandling(java.lang.String uri, java.lang.String localName, java.lang.String qName) throws DesignImportException
This is arguably the last callback a tag handler receives. After this, the current tag handler is popped out from the chain and the subsequent Tika events are directed to preceding tag handlers.
uri
- localName
- qName
- DesignImportException
void setDesignImporterContext(DesignImporterContext designImporterContext)
designImporterContext
- void setTagHandlerProvider(TagHandlerProvider tagHandlerProvider)
void startElement(java.lang.String uri, java.lang.String localName, java.lang.String qName, org.xml.sax.Attributes atts) throws DesignImportException
Once a tag handler begins handling, it receives the start tag events for all the nested tags within the purview of the tag this tag handler is registered against.
uri
- localName
- qName
- atts
- org.xml.sax.SAXException
DesignImportException
Copyright © 2010 - 2020 Adobe. All Rights Reserved