...
| Info |
|---|
|
In order to analyze or extract details from an XJDF Document it is recommended to work with XPath expressions. Parsing the whole document and working with the DOM Tree Objects is no longer state of the art. This mechanism consumes time and raises code complexity. Besides, parsing an InputStream is also prone to errors because it requires fully conform documents. CIP4 xJdfLib provides an extra class XJdfNavigator for dealing with XPath expressions in XJDF Documents. XJDF is desinged for XPath so the preferred way of reading XJDF Documents is XPath. |
XJdfValidator
The XJdfValidator class validates an XJDF Binary Stream against the latest XJDF Schema. A new instance is required for each validation process. So when validating an XJDF Document, first of all a new validator object has to be created. The method isValid() runs the validation process and finally returns the result as Boolean.
Out of the box all XJDF Documents created with the library are automatically being validated during the parsing process. This mechanism can be explicitly switched off. For more details about that see XJdfParser.
| Code Block |
|---|
|
// get binary stream
InputStream xJdfStream = [...]
// new instance of XJdfValidator
XJdfValidator xJdfValidator = new XJdfValidator(xJdfStream);
// get validation result
boolean result = xJdfValidator.isValid(); |
The validation procedure also can be done in a single line:
| Code Block |
|---|
|
// get binary stream
InputStream xJdfStream = [...]
// process validation in a single line
boolean result = new XJdfValidator(xJdfStream).isValid(); |
If a more detailed output is desired all errors are available as a list of Strings by calling the getMessages() method. In order to simplify user output (e. g. for the creation of exception messages) there is an additional method getMessagesText(), which converts all messages into a single String value.
| Code Block |
|---|
|
// get binary stream
InputStream xJdfStream = [...]
// validate
XJdfValidator xJdfValidator = XJdfValidator.newInstance(xJdfStream);
boolean result = xJdfValidator.isValid();
// message output
List<String> messages = xJdfValidator.getMessages();
String msgText = xJdfValidator.getMessagesText(); |