QXmlStreamEntityResolver Class
La clase `QXmlStreamEntityResolver` proporciona un resolutor de entidades para un ` QXmlStreamReader`. Más información...
| Encabezado: | #include <QXmlStreamEntityResolver> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los miembros heredados
- QXmlStreamEntityResolver forma parte de las clases XML.
Nota: Todas las funciones de esta clase son reentrantes.
Funciones públicas
| QXmlStreamEntityResolver() | |
| virtual | ~QXmlStreamEntityResolver() |
| virtual QString | resolveUndeclaredEntity(const QString &name) |
Descripción detallada
Se utiliza para indicar a QXmlStreamReader cómo expandir las entidades que no son declared in the internal-set of the DTD.
Consideraciones de seguridad
Ciclos de las entidades
Debe tener cuidado de evitar que las entidades se resuelvan en ciclos, ya que QXmlStreamReader solo detecta y rechaza los ciclos en entities defined in the DTD, no en las entidades derivadas de una implementación de la interfaz QXmlStreamEntityResolver.
Esto es así por diseño: QXmlStreamReader delega la tarea a la implementación de un QXmlStreamEntityResolver concreto. En el caso de las asignaciones estáticas, como las definiciones de entidades XML para caracteres, esto queda garantizado de forma trivial, por lo que ejecutar algún tipo de seguimiento en segundo plano solo ralentizaría el proceso para todos.
La cosa se complica cuando se leen definiciones de entidad desde una entrada externa, incluidas fuentes no fiables. En este caso, tu implementación debe garantizar que las expansiones que utiliza como entrada no contengan ciclos. Se trata de una operación de grafo sencilla que puede implementarse en tiempo y espacio lineales y que puede realizarse por adelantado en el momento de la carga, por lo que no afecta al rendimiento de ` resolveUndeclaredEntity()`.
Límite de expansión de entidades
Por el momento, las entidades resueltas por esta clase no cuentan a efectos de QXmlStreamReader::entityExpansionLimit(). Esto podría cambiar en futuras versiones de Qt.
Por el momento, debes establecer tú mismo un límite máximo de expansión si lees definiciones de entidades procedentes de una fuente externa. Tras la detección de ciclos, el cálculo de la ruta más larga es una operación gráfica sencilla que puede implementarse en tiempo y espacio lineales y que puede realizarse por adelantado en el momento de la carga, por lo que tampoco afecta al rendimiento de ` resolveUndeclaredEntity()`.
Véase también QXmlStreamReader::setEntityResolver().
Documentación de la función miembro
[constexpr noexcept default] QXmlStreamEntityResolver::QXmlStreamEntityResolver()
Crea por defecto una instancia de ` QXmlStreamEntityResolver`.
[virtual noexcept] QXmlStreamEntityResolver::~QXmlStreamEntityResolver()
Elimina el resolutor de entidades.
[virtual] QString QXmlStreamEntityResolver::resolveUndeclaredEntity(const QString &name)
Reimplementa esta función para resolver la entidad no declarada name y devuelve su texto de sustitución. Si el resolutor de entidades desconoce la entidad, devuelve un null string: QString(). Esto provocará un error en QXmlStreamreader. Una cadena vacía, pero no nula, se considera una expansión válida de la entidad y no provocará ningún error.
La implementación predeterminada siempre devuelve QString().
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.