






















|
| |
Main Page Class Hierarchy Alphabetical List Compound List File List Compound Members File Members
XMLErrorReporter Class ReferenceThis abstract class defines a callback mechanism for the scanner.
More...
#include <XMLErrorReporter.hpp>
Inheritance diagram for XMLErrorReporter:
List of all members.Public Types
Public Methods
- virtual void error ( const unsigned int errCode , const XMLCh* const errDomain , const ErrTypes type , const XMLCh* const errorText , const XMLCh* const systemId , const XMLCh* const publicId , const unsigned int lineNum , const unsigned int colNum ) = 0
- Called to report errors from the scanner or validator. More...
- virtual void resetErrors () = 0
- Called before a new parse event to allow the handler to reset. More...
| |
Protected Methods
|
Detailed Description
This abstract class defines a callback mechanism for the scanner.
By
creating a class that implements this interface and plugging an instance
of that class into the scanner, the scanner will call back on the object's
virtual methods to report error events. This class is also used with the
validator, to allow it to report errors.
This class is primarily for use by those writing their own parser classes.
If you use the standard parser classes, DOMParser and SAXParser, you won't
use this API. You will instead use a similar mechanism defined by the SAX
API, called ErrorHandler.
Member Enumeration Documentation
enum XMLErrorReporter::ErrTypes |
|
Constructor & Destructor Documentation
XMLErrorReporter::~XMLErrorReporter () [virtual] |
|
XMLErrorReporter::XMLErrorReporter () [protected] |
|
Member Function Documentation
void XMLErrorReporter::error (
|
const unsigned int errCode, |
|
const XMLCh * const msgDomain, |
|
const ErrTypes type, |
|
const XMLCh * const errorText, |
|
const XMLCh * const systemId, |
|
const XMLCh * const publicId, |
|
const unsigned int lineNum, |
|
const unsigned int colNum) [pure virtual] |
|
Called to report errors from the scanner or validator.
This method is called back on by the scanner or validator (or any other
internal parser component which might need to report an error in the
future.) It contains all the information that the client code might
need to report or log the error.
-
Parameters:
-
errCode
|
The error code of the error being reported. What
this means is dependent on the domain it is from.
|
-
Parameters:
-
errDomain
|
The domain from which the error occured. The domain
is a means of providing a hierarchical layering to
the error system, so that a single set of error id
numbers don't have to be split up.
|
-
Parameters:
-
type
|
The error type, which is defined mostly by XML which
categorizes errors into warning, errors and validity
constraints.
|
-
Parameters:
-
errorText
|
The actual text of the error. This is translatable,
so can possibly be in the local language if a
translation has been provided.
|
-
Parameters:
-
sysetmId
|
The system id of the entity where the error occured,
fully qualified.
|
-
Parameters:
-
publicId
|
The optional public id of the entity were the error
occured. It can be an empty string if non was provided.
|
-
Parameters:
-
lineNum
|
The line number within the source XML of the error.
|
-
Parameters:
-
colNum
|
The column number within the source XML of the error.
Because of the parsing style, this is usually just
after the actual offending text.
|
void XMLErrorReporter::resetErrors () [pure virtual] |
|
Called before a new parse event to allow the handler to reset.
This method is called by the scanner before a new parse event is
about to start. It gives the error handler a chance to reset its
internal state.
Reimplemented in DOMParser, and SAXParser.
The documentation for this class was generated from the following file:
|
|