org.attoparser.markup
Interface IDetailedElementHandling

All Superinterfaces:
IAttributeSequenceHandling
All Known Implementing Classes:
AbstractDetailedMarkupAttoHandler, AbstractDetailedNonValidatingHtmlAttoHandler, AbstractDetailedXmlAttoHandler, AbstractStandardMarkupAttoHandler, AbstractStandardNonValidatingHtmlAttoHandler, AbstractStandardXmlAttoHandler, DOMXmlAttoHandler, DuplicatingDetailedMarkupAttoHandler, HtmlCodeDisplayAttoHandler, TextTracingDetailedHtmlAttoHandler, TextTracingDetailedMarkupAttoHandler, TextTracingStandardMarkupAttoHandler, TracingDetailedHtmlAttoHandler, TracingDetailedMarkupAttoHandler

public interface IDetailedElementHandling
extends IAttributeSequenceHandling

Handler feature interface to be implemented by IAttoHandler implementations that offer detailed reporting of elements (markup tags).

Since:
1.0
Author:
Daniel Fernández

Method Summary
 void handleAutoCloseElementEnd(int line, int col)
           Called for signaling the end of an auto-close element, created for balancing an unclosed tag.
 void handleAutoCloseElementStart(char[] buffer, int nameOffset, int nameLen, int line, int col)
           Called for signaling the start of an auto-close element (a synthetic close tag), created for balancing an unclosed tag.
 void handleCloseElementEnd(int line, int col)
           Called when the end of a close element (a close tag) is found.
 void handleCloseElementStart(char[] buffer, int nameOffset, int nameLen, int line, int col)
           Called when the start of a close element (a close tag) is found.
 void handleOpenElementEnd(int line, int col)
           Called when the end of an open element (an open tag) is found.
 void handleOpenElementStart(char[] buffer, int nameOffset, int nameLen, int line, int col)
           Called when an open element (an open tag) is found.
 void handleStandaloneElementEnd(int line, int col)
           Called when the end of a standalone element (a minimized tag) is found
 void handleStandaloneElementStart(char[] buffer, int nameOffset, int nameLen, int line, int col)
           Called when a standalone element (a minimized tag) is found.
 void handleUnmatchedCloseElementEnd(int line, int col)
           Called when the end of an unmatched close element (close tag) is found.
 void handleUnmatchedCloseElementStart(char[] buffer, int nameOffset, int nameLen, int line, int col)
           Called when the start of an unmatched close element (close tag) is found.
 
Methods inherited from interface org.attoparser.markup.IAttributeSequenceHandling
handleAttribute, handleInnerWhiteSpace
 

Method Detail

handleStandaloneElementStart

void handleStandaloneElementStart(char[] buffer,
                                  int nameOffset,
                                  int nameLen,
                                  int line,
                                  int col)
                                  throws AttoParseException

Called when a standalone element (a minimized tag) is found. The name of the element is also reported.

Artifacts are reported using the document buffer directly, and this buffer should not be considered to be immutable, so reported structures should be copied if they need to be stored (either by copying len chars from the buffer char[] starting in offset or by creating a String from it using the same specification).

Implementations of this handler should never modify the document buffer.

Parameters:
buffer - the document buffer (not copied)
nameOffset - the offset (position in buffer) where the element name appears.
nameLen - the length (in chars) of the element name.
line - the line in the original document where this artifact starts.
col - the column in the original document where this artifact starts.
Throws:
AttoParseException

handleStandaloneElementEnd

void handleStandaloneElementEnd(int line,
                                int col)
                                throws AttoParseException

Called when the end of a standalone element (a minimized tag) is found

Parameters:
line - the line in the original document where the element ending structure appears.
col - the column in the original document where the element ending structure appears.
Throws:
AttoParseException

handleOpenElementStart

void handleOpenElementStart(char[] buffer,
                            int nameOffset,
                            int nameLen,
                            int line,
                            int col)
                            throws AttoParseException

Called when an open element (an open tag) is found. The name of the element is also reported.

Artifacts are reported using the document buffer directly, and this buffer should not be considered to be immutable, so reported structures should be copied if they need to be stored (either by copying len chars from the buffer char[] starting in offset or by creating a String from it using the same specification).

