Author: mukulg
Date: Fri Apr 12 06:32:27 2013
New Revision: 1467171
URL: http://svn.apache.org/r1467171
Log:
committing few minor improvements to xerces xsd 1.1 docs
Modified:
xerces/java/branches/xml-schema-1.1-dev/docs/faq-xs.xml
Modified: xerces/java/branches/xml-schema-1.1-dev/docs/faq-xs.xml
URL:
http://svn.apache.org/viewvc/xerces/java/branches/xml-schema-1.1-dev/docs/faq-xs.xml?rev=1467171&r1=1467170&r2=1467171&view=diff
==============================================================================
--- xerces/java/branches/xml-schema-1.1-dev/docs/faq-xs.xml (original)
+++ xerces/java/branches/xml-schema-1.1-dev/docs/faq-xs.xml Fri Apr 12 06:32:27
2013
@@ -90,7 +90,7 @@ v.validate(instanceDocument);
</a>
</faq>
<faq title="XPath 2.0 support for XML Schema 1.1 validation">
- <q>How Xerces-J uses an XPath 2.0 engine for XML Schema 1.1 assertions
and CTAs?</q>
+ <q>How an XPath 2.0 engine is used for XML Schema 1.1 assertions and
CTAs?</q>
<a>
<p>XML Schema 1.1 assertions and CTAs require an XPath processor
during evaluation. For XSD 1.1 assertions,
full <jump href="http://www.w3.org/TR/xpath20/";>XPath 2.0</jump>
support is required. For XSD 1.1 CTAs the XSD schema engines can
@@ -102,33 +102,26 @@ v.validate(instanceDocument);
(for XSD 1.1 assertions, and optionally for CTAs), Xerces-J uses the
<jump
href="http://wiki.eclipse.org/PsychoPathXPathProcessor";>Eclipse/PsychoPath
XPath 2.0 engine</jump>.
Xerces-J does bundle along a PsychoPath XPath 2.0 jar (which
requires JDK 1.4 or later).
</p>
- <note>
- Users should be aware that more recent releases of the Eclipse
PsychoPath
- XPath engine may have better conformance to the W3C XPath 2.0
language than the PsychoPath XPath 2.0 jar that's bundled with Apache Xerces-J.
- Official builds of the PsychoPath XPath 2.0 jar are available for
download from the location, <jump
href="http://www.eclipse.org/webtools/";>Eclipse Web Tools Platform (WTP)
Project</jump> -
- The latest 'Released' or a 'Stable milestone' WTP version can be
downloaded from here (from which the PsychoPath XPath 2.0 jar can be extracted).
- The latest PsychoPath XPath 2.0 engine builds at Eclipse require a
minimum JDK level of 1.5.
- </note>
</a>
</faq>
<faq title="User defined error messages, for XML Schema 1.1 assertion
failures">
<q>How to specify a user defined error message, when an XML Schema 1.1
assertion returns a 'false' result?</q>
<a>
- <p>By default when an XSD 1.1 assertion fails, the Xerces XML Schema
validator would produce a default error message,
+ <p>When evaluation of an XSD 1.1 assertion fails the Xerces XML Schema
validator would produce a default error message,
which would say that which element or attribute was not validated
successfully by an assertion and the schema type involved
during validation. It is however possible to, specify an user-defined
error message for assertion failures. This is done by
- specifying an attribute <code>"message"</code> in the XML namespace
<code>'http://xerces.apache.org'</code> on an <code>xs:assert</code> or
<code>xs:assertion</code>
- element in the schema. The value of attribute <code>"message"</code>
is the text of user-defined assertion error message, which is produced by
- the Xerces XML Schema validator when an assertion fails.
+ specifying an attribute <code>"message"</code> in the XML namespace
<code>'http://xerces.apache.org'</code> on an
+ <code>xs:assert</code> or <code>xs:assertion</code> element in the
schema. In this case, the value of attribute <code>"message"</code>
+ is a text of user-defined assertion error message which is generated
by the Xerces XML Schema validator when an assertion fails.
</p>
<p>
- In case of use of the XML Schema <code>xs:assertion</code> facet
within simple types, if a user defined error message is used, if a user wants
- it is further possible to dynamically construct the assertion error
message by fetching the value of XPath 2.0 context variable
- <code>$value</code> into the assertion error message. Following is an
example of such an assertion error message:
- <code>xerces:message="The number {$value} is not divisible by
2"</code>. With such a specification of assertion error message,
- a value from XML instance document is assigned to a variable
placeholder <code>{$value}</code> (which is a key word). Therefore at
- runtime, an assertion message for this example would be produced as
follows, <code>"The number 3 is not divisible by 2"</code>
- (the value 3 was assigned to the variable reference
<code>{$value}</code>).
+ While using <code>xs:assertion</code> facet within simple types, if a
user defined error message is used, a user may
+ dynamically construct the assertion error message by getting the value
of XPath 2.0 context variable
+ <code>$value</code> into the error message. Following is an example of
such an assertion error message:
+ <code>xerces:message="The number {$value} is not divisible by
2"</code>. With such a description of assertion error message,
+ a value from XML instance document is assigned to a variable reference
<code>{$value}</code> which is a defined keyword.
+ During a validation failure, an error message for this example would
be produced as follows,
+ <code>"The number 3 is not divisible by 2"</code> (the variable
reference <code>{$value}</code> is assigned a value 3).
</p>
<note>
User-defined error messages for assertion failures are not a
standard feature of the XML Schema 1.1 specification, and
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@xerces.apache.org
For additional commands, e-mail: commits-h...@xerces.apache.org
