网站网站建站关键词热度分析
目录
- 前言
- WebResponseExceptionTranslator
- 自定义异常处理
- 1、自定义我们响应实体类
- 2、定义响应结果枚举类
- 3、自定义异常转换类
- 4、配置自定义异常转换器
- 5、测试
前言
Spring Security OAuth2 认证失败的格式如下
{"error": "unsupported_grant_type","error_description": "Unsupported grant type: refresh_token1"
}
这个返回是很不友好的,特别是在前后端分离的时候,前端一般是根据我们的返回码进行处理,所以我们还得自定义我们的异常处理
WebResponseExceptionTranslator
在 AuthorizationServerEndpointsConfigurer端点配置类有一个 WebResponseExceptionTranslator异常转换器。
WebResponseExceptionTranslator只有一个translate方法,很明显,这个方法就是用来转换异常的
public interface WebResponseExceptionTranslator<T> {ResponseEntity<T> translate(Exception e) throws Exception;}
它就是专门用于处理异常转换的,我们要自定义异常很简单,创建一个类来实现WebResponseExceptionTranslator接口,然后进行配置即
自定义异常处理
1、自定义我们响应实体类
定义一个我们需要格式的响应实体类,这个实体类我们以json的格式返回
/*** 统一的返回实体*/
@Data
@NoArgsConstructor
public class MyResponseResult<T> {/*** 响应码*/private String code;/*** 响应结果消息*/private String msg;/*** 响应数据*/private T data;protected MyResponseResult(String code, String msg, T data) {this.code = code;this.msg = msg;this.data = data;}public static <T> MyResponseResult<T> failed(String resultCode, String resultMsg) {return new MyResponseResult<T>(resultCode, resultMsg, null);}public static <T> MyResponseResult<T> failed(String message) {return new MyResponseResult<T>(ResultCode.FAILED.getCode(), message, null);}public static <T> MyResponseResult<T> failed(T data) {return new MyResponseResult<T>(ResultCode.SUCCESS.getCode(), ResultCode.SUCCESS.getMsg(), data);}}
2、定义响应结果枚举类
/*** 响应结果枚举*/
@Getter
@AllArgsConstructor
public enum ResultCode {SUCCESS("200", "操作成功"),FAILED("500", "操作失败"),AUTH_FAIL("10001", "认证失败"),INVALID_TOKEN("10002", "token无效"),NONSUPPORT_GRANT_TYPE("10003", "授权类型不支持"),;private final String code;private final String msg;}
3、自定义异常转换类
/*** 自定义异常转换*/
@Slf4j
public class MyExtendOAuth2ResponseExceptionTranslator implements WebResponseExceptionTranslator {public static final int FAIL_CODE = 500;@Overridepublic ResponseEntity translate(Exception e) throws Exception {log.error("认证服务器认证异常:{}", e.getMessage());//对异常进行转换if (e instanceof UnsupportedGrantTypeException){return ResponseEntity.status(FAIL_CODE).contentType(MediaType.APPLICATION_JSON).body(MyResponseResult.failed(ResultCode.NONSUPPORT_GRANT_TYPE.getCode(), ResultCode.NONSUPPORT_GRANT_TYPE.getMsg()));}if (e instanceof InvalidTokenException) {return ResponseEntity.status(FAIL_CODE).contentType(MediaType.APPLICATION_JSON).body(MyResponseResult.failed(ResultCode.INVALID_TOKEN.getCode(),ResultCode.INVALID_TOKEN.getMsg()));}return ResponseEntity.status(FAIL_CODE).contentType(MediaType.APPLICATION_JSON).body(MyResponseResult.failed(ResultCode.AUTH_FAIL.getCode(),ResultCode.AUTH_FAIL.getMsg()));}}
4、配置自定义异常转换器
在AuthorizationServerConfig配置文件的configure(AuthorizationServerEndpointsConfigurer endpoints)方法加下下面这行配置即可
//指定异常转换器endpoints.exceptionTranslator(new MyExtendOAuth2ResponseExceptionTranslator());
5、测试
使用一个不存在的grant_type请求/oauth/token,已经返回我们自定义的异常响应了
{"code": "10003","msg": "授权类型不支持","data": null
}