Solon详解（六）-|Solon详解（六）- 定制业务级别的验证注解 Solon详解（六）-定制业务级别

Solon详解系列文章：
Solon详解（一）- 快速入门
Solon详解（二）- Solon的核心
Solon详解（三）- Solon的web开发
Solon详解（四）- Solon的事务传播机制
Solon详解（五）- Solon扩展机制之Solon Plugin
Solon详解（六）- 定制业务级别的验证注解

在业务的实现过程中，尤其是对外接口开发，我们需要对请求进行大量的验证并返回错误状态码和描述。lombok 框架有很多很赞的注解，但是人家是throw一个异常，这与有些需求不一定能匹配。
该文将基于Solon的一些扩展基础，简单的实现一套定制的业务验证机制。效果如下：

@XController public class UserController extends VerifyController{ @RepeatSubmit//重复提交验证 @Whitelist//IP白名单验证 @NotNull({"name", "mobile", "icon", "code"})//非NULL验证 public void addUser(UserModel user){ //... } }

一、定制开始
1、先定义一组验证注解

@Inherited @Target({ElementType.METHOD}) @Retention(RetentionPolicy.RUNTIME) public @interface NotNull { String[] value(); }@Inherited @Target({ElementType.METHOD}) @Retention(RetentionPolicy.RUNTIME) public @interface Whitelist { }//... 更多略

2、然后，定义一个验证用的拦截器

// //Solon里的所有拦截器，也都是 XHandler // public class VerifyInterceptor implements XHandler { @Override public void handle(XContext ctx) throws Throwable { //获取上下文中的XAction // XAction action = ctx.attr("action"); if (action != null) { handle0(ctx, action); } }protected void handle0(XContext ctx, XAction action) throws Throwable { //这里的顺序，要与业务的期望顺序匹配//白名单 checkWhitelist(ctx, action); //不能为Null checkNotNull(ctx, action); //...更多略 }protected void checkWhitelist(XContext ctx, XAction action)throws Throwable{ if(ctx.getHandled()){ return; }Whitelist anno = action.method().getAnnotation(Whitelist.class); if (anno != null) { String ip = IpUtils.getIP(ctx); if (WhitelistApi.existsOfServerIp(ip) == false) { ctx.setHandled(true); ctx.render(UapiCodes.CODE_16); } } }protected void checkNotNull(XContext ctx, XAction action)throws Throwable{ if(ctx.getHandled()){ return; }NotNull anno = action.method().getAnnotation(NotNull.class); if (anno != null) { checkParamsIsOk(ctx, false, anno.value()); } } }

3、再是，定义一个支持验证的控制器基类

// // 创建一个有验证拦截器的基类；@XBefore 注解是可继承的... // @XBefore({VerifyInterceptor.class}) public class VerifyController {}

完工了
二、附：关于 XContext 的部分扩展属性
Solon 的上下文对象：XContext，有一组可扩展属性的接口：attr(), attrSet(), attrMap()。用于记录处理过程中的数据或对象。
【Solon详解（六）-|Solon详解（六）- 定制业务级别的验证注解】以下是框架在运行过程中已记录的扩展属性：

扩展属性	说明
ctx.attr("controller")	获取当前控制器
ctx.attr("action")	获取当前活动
ctx.result	获取当前活动的执行结果，可用于统一的业务日志记录
ctx.attr("error")	获取当前错误
ctx.attr("output")	获取当前序列化输出，可用于统一的业务日志记录