The QXmlSchemaValidator class validates XML instance documents against a W3C XML Schema. 更多...
| 頭： | #include <QXmlSchemaValidator> |
| qmake: | QT += xmlpatterns |
| Since: | Qt 4.6 |
注意： 此類的所有函數 可重入 .
| QXmlSchemaValidator () | |
| QXmlSchemaValidator (const QXmlSchema & schema ) | |
| ~QXmlSchemaValidator () | |
| QAbstractMessageHandler * | messageHandler () const |
| QXmlNamePool | namePool () const |
| QNetworkAccessManager * | networkAccessManager () const |
| QXmlSchema | schema () const |
| void | setMessageHandler (QAbstractMessageHandler * handler ) |
| void | setNetworkAccessManager (QNetworkAccessManager * manager ) |
| void | setSchema (const QXmlSchema & schema ) |
| void | setUriResolver (const QAbstractUriResolver * resolver ) |
| const QAbstractUriResolver * | uriResolver () const |
| bool | validate (const QUrl & source ) const |
| bool | validate (QIODevice * source , const QUrl & documentUri = QUrl()) const |
| bool | validate (const QByteArray & data , const QUrl & documentUri = QUrl()) const |
The QXmlSchemaValidator class validates XML instance documents against a W3C XML Schema.
The QXmlSchemaValidator class loads, parses an XML instance document and validates it against a W3C XML Schema that has been compiled with QXmlSchema .
The following example shows how to load a XML Schema from a local file, check whether it is a valid schema document and use it for validation of an XML instance document:
QUrl schemaUrl("file:///home/user/schema.xsd");
QXmlSchema schema;
schema.load(schemaUrl);
if (schema.isValid()) {
QFile file("test.xml");
file.open(QIODevice::ReadOnly);
QXmlSchemaValidator validator(schema);
if (validator.validate(&file, QUrl::fromLocalFile(file.fileName())))
qDebug() << "instance document is valid";
else
qDebug() << "instance document is invalid";
}
This class implements schema validation according to the XML Schema 1.0 specification.
另請參閱 QXmlSchema and XML 模式驗證範例 .
Constructs a schema validator. The schema used for validation must be referenced in the XML instance document via the
xsi:schemaLocation
or
xsi:noNamespaceSchemaLocation
屬性。
Constructs a schema validator that will use
schema
for validation. If an empty
QXmlSchema
schema is passed to the validator, the schema used for validation must be referenced in the XML instance document via the
xsi:schemaLocation
or
xsi:noNamespaceSchemaLocation
屬性。
銷毀此 QXmlSchemaValidator .
Returns the message handler that handles parsing and validation messages for this QXmlSchemaValidator .
另請參閱 setMessageHandler ().
Returns the name pool used by this QXmlSchemaValidator for constructing 名稱 . There is no setter for the name pool, because mixing name pools causes errors due to name confusion.
Returns the network manager, or 0 if it has not been set.
另請參閱 setNetworkAccessManager ().
Returns the schema that is used for validation.
另請參閱 setSchema ().
改變 message handler 為此 QXmlSchemaValidator to handler . The schema validator sends all parsing and validation messages to this message handler. QXmlSchemaValidator 未擁有所有權對於 handler .
Normally, the default message handler is sufficient. It writes compile and validation messages to stderr . The default message handler includes color codes if stderr can render colors.
當 QXmlSchemaValidator calls QAbstractMessageHandler::message (), the arguments are as follows:
| message() argument | Semantics |
|---|---|
| QtMsgType type | 僅 QtWarningMsg and QtFatalMsg are used. The former identifies a warning, while the latter identifies an error. |
| const QString & description | An XHTML document which is the actual message. It is translated into the current language. |
| const QUrl &identifier | Identifies the error with a URI, where the fragment is the error code, and the rest of the URI is the error namespace. |
| const QSourceLocation & sourceLocation | Identifies where the error occurred. |
另請參閱 messageHandler ().
將網絡管理器設為 manager . QXmlSchemaValidator 未擁有所有權對於 manager .
另請參閱 networkAccessManager ().
設置
schema
that shall be used for further validation. If the schema is empty, the schema used for validation must be referenced in the XML instance document via the
xsi:schemaLocation
or
xsi:noNamespaceSchemaLocation
屬性。
另請參閱 schema ().
將 URI (統一資源標識符) 解析器設為 resolver . QXmlSchemaValidator 未擁有所有權對於 resolver .
另請參閱 uriResolver ().
Returns the schema's URI resolver. If no URI resolver has been set, Qt XML Patterns will use the URIs in instance documents as they are.
The URI resolver provides a level of abstraction, or polymorphic URIs . A resolver can rewrite logical URIs to physical ones, or it can translate obsolete or invalid URIs to valid ones.
When Qt XML Patterns calls QAbstractUriResolver::resolve () the absolute URI is the URI mandated by the schema specification, and the relative URI is the URI specified by the user.
另請參閱 setUriResolver ().
Validates the XML instance document read from source against the schema.
返迴
true
if the XML instance document is valid according to the schema,
false
否則。
範例：
const QXmlSchema schema = getSchema();
const QUrl url("http://www.schema-example.org/test.xml");
QXmlSchemaValidator validator(schema);
if (validator.validate(url))
qDebug() << "instance document is valid";
else
qDebug() << "instance document is invalid";
Validates the XML instance document read from source 采用給定 documentUri against the schema.
返迴
true
if the XML instance document is valid according to the schema,
false
否則。
範例：
const QXmlSchema schema = getSchema();
QFile file("test.xml");
file.open(QIODevice::ReadOnly);
QXmlSchemaValidator validator(schema);
if (validator.validate(&file, QUrl::fromLocalFile(file.fileName())))
qDebug() << "instance document is valid";
else
qDebug() << "instance document is invalid";
Validates the XML instance document read from data 采用給定 documentUri against the schema.
返迴
true
if the XML instance document is valid according to the schema,
false
否則。
範例：
const QXmlSchema schema = getSchema();
QByteArray data("<?xml version=\"1.0\" encoding=\"UTF-8\"?>"
"<test></test>");
QBuffer buffer(&data);
buffer.open(QIODevice::ReadOnly);
QXmlSchemaValidator validator(schema);
if (validator.validate(&buffer))
qDebug() << "instance document is valid";
else
qDebug() << "instance document is invalid";