Sophie

Sophie

distrib > Mageia > 7 > i586 > by-pkgid > b3bdfe6d859a3d6920ff2c44b38e9a6f > files > 1458

saxon-manual-9.4.0.9-2.mga7.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc (build 1.6.0_18) on Fri Dec 09 20:48:49 GMT 2011 -->
<TITLE>
com.saxonica.validate
</TITLE>

<META NAME="date" CONTENT="2011-12-09">

<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">

<SCRIPT type="text/javascript">
function windowTitle()
{
    if (location.href.indexOf('is-external=true') == -1) {
        parent.document.title="com.saxonica.validate";
    }
}
</SCRIPT>
<NOSCRIPT>
</NOSCRIPT>

</HEAD>

<BODY BGCOLOR="white" onload="windowTitle();">
<HR>


<!-- ========= START OF TOP NAVBAR ======= -->
<A NAME="navbar_top"><!-- --></A>
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <FONT CLASS="NavBarFont1">Class</FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../com/saxonica/update/package-summary.html"><B>PREV PACKAGE</B></A>&nbsp;
&nbsp;<A HREF="../../../com/saxonica/xsltextn/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html?com/saxonica/validate/package-summary.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="package-summary.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>


</FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_top"></A>
<!-- ========= END OF TOP NAVBAR ========= -->

<HR>
<H2>
Package com.saxonica.validate
</H2>
The validation package contains classes used to validate document instances against a schema.
<P>
<B>See:</B>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="#package_description"><B>Description</B></A>
<P>

<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Class Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/AbstractWatch.html" title="class in com.saxonica.validate">AbstractWatch</A></B></TD>
<TD>A Watch represents a class that is interested in looking at nodes for the purpose
 of evaluating uniqueness and key constraints.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/AllElementValidator.html" title="class in com.saxonica.validate">AllElementValidator</A></B></TD>
<TD>This class is validator used to check the content of an element whose complex type
 uses the "xs:all" construction in XML Schema.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/AnyTypeValidator.html" title="class in com.saxonica.validate">AnyTypeValidator</A></B></TD>
<TD>Validator to validate an element against the class xs:anyType</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/AssertionTreeBuilder.html" title="class in com.saxonica.validate">AssertionTreeBuilder</A></B></TD>
<TD>This class sits in the validation pipeline, ready (when requested) to build subtrees of the validated
 document for use in testing assertions against complex types.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/AttributeValidator.html" title="class in com.saxonica.validate">AttributeValidator</A></B></TD>
<TD>This class is an abstract superclass for all the receivers that do element content
 validation.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/Checker.html" title="class in com.saxonica.validate">Checker</A></B></TD>
<TD>A Checker is a Receiver used to check the content of elements and attributes, especially those
 that participate in uniqueness, key, and keyref constraints</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/ComplexContentValidator.html" title="class in com.saxonica.validate">ComplexContentValidator</A></B></TD>
<TD>This class is a filter that is used to validate the content of an element with a
 complex type.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/ConstraintChecker.html" title="class in com.saxonica.validate">ConstraintChecker</A></B></TD>
<TD>This class handles the checking of Schema-defined unique, key, and keyref
 constraints.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/ContentValidator.html" title="class in com.saxonica.validate">ContentValidator</A></B></TD>
<TD>This class is an abstract superclass for all the validators.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/DocumentValidator.html" title="class in com.saxonica.validate">DocumentValidator</A></B></TD>
<TD>DocumentValidator checks that a document is well-formed: specifically, that it contains a single element
 node child and no text node children.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/EmptyContentValidator.html" title="class in com.saxonica.validate">EmptyContentValidator</A></B></TD>
<TD>This class is a filter that is used to validate that an element has empty content.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/EntityValidator.html" title="class in com.saxonica.validate">EntityValidator</A></B></TD>
<TD>This class validates that elements and attributes of type ENTITY or ENTITIES have values are
 declared in the DOCTYPE declaration of the instance document as unparsed entities.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/FieldChecker.html" title="class in com.saxonica.validate">FieldChecker</A></B></TD>
<TD>A FieldChecker is instantiated when a field in an identity constraint is matched; it receives
 notification of all events until the end of the element (or attribute) that matched the selector.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/FieldWatch.html" title="class in com.saxonica.validate">FieldWatch</A></B></TD>
<TD>A FieldWatch is a class that is looking for nodes that match a field
 selector within a uniqueness or key constraint.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/IdValidator.html" title="class in com.saxonica.validate">IdValidator</A></B></TD>
<TD>This class validates that ID elements and attributes have unique values and that
 IDREF and IDREFS elements and attributes refer to an ID in the same document.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/IgnorableWhitespaceStripper.html" title="class in com.saxonica.validate">IgnorableWhitespaceStripper</A></B></TD>
