java 错误代码 返回格式_springmvc 通过异常增强返回给客户端统一格式

在springmvc开发中，我们经常遇到这样的问题；逻辑正常执行时返回客户端指定格式的数据，比如json，但是遇NullPointerException空指针异常,NoSuchMethodException调用的方法不存在异常，返回给客户端的是服务端异常堆栈信息，导致客户端不能正常解析数据；这明显不是我们想要的。

幸好从spring3.2提供的新注解@ControllerAdvice，从名字上可以看出大体意思是控制器增强。原理是使用AOP对Controller控制器进行增强(前置增强、后置增强、环绕增强，AOP原理请自行查阅)；那么我没可以自行对控制器的方法进行调用前(前置增强)和调用后(后置增强)的处理。

spring提供了@ExceptionHandler异常增强注解。程序如果在执行控制器方法前或执行时抛出异常，会被@ExceptionHandler注解了的方法处理。

配置applicationContext-mvc.xml：

全局异常处理类：

packagecom.drskj.apiservice.handler;importjava.io.IOException;importorg.springframework.beans.ConversionNotSupportedException;importorg.springframework.beans.TypeMismatchException;importorg.springframework.http.converter.HttpMessageNotReadableException;importorg.springframework.http.converter.HttpMessageNotWritableException;importorg.springframework.web.HttpMediaTypeNotAcceptableException;importorg.springframework.web.HttpRequestMethodNotSupportedException;importorg.springframework.web.bind.MissingServletRequestParameterException;importorg.springframework.web.bind.annotation.ControllerAdvice;importorg.springframework.web.bind.annotation.ExceptionHandler;importorg.springframework.web.bind.annotation.ResponseBody;importcom.drskj.apiservice.common.utils.ReturnFormat;/*** 异常增强，以JSON的形式返回给客服端

* 异常增强类型：NullPointerException,RunTimeException,ClassCastException,

NoSuchMethodException,IOException,IndexOutOfBoundsException

以及springmvc自定义异常等，如下：SpringMVC自定义异常对应的status code

Exception HTTP Status Code

ConversionNotSupportedException 500 (Internal Server Error)

HttpMessageNotWritableException 500 (Internal Server Error)

HttpMediaTypeNotSupportedException 415 (Unsupported Media Type)

HttpMediaTypeNotAcceptableException 406 (Not Acceptable)

HttpRequestMethodNotSupportedException 405 (Method Not Allowed)

NoSuchRequestHandlingMethodException 404 (Not Found)

TypeMismatchException 400 (Bad Request)

HttpMessageNotReadableException 400 (Bad Request)

MissingServletRequestParameterException 400 (Bad Request)

**/@ControllerAdvicepublic classRestExceptionHandler{//运行时异常

@ExceptionHandler(RuntimeException.class)

@ResponseBodypublicString runtimeExceptionHandler(RuntimeException runtimeException) {return ReturnFormat.retParam(1000, null);

}//空指针异常

@ExceptionHandler(NullPointerException.class)

@ResponseBodypublicString nullPointerExceptionHandler(NullPointerException ex) {

ex.printStackTrace();return ReturnFormat.retParam(1001, null);

}//类型转换异常

@ExceptionHandler(ClassCastException.class)

@ResponseBodypublicString classCastExceptionHandler(ClassCastException ex) {

ex.printStackTrace();return ReturnFormat.retParam(1002, null);

}//IO异常

@ExceptionHandler(IOException.class)

@ResponseBodypublicString iOExceptionHandler(IOException ex) {

ex.printStackTrace();return ReturnFormat.retParam(1003, null);

}//未知方法异常

@ExceptionHandler(NoSuchMethodException.class)

@ResponseBodypublicString noSuchMethodExceptionHandler(NoSuchMethodException ex) {

ex.printStackTrace();return ReturnFormat.retParam(1004, null);

}//数组越界异常

@ExceptionHandler(IndexOutOfBoundsException.class)

@ResponseBodypublicString indexOutOfBoundsExceptionHandler(IndexOutOfBoundsException ex) {

ex.printStackTrace();return ReturnFormat.retParam(1005, null);

}//400错误

@ExceptionHandler({HttpMessageNotReadableException.class})

@ResponseBodypublicString requestNotReadable(HttpMessageNotReadableException ex){

System.out.println("400..requestNotReadable");

ex.printStackTrace();return ReturnFormat.retParam(400, null);

}//400错误

@ExceptionHandler({TypeMismatchException.class})

@ResponseBodypublicString requestTypeMismatch(TypeMismatchException ex){

System.out.println("400..TypeMismatchException");

ex.printStackTrace();return ReturnFormat.retParam(400, null);

}//400错误

@ExceptionHandler({MissingServletRequestParameterException.class})

@ResponseBodypublicString requestMissingServletRequest(MissingServletRequestParameterException ex){

System.out.println("400..MissingServletRequest");

ex.printStackTrace();return ReturnFormat.retParam(400, null);

}//405错误

@ExceptionHandler({HttpRequestMethodNotSupportedException.class})

@ResponseBodypublicString request405(){

System.out.println("405...");return ReturnFormat.retParam(405, null);

}//406错误

@ExceptionHandler({HttpMediaTypeNotAcceptableException.class})

@ResponseBodypublicString request406(){

System.out.println("404...");return ReturnFormat.retParam(406, null);

}//500错误

@ExceptionHandler({ConversionNotSupportedException.class,HttpMessageNotWritableException.class})

@ResponseBodypublicString server500(RuntimeException runtimeException){

System.out.println("500...");return ReturnFormat.retParam(406, null);

}

}

