com.inet.report.parser
Interface NodeParser

All Known Subinterfaces:

DynamicValueProvider

All Known Implementing Classes:

AbstractFontElement, AbstractLineElement, AbstractPictureElement, AbstractValueElement, Area, Box, BySummaryOrder, CascadingValueProvider, Chart2, CrossTab, CrossTabCell, CrossTabColumn, CrossTabDescriptionSection, CrossTabRow, DatabaseField, DatabasePicture, Element, Engine, Field, FieldElement, FieldPart, FieldValueProvider, FormulaField, Group, GroupField, JavaBean, Join, Line, Paragraph, Picture, PromptField, QueryValueProvider, Region, ReportComponent, ReportProperties, SQLField, SQLValueProvider, Section, SignatureForm, SortField, SpecialField, SpecifiedOrder, Subreport, SubreportLink, SummaryField, TableSource, Text, TextPart

public interface NodeParser

Interface for report components which are to be able to parse XML nodes. This interface is only for internal use of i-net Clear Reports.

Method Summary

boolean	isDOMParser() Internal method for reading report XML Returns whether this node is to be read via a DOM parser.
void	parseDOM(org.w3c.dom.Node node, java.util.Map parserMap) Internal method for reading report XML Parses the node.
NodeParser	parseElement(com.inet.report.parser.XMLTag group, java.lang.String tag, org.xml.sax.Attributes atts, java.util.Map parserMap) Internal method for reading report XML Parses an XML node with the given information, and returns either a sub-element which was created as a result, or null if no sub-element was created, i.e. the information was applied to the ReportComponent itself.
void	parseEndElement(com.inet.report.parser.XMLTag group, java.lang.String tag, java.util.Map parserMap) Internal method for reading report XML Receive notification of the end of an XML tag.
void	parseText(java.lang.String text, java.util.Map parserMap) Internal method for reading report XML This method is called if text was encountered in the context of this node.

Method Detail

parseElement

NodeParser parseElement(com.inet.report.parser.XMLTag group,
                        java.lang.String tag,
                        org.xml.sax.Attributes atts,
                        java.util.Map parserMap)
                        throws FatalParserException

Internal method for reading report XML

Parses an XML node with the given information, and returns either a sub-element which was created as a result, or null if no sub-element was created, i.e. the information was applied to the ReportComponent itself. Note that the parsing is highly tolerant, i.e. exceptions are intercepted and suppressed if at all possible.

Parameters:

group - XMLTag of the current node to be parsed, or null if there is no such current group. An XMLTag is a group of nodes bundled together, usually it is a Properties node such as CommonProperties, BorderProperties, etc.

tag - The XMLTag to be parsed

atts - The set of attributes in the current XMLTag

parserMap - The map of current Parser.

Returns:

The NodeParser sub-element if one needed to be created, or null if none was created.

Throws:

FatalParserException - if an exception occurs which causes the report to not be able to be read: causes the abortion of the reading of the report.

parseText

void parseText(java.lang.String text,
               java.util.Map parserMap)

Internal method for reading report XML

This method is called if text was encountered in the context of this node. (Examples would be a formula's text or a text element's text)

Parameters:

text - text encountered and to be stored

parserMap - The map of current Parser.

parseEndElement

void parseEndElement(com.inet.report.parser.XMLTag group,
                     java.lang.String tag,
                     java.util.Map parserMap)
                     throws FatalParserException

Internal method for reading report XML

Receive notification of the end of an XML tag.

Parameters:

group - XMLTag of the current node to be parsed, or null if there is no such current group.

tag - The XMLTag to be parsed

parserMap - The map of current Parser.

Throws:

FatalParserException - if an exception occurs which causes the report to not be able to be read: causes the abortion of the reading of the report.

isDOMParser

boolean isDOMParser()

Internal method for reading report XML

Returns whether this node is to be read via a DOM parser.

Returns:

true if this node is to be read via a DOM parser, false otherwise.

Since:

8.0

parseDOM

void parseDOM(org.w3c.dom.Node node,
              java.util.Map parserMap)
              throws FatalParserException

Internal method for reading report XML

Parses the node.

Parameters:

node - the node

parserMap - The map of current Parser.

Throws:

FatalParserException - if an exception occurs which causes the report to not be able to be read: causes the abortion of the reading of the report.