39 lines
1.5 KiB
Plaintext
39 lines
1.5 KiB
Plaintext
|
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"
|