QXmlSchema

The QXmlSchema class provides loading and validation of a W3C XML Schema. More…

New in version 4.6.

Synopsis

Functions

• def documentUri ()

• def isValid ()

• def load (data[, documentUri=QUrl()])

• def load (source)

• def load (source[, documentUri=QUrl()])

• def messageHandler ()

• def namePool ()

• def networkAccessManager ()

• def setMessageHandler (handler)

• def setNetworkAccessManager (networkmanager)

• def setUriResolver (resolver)

• def uriResolver ()

Detailed Description

The QXmlSchema class loads, compiles and validates W3C XML Schema files that can be used further for validation of XML instance documents via QXmlSchemaValidator .

The following example shows how to load a XML Schema file from the network and test whether it is a valid schema document:

QUrl url("http://www.schema-example.org/myschema.xsd");

QXmlSchema schema;
if (schema.load(url) == true)
    qDebug() << "schema is valid";
else
    qDebug() << "schema is invalid";

XML Schema Version

This class is used to represent schemas that conform to the XML Schema 1.0 specification.

See also

QXmlSchemaValidator XML Schema Validation Example

class PySide2.QtXmlPatterns.QXmlSchema

PySide2.QtXmlPatterns.QXmlSchema(other)

param other:

PySide2.QtXmlPatterns.QXmlSchema

Constructs an invalid, empty schema that cannot be used until load() is called.

Constructs a QXmlSchema that is a copy of other . The new instance will share resources with the existing schema to the extent possible.

PySide2.QtXmlPatterns.QXmlSchema.documentUri()

Return type:

PySide2.QtCore.QUrl

Returns the document URI of the schema or an empty URI if no schema has been set.

PySide2.QtXmlPatterns.QXmlSchema.isValid()

Return type:

bool

Returns true if this schema is valid. Examples of invalid schemas are ones that contain syntax errors or that do not conform the W3C XML Schema specification.

PySide2.QtXmlPatterns.QXmlSchema.load(source[, documentUri=QUrl()])

Parameters:

• source – PySide2.QtCore.QIODevice

• documentUri – PySide2.QtCore.QUrl

Return type:

bool

PySide2.QtXmlPatterns.QXmlSchema.load(data[, documentUri=QUrl()])

Parameters:

• data – PySide2.QtCore.QByteArray

• documentUri – PySide2.QtCore.QUrl

Return type:

bool

PySide2.QtXmlPatterns.QXmlSchema.load(source)

Parameters:

source – PySide2.QtCore.QUrl

Return type:

bool

Sets this QXmlSchema to a schema loaded from the source URI.

If the schema is invalid , false is returned and the behavior is undefined.

Example:

QUrl url("http://www.schema-example.org/myschema.xsd");

QXmlSchema schema;
if (schema.load(url) == true)
    qDebug() << "schema is valid";
else
    qDebug() << "schema is invalid";

See also

isValid()

PySide2.QtXmlPatterns.QXmlSchema.messageHandler()

Return type:

PySide2.QtXmlPatterns.QAbstractMessageHandler

Returns the message handler that handles compile and validation messages for this QXmlSchema .

See also

setMessageHandler()

PySide2.QtXmlPatterns.QXmlSchema.namePool()

Return type:

PySide2.QtXmlPatterns.QXmlNamePool

Returns the name pool used by this QXmlSchema for constructing names . There is no setter for the name pool, because mixing name pools causes errors due to name confusion.

PySide2.QtXmlPatterns.QXmlSchema.networkAccessManager()

Return type:

PySide2.QtNetwork.QNetworkAccessManager

Returns the network manager, or 0 if it has not been set.

See also

setNetworkAccessManager()

PySide2.QtXmlPatterns.QXmlSchema.setMessageHandler(handler)

Parameters:

handler – PySide2.QtXmlPatterns.QAbstractMessageHandler

Changes the message handler for this QXmlSchema to handler . The schema sends all compile and validation messages to this message handler. QXmlSchema does not take ownership of 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.

When QXmlSchema calls message() , the arguments are as follows:

message() argument	Semantics
QtMsgType type	Only 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.

See also

messageHandler()

PySide2.QtXmlPatterns.QXmlSchema.setNetworkAccessManager(networkmanager)

Parameters:

networkmanager – PySide2.QtNetwork.QNetworkAccessManager

Sets the network manager to manager . QXmlSchema does not take ownership of manager .

See also

networkAccessManager()

PySide2.QtXmlPatterns.QXmlSchema.setUriResolver(resolver)

Parameters:

resolver – PySide2.QtXmlPatterns.QAbstractUriResolver

Sets the URI resolver to resolver . QXmlSchema does not take ownership of resolver .

See also

uriResolver()

PySide2.QtXmlPatterns.QXmlSchema.uriResolver()

Return type:

PySide2.QtXmlPatterns.QAbstractUriResolver

Returns the schema’s URI resolver. If no URI resolver has been set, Qt XML Patterns will use the URIs in schemas 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 resolve() the absolute URI is the URI mandated by the schema specification, and the relative URI is the URI specified by the user.

See also

setUriResolver()