docs(annotation): add basic note about JSR annotation

chenyong · chenyong · commit abf273845f59 · 2021-06-07T11:29:12.000+08:00
diff --git a/java/spring/spring-annotation.md b/java/spring/spring-annotation.md
@@ -284,7 +284,53 @@ public class AnnotationClass {
     }
     ```
 
-#### SpringX&#24120;&#29992;&#27880;&#35299;&#26377;&#21738;&#20123;
+#### &#24120;&#29992;&#27880;&#35299;&#26377;&#21738;&#20123;
+
+* Hibernate Validator &#21442;&#32771;&#25991;&#31456; https://zhuanlan.zhihu.com/p/194097505
+```
+&#22312;&#31243;&#24207;&#24320;&#21457;&#20013;&#65292;&#32463;&#24120;&#35201;&#23545;&#25968;&#25454;&#36827;&#34892;&#26657;&#39564;&#21518;&#20877;&#36827;&#34892;&#19994;&#21153;&#22788;&#29702;&#12290;&#22914;&#26524;&#22312;&#19994;&#21153;&#20195;&#30721;&#20013;&#36827;&#34892;Bean&#30340;&#23383;&#27573;&#26657;&#39564;&#65292;&#20250;&#20351;&#24471;&#20195;&#30721;&#21464;&#30340;&#38750;&#24120;&#32321;&#29712;&#12290;JSR303 - Bean Validation[JSR Java Specification Requests]&#20026;JavaBean&#30340;&#39564;&#35777;&#23450;&#20041;&#20102;&#30456;&#20851;&#30340;&#20803;&#25968;&#25454;&#27169;&#22411;&#21644;API&#12290;
+This JSR will define a meata-data model and API for JavaBeanTM validation, with overrides and extended meta-data through the use of XML validateion descriptors. &#22312;Java8&#20043;&#21518;&#65292;&#21448;&#25512;&#20986;JSR380 - Bean Validation 2.0&#12290;
+JSR&#26159;Java Specification Requests&#30340;&#32553;&#20889;&#65292;&#24847;&#24605;&#26159;Java &#35268;&#33539;&#25552;&#26696;&#12290;&#26159;&#25351;&#21521;JCP(Java Community Process)&#25552;&#20986;&#26032;&#22686;&#19968;&#20010;&#26631;&#20934;&#21270;&#25216;&#26415;&#35268;&#33539;&#30340;&#27491;&#24335;&#35831;&#27714;&#12290;&#20219;&#20309;&#20154;&#37117;&#21487;&#20197;&#25552;&#20132;JSR&#65292;&#20197;&#21521;Java&#24179;&#21488;&#22686;&#28155;&#26032;&#30340;API&#21644;&#26381;&#21153;&#12290;JSR&#24050;&#25104;&#20026;Java&#30028;&#30340;&#19968;&#20010;&#37325;&#35201;&#26631;&#20934;&#12290;
+Hibernate Validator&#26159;Bean Validation&#30340;&#23454;&#29616;&#65292;Hibernate Validator&#20869;&#32622;&#20102;JSR303/JSR380&#20013;&#30340;&#25152;&#26377;&#30340;constraint[&#32422;&#26463;&#65292;&#38480;&#21046;]&#30340;&#23454;&#29616;&#65292;&#36824;&#39069;&#22806;&#23450;&#20041;&#20102;&#24456;&#22810;&#33258;&#23450;&#20041;&#30340;constraint&#12290;
+```
+* &#23548;&#20837;&#20381;&#36182; spring-boot-starter-web&#20013;&#38598;&#25104;&#20102;Hibernate Validator&#24037;&#20855;&#65292;&#26080;&#38656;&#39069;&#22806;&#24341;&#29992;&#12290;
+* maven&#20381;&#36182; hibernate-validator
+* Bean Validation&#20013;&#20869;&#32622;&#30340;constraint
+```
+@Null &#20803;&#32032;&#24517;&#39035;&#20026;null
+@NotNull &#20803;&#32032;&#19981;&#33021;&#20026;null
+@NotBlank &#20803;&#32032;&#19981;&#33021;&#20026;null&#19988;&#19981;&#33021;&#20026;&#31354;&#65292;&#29992;&#20110;string
+@NotEmpty &#20803;&#32032;&#19981;&#33021;&#20026;null&#19988;&#19981;&#33021;&#20026;&#31354;&#38598;&#21512;
+@Length
+@Negative 
+@NegativeOrZero
+@Positive
+@PositiveOrZero
+@Size 
+@Min
+@Max
+@DecimalMin
+@DecimalMax
+@Digits &#20803;&#32032;&#24517;&#39035;&#20026;&#19968;&#20010;&#25351;&#23450;&#26684;&#24335;&#30340;&#25968;&#23383; @Digits(integer=, fraction=) integer&#25351;&#23450;&#25972;&#25968;&#31934;&#24230;&#65292;fraction&#25351;&#23450;&#23567;&#25968;&#31934;&#24230;
+@AssertFalse &#20803;&#32032;&#24517;&#39035;&#20026;false
+@AssertTrue &#20803;&#32032;&#24517;&#39035;&#20026;true&#65292;&#21487;&#29992;&#20110;&#29992;&#25143;&#21516;&#24847;&#26465;&#27454;
+@Email
+@Pattern
+@Past
+@PastOrPresent
+@Future
+@FutureOrPresent
+@Range
+@SafeHtml
+@URL
+@CreditCardNumber
+@CodePointLength
+@UniqueElements
+@DurationMin
+@DurationMax
+```
+
+
 
 * Spring
     * @NotEmpty &#29992;&#22312;&#38598;&#21512;&#31867;&#19978;&#38754; &#21152;&#20102;@NotEmpty&#30340;String&#31867;&#12289;Collection&#12289;Map&#12289;&#25968;&#32452;&#65292;&#26159;&#19981;&#33021;&#20026;null&#25110;&#32773;&#38271;&#24230;&#20026;0&#30340;(String Collection Map&#30340;isEmpty()&#26041;&#27861;)

-Original file line number
+Diff line change
+    }
     ```
 -#### SpringX常用注解有哪些
 +#### 常用注解有哪些
