| net.n3.nanoxml.IXMLBuilder
All known Subclasses: net.n3.nanoxml.StdXMLBuilder, net.n3.nanoxml.sax.SAXAdapter,
| IXMLBuilder | | public interface IXMLBuilder (Code) | | NanoXML uses IXMLBuilder to construct the XML data structure it retrieved
from its data source. You can supply your own builder or you can use the
default builder of NanoXML.
If a method of the builder throws an exception, the parsing is aborted and
net.n3.nanoxml.IXMLParser.parse throws an
net.n3.nanoxml.XMLException which encasulates the original
exception.
See Also: net.n3.nanoxml.IXMLParser
author:
Marc De Scheemaecker
version:
$Name: RELEASE_2_2_1 $, $Revision: 1.3 $ |
| Method Summary | |
| public void | addAttribute(String key, String nsPrefix, String nsURI, String value, String type)
This method is called when a new attribute of an XML element is
encountered.
Parameters:
key - the key (name) of the attribute.
Parameters:
nsPrefix - the prefix used to identify the namespace. | | public void | addPCData(Reader reader, String systemID, int lineNr)
This method is called when a PCDATA element is encountered. | | public void | elementAttributesProcessed(String name, String nsPrefix, String nsURI)
This method is called when the attributes of an XML element have been
processed.
See Also: IXMLBuilder.startElement
See Also: IXMLBuilder.addAttribute
Parameters:
name - the name of the element.
Parameters:
nsPrefix - the prefix used to identify the namespace. | | public void | endElement(String name, String nsPrefix, String nsURI)
This method is called when the end of an XML elemnt is encountered.
See Also: IXMLBuilder.startElement
Parameters:
name - the name of the element.
Parameters:
nsPrefix - the prefix used to identify the namespace. | | public Object | getResult()
Returns the result of the building process. | | public void | newProcessingInstruction(String target, Reader reader)
This method is called when a processing instruction is encountered.
A PI with a reserved target ("xml" with any case) is never reported.
Parameters:
target - the processing instruction target.
Parameters:
reader - the method can retrieve the parameter of the PI from thisreader. | | public void | startBuilding(String systemID, int lineNr)
This method is called before the parser starts processing its input. | | public void | startElement(String name, String nsPrefix, String nsURI, String systemID, int lineNr)
This method is called when a new XML element is encountered.
See Also: IXMLBuilder.endElement
Parameters:
name - the name of the element.
Parameters:
nsPrefix - the prefix used to identify the namespace. |
| addAttribute | | public void addAttribute(String key, String nsPrefix, String nsURI, String value, String type) throws Exception(Code) | | This method is called when a new attribute of an XML element is
encountered.
Parameters:
key - the key (name) of the attribute.
Parameters:
nsPrefix - the prefix used to identify the namespace. If nonamespace has been specified, this parameter is null.
Parameters:
nsURI - the URI associated with the namespace. If nonamespace has been specified, or no URI isassociated with nsPrefix, this parameter is null.
Parameters:
value - the value of the attribute.
Parameters:
type - the type of the attribute. If no type is known,"CDATA" is returned.
throws:
java.lang.Exception - If an exception occurred while processing the event. |
| addPCData | | public void addPCData(Reader reader, String systemID, int lineNr) throws Exception(Code) | | This method is called when a PCDATA element is encountered. A Java
reader is supplied from which you can read the data. The reader will
only read the data of the element. You don't need to check for
boundaries. If you don't read the full element, the rest of the data
is skipped. You also don't have to care about entities: they are
resolved by the parser.
Parameters:
reader - the method can retrieve the data from this reader. Youmay close the reader before reading all its data and youcannot read too much data.
Parameters:
systemID - the system ID of the XML data source.
Parameters:
lineNr - the line in the source where the element starts.
throws:
java.lang.Exception - If an exception occurred while processing the event. |
| elementAttributesProcessed | | public void elementAttributesProcessed(String name, String nsPrefix, String nsURI) throws Exception(Code) | | This method is called when the attributes of an XML element have been
processed.
See Also: IXMLBuilder.startElement
See Also: IXMLBuilder.addAttribute
Parameters:
name - the name of the element.
Parameters:
nsPrefix - the prefix used to identify the namespace. If nonamespace has been specified, this parameter is null.
Parameters:
nsURI - the URI associated with the namespace. If nonamespace has been specified, or no URI isassociated with nsPrefix, this parameter is null.
throws:
java.lang.Exception - If an exception occurred while processing the event. |
| endElement | | public void endElement(String name, String nsPrefix, String nsURI) throws Exception(Code) | | This method is called when the end of an XML elemnt is encountered.
See Also: IXMLBuilder.startElement
Parameters:
name - the name of the element.
Parameters:
nsPrefix - the prefix used to identify the namespace. If nonamespace has been specified, this parameter is null.
Parameters:
nsURI - the URI associated with the namespace. If nonamespace has been specified, or no URI isassociated with nsPrefix, this parameter is null.
throws:
java.lang.Exception - If an exception occurred while processing the event. |
| newProcessingInstruction | | public void newProcessingInstruction(String target, Reader reader) throws Exception(Code) | | This method is called when a processing instruction is encountered.
A PI with a reserved target ("xml" with any case) is never reported.
Parameters:
target - the processing instruction target.
Parameters:
reader - the method can retrieve the parameter of the PI from thisreader. You may close the reader before reading all itsdata and you cannot read too much data.
throws:
java.lang.Exception - If an exception occurred while processing the event. |
| startBuilding | | public void startBuilding(String systemID, int lineNr) throws Exception(Code) | | This method is called before the parser starts processing its input.
Parameters:
systemID - the system ID of the XML data source.
Parameters:
lineNr - the line on which the parsing starts.
throws:
java.lang.Exception - If an exception occurred while processing the event. |
| startElement | | public void startElement(String name, String nsPrefix, String nsURI, String systemID, int lineNr) throws Exception(Code) | | This method is called when a new XML element is encountered.
See Also: IXMLBuilder.endElement
Parameters:
name - the name of the element.
Parameters:
nsPrefix - the prefix used to identify the namespace. If nonamespace has been specified, this parameter is null.
Parameters:
nsURI - the URI associated with the namespace. If nonamespace has been specified, or no URI isassociated with nsPrefix, this parameter is null.
Parameters:
systemID - the system ID of the XML data source.
Parameters:
lineNr - the line in the source where the element starts.
throws:
java.lang.Exception - If an exception occurred while processing the event. |
|
|