<TD>The IgnorableWhitespaceStripper removes whitespace text nodes belonging to elements
 whose schema-defined type defines element-only content</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/InSituValidator.html" title="class in com.saxonica.validate">InSituValidator</A></B></TD>
<TD>This class performs in-situ validation of a tree represented in memory as a NodeInfo
 object.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/KeySelectorWatch.html" title="class in com.saxonica.validate">KeySelectorWatch</A></B></TD>
<TD>This class watches the selector for a key or unique constraint</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/LaxValidator.html" title="class in com.saxonica.validate">LaxValidator</A></B></TD>
<TD>This class performs lax validation on an element.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/RefSelectorWatch.html" title="class in com.saxonica.validate">RefSelectorWatch</A></B></TD>
<TD>This class watches the selector for a keyref constraint</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/SchemaAttributeTest.html" title="class in com.saxonica.validate">SchemaAttributeTest</A></B></TD>
<TD>A NodeTest of the form schema-attribute(attribute-name)</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/SchemaElementTest.html" title="class in com.saxonica.validate">SchemaElementTest</A></B></TD>
<TD>A NodeTest of the form schema-element(element-name)</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/SelectorWatch.html" title="class in com.saxonica.validate">SelectorWatch</A></B></TD>
<TD>A Watch represents a class that is interested in looking at nodes for the purpose
 of evaluating uniqueness and key constraints.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/SimpleContentValidator.html" title="class in com.saxonica.validate">SimpleContentValidator</A></B></TD>
<TD>This class is a filter that is used to validate that an element has simple content
 conforming to a given simple type.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/SkipValidator.html" title="class in com.saxonica.validate">SkipValidator</A></B></TD>
<TD>This class is a filter that passes all Receiver events through unchanged,
 except that it removes all type annotations from element and attribute nodes.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/StartTagBufferEE.html" title="class in com.saxonica.validate">StartTagBufferEE</A></B></TD>
<TD>This class handles attribute inheritance.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/StatisticsReporter.html" title="class in com.saxonica.validate">StatisticsReporter</A></B></TD>
<TD>Generates statistics relating to a validation episode</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/ValidatingFilter.html" title="class in com.saxonica.validate">ValidatingFilter</A></B></TD>
<TD>This class is used for a filter on the validation pipeline.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/ValidationStack.html" title="class in com.saxonica.validate">ValidationStack</A></B></TD>
<TD>This class manages the receivers that do element content
 validation.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/validate/XSIAttributeHandler.html" title="class in com.saxonica.validate">XSIAttributeHandler</A></B></TD>
<TD>This class processes attributes such as xsi:schemaLocation and xsi:type.</TD>
</TR>
</TABLE>
&nbsp;

<P>
<A NAME="package_description"><!-- --></A><H2>
Package com.saxonica.validate Description
</H2>

<P>
<p>The validation package contains classes used to validate document instances against a schema.</p>

    <p>This validation is all performed "on-the-fly", by a collection of classes that
    implement Saxon's (SAX-like) Receiver interface, which is notified of start/end element
    events, attributes, and text nodes, as they occur. A pipeline of such classes is
    used both while processing input documents and while writing output documents, and in
    both cases, validation classes can be added to the pipeline.</p>

    <p>Local validation of elements is controlled using the ValidationStack class, which
    manages a stack of validators for each element that is currently open. The most
    interesting of these is the ComplexContentValidator, which makes use of a finite
    state machine created by compiling a ComplexType in the schema. The finite state
    machine is represented by the AutomatonState object corresponding to the initial
    (entry) state of the machine.</p>

    <p>Global validation of uniqueness and referential constraints is controlled using the
    ConstraintChecker class. The maintains a set of Watch classes that are interested in
    elements matching particular (restricted) XPath expressions. The restricted XPath expression
    used in XML Schema (which is similar to, but not identical to, an XPath pattern) is
    represented by a Selection object. Implementations of the Watch class are used to
    handle the different kinds of constraint that a schema can specify.</p>

    <p>None of the classes in this package will normally be used directly by user
    applications.</p>
<P>

<P>
<DL>
</DL>
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <FONT CLASS="NavBarFont1">Class</FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../com/saxonica/update/package-summary.html"><B>PREV PACKAGE</B></A>&nbsp;
&nbsp;<A HREF="../../../com/saxonica/xsltextn/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html?com/saxonica/validate/package-summary.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="package-summary.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>


</FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
Copyright (c) 2004-2011 Saxonica Limited. All rights reserved.
</BODY>
</HTML>