JAX-WS Exception Handling with TomEE and WebSphere Application Server 8.5

Let’s write a simple JAX-WS example which will throw an Exception. We will then deploy it in TomEE and then to WebSphere 8.5 and see the difference.

1. Download TomEE ( I have downloaded the plus version which at the time of writing was 1.7.1)
2. Download and install WebSphere Application Server (Developer version is free)
3. Download and install SoapUI

Once servers are downloaded and installed, open your eclipse and create a new “Dynamic Web Project”. Our project will have three Source Files namely:

1. EndPoint interface IMyService
2. Implementation class MyServiceImpl
3. Exception class MyException

I will not get into what these annotations are, rather you can visit any of the many available tutorials for a quick/detailed walk through.

First our interface IMyService.java

[sourcecode language=”java”]
package com.test.mumz.soap.soapexp;

import javax.jws.WebService;

/**
* The Interface IMyService.
*
* @author prabhat.jha
*/
@WebService(targetNamespace = "http://mprabhat.com/&quot😉
public interface IMyService {

/**
* Say hello.
*
* @param userName the user name
* @return the string
* @throws MyException the my exception if <code>username</code> is null or blank
*/
public String sayHello(String userName) throws MyException;
}
[/sourcecode]

Our interface is simple enough just has one method sayHello which accepts a String and if the parameter is null or empty will throw an instance of MyException

Next our Web Service implementation class.

[sourcecode language=”java”]
package com.test.mumz.soap.soapexp;

import java.util.Date;

import javax.ejb.Stateless;
import javax.jws.WebService;

/**
* The Class MyServiceImpl.
* @author prabhat.jha
*/
@Stateless
@WebService(portName = "myport", serviceName = "MyService", targetNamespace = "http://mprabhat.com/&quot;, endpointInterface = "com.test.mumz.soap.soapexp.IMyService")
public class MyServiceImpl implements IMyService {

/**
* Instantiates a new my service impl.
*/
public MyServiceImpl() {
}

/* (non-Javadoc)
* @see com.test.mumz.soap.soapexp.IMyService#sayHello(java.lang.String)
*/
@Override
public String sayHello(String userName) throws MyException {
if (userName == null || userName.trim().length() == 0 || "".equals(userName)) {
throw new MyException("Username cannot be null");
}
return "Hello : " + userName + " ,server time is : " + new Date();
}
}

[/sourcecode]

This again is self-explanatory, just returns hello message with server time. If parameter is null with throw MyException.

Finally our exception class MyException.java

[sourcecode language=”java”]
package com.test.mumz.soap.soapexp;

import javax.xml.ws.WebFault;

/**
* The Class MyException.
*
* @author prabhat.jha
*/
@WebFault(name="MyException")
public class MyException extends Exception {

/** The Constant serialVersionUID. */
private static final long serialVersionUID = -861826770198517502L;

/**
* Instantiates a new my exception.
*
* @param message
* the message
*/
public MyException(String message) {
super(message);
}

/**
* Instantiates a new my exception.
*
* @param cause
* the cause
*/
public MyException(Throwable cause) {
super(cause);
}

/**
* Instantiates a new my exception.
*
* @param message
* the message
* @param cause
* the cause
*/
public MyException(String message, Throwable cause) {
super(message, cause);
}

/**
* Instantiates a new my exception.
*
* @param message
* the message
* @param cause
* the cause
* @param enableSuppression
* the enable suppression
* @param writableStackTrace
* the writable stack trace
*/
public MyException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
super(message, cause, enableSuppression, writableStackTrace);
}
}

[/sourcecode]

Now export your project as war and deploy it in TomEE first (Simple way: Right Click on project -> Export -> War and then place this war inside /webapps). Or you can even deploy it through Eclipse. After deployment start TomEE and on console you should see the wsdl location. It should look like this:

[sourcecode language=”java”]
INFO: Webservice(wsdl=http://localhost:8080/SoapException/webservices/MyServiceImpl, qname={http://mprabhat.com/}MyService) –> Ejb(id=MyServiceImpl)
[/sourcecode]
To test:

1. Launch SoapUI
2. File -> New Soap Project
3. Give Project Name like MyServiceSoapUIPrj and wsdl. Just append “?wsdl” to what is printed on the console. It should be like:
   http://localhost:8080/SoapException/webservices/MyServiceImpl?wsdl

4. Now send a request with some parameter:
   [sourcecode language=”xml”]
   <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/&quot; xmlns:mpr="http://mprabhat.com/"&gt;
   <soapenv:Header/>
   <soapenv:Body>
   <mpr:sayHello>
   <arg0>User</arg0>
   </mpr:sayHello>
   </soapenv:Body>
   </soapenv:Envelope>
   [/sourcecode]
   
   You should get the response back like below:
   [sourcecode language=”xml”]
   <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"&gt;
   <soap:Body>
   <ns2:sayHelloResponse xmlns:ns2="http://mprabhat.com/"&gt;
   <return>Hello : User ,server time is : Sun Nov 02 23:40:06 IST 2014</return>
   </ns2:sayHelloResponse>
   </soap:Body>
   </soap:Envelope>
   [/sourcecode]
   
   Input with null parameter:
   [sourcecode language=”xml”]
   <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/&quot; xmlns:mpr="http://mprabhat.com/"&gt;
   <soapenv:Header/>
   <soapenv:Body>
   <mpr:sayHello>
   <arg0></arg0>
   </mpr:sayHello>
   </soapenv:Body>
   </soapenv:Envelope>
   [/sourcecode]
   
   Here is your SOAP fault
   [sourcecode language=”xml”]
   <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"&gt;
   <soapenv:Body>
   <soapenv:Fault>
   <faultcode>soapenv:Server</faultcode>
   <faultstring>Username cannot be null</faultstring>
   <detail>
   <a:MyException xmlns:a="http://mprabhat.com/"&gt;
   <message>Username cannot be null</message>
   </a:MyException>
   </detail>
   </soapenv:Fault>
   </soapenv:Body>
   </soapenv:Envelope>
   [/sourcecode]
   
   So all in all, everything works expected and we have our JAX-WS working. Wait only in TomEE!!!
   Now let’s deploy the same in our WebSphere Application Server. Steps to deploy:
   1. Make sure your WebSphere Application Server is installed and you have already created profile
   2. Start your server
   3. Go to administrator Console -> Applications -> WebSphere Enterprise Application and click on Install
   4. Click on Choose File, browse and select your war file
   5. Click Next and then choose “Fast Path – Prompt only when additional information is required.”
   6. Click Next, in the following screen make sure “Deploy Web Services” is selected/checked and click Next
   7. Click Next and again Click Next
   8. Provide some context root like /soapexptest and click Next and again Next and then Finish
   9. After some time it should ask you to save or Review the deployment, click on Save.
   10. From list of available applications, select your Application and click on Start. You should see something like below
       

       Application SoapException_war on server server1 and node DRLTRN0002Node01 started successfully. The collection may need to be refreshed to show the current status.

   11. Now go to SoapUI and create a new project, your WSDL should look like this:
       [sourcecode language=”java”]
       http://localhost:9080/soapexptest/MyService/MyService.wsdl
       [/sourcecode]

   12. Sample input and output remains the same

   That’s it everything worked perfectly, now in the next post we will see how things get complicated when we use a custom bean for providing SOAP Fault.

   Share this:

   • LinkedIn
   • Email
   • Print
   • X
   • Facebook

   Like this:

   Like Loading…