Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Toutes les fonctions  ·  Vues d'ensemble  · 

QXmlSchemaValidator Class Reference
[QtXmlPatterns module]

The QXmlSchemaValidator class validates XML instance documents against a W3C XML Schema. More...

 #include <QXmlSchemaValidator>

This class is not part of the Qt GUI Framework Edition.

Note: All functions in this class are reentrant.

This class was introduced in Qt 4.6.


Public Functions

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

Detailed Description

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";
     }

XML Schema Version

This class implements schema validation according to the XML Schema 1.0 specification.

See also QXmlSchema and XML Schema Validation Example.


Member Function Documentation

QXmlSchemaValidator::QXmlSchemaValidator ()

Constructs a schema validator. The schema used for validation must be referenced in the XML instance document via the xsi:schemaLocation or xsi:noNamespaceSchemaLocation attribute.

QXmlSchemaValidator::QXmlSchemaValidator ( const QXmlSchema & schema )

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 attribute.

QXmlSchemaValidator::~QXmlSchemaValidator ()

Destroys this QXmlSchemaValidator.

QAbstractMessageHandler * QXmlSchemaValidator::messageHandler () const

Returns the message handler that handles parsing and validation messages for this QXmlSchemaValidator.

See also setMessageHandler().

QXmlNamePool QXmlSchemaValidator::namePool () const

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

QNetworkAccessManager * QXmlSchemaValidator::networkAccessManager () const

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

See also setNetworkAccessManager().

QXmlSchema QXmlSchemaValidator::schema () const

Returns the schema that is used for validation.

See also setSchema().

void QXmlSchemaValidator::setMessageHandler ( QAbstractMessageHandler * handler )

Changes the message handler for this QXmlSchemaValidator to handler. The schema validator sends all parsing and validation messages to this message handler. QXmlSchemaValidator 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 QXmlSchemaValidator calls QAbstractMessageHandler::message(), the arguments are as follows:

message() argumentSemantics
QtMsgType typeOnly QtWarningMsg and QtFatalMsg are used. The former identifies a warning, while the latter identifies an error.
const QString & descriptionAn XHTML document which is the actual message. It is translated into the current language.
const QUrl &identifierIdentifies the error with a URI, where the fragment is the error code, and the rest of the URI is the error namespace.
const QSourceLocation & sourceLocationIdentifies where the error occurred.

See also messageHandler().

void QXmlSchemaValidator::setNetworkAccessManager ( QNetworkAccessManager * manager )

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

See also networkAccessManager().

void QXmlSchemaValidator::setSchema ( const QXmlSchema & schema )

Sets the 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 attribute.

See also schema().

void QXmlSchemaValidator::setUriResolver ( const QAbstractUriResolver * resolver )

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

See also uriResolver().

const QAbstractUriResolver * QXmlSchemaValidator::uriResolver () const

Returns the schema's URI resolver. If no URI resolver has been set, QtXmlPatterns 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 QtXmlPatterns 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.

See also setUriResolver().

bool QXmlSchemaValidator::validate ( const QUrl & source ) const

Validates the XML instance document read from source against the schema.

Returns true if the XML instance document is valid according to the schema, false otherwise.

Example:

     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";

bool QXmlSchemaValidator::validate ( QIODevice * source, const QUrl & documentUri = QUrl() ) const

Validates the XML instance document read from source with the given documentUri against the schema.

Returns true if the XML instance document is valid according to the schema, false otherwise.

Example:

     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";

bool QXmlSchemaValidator::validate ( const QByteArray & data, const QUrl & documentUri = QUrl() ) const

Validates the XML instance document read from data with the given documentUri against the schema.

Returns true if the XML instance document is valid according to the schema, false otherwise.

Example:

     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";

Publicité

Best Of

Actualités les plus lues

Semaine
Mois
Année
  1. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 103
  2. Pourquoi les programmeurs sont-ils moins payés que les gestionnaires de programmes ? Manquent-ils de pouvoir de négociation ? 56
  3. «Le projet de loi des droits du développeur» : quelles conditions doivent remplir les entreprises pour que le développeur puisse réussir ? 90
  4. Les développeurs détestent-ils les antivirus ? Un programmeur manifeste sa haine envers ces solutions de sécurité 31
  5. Qt Commercial : Digia organise un webinar gratuit le 27 mars sur la conception d'interfaces utilisateur et d'applications avec le framework 0
  6. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
  7. 2017 : un quinquennat pour une nouvelle version du C++ ? Possible, selon Herb Sutter 11
Page suivante
  1. Linus Torvalds : le "C++ est un langage horrible", en justifiant le choix du C pour le système de gestion de version Git 100
  2. Comment prendre en compte l'utilisateur dans vos applications ? Pour un développeur, « 90 % des utilisateurs sont des idiots » 231
  3. Quel est LE livre que tout développeur doit lire absolument ? Celui qui vous a le plus marqué et inspiré 96
  4. Apple cède et s'engage à payer des droits à Nokia, le conflit des brevets entre les deux firmes s'achève 158
  5. Nokia porte à nouveau plainte contre Apple pour violation de sept nouveaux brevets 158
  6. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 103
  7. Quel est le code dont vous êtes le plus fier ? Pourquoi l'avez-vous écrit ? Et pourquoi vous a-t-il donné autant de satisfaction ? 83
Page suivante

Le Qt Developer Network au hasard

Logo

Comment fermer une application

Le Qt Developer Network est un réseau de développeurs Qt anglophone, où ils peuvent partager leur expérience sur le framework. Lire l'article.

Communauté

Ressources

Liens utiles

Contact

  • Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).

Qt dans le magazine

Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 4.6-snapshot
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !
 
 
 
 
Partenaires

Hébergement Web