Nuwan Bandara [https://community.jboss.org/people/Daffy] modified the document: "RESTEasy" To view the document, visit: https://community.jboss.org/docs/DOC-48310 -------------------------------------------------------------- h2. Purpose Purpose of the article is to show how to handle exception in RESTEasy. h2. Solution RESTEasy provides such a exception handling mechanism which simplifies the exception handling process. RESTEasy ExceptionMappers are custom, application provided, components that can catch thrown application exceptions and write specific HTTP responses. The are classes annotated with @Provider and that implement this interface. When an application exception is thrown it will be caught by the JAX-RS runtime. JAX-RS will then scan registered ExceptionMappers to see which one support marshalling the exception type thrown. h2. How to Do? h4. High-Level Steps * Implements ExceptionMapper * Register ExceptionMapper in the web.xml * Create JAXB model class for the response (Optional) * Create RESTEasy method * WebService Output h3. Implementation Create a exception handler/mapper to marshal the exception. package com.nuwan.poc.wsmodule.exception; import javax.ws.rs.core.MediaType; import javax.ws.rs.core.Response; import javax.ws.rs.ext.ExceptionMapper; import javax.ws.rs.ext.Provider; /** * User: Nuwan.N.Bandara */ @Provider public class DefaultExceptionHandler implements ExceptionMapper<Exception> {     @Override     public Response toResponse(Exception e) {                // For simplicity I am preparing error xml by hand.         // Ideally we should create an ErrorResponse class to hold the error info.         StringBuilder response = new StringBuilder("<response>");         response.append("<status>ERROR</status>");         response.append("<message>" + e.getMessage() + "</message>");         response.append("</response>");         return Response.serverError().entity(response.toString()).type(MediaType.APPLICATION_XML).build();     } } Register the DefaultExceptionHandler in your web.xml <context-param>         <param-name>resteasy.providers</param-name>         <param-value>com.nuwan.poc.wsmodule.exception.DefaultExceptionHandler</param-value> </context-param> Create JAXB model class for marshalling POJO to XML to produce the response. (This is optional) package com.nuwan.poc.wsmodule.model; import javax.xml.bind.annotation.XmlRootElement; import javax.xml.bind.annotation.XmlAttribute; import javax.xml.bind.annotation.XmlElement; import java.util.Date; /** * User: Nuwan.N.Bandara */ @XmlRootElement public class Response {     private long id;     private String status;     private String message;     public long getId() {         return (new Date()).getTime();     }     @XmlAttribute     public void setId(long id) {         this.id = id;     }     public String getStatus() {         return status;     }     @XmlElement     public void setStatus(String status) {         this.status = status;     }     public String getMessage() {         return message;     }     @XmlElement     public void setMessage(String message) {         this.message = message;     } } Here's the RESTEasy web service method implementation. When method receives value 0, code hit the catch block and throws an ArithmeticException. Which is a type of an Exception that we have already handled in DefaultExceptionHandler class.     @GET     @Path("testWebService")     @Produces({MediaType.APPLICATION_XML})     public Response testWebService(int value) throws Exception {         Response response = new Response();         try {             if((100 / value) > 0) {                 response.setStatus("OK");                 response.setMessage("Greater Than Zero");             }             else {                 response.setStatus("OK");                 response.setMessage("Less Than Zero");             }         }         catch (ArithmeticException e) {             throw new ArithmeticException("Division by zero!");         }         return response;     } Output of the web service would look like this; Successful response output. Response class generates this XML. <response>   <status>SUCCESSFUL</status>   <message>Greater Than Zero</message> </response> Error response output. DefaultExceptionHandler toResponse() generates this XML. <response>   <status>ERROR</status>   <message>Division by zero!</message> </response> h2. Reference * http://docs.jboss.org/resteasy/docs/1.1.GA/userguide/html/ExceptionHandli... Chapter 25. Exception Handling -------------------------------------------------------------- Comment by going to Community [https://community.jboss.org/docs/DOC-48310] Create a new document in JBoss Web Services Development at Community [https://community.jboss.org/choose-container!input.jspa?contentType=102&a...]