| java.lang.Object
 org.apache.xmlbeans.samples.validation.Validation
| Validation | | public class Validation (Code) | | A sample to illustrate two means for validating XML against schema
using features of the XMLBeans API. The features illustrated are:
- Validating after changes by using the XmlObject.validate method.
This method is exposed by types generated by compiling schema. The
validate method validates instances against all aspects of schema.
Also, with this method you can specify a Collection instance to
capture errors that occur during validation.
- Validating "on the fly" using the XmlOptions.VALIDATE_ON_SET constant.
This option prompts XMLBeans to validate XML against simple schema types
as you set them, rather than by expressly calling for validation.
You can set this option by calling XmlOptions.setValidateOnSet, then
specifying the XmlOptions instance as a parameter when creating
a new instance from schema or parsing an existing one.
Note that it is also possible to validate instances from the
command line by using tools you'll find in the bin directory of the
XMLBeans distribution.
|
| Method Summary | |
| public boolean | isValidAfterChanges(String xmlPath)
Illustrates use of the validate method by making changes to incoming
XML that invalidate the XML, then validating the instance and
printing resulting error messages.
Because this code is designed to generate invalid XML, it
returns false when successful.
Parameters:
xmlPath - A path to the XML instance file. | | public boolean | isValidOnTheFly(String xmlPath)
Illustrates the "validate on set" feature, which validates XML
for simple types on the fly. | | public static void | main(String[] args)
Receives a todo list XML instance, twice rendering it invalid
and validating it using the XMLBeans API. | | public XmlObject | parseXml(String xmlFilePath, XmlOptions validationOptions)
Creates a File from the XML path provided in main arguments, then
parses the file's contents into a type generated from schema.
Note that this work might have been done in main. | | public void | printErrors(ArrayList validationErrors)
Receives the collection containing errors found during
validation and print the errors to the console. |
| isValidAfterChanges | | public boolean isValidAfterChanges(String xmlPath)(Code) | | Illustrates use of the validate method by making changes to incoming
XML that invalidate the XML, then validating the instance and
printing resulting error messages.
Because this code is designed to generate invalid XML, it
returns false when successful.
Parameters:
xmlPath - A path to the XML instance file. true if the XML is valid after changes; otherwise, false. |
| isValidOnTheFly | | public boolean isValidOnTheFly(String xmlPath)(Code) | | Illustrates the "validate on set" feature, which validates XML
for simple types on the fly. As XML for those types is "set" through
accessors generated by compiling schema, XMLBeans checks the XML's
validity. The code here uses generated types to retrieve the first
- in a , then update the
- 's id attribute. The code
throws an exception when it tries to set an id attribute value that
is too high.
Because this code is designed to generate invalid XML, it
returns false when successful.
Parameters:
xmlPath - A path to the XML instance file. true if valid XML is successfully created; otherwise, false. |
| main | | public static void main(String[] args)(Code) | | Receives a todo list XML instance, twice rendering it invalid
and validating it using the XMLBeans API.
Parameters:
args - An array in which the first item is apath to the XML instance file. |
| parseXml | | public XmlObject parseXml(String xmlFilePath, XmlOptions validationOptions)(Code) | | Creates a File from the XML path provided in main arguments, then
parses the file's contents into a type generated from schema.
Note that this work might have been done in main. Isolating it here
makes the code separately available from outside this class.
Parameters:
xmlFilePath - A path to XML based on the schema in inventory.xsd. An instance of a generated schema type that contains the parsedXML. |
| printErrors | | public void printErrors(ArrayList validationErrors)(Code) | | Receives the collection containing errors found during
validation and print the errors to the console.
Parameters:
validationErrors - The validation errors. |
|
|