业务参数校验

业务参数校验采用JSR-303方式，关于JSR-303介绍可以参考这篇博文：JSR 303 - Bean Validation 介绍及最佳实践

在参数中使用注解即可，框架会自动进行验证。如下面一个添加商品接口，它的参数是GoodsParam

  1. @ApiMapping(value = "goods.add")
  2. public void addGoods(GoodsParam param) {
  3.     ...
  4. }

在GoodsParam中添加JSR-303注解:

  1. @Data
  2. public class GoodsParam {
  3.     @NotEmpty(message = "商品名称不能为空")    
  4.     private String goods_name;
  5. }

如果不传商品名称则返回

  1. {"goods_add_response":{"msg":"Success","code":"10000","sub_msg":"商品名称不能为空","sub_code":"isv.invalid-parameter"},"sign":"Eh3Z5CxDCHsb4MyYFVxsPSmBpwVi1LISJdOkrzglxXoqG7RVyEOt4ef1kNpznUvMI3FDQU1suR7Rsmx6NjGdEVS6NSH2Kt0d8TFBRpLhWz8hApnxOtgzqMqbYeMuJie7X5gF6m8hTnvuuxF21IrkixMe+lyBcXw7dk0C3w1SwdEZkHQ+xC+M4bLqAZt5/3kl79/FWSMFJWHiZmg5YeEi8e8XhYCNcz+xlJRJL0x2Y87fFxqSY0UYWNxbQHgdVI8xRfn1n31nzkcLxiAtTh4LPtNRrG7w7absK/C1Oi/vczuBlFeq2EWUsYVWOVpKiJifUwvYVUUsztSLElzplzOjbg=="}

参数校验国际化

国际化的配置方式如下：

  1. @NotEmpty(message = "{goods.remark.notNull}")
  2. private String goods_remark;

国际化资源文件bizerror_en.properties中添加：

  1. goods.remark.notNull=The goods_remark can not be null

bizerror_zh_CN.properties中添加：

  1. # 商品备注不能为空
  2. goods.remark.notNull=\u5546\u54c1\u5907\u6ce8\u4e0d\u80fd\u4e3a\u7a7a

参数校验国际化传参

下面校验商品评论的长度，要求大于等于3且小于等于20。数字3和20要填充到国际化资源中去。

  1. // 传参的格式：{xxx}=value1,value2...
  2. @Length(min = 3, max = 20, message = "{goods.comment.length}=3,20")
  3. private String goods_comment;

bizerror_en.properties:

  1. goods.comment.length=The goods_comment length must >= {0} and <= {1}

bizerror_zh_CN.properties中添加：

  1. # 商品评论长度必须在{0}和{1}之间
  2. goods.comment.length=\u5546\u54c1\u8bc4\u8bba\u957f\u5ea6\u5fc5\u987b\u5728{0}\u548c{1}\u4e4b\u95f4

这样value1，value2会分别填充到{0},{1}中