JarCasting对象参数校验和参数容错处理的工具
提供多种参数验证和参数处理使用方式：
通过注解的形式提供标准javaBean中的字段的参数验证和处理。
参数验证：当参数不合法，直接抛出ValidationFailException异常。
参数处理：对于javaBean一些参数，我们可以做前置容错处理：比如字符串转大写，字符串转小写，去空格，去制表符等处理。
当参数验证和参数处理时，如果验证的字段没有提供get/set方法，则所有的验证和处理逻辑都不会生效。
快速使用
<!-- 参数验证核心工具 -->
<dependency>
<artifactId>web-validation-core</artifactId>
<groupId>com.github.chenhaiyangs</groupId>
<version>1.2.0</version>
</dependency>
参数验证的主体
只针对javaBean进行参数验证（javaBean要提供字段的get/set），不能直接处理原生数据类型。所有注解类型都是注解在字段级别。 例如如下代码，用来生明对javaBean中具体参数的参数验证逻辑：
public class User {
@NotNull
private String userId;
@IntNumber(min = 6,max = 12)
private int age;
@DateStringFormat(format = "yyyy-MM-dd")
@StringLength(min = 10,max = 10)
private String timeStemp;
get/set......
}
参数验证类注解详解
在com.web.validation.core.annotation.valid包下包含所有的验证相关的注解：
除了@ValidChild注解，其他注解都具有两个公共属性code，默认为''。message,默认为 field %s validate error，rule : xxx
注解上的code和message可以自己设置，在参数验证失败抛出的异常ValidationFailException中能够获取code和message。xxx表示每个注解的注解名称
message的设置 如果添加了 %s ，%s会自动映射到出错的字段上。
下面注解的讲解不会讲解公共属性。
@NotNull
标注此注解的字段不允许为null，但允许为空
@NotEmpty
标注此注解的字段可以为null，不允许为空串和空白串，只验证字符串。非字符串忽略
@NotNullorEmpty
标注此注解的字段不允许为null，也不允许为空串和空白字符串
@StringLength
标准此注解的字段验证在字段非null时才生效。
表示字符串的长度范围。两个属性：min，max，每个属性默认值-1,-1表示不验证min或者max
@AssertBool
标准此注解的字段验证在字段非null时才生效。
表示字段类型必须是布尔值或者是字符串类型的布尔值
@AssertTrue
标准此注解的字段验证在字段非null时才生效。
表示字段类型必须是布尔值true或者是字符串类型的布尔值true
@AssertFalse
标准此注解的字段验证在字段非null时才生效。
表示字段类型必须是布尔值false或者是字符串类型的布尔值false
@Pattern
表示字符串字段必须符合某正则，字段也不允许为null。
@CollectionSize
标准此注解的字段验证在字段非null时才生效。
如果字段是一个数组，Collection，Map。该字段可以验证这个数组／collection/map的size在min和max之间，min和max默认为-1，-1表示不验证最小或者最大边界
@IntNumber
@LongNumber
@DoubleNumber
标准此以上的字段验证在字段非null时才生效。
表示标注的字段必须是可以转成对应类型的数字。并且数字范围在min和max之间。-1表示不限制最小值或者最大值
@DateStringFormat
标准此以上的字段验证在字段非null时才生效。
表示标注的字段必须是指定format类型的时间，比如：
public class User {
@NotNull
@DateStringFormat(format="yyyy-MM-dd")
private String createTime;
get/set......
}
但是以上验证不是很严格。比如说format=yyyy-MM-dd。但实际上传递 2018-12-12 12:13:55 这样待小时的时间也被认为是合法的。
如果你要求必须是严格的yyyy-MM-dd类型，建议加上@StringLength(min=10,max=10)来限制长度。
@In
标注此字段的值只能在contains可选值属性中。被标注的字段只能是String或者java基础类型。 例如：
public class User {
@In(contains ={"1","2","3"})
private String type;
get/set......
}
表示type字段在非null的情况下只能是1，2，3。 但是null时不判断。因此如果要求必传字段。建议添加注解@NotNull
@ValidChild
标准此以上的字段验证在字段非null时才生效。
默认情况下，该工具只验证对象的一级参数。如果你的javaBean对象的一个字段也是一个javaBean
你需要在字段前标注@ValidChild 注解告诉工具需要验证子对象，例如：
public class User {
@NotNull
@ValidChild
private Order order;
get/set......
}
参数处理类注解详解：
参数处理类注解只能处理字符串类型的字段,且字符串不能为null。
@ToLower
标注此注解的字段会被处理成全小写
@ToUpper
标注此注解的字段会被处理成全大写
@TrimAll
标注此注解的字段会被处理全部的空格，前后中
@TrimPrefixAndSuffix
标注此注解的字段会处理前后空格
@TrimTableChar
标注此注解的字段会处理制表符和空格。比如 \r,\n,\r\n等。
@ProcessChild
默认情况下，该工具只处理对象的一级参数。如果你的javaBean对象的一个字段也是一个javaBean
你需要在字段前标注@ProcessChild注解告诉工具需要处理子对象，例如：
public class User {
@ProcessChild
private Order order;
}
API的方式使用该工具：
只导入依赖：
<!-- 参数验证核心工具 -->
<dependency>
<artifactId>web-validation-core</artifactId>
<groupId>com.github.chenhaiyangs</groupId>
<version>1.2.0</version>
</dependency>
编写代码：
public void setUser(User user){
//参数验证API
Validation.validate(user);
//参数处理API
Procession.process(user);
}
SpringAOP的方式使用该工具：
只导入依赖：
<!-- 在Spring中使用参数验证 -->
<dependency>
<artifactId>web-validation-spring-simple</artifactId>
<groupId>com.github.chenhaiyangs</groupId>
<version>1.1.0</version>
</dependency>
如果校验规则有新增。也可以另外导入core:如：1.2.0
<!-- 参数验证核心工具 -->
<dependency>
<artifactId>web-validation-core</artifactId>
<groupId>com.github.chenhaiyangs</groupId>
<version>1.2.0</version>
</dependency>
编写AOP的拦截配置：（截取aop相关关键配置）
<bean id="validInterceptor" class="com.web.validation.spring.aop.AspectjAopInterceptor"/>
<!-- aspectj织入 配置-->
<aop:aspectj-autoproxy proxy-target-class="true"/>
<aop:config proxy-target-class="true">
<!-- 处理 @validInterceptor AOP-->
<aop:aspect ref="validInterceptor">
<aop:pointcut id="validInterceptorPointCut" expression="execution(* com.xxx.xxxx.xxxxxx.xxxxxxxxx.*.*(..))"/>
<aop:around pointcut-ref="validInterceptorPointCut" method="process"/>
</aop:aspect>
</aop:config>
在要参数的方法的参数上添加对应注解。
public User sayHello(@Valid @Process User user,int max, @Valid Country country){
......
}
如上，多个参数，只要是javaBean类型，只要在方法对应的参数前加上@Valid或者Process注解，对应的验证或处理逻辑就生效。
如果@Valid和@Process 两个注解在一个参数上同时存在，是先验证数据合法性还是先处理数据？ 默认是先Process后Valid。 你可以人为调整逻辑顺序。这两个注解都有order属性,表示顺序，order越大的，执行顺序靠后。
在SpringBoot的restful API 中使用该工具
只导入依赖：
<!-- 在Spring中使用参数验证 -->
<dependency>
<artifactId>web-validation-spring-boot-starter</artifactId>
<groupId>com.github.chenhaiyangs</groupId>
<version>1.2.0</version>
</dependency>
<!-- 参数验证核心工具 -->
<dependency>
<artifactId>web-validation-core</artifactId>
<groupId>com.github.chenhaiyangs</groupId>
<version>1.2.0</version>
</dependency>
在启动类上添加@ValidAndProcessEnabled注解：
@ValidAndProcessEnabled
@SpringBootApplication
@EnableAspectJAutoProxy(proxyTargetClass = true,exposeProxy = true)
public class SpringBootTestApplication {
public static void main(String[] args) {
SpringApplication.run(SpringBootTestApplication.class,args);
}
}
验证逻辑：
@RequestMapping(value = "/validtest",method = RequestMethod.POST,produces = "application/json;charset=UTF-8")
@ResponseBody
public User sayHello(@RequestBody @Valid User user){
return user;
}
如果是Dubbo等后台RPC接口。也一样有效。
public User sayHello(@Valid @Process User user){
return user;
}
使用建议
在和Spring相关的AOP使用场景中，建议编写统一异常处理拦截ValidationException 获取code和message，来处理。