Implementations of this handler should never modify the document buffer.

Parameters:
buffer - the document buffer (not copied)
nameOffset - the offset (position in buffer) where the element name appears.
nameLen - the length (in chars) of the element name.
line - the line in the original document where this artifact starts.
col - the column in the original document where this artifact starts.
Throws:
AttoParseException

handleOpenElementEnd

void handleOpenElementEnd(int line,
                          int col)
                          throws AttoParseException

Called when the end of an open element (an open tag) is found.

Parameters:
line - the line in the original document where the element ending structure appears.
col - the column in the original document where the element ending structure appears.
Throws:
AttoParseException

handleCloseElementStart

void handleCloseElementStart(char[] buffer,
                             int nameOffset,
                             int nameLen,
                             int line,
                             int col)
                             throws AttoParseException

Called when the start of a close element (a close tag) is found. The name of the element is also reported.

Artifacts are reported using the document buffer directly, and this buffer should not be considered to be immutable, so reported structures should be copied if they need to be stored (either by copying len chars from the buffer char[] starting in offset or by creating a String from it using the same specification).

Implementations of this handler should never modify the document buffer.

Parameters:
buffer - the document buffer (not copied)
nameOffset - the offset (position in buffer) where the element name appears.
nameLen - the length (in chars) of the element name.
line - the line in the original document where this artifact starts.
col - the column in the original document where this artifact starts.
Throws:
AttoParseException

handleCloseElementEnd

void handleCloseElementEnd(int line,
                           int col)
                           throws AttoParseException

Called when the end of a close element (a close tag) is found.

Parameters:
line - the line in the original document where the element ending structure appears.
col - the column in the original document where the element ending structure appears.
Throws:
AttoParseException

handleUnmatchedCloseElementStart

void handleUnmatchedCloseElementStart(char[] buffer,
                                      int nameOffset,
                                      int nameLen,
                                      int line,
                                      int col)
                                      throws AttoParseException

Called when the start of an unmatched close element (close tag) is found. The name of the element is also reported.

Artifacts are reported using the document buffer directly, and this buffer should not be considered to be immutable, so reported structures should be copied if they need to be stored (either by copying len chars from the buffer char[] starting in offset or by creating a String from it using the same specification).

Implementations of this handler should never modify the document buffer.

Parameters:
buffer - the document buffer (not copied)
nameOffset - the offset (position in buffer) where the element name appears.
nameLen - the length (in chars) of the element name.
line - the line in the original document where this artifact starts.
col - the column in the original document where this artifact starts.
Throws:
AttoParseException

handleUnmatchedCloseElementEnd

void handleUnmatchedCloseElementEnd(int line,
                                    int col)
                                    throws AttoParseException

Called when the end of an unmatched close element (close tag) is found.

Parameters:
line - the line in the original document where the element ending structure appears.
col - the column in the original document where the element ending structure appears.
Throws:
AttoParseException

handleAutoCloseElementStart

void handleAutoCloseElementStart(char[] buffer,
                                 int nameOffset,
                                 int nameLen,
                                 int line,
                                 int col)
                                 throws AttoParseException

Called for signaling the start of an auto-close element (a synthetic close tag), created for balancing an unclosed tag. The name of the element is also reported.

Artifacts are reported using the document buffer directly, and this buffer should not be considered to be immutable, so reported structures should be copied if they need to be stored (either by copying len chars from the buffer char[] starting in offset or by creating a String from it using the same specification).

Implementations of this handler should never modify the document buffer.

Parameters:
buffer - the document buffer (not copied)
nameOffset - the offset (position in buffer) where the element name appears.
nameLen - the length (in chars) of the element name.
line - the line in the original document where this artifact starts.
col - the column in the original document where this artifact starts.
Throws:
AttoParseException

handleAutoCloseElementEnd

void handleAutoCloseElementEnd(int line,
                               int col)
                               throws AttoParseException

Called for signaling the end of an auto-close element, created for balancing an unclosed tag.

Parameters:
line - the line in the original document where the element ending structure appears.
col - the column in the original document where the element ending structure appears.
Throws:
AttoParseException


Copyright © 2013 The ATTOPARSER team. All Rights Reserved.