Sample: Validation
Author: Steven Traut (straut@bea.com)
Last Updated: May 25, 2005

Versions:
    xmlbeans-v1 1.0.3
    xmlbeans-v2

-----------------------------------------------------------------------------

This sample illustrates how you can use the XMLBeans API to validate
XML instances against schema. The API provides two validation features:

- A validate method (available from XmlOjbect and types generated from schema)
with which you can validate the bound instance and collect error messages that 
result.
- An option through which you can specify that simple schema types should
be validated by XMLBeans when your code sets their value. This feature
will simply throw an exception if setting the value renders the instance
invalid.

Because it uses invalid XML for illustration, this sample is designed to "fail"
when it runs. When you run this sample, you'll see it print two blocks of information
in the console:
- A message containing errors resulting from calling the validate method
on invalid XML.
- The stack trace of an exception resulting from setting an invalid value
when the XmlOptions.VALIDATE_ON_SET option has been specified.

Note that you can also validate at the command line using tools provided 
in the bin directory of the XMLBeans distribution.

To try out this sample:

1. Set XMLBEANS_HOME in your environment
2. Ant must be on your PATH
3. To compile the schemas and sample source, run "ant build"
4. To execute the sample, run "ant run"