3. Security and Validation

validator

Can be used in:

serviceProxy, api, proxy, global, chainDef, for, stompProxy, if, registration, wsStompReassembler, internal, interceptor, chain, bean, transport and soapProxy

Syntax

<validator
  wsdl="location"?
  schema="location"?
  schematron="location"?
  jsonSchema="location"?
  failureHandler="handler"?
  skipFaults="[true,false]"? />

Sample

The following example shows how to validate requests and responses against the referenced WSDL and included Schemas.

<serviceProxy port="8080">
  <validator wsdl="http://www.predic8.com:8080/material/ArticleService?wsdl" />
</serviceProxy>

The following example shows how to validate XML content. The requests will be validated against the order.xsd Schema, while for responses the confirm.xsd schema will be used for validation.

<serviceProxy port="8080">
  <request>
	<validator schema="http://www.predic8.com/schemas/order.xsd" />
  </request>
  <response>
	<validator schema="http://www.predic8.com/schemas/confirm.xsd" />
  </response>
</serviceProxy>

The following example shows how to validate XML using a Schematron XML file.

<serviceProxy port="8080">
  <request>
	<validator
	  schema="examples/validation/schematron/car-schematron.xml"
	  failureHandler="log" />
  </request>
</serviceProxy>

Attributes

NameRequiredDefaultDescriptionExamples
schema false - The XSD Schema (URL or file) to validate against.
http://www.predic8.com/schemas/order.xsd
failureHandler false response
 If "response", the HTTP response will include a detailled error message. If "log", the response will be generic and the validation error will be logged.
log
wsdl false - The WSDL (URL or file) to validate against.
"http://predic8.com:8080/material/ArticleService?wsdl
schemaVersion false 2020-12
 The version of the Schema.
04, 05, 06, 07, 2019-09, 2020-12
jsonSchema false - The JSON Schema (URL or file) to validate against.
examples/validation/json-schema/schema2000.json
serviceName false - Optional name of a serivce element in a WSDL. If specified it will be checked if the SOAP element is possible for that service.
-
skipFaults false false
 Whether to skip validation for SOAP fault messages.
-
schematron false - The Schematron schema (URL or file) to validate against.
examples/validation/schematron/car-schematron.xml

The <validator> element must have exactly one of the {wsdl,schema,schematron,jsonSchema} attributes.

As a child of soapProxy, if no attributes are present, the soapProxy-parent's wsdl attribute is used.