以上包括了常见的服务端异常类型，@ResponseBody表示以json格式返回客户端数据。我们也可以自定义异常类(这里我把它叫做MyException)并且继承RunTimeException，并且在全局异常处理类新增一个方法来处理异常，使用@ExceptionHandler(MyException.class)注解在方法上实现自定义异常增强。

格式化response数据类ReturnFormat：

packagecom.drskj.apiservice.common.utils;importjava.lang.reflect.Field;importjava.text.SimpleDateFormat;importjava.util.ArrayList;importjava.util.Date;importjava.util.HashMap;importjava.util.List;importjava.util.Map;importcom.alibaba.fastjson.JSON;importcom.google.common.collect.Maps;

//格式化返回客户端数据格式(json)public classReturnFormat {private static MapmessageMap =Maps.newHashMap();//初始化状态码与文字说明

static{

messageMap.put("0", "");

messageMap.put("400", "Bad Request!");

messageMap.put("401", "NotAuthorization");

messageMap.put("405", "Method Not Allowed");

messageMap.put("406", "Not Acceptable");

messageMap.put("500", "Internal Server Error");

messageMap.put("1000", "[服务器]运行时异常");

messageMap.put("1001", "[服务器]空值异常");

messageMap.put("1002", "[服务器]数据类型转换异常");

messageMap.put("1003", "[服务器]IO异常");

messageMap.put("1004", "[服务器]未知方法异常");

messageMap.put("1005", "[服务器]数组越界异常");

messageMap.put("1006", "[服务器]网络异常");

messageMap.put("1010", "用户未注册");

messageMap.put("1011", "用户已注册");

messageMap.put("1012", "用户名或密码错误");

messageMap.put("1013", "用户帐号冻结");

messageMap.put("1014", "用户信息编辑失败");

messageMap.put("1015", "用户信息失效，请重新获取");

messageMap.put("1020", "验证码发送失败");

messageMap.put("1021", "验证码失效");

messageMap.put("1022", "验证码错误");

messageMap.put("1023", "验证码不可用");

messageMap.put("1029", "短信平台异常");

messageMap.put("1030", "周边无店铺");

messageMap.put("1031", "店铺添加失败");

messageMap.put("1032", "编辑店铺信息失败");

messageMap.put("1033", "每个用户只能添加一个商铺");

messageMap.put("1034", "店铺不存在");

messageMap.put("1040", "无浏览商品");

messageMap.put("1041", "添加失败,商品种类超出上限");

messageMap.put("1042", "商品不存在");

messageMap.put("1043", "商品删除失败");

messageMap.put("2010", "缺少参数或值为空");

messageMap.put("2029", "参数不合法");

messageMap.put("2020", "无效的Token");

messageMap.put("2021", "无操作权限");

messageMap.put("2022", "RSA解密失败,密文数据已损坏");

messageMap.put("2023", "请重新登录");

}public static String retParam(intstatus,Object data) {

OutputJson json= newOutputJson(status, messageMap.get(String.valueOf(status)), data);returnjson.toString();

}

}

返回格式实体类OutPutJson；这里用到了知名的fastjson将对象转json：

packagecom.drskj.apiservice.common.utils;importjava.io.Serializable;importcom.alibaba.fastjson.JSON;public class OutputJson implementsSerializable{/*** 返回客户端统一格式，包括状态码，提示信息，以及业务数据*/

private static final long serialVersionUID = 1L;//状态码

private intstatus;//必要的提示信息

privateString message;//业务数据

privateObject data;public OutputJson(intstatus,String message,Object data){this.status =status;this.message =message;this.data =data;

}public intgetStatus() {returnstatus;

}public void setStatus(intstatus) {this.status =status;

}publicString getMessage() {returnmessage;

}public voidsetMessage(String message) {this.message =message;

}publicObject getData() {returndata;

}public voidsetData(Object data) {this.data =data;

}publicString toString(){if(null == this.data){this.setData(newObject());

}return JSON.toJSONString(this);

}

}

实例：CodeController继承自BaseController，有一个sendMessage方法调用Service层发送短信验证码；

1.如果客户端请求方式为非POST，否则抛出HttpMediaTypeNotSupportedException异常；

2.如果username、forType或userType没传，则抛出MissingServletRequestParameterException异常；

3.如果springmvc接收无法进行类型转换的字段，会报TypeMismatchException异常；

.....

大部分的请求异常，springmvc已经为我们定义好了，为我们开发restful应用提高了测试效率，方便排查问题出在哪一环节。

@RestController@RequestMapping("/api/v1/code")

public class CodeController extendsBaseController {

@AutowiredprivateCodeService codeService;/*** 发送短信

*@paramusername 用户名

*@paramtype register/backpwd

*@return* status: 0 2010 2029 1011 1010 1006 1020*/@RequestMapping(value="/sendMessage",method=RequestMethod.POST,produces="application/json")public String sendMessage(@RequestParam(value="username",required=true)String username,

@RequestParam(value="forType",required=true)String forType,

@RequestParam(value="userType",required=true)String userType){if(null == username || "".equals(username)){return retContent(2010, null);

}if(!"user".equals(userType) && !"merchant".equals(userType)){return retContent(2029, null);

}if(!"register".equals(forType) && !"backpwd".equals(forType)){return retContent(2029, null);

}returncodeService.sendMessage(username, forType, userType);

}

}

public abstract classBaseController {protected String retContent(intstatus,Object data) {returnReturnFormat.retParam(status, data);

}

}

最终，不管是正常的业务逻辑还是服务端异常，都会调用ReturnFormat.retParam(int status,Object data)方法返回格式统一的数据。