++
 +* Hibernate Validator 参考文章 https://zhuanlan.zhihu.com/p/194097505
 +```
 +在程序开发中，经常要对数据进行校验后再进行业务处理。如果在业务代码中进行Bean的字段校验，会使得代码变的非常繁琐。JSR303 - Bean Validation[JSR Java Specification Requests]为JavaBean的验证定义了相关的元数据模型和API。
 +This JSR will define a meata-data model and API for JavaBeanTM validation, with overrides and extended meta-data through the use of XML validateion descriptors. 在Java8之后，又推出JSR380 - Bean Validation 2.0。
 +JSR是Java Specification Requests的缩写，意思是Java 规范提案。是指向JCP(Java Community Process)提出新增一个标准化技术规范的正式请求。任何人都可以提交JSR，以向Java平台增添新的API和服务。JSR已成为Java界的一个重要标准。
 +Hibernate Validator是Bean Validation的实现，Hibernate Validator内置了JSR303/JSR380中的所有的constraint[约束，限制]的实现，还额外定义了很多自定义的constraint。
 +```
 +* 导入依赖 spring-boot-starter-web中集成了Hibernate Validator工具，无需额外引用。
 +* maven依赖 hibernate-validator
 +* Bean Validation中内置的constraint
 +```
 +@Null 元素必须为null
 +@NotNull 元素不能为null
 +@NotBlank 元素不能为null且不能为空，用于string
 +@NotEmpty 元素不能为null且不能为空集合
 +@Length
 +@Negative
 +@NegativeOrZero
 +@Positive
 +@PositiveOrZero
 +@Size
 +@Min
 +@Max
 +@DecimalMin
 +@DecimalMax
 +@Digits 元素必须为一个指定格式的数字 @Digits(integer=, fraction=) integer指定整数精度，fraction指定小数精度
 +@AssertFalse 元素必须为false
 +@AssertTrue 元素必须为true，可用于用户同意条款
 +@Email
 +@Pattern
 +@Past
 +@PastOrPresent
 +@Future
 +@FutureOrPresent
 +@Range
 +@SafeHtml
 +@URL
 +@CreditCardNumber
 +@CodePointLength
 +@UniqueElements
 +@DurationMin
 +@DurationMax
 +```
++
++
 * Spring
     * @NotEmpty 用在集合类上面 加了@NotEmpty的String类、Collection、Map、数组，是不能为null或者长度为0的(String Collection Map的isEmpty()方法)