Validation Module

From BaseX Documentation
Jump to navigation Jump to search

This XQuery Module contains functions to perform validations against XML Schema and Document Type Declarations. This module has been introduced with Version 7.2.2.

All functions are preceded by the validate: prefix, which is linked to the statically declared http://basex.org/modules/validate namespace.

Functions

validate:xsd

Signatures validate:xsd($input as item()) as empty-sequence()
validate:xsd($input as item(), $schema as item()) as empty-sequence()
Summary Validates the document specified by $input.

Both $input and $schema may be

  • an xs:string, containing the path to the resource,
  • an xs:string, containing the resource in its string representation, or
  • a node(), containing the resource itself.

$schema can be used to specify the schema for validation. If no schema is given, $input is required to contain an xsi:(noNamespace)schemaLocation as defined in W3C XML Schema.

Exceptions Todo
Examples
  • validate:xsd('doc.xml', 'doc.xsd') validates the document doc.xm against the specified schema doc.xsd.
  • The following example demonstrates how a document can be validated against a schema without resorting to local or remote URIs:
let $doc := <simple:root xmlns:simple='http://basex.org/simple'/>
let $schema :=
  <xs:schema xmlns:xs='http://www.w3.org/2001/XMLSchema' targetNamespace='http://basex.org/simple'>
    <xs:element name='root'/>
  </xs:schema>
return validate:xsd($doc, $schema)

validate:dtd

Signatures validate:dtd($input as item()) as empty-sequence()
validate:dtd($input as item(), $dtd as xs:string) as empty-sequence()

Examples

Example 1: Basic validation against a document containing a schema definition

Query:

validate:xsd($doc)

Changelog

The module was introduced with Version 7.2.2.