org.attoparser.markup.xml
Interface IDetailedXmlElementHandling

All Superinterfaces:

IAttributeSequenceHandling

All Known Implementing Classes:

AbstractDetailedXmlAttoHandler, AbstractStandardXmlAttoHandler, DOMXmlAttoHandler

public interface IDetailedXmlElementHandling
extends IAttributeSequenceHandling

Since:

1.1

Author:

Daniel Fernández

Method Summary

void	handleXmlCloseElementEnd(int line, int col) Called when the end of a close element (a close tag) is found.
void	handleXmlCloseElementStart(char[] buffer, int nameOffset, int nameLen, int line, int col) Called when a close element (a close tag) is found.
void	handleXmlOpenElementEnd(int line, int col) Called when the end of an open element (an open tag) is found.
void	handleXmlOpenElementStart(char[] buffer, int nameOffset, int nameLen, int line, int col) Called when an open element (an open tag) is found.
void	handleXmlStandaloneElementEnd(int line, int col) Called when the end of a standalone element (a minimized tag) is found.
void	handleXmlStandaloneElementStart(char[] buffer, int nameOffset, int nameLen, int line, int col) Called when a standalone element (a minimized tag) is found.

Methods inherited from interface org.attoparser.markup.IAttributeSequenceHandling

handleAttribute, handleInnerWhiteSpace

Method Detail

handleXmlStandaloneElementStart

void handleXmlStandaloneElementStart(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.

An example standalone element: <metainfo action-type="interop"/>

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

handleXmlStandaloneElementEnd

void handleXmlStandaloneElementEnd(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 this artifact starts.

col - the column in the original document where this artifact starts.

Throws:

AttoParseException

handleXmlOpenElementStart

void handleXmlOpenElementStart(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

handleXmlOpenElementEnd

void handleXmlOpenElementEnd(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 this artifact starts.

col - the column in the original document where this artifact starts.

Throws:

AttoParseException

handleXmlCloseElementStart

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

Called when 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

handleXmlCloseElementEnd

void handleXmlCloseElementEnd(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 this artifact starts.

col - the column in the original document where this artifact starts.

Throws:

AttoParseException