浅谈springmvc 通过异常增强返回给客户端统一格式

2023-07-14 16:01:03 79

在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自定义异常对应的statuscode
ExceptionHTTPStatusCode
ConversionNotSupportedException500(InternalServerError)
HttpMessageNotWritableException500(InternalServerError)
HttpMediaTypeNotSupportedException415(UnsupportedMediaType)
HttpMediaTypeNotAcceptableException406(NotAcceptable)
HttpRequestMethodNotSupportedException405(MethodNotAllowed)
NoSuchRequestHandlingMethodException404(NotFound)
TypeMismatchException400(BadRequest)
HttpMessageNotReadableException400(BadRequest)
MissingServletRequestParameterException400(BadRequest)
*
*/
@ControllerAdvice
publicclassRestExceptionHandler{
//运行时异常
@ExceptionHandler(RuntimeException.class)
@ResponseBody
publicStringruntimeExceptionHandler(RuntimeExceptionruntimeException){
returnReturnFormat.retParam(1000,null);
}
//空指针异常
@ExceptionHandler(NullPointerException.class)
@ResponseBody
publicStringnullPointerExceptionHandler(NullPointerExceptionex){
ex.printStackTrace();
returnReturnFormat.retParam(1001,null);
}
//类型转换异常
@ExceptionHandler(ClassCastException.class)
@ResponseBody
publicStringclassCastExceptionHandler(ClassCastExceptionex){
ex.printStackTrace();
returnReturnFormat.retParam(1002,null);
}
//IO异常
@ExceptionHandler(IOException.class)
@ResponseBody
publicStringiOExceptionHandler(IOExceptionex){
ex.printStackTrace();
returnReturnFormat.retParam(1003,null);
}
//未知方法异常
@ExceptionHandler(NoSuchMethodException.class)
@ResponseBody
publicStringnoSuchMethodExceptionHandler(NoSuchMethodExceptionex){
ex.printStackTrace();
returnReturnFormat.retParam(1004,null);
}
//数组越界异常
@ExceptionHandler(IndexOutOfBoundsException.class)
@ResponseBody
publicStringindexOutOfBoundsExceptionHandler(IndexOutOfBoundsExceptionex){
ex.printStackTrace();
returnReturnFormat.retParam(1005,null);
}
//400错误
@ExceptionHandler({HttpMessageNotReadableException.class})
@ResponseBody
publicStringrequestNotReadable(HttpMessageNotReadableExceptionex){
System.out.println("400..requestNotReadable");
ex.printStackTrace();
returnReturnFormat.retParam(400,null);
}
//400错误
@ExceptionHandler({TypeMismatchException.class})
@ResponseBody
publicStringrequestTypeMismatch(TypeMismatchExceptionex){
System.out.println("400..TypeMismatchException");
ex.printStackTrace();
returnReturnFormat.retParam(400,null);
}
//400错误
@ExceptionHandler({MissingServletRequestParameterException.class})
@ResponseBody
publicStringrequestMissingServletRequest(MissingServletRequestParameterExceptionex){
System.out.println("400..MissingServletRequest");
ex.printStackTrace();
returnReturnFormat.retParam(400,null);
}
//405错误
@ExceptionHandler({HttpRequestMethodNotSupportedException.class})
@ResponseBody
publicStringrequest405(){
System.out.println("405...");
returnReturnFormat.retParam(405,null);
}
//406错误
@ExceptionHandler({HttpMediaTypeNotAcceptableException.class})
@ResponseBody
publicStringrequest406(){
System.out.println("404...");
returnReturnFormat.retParam(406,null);
}
//500错误
@ExceptionHandler({ConversionNotSupportedException.class,HttpMessageNotWritableException.class})
@ResponseBody
publicStringserver500(RuntimeExceptionruntimeException){
System.out.println("500...");
returnReturnFormat.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）
publicclassReturnFormat{
privatestaticMapmessageMap=Maps.newHashMap();
//初始化状态码与文字说明
static{
messageMap.put("0","");
messageMap.put("400","BadRequest!");
messageMap.put("401","NotAuthorization");
messageMap.put("405","MethodNotAllowed");
messageMap.put("406","NotAcceptable");
messageMap.put("500","InternalServerError");
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","请重新登录");
}
publicstaticStringretParam(intstatus,Objectdata){
OutputJsonjson=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;
publicclassOutputJsonimplementsSerializable{
/**
*返回客户端统一格式，包括状态码，提示信息，以及业务数据
*/
privatestaticfinallongserialVersionUID=1L;
//状态码
privateintstatus;
//必要的提示信息
privateStringmessage;
//业务数据
privateObjectdata;
publicOutputJson(intstatus,Stringmessage,Objectdata){
this.status=status;
this.message=message;
this.data=data;
}
publicintgetStatus(){
returnstatus;
}
publicvoidsetStatus(intstatus){
this.status=status;
}
publicStringgetMessage(){
returnmessage;
}
publicvoidsetMessage(Stringmessage){
this.message=message;
}
publicObjectgetData(){
returndata;
}
publicvoidsetData(Objectdata){
this.data=data;
}
publicStringtoString(){
if(null==this.data){
this.setData(newObject());
}
returnJSON.toJSONString(this);
}
}

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

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

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

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

.....

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

@RestController@RequestMapping("/api/v1/code")
publicclassCodeControllerextendsBaseController{
@Autowired
privateCodeServicecodeService;

/**
*发送短信
*@paramusername用户名
*@paramtyperegister/backpwd
*@return
*status:0201020291011101010061020
*/
@RequestMapping(value="/sendMessage",method=RequestMethod.POST,produces="application/json")
publicStringsendMessage(@RequestParam(value="username",required=true)Stringusername,
@RequestParam(value="forType",required=true)StringforType,
@RequestParam(value="userType",required=true)StringuserType){
if(null==username||"".equals(username)){
returnretContent(2010,null);
}
if(!"user".equals(userType)&&!"merchant".equals(userType)){
returnretContent(2029,null);
}
if(!"register".equals(forType)&&!"backpwd".equals(forType)){
returnretContent(2029,null);
}
returncodeService.sendMessage(username,forType,userType);
}
}

publicabstractclassBaseController{
protectedStringretContent(intstatus,Objectdata){
returnReturnFormat.retParam(status,data);
}
}

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

以上这篇浅谈springmvc通过异常增强返回给客户端统一格式就是小编分享给大家的全部内容了，希望能给大家一个参考，也希望大家多多支持毛票票。

浅谈springmvc 通过异常增强返回给客户端统一格式

热门推荐

随机推荐