Schema Validation Filter in Mule

  Schema Validation Filter in Mule

The Schema Validation filter takes XML inputs and validates these against a referenced XSD schema.

Typically, you can place this filter before another message processor, such as a connector, to determine whether the incoming message or event should be handled or not, allowing the message to only continue on along the flow when the filter validations are met and the included XML is considered valid.

Minimum Configuration: The path to the XSD schema location.

The Schema Validation Filter uses the JAXP libraries to validate a message against a schema. You must provide the path, file name, and extension of the schema or schemas in the Schema Locations property.

Optionally, you can set Schema Language to the schema language to use. If not specified, the property defaults to XML Schema.

In the case you want to get an exception and/or call another flow when the validation fails, you could wrap the schema validation filter inside a message filter and then use "onUnaccepted" and "throwOnUnaccepted" configuration attributes to determinate the behavior.


Schema validation filter filters payload on the basis of schema.If input payload matches with referenced schema then only input will allow to pass.

Here in our example i have used xml input and xsd schema to filter the payload.If xml input matches with schema the only it will pass.



flow of schema validation filter :

schema validation filter configuration :


We need to give path of schema.I put schema.xsd in src/main/resources folder of project.





xsd schema :

<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="book">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="title" type="xs:string" />
        <xs:element name="author" type="xs:string" />
        <xs:element name="year" type="xs:unsignedShort" />
        <xs:element name="price" type="xs:decimal" />
      </xs:sequence>
      <xs:attribute name="category" type="xs:string" use="required" />
    </xs:complexType>
  </xs:element>
</xs:schema>

URL : http://localhost:8085/api/schemavalidate


Input :



Output :




XML project code :


<?xml version="1.0" encoding="UTF-8"?>
<mule xmlns:http="http://www.mulesoft.org/schema/mule/http" xmlns:mulexml="http://www.mulesoft.org/schema/mule/xml" xmlns="http://www.mulesoft.org/schema/mule/core" xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
xmlns:spring="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-current.xsd
http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/xml http://www.mulesoft.org/schema/mule/xml/current/mule-xml.xsd">
    <http:listener-config name="HTTP_Listener_Configuration" host="0.0.0.0" port="8085" basePath="/api" doc:name="HTTP Listener Configuration"/>
    <flow name="test_schemavalidationFlow">
        <http:listener config-ref="HTTP_Listener_Configuration" path="/schemavalidate" doc:name="HTTP"/>
        <mulexml:schema-validation-filter schemaLocations="schema.xsd" returnResult="true" doc:name="Schema Validation"/>
        <mulexml:dom-to-xml-transformer doc:name="DOM to XML"/>
    </flow>
</mule>