public interface IXMLBuilder
If a method of the builder throws an exception, the parsing is aborted and
IXMLParser.parse()
throws an
XMLException
which encasulates the original
exception.
IXMLParser
Modifier and Type | Method and Description |
---|---|
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.
|
void |
addPCData(Reader reader,
String systemID,
int lineNr)
This method is called when a PCDATA element is encountered.
|
void |
elementAttributesProcessed(String name,
String nsPrefix,
String nsURI)
This method is called when the attributes of an XML element have been
processed.
|
void |
endElement(String name,
String nsPrefix,
String nsURI)
This method is called when the end of an XML elemnt is encountered.
|
Object |
getResult()
Returns the result of the building process.
|
void |
newProcessingInstruction(String target,
Reader reader)
This method is called when a processing instruction is encountered.
|
void |
startBuilding(String systemID,
int lineNr)
This method is called before the parser starts processing its input.
|
void |
startElement(String name,
String nsPrefix,
String nsURI,
String systemID,
int lineNr)
This method is called when a new XML element is encountered.
|
void startBuilding(String systemID, int lineNr) throws Exception
systemID
- the system ID of the XML data source.lineNr
- the line on which the parsing starts.Exception
- If an exception occurred while processing the event.void newProcessingInstruction(String target, Reader reader) throws Exception
target
- the processing instruction target.reader
- the method can retrieve the parameter of the PI from this
reader. You may close the reader before reading all its
data and you cannot read too much data.Exception
- If an exception occurred while processing the event.void startElement(String name, String nsPrefix, String nsURI, String systemID, int lineNr) throws Exception
name
- the name of the element.nsPrefix
- the prefix used to identify the namespace. If no
namespace has been specified, this parameter is null.nsURI
- the URI associated with the namespace. If no
namespace has been specified, or no URI is
associated with nsPrefix, this parameter is null.systemID
- the system ID of the XML data source.lineNr
- the line in the source where the element starts.Exception
- If an exception occurred while processing the event.endElement(java.lang.String, java.lang.String, java.lang.String)
void addAttribute(String key, String nsPrefix, String nsURI, String value, String type) throws Exception
key
- the key (name) of the attribute.nsPrefix
- the prefix used to identify the namespace. If no
namespace has been specified, this parameter is null.nsURI
- the URI associated with the namespace. If no
namespace has been specified, or no URI is
associated with nsPrefix, this parameter is null.value
- the value of the attribute.type
- the type of the attribute. If no type is known,
"CDATA" is returned.Exception
- If an exception occurred while processing the event.void elementAttributesProcessed(String name, String nsPrefix, String nsURI) throws Exception
name
- the name of the element.nsPrefix
- the prefix used to identify the namespace. If no
namespace has been specified, this parameter is null.nsURI
- the URI associated with the namespace. If no
namespace has been specified, or no URI is
associated with nsPrefix, this parameter is null.Exception
- If an exception occurred while processing the event.startElement(java.lang.String, java.lang.String, java.lang.String, java.lang.String, int)
,
addAttribute(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String)
void endElement(String name, String nsPrefix, String nsURI) throws Exception
name
- the name of the element.nsPrefix
- the prefix used to identify the namespace. If no
namespace has been specified, this parameter is null.nsURI
- the URI associated with the namespace. If no
namespace has been specified, or no URI is
associated with nsPrefix, this parameter is null.Exception
- If an exception occurred while processing the event.startElement(java.lang.String, java.lang.String, java.lang.String, java.lang.String, int)
void addPCData(Reader reader, String systemID, int lineNr) throws Exception
reader
- the method can retrieve the data from this reader. You
may close the reader before reading all its data and you
cannot read too much data.systemID
- the system ID of the XML data source.lineNr
- the line in the source where the element starts.Exception
- If an exception occurred while processing the event.Object getResult() throws Exception
Exception
- If an exception occurred while processing the event.IXMLParser.parse()