8. SOAP based Web Services

validator


Can be used in:

serviceProxy, api, stompProxy, swaggerProxy, if, registration, wsStompReassembler, interceptor, bean, internalProxy, 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

NameRequiredDefaultDescriptionExample
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
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.