Класс QXmlDefaultHandler

Класс QXmlDefaultHandler предоставляет реализацию по умолчанию для всех классов обработчиков XML. Подробнее...

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются реентерабельными.

Открытые функции

Переопределённые открытые функции

Подробное описание

Этот класс объединяет функции специализированных классов обработчиков, делая его удобной отправной точкой при реализации пользовательских обработчиков для подклассов QXmlReader, особенно QXmlSimpleReader. Виртуальные функции из каждого из базовых классов переопределяются в этом классе, обеспечивая разумное поведение по умолчанию для многих общих случаев. Подклассировав этот класс и переопределив эти функции, вы можете сосредоточиться на реализации частей обработчика, относящихся к вашему приложению.

Чтецу XML необходимо указать, какой обработчик использовать для различных событий во время разбора. Это означает, что, хотя QXmlDefaultHandler предоставляет реализации по умолчанию для функций, унаследованных от всех его базовых классов, мы по-прежнему можем использовать специализированные обработчики для определённых типов событий.

Например, QXmlDefaultHandler является подклассом как QXmlContentHandler, так и QXmlErrorHandler, поэтому, подклассировав его, мы можем использовать один и тот же обработчик для обеих следующих функций чтеца:

    xmlReader.setContentHandler(handler);
    xmlReader.setErrorHandler(handler);

Поскольку чтец сообщает обработчику об ошибках разбора, необходимо переопределить QXmlErrorHandler::fatalError(), если, например, мы хотим остановить разбор при возникновении такой ошибки:

bool Handler::fatalError (const QXmlParseException & exception)
{
    qWarning() << "Fatal error on line" << exception.lineNumber()
               << ", column" << exception.columnNumber() << ':'
               << exception.message();

    return false;
}

Вышеуказанная функция возвращает false, что указывает чтецу остановить разбор. Для продолжения использования того же чтеца необходимо создать новый экземпляр обработчика и настроить чтец на его использование описанным выше способом.

Полезно рассмотреть некоторые из функций, унаследованных QXmlDefaultHandler, и подумать, почему их можно переопределить в пользовательском обработчике. Пользовательские обработчики обычно переопределяют QXmlContentHandler::startDocument(), чтобы подготовить обработчик к новым данным. Элементы документа и текст внутри них можно обработать, переопределив QXmlContentHandler::startElement(), QXmlContentHandler::endElement() и QXmlContentHandler::characters(). Вы можете переопределить QXmlContentHandler::endDocument(), чтобы выполнить некоторую финализацию или проверку содержимого после полного прочтения документа.

См. также QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlEntityResolver, QXmlErrorHandler, QXmlLexicalHandler и Введение в SAX2.

Документация по функциям-членам

QXmlDefaultHandler::QXmlDefaultHandler()

Создаёт обработчик для использования с подклассами QXmlReader.

[virtual] QXmlDefaultHandler::~QXmlDefaultHandler()

Уничтожает обработчик.

[override virtual] bool QXmlDefaultHandler::attributeDecl(const QString &eName, const QString &aName, const QString &type, const QString &valueDefault, const QString &value)

Переопределяет: QXmlDeclHandler::attributeDecl(const QString &eName, const QString &aName, const QString &type, const QString &valueDefault, const QString &value).

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::characters(const QString &ch)

Переопределяет: QXmlContentHandler::characters(const QString &ch).

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::comment(const QString &ch)

Переопределяет: QXmlLexicalHandler::comment(const QString &ch).

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::endCDATA()

Переопределяет: QXmlLexicalHandler::endCDATA().

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::endDTD()

Переопределяет: QXmlLexicalHandler::endDTD().

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::endDocument()

Переопределяет: QXmlContentHandler::endDocument().

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::endElement(const QString &namespaceURI, const QString &localName, const QString &qName)

Переопределяет: QXmlContentHandler::endElement(const QString &namespaceURI, const QString &localName, const QString &qName).

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::endEntity(const QString &name)

