@positive 和 @negative 是 jakarta bean validation 的内置注解，分别校验数值是否严格大于0或小于0，需配合 hibernate validator 等实现及 @valid 触发验证，支持多种数值类型。
Java 中的 @Positive 和 @Negative 是 Bean Validation（JSR 380，即 Jakarta Bean Validation）规范提供的内置约束注解，用于校验数值是否为正数或负数。它们不能直接在 Java 原生代码中使用，需配合验证框架（如 Hibernate Validator）和校验触发机制（如 Spring Boot 的 @Valid）才能生效。
需要引入依赖和启用验证
以 Maven 为例，确保项目包含 Jakarta Bean Validation 实现（推荐 Hibernate Validator 7+）：
注意：Spring Boot 3.x 默认使用 Jakarta EE 9+ 命名空间（jakarta.validation.*），不再是 javax.validation.*
- Gradle（Spring Boot 3.x）：
implementation 'org.springframework.boot:spring-boot-starter-validation'
- 该 starter 已自动包含
jakarta.validationAPI 和 Hibernate Validator 实现 - 无需额外添加
hibernate-validator依赖（除非需自定义版本）
基本用法示例
在实体类或 DTO 的字段上直接标注：
public class AccountRequest {
@Positive(message = "余额必须为正数")
private BigDecimal balance;
@Negative(message = "折扣率必须为负数（表示优惠）")
private Double discount;
// getter/setter...
}
-
@Positive要求值 > 0（不包含 0）；支持short、int、long、float、double、BigDecimal、BigInteger及其包装类型 -
@Negative要求值 - 0 既不被
@Positive接受，也不被@Negative接受；如需允许 0，改用@PositiveOrZero或@NegativeOrZero
在 Spring MVC 中触发校验
Controller 方法参数加 @Valid 即可激活校验：
@PostMapping("/account")
public ResponseEntity<string> create(@Valid @RequestBody AccountRequest request) {
return ResponseEntity.ok("创建成功");
}</string>
- 若校验失败（如 balance=0 或 discount=0.1），Spring 会自动返回 400 Bad Request，并携带错误信息（默认为 JSON 格式的
ConstraintViolationException细节） - 可通过
@ExceptionHandler(MethodArgumentNotValidException.class)自定义错误响应格式
常见注意事项
- 这些注解只对非 null 值生效；若字段可为空，需额外加
@NotNull或使用@PositiveOrZero等组合逻辑 - 不支持基本类型（如
int balance）的 null 校验（基本类型无法为 null），建议统一使用包装类型（Integer） - 浮点数校验存在精度风险（如
-0.0被视为 0，不满足@Negative）；业务中建议优先用BigDecimal表达精确数值 - 自定义 message 支持占位符，例如：
@Positive(message = "金额 {value} 必须大于 0")（{value}会被自动替换为实际值）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
