Package com.day.cq.wcm.designimporter.api

Interface TagHandler

All Known Implementing Classes:

AbstractTagHandler, CanvasComponentTagHandler, DefaultComponentTagHandler, DefaultTagHandler, HeadTagHandler, IFrameTagHandler, ImageComponentTagHandler, ImgTagHandler, InlineScriptTagHandler, LinkTagHandler, MetaTagHandler, NonScriptTagHandler, ParsysComponentTagHandler, ScriptTagHandler, StyleTagHandler, TextComponentTagHandler, TitleComponentTagHandler, TitleTagHandler

public interface TagHandler

Interface for handling HTML tags in the input HTML document. The tag handlers are registered with the 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.

Method Summary

Modifier and Type	Method	Description
void	beginHandling(String uri, String localName, String qName, 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(String uri, String localName, String qName)	Callback to signal the encounter of a tag end.
void	endHandling(String uri, String localName, 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(String uri, String localName, String qName, Attributes atts)	Callback to signal the encounter of a tag start.

Method Detail

beginHandling

void beginHandling(String uri,
                   String localName,
                   String qName,
                   Attributes atts)
            throws DesignImportException

Callback to signal the start of handling giving the tag handler a chance for running intialization routines.

TagHandlers 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.

Parameters:

uri -

localName -

qName -

atts -

Throws:

DesignImportException

characters

void characters(char[] ch,
                int start,
                int length)
         throws DesignImportException

Callback to signal the encounter of character content within tags.

Parameters:

ch -

start -

length -

Throws:

SAXException

DesignImportException

endElement

void endElement(String uri,
                String localName,
                String qName)
         throws DesignImportException

Callback to signal the encounter of a tag end.

Parameters:

uri -

localName -

qName -

Throws:

SAXException

DesignImportException

endHandling

void endHandling(String uri,
                 String localName,
                 String qName)
          throws DesignImportException

Callback to signal the end of handling giving the tag handler a chance for finalizing things.

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.

Parameters:

uri -

localName -

qName -

Throws:

DesignImportException

setDesignImporterContext

void setDesignImporterContext(DesignImporterContext designImporterContext)

Sets the design importer context

Parameters:

designImporterContext -

setTagHandlerProvider

void setTagHandlerProvider(TagHandlerProvider tagHandlerProvider)

startElement

void startElement(String uri,
                  String localName,
                  String qName,
                  Attributes atts)
           throws DesignImportException

Callback to signal the encounter of a tag start.

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.

Parameters:

uri -

localName -

qName -

atts -

Throws:

SAXException

DesignImportException