Skip to content

Commit b3666ac

Browse files
committed
docs: 优化各个模块的readme说明
1 parent 9c0a395 commit b3666ac

File tree

6 files changed

+32
-6
lines changed

6 files changed

+32
-6
lines changed

spel-validator-constrain/README.md

+6
Original file line numberDiff line numberDiff line change
@@ -3,3 +3,9 @@
33
此模块内包含了一些常用的约束校验器,用于校验对象的属性是否符合预期。
44

55
同时这些校验器的测试用例也在此模块中。
6+
7+
刚开始这些约束器都是在 `-core` 模块里的。
8+
但是由于这些约束器的测试工具依赖了 `-core` 模块,然后 `-core` 模块又依赖了 `-test`,这样就形成了循环依赖,导致编译不通过。
9+
所以将这些约束器单独提取出来,放到一个新的模块中。
10+
11+
至于为什么需要将 `-test` 独立出来,可以看看 `-test` 模块的 [README.md](../spel-validator-test/README.md) 文件。

spel-validator-core/README.md

+8
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# 模块说明
2+
3+
此模块为校验器核心模块,提供了校验器的基本功能,包括校验器的注册、执行、结果汇总等。
4+
5+
该模块可以被单独使用,只需要遵循校验器的规范 [SpelConstraint](src/main/java/cn/sticki/spel/validator/core/SpelConstraint.java)
6+
并实现自己需要的约束注解即可。
7+
8+
但一般情况下,建议直接使用 `-javax``-jakarta` 模块,因为这两个模块已经提供了一些常用的约束注解和启动注解。

spel-validator-core/src/main/java/cn/sticki/spel/validator/core/SpelConstraint.java

+5-5
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
import java.lang.annotation.*;
44

55
/**
6-
* 将注解标记为由 {@link SpelValid} 进行校验的Bean验证约束。
6+
* 将注解标记为由 {@link cn.sticki.spel.validator.javax.SpelValid} 进行校验的Bean验证约束。
77
* <p>
88
* 该注解的属性 {@link SpelConstraint#validatedBy()} 用于指定校验器的实现类,实现类需要实现 {@link SpelConstraintValidator} 接口。
99
* <p>
@@ -15,20 +15,20 @@
1515
* 当 表达式为空 或 计算结果为true 时,才会对带注解的元素进行校验。
1616
* </li>
1717
* <li>{@code String[] group() default {};} 用于指定约束开启的分组条件,必须为合法的SpEL表达式。
18-
* 当分组信息不为空时,只有当 {@link SpelValid#spelGroups()} 中的分组信息与此处的分组信息有交集时,才会对带注解的元素进行校验。
18+
* 当分组信息不为空时,只有当 {@link cn.sticki.spel.validator.javax.SpelValid#spelGroups()} 中的分组信息与此处的分组信息有交集时,才会对带注解的元素进行校验。
1919
* 其计算结果可以是任何类型,但只有两个计算结果完全相等时,才被认为是相等的。
2020
* </li>
2121
* </ul>
2222
* <p>
2323
* 这里有一些定义约束的例子,可以参考:
2424
* <ul>
25-
* <li>{@link cn.sticki.spel.validator.core.constrain.SpelAssert}</li>
26-
* <li>{@link cn.sticki.spel.validator.core.constrain.SpelNotNull}</li>
25+
* <li>{@link cn.sticki.spel.validator.constrain.SpelAssert}</li>
26+
* <li>{@link cn.sticki.spel.validator.constrain.SpelNotNull}</li>
2727
* </ul>
2828
*
2929
* @author 阿杆
3030
* @version 1.0
31-
* @see SpelValid
31+
* @see cn.sticki.spel.validator.javax.SpelValid
3232
* @see SpelConstraintValidator
3333
* @since 2024/4/11
3434
*/

spel-validator-jakarta/README.md

+5
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# 模块说明
2+
3+
此模块是可以直接使用的,基于 `jakarta.validation-api` 的参数校验工具模块。
4+
5+
内包含启动注解和一些常用的约束注解,可以直接使用。

spel-validator-javax/README.md

+5
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# 模块说明
2+
3+
此模块是可以直接使用的,基于 `javax.validation-api` 的参数校验工具模块。
4+
5+
内包含启动注解和一些常用的约束注解,可以直接使用。

spel-validator-test/README.md

+3-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
1-
# 此模板内包含一些测试使用的工具
1+
# 模块说明
2+
3+
此模板内包含一些测试使用的工具,其他模块引入此模块时都需要以 `<scope>test</scope>` 的方式引入。
24

35
刚开始只有一个 `spel-validator`,里面包含了所有的代码。
46

0 commit comments

Comments
 (0)