Переопределяет: QXmlLexicalHandler::endEntity(const QString &name).

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::endPrefixMapping(const QString &prefix)

Переопределяет: QXmlContentHandler::endPrefixMapping(const QString &prefix).

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::error(const QXmlParseException &exception)

Переопределяет: QXmlErrorHandler::error(const QXmlParseException &exception).

Это переопределение ничего не делает.

[override virtual] QString QXmlDefaultHandler::errorString() const

Переопределяет: QXmlContentHandler::errorString() const.

Возвращает строку ошибки по умолчанию.

[override virtual] bool QXmlDefaultHandler::externalEntityDecl(const QString &name, const QString &publicId, const QString &systemId)

Переопределяет: QXmlDeclHandler::externalEntityDecl(const QString &name, const QString &publicId, const QString &systemId).

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::fatalError(const QXmlParseException &exception)

Переопределяет: QXmlErrorHandler::fatalError(const QXmlParseException &exception).

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::ignorableWhitespace(const QString &ch)

Переопределяет: QXmlContentHandler::ignorableWhitespace(const QString &ch).

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::internalEntityDecl(const QString &name, const QString &value)

Переопределяет: QXmlDeclHandler::internalEntityDecl(const QString &name, const QString &value).

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::notationDecl(const QString &name, const QString &publicId, const QString &systemId)

Переопределяет: QXmlDTDHandler::notationDecl(const QString &name, const QString &publicId, const QString &systemId).

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::processingInstruction(const QString &target, const QString &data)

Переопределяет: QXmlContentHandler::processingInstruction(const QString &target, const QString &data).

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::resolveEntity(const QString &publicId, const QString &systemId, QXmlInputSource *&ret)

Переопределяет: QXmlEntityResolver::resolveEntity(const QString &publicId, const QString &systemId, QXmlInputSource *&ret).

Устанавливает ret в nullptr, чтобы читатель использовал идентификатор системы, предоставленный в XML-документе.

[override virtual] void QXmlDefaultHandler::setDocumentLocator(QXmlLocator *locator)

Переопределяет: QXmlContentHandler::setDocumentLocator(QXmlLocator *locator).

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::skippedEntity(const QString &name)

Переопределяет: QXmlContentHandler::skippedEntity(const QString &name).

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::startCDATA()

Переопределяет: QXmlLexicalHandler::startCDATA().

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::startDTD(const QString &name, const QString &publicId, const QString &systemId)

Переопределяет: QXmlLexicalHandler::startDTD(const QString &name, const QString &publicId, const QString &systemId).

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::startDocument()

Переопределяет: QXmlContentHandler::startDocument().

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::startElement(const QString &namespaceURI, const QString &localName, const QString &qName, const QXmlAttributes &atts)

Переопределяет: QXmlContentHandler::startElement(const QString &namespaceURI, const QString &localName, const QString &qName, const QXmlAttributes &atts).

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::startEntity(const QString &name)

Переопределяет: QXmlLexicalHandler::startEntity(const QString &name).

Это переопределение ничего не делает.

[override virtual] bool QXmlDefaultHandler::startPrefixMapping(const QString &prefix, const QString &uri)

Реализует: QXmlContentHandler::startPrefixMapping(const QString &prefix, const QString &uri).

Эта реализация ничего не делает.

[override virtual] bool QXmlDefaultHandler::unparsedEntityDecl(const QString &name, const QString &publicId, const QString &systemId, const QString &notationName)

Реализует: QXmlDTDHandler::unparsedEntityDecl(const QString &name, const QString &publicId, const QString &systemId, const QString &notationName).

Эта реализация ничего не делает.

[override virtual] bool QXmlDefaultHandler::warning(const QXmlParseException &exception)

Реализует: QXmlErrorHandler::warning(const QXmlParseException &exception).

Эта реализация ничего не делает.