By default, JBoss JAX-WS Web services doesn’t validate SOAP requests for a valid xml or schema. This is by default in order to prevent performance overhead.
This may turn into a problem when developing the web service, since a required attribute in the schema may not be present in the request and the request will arrive to our service with no further notice. In many cases, this behavior is not a problem, you just need to consider in your web service that a null value may come for a required attribute.

So, Why validate?

    • Enforce schema

Sometimes it is good to enforce the schema validation when the request must comply with the schema, for example, when an attribute is required, or when the request must contain a list with exactly 2 elements but no more. Basically, when the request needs to comply with the xsd of the element. Validation in these cases is an aid for development, since the developer wouldn’t need to verify if the request has the required attributes.

    • Prevent default behavior

There are cases when the client can mispell a tag of the request, for example if the request has an attribute to filter the modification of a DB using a <filter> tag. If the client mispells the request and sends a <filters> tag instead of <filter> when no validation is enabled, the server will think that the client doesn’t need any filter (JBoss will set the filter variable to null), thus altering the behavior of the processing, updating all the rows in the DB without filtering, probably leading to disaster.

Validation in JBoss

In JBoss there is a simple way to enforce validation for the Web Service SOAP requests using the @SchemaValidation annotation. At the beginning, the use of the annotation seemed to be trivial, but after some unsuccessful attempts I found out that an extra effort was needed to get it going. This tutorial explains the simple steps needed to enable schema validation for JBoss and JAX-WS.

We start with a simple web service IMyWebService and the implementing class MyWebService, which has only one WebMethod getResponse, which receives one parameter param1. You can download the full project from here. It’s an eclipse Java project.
The parameter param1 is of class Param1 which has 2 fields:

private String param1Str;
private Integer param1Int;

After deploying the test project, using Soap UI to call the web service, we first import the wsdl from: http://localhost:8080/WSTest/WebService?wsdl
Calling the web service with the following message:

<soapenv:Envelope xmlns:soapenv="" xmlns:type="http://test/com/wsTest/ws/type">

We can see the following log in the server console (we are just printing out the input values):

19:17:24,824 INFO [STDOUT] 10
19:17:24,824 INFO [STDOUT] TestString

So far so good, but until now we didn’t add any requirements on the fields. Let’s make the param1Strattribute required by adding the following annotation in the Param1 class:

public String getParam1Str() {
 return param1Str;

After redeploying WSTest and running the test case again we’d expect the server to reject the message due to validation errors, but this isn’t the case. As discussed earlier, JBoss disables SOAP request validation by default.
In order to enable validation, we need to do the following steps:

  1. Create a schema file with the declared elements from the wsdl
  2. Enable @SchemaValidation pointing to the schema file

Let’s discuss these points

Create a schema file with the declared elements from the wsdl

First, we need to create a schema file containing the elements we are going to use in the web service request. This may seem a time consuming task, but following these steps it should become really easy.
Create an xsd file, for example: schema.xsd using the following skeleton

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0"
 xmlns:xs="" xmlns:ns1="<same_as_target_namespace_in_wsdl>">
 <!-- elements -->
 <xs:element name="param1" nillable="true" type="ns1:param1"/>
 <!-- types -->
 <xs:complexType name="param1">

1. Replace the values of with the namespace used for the definitions of the wsdl. To find this, you will need to point your browser to the published wsdl ( http://localhost:8080/WSTest/WebService?wsdl ), navigate through the imported wsdl until you find the type definitions. Use the targetNamespace of the elements defined. In this case: http://test/com/wsTest/ws/type

2. Copy the <element> tags into the schema file.
3. Copy the <complexType> tags into the schema file.
After this, the schema.xsd should look like this (containing the elements of param1 and result1, complexType for param1 and result1):

<xs:schema elementFormDefault="qualified" version="1.0"
 targetNamespace="http://test/com/wsTest/ws/type" xmlns:xs=""
   <!-- elements -->
   <xs:element name="param1" nillable="true" type="ns1:param1" />
   <xs:element name="result1" nillable="true" type="ns1:result1" />
   <!-- types -->
   <xs:complexType name="param1">
     <xs:element minOccurs="0" name="param1Int" type="xs:int" />
     <xs:element name="param1Str" type="xs:string" />
 <xs:complexType name="result1">
   <xs:sequence />

After creating the file, we need to put it in an accessible place for the application, for example META-INF/xsd/schema.xsd

Enable @SchemaValidation

We need to tell JBoss that it needs to validate the incoming requests for the web service we are publishing. In order to do this, we’ll simply add the following annotation in the implementing class of the web service, pointing to the schema file in the schemaLocation attribute.

@WebService(endpointInterface = "", serviceName = "MyWebService", name = "MyWebService", portName = "MyWebServicePort")
@SchemaValidation(enabled = true ,schemaLocation="META-INF/xsd/schema.xsd")
@SOAPBinding(parameterStyle = SOAPBinding.ParameterStyle.BARE)
public class MyWebService implements IMyWebService {

After deploying and running the application, JBoss will start logging messages saying that it is validating the request/responses

16:41:33,608 INFO [SOAPBodyElementDoc] Validating: XML_VALID
16:41:33,623 INFO [STDOUT] 10
16:41:33,623 INFO [STDOUT] TestString
16:41:33,623 INFO [SOAPBodyElementDoc] Validating: XML_VALID

Removing the param1Str from the Soap UI request:

<soapenv:Envelope xmlns:soapenv="" xmlns:type="http://test/com/wsTest/ws/type">

Issuing this request will lead to a validation error in JBoss:

16:48:11,052 INFO [SOAPBodyElementDoc] Validating: XML_VALID
16:48:11,052 ERROR [StrictlyValidErrorHandler] org.xml.sax.SAXParseException: cvc-complex-type.2.4.a: Invalid content was found starting with element 'param1Int'. One of '{"http://test/com/wsTest/ws/type":param1Int, "http://test/com/wsTest/ws/type":param1Str}' is expected.
16:48:11,068 ERROR [SOAPFaultHelperJAXWS] SOAP request exception org.xml.sax.SAXException: cvc-complex-type.2.4.a: Invalid content was found starting with element 'param1Int'. One of '{"http://test/com/wsTest/ws/type":param1Int, "http://test/com/wsTest/ws/type":param1Str}' is expected.

And the corresponding error response in Soap UI:

<env:Envelope xmlns:env="">
     <faultstring>org.xml.sax.SAXException: cvc-complex-type.2.4.a: Invalid content was found starting with element 'param1Int'. One of '{"http://test/com/wsTest/ws/type":param1Int, "http://test/com/wsTest/ws/type":param1Str}' is expected.</faultstring>

From this point, validating more complex requests shouldn’t be a difficult task. You can download the resulting source code from here. Open it as an Eclipse project or use the source code from your favorite IDE.

I hope this post makes your life easier enabling soap request validation for JBoss. Please let me know if this is your case or if you have any comments or difficulties.