本文探讨了在lombok生成的java对象中，如何为两个可空字段（例如`maybea`和`maybeb`）设置一个约束，即它们不能同时为null，至少其中一个必须存在。通过结合使用`javax.validation.constraints.assertfalse`注解和一个自定义的验证方法，我们能够有效地实现这一“异或”逻辑，确保数据模型的完整性和业务规则的遵循，而无需放弃lombok的便捷性。
1. 问题背景与需求
在使用Lombok的@Builder和@RequiredArgsConstructor等注解构建数据对象时，我们经常会遇到这样的场景：对象中包含多个字段，它们各自都可以是null。然而，在某些业务逻辑中，我们需要强制要求这些可空字段中的至少一个必须有值，即它们不能全部为null。例如，一个Example对象有两个字符串字段maybeA和maybeB，我们希望允许以下情况：
- maybeA有值，maybeB有值
- maybeA有值，maybeB为null
- maybeA为null，maybeB有值
但不允许以下情况：
- maybeA为null，maybeB为null
Lombok本身提供的注解（如@NonNull）只能强制单个字段非空，无法直接表达这种“异或”或“至少一个”的复杂约束。
2. 解决方案：结合JSR 380 (Bean Validation)
解决此类问题的标准方法是利用Java Bean Validation API (JSR 380)，特别是其提供的自定义验证能力。javax.validation.constraints包中的注解，如@AssertFalse，可以用于标记一个方法，该方法返回true时表示验证失败。
2.1 引入依赖
首先，确保你的项目中已引入Bean Validation API及其实现（如Hibernate Validator）。 在Maven项目中，通常需要添加以下依赖：
javax.validation validation-api 2.0.1.Final org.hibernate.validator hibernate-validator 6.1.7.Final
2.2 实现自定义验证逻辑
在Lombok生成的对象中，我们可以添加一个私有方法，该方法封装了“两个字段都为null”的判断逻辑，并使用@AssertFalse注解。
示例代码：
import lombok.Builder;
import lombok.Getter;
import lombok.RequiredArgsConstructor;
import javax.validation.constraints.AssertFalse; // 确保导入正确的包
@Getter
@Builder
@RequiredArgsConstructor
public class Example {
private final String maybeA;
private final String maybeB;
/**
* 验证方法：确保 maybeA 和 maybeB 不能同时为 null。
* @AssertFalse 表示当此方法返回 true 时，验证失败。
* 因此，当 maybeA 和 maybeB 都为 null 时，我们希望返回 true。
*/
@AssertFalse(message = "maybeA 和 maybeB 不能同时为 null，至少一个必须存在。")
private boolean oneFieldHasToExist() {
return maybeA == null && maybeB == null;
}
// 可以在这里添加 main 方法或测试用例来演示
public static void main(String[] args) {
// 示例：有效的对象
Example validExample1 = Example.builder().maybeA("Value A").build();
Example validExample2 = Example.builder().maybeB("Value B").build();
Example validExample3 = Example.builder().maybeA("Value A").maybeB("Value B").build();
// 示例：无效的对象 (两个都为 null)
Example invalidExample = Example.builder().build(); // maybeA 和 maybeB 都是 null
// 实际应用中，你需要一个 Validator 实例来执行验证
// 例如：
// ValidatorFactory factory = Validation.buildDefaultValidatorFactory();
// Validator validator = factory.getValidator();
// Set> violations = validator.validate(invalidExample);
// violations.forEach(v -> System.out.println(v.getMessage()));
}
} 解释：
- @AssertFalse: 这个注解是关键。它告诉Bean Validation框架，如果它所注解的方法返回true，则表示验证失败。
-
oneFieldHasToExist() 方法:
- 这个方法被标记为@AssertFalse。
- 它的逻辑是 return maybeA == null && maybeB == null;。
- 这意味着，当maybeA和maybeB都为null时，该方法返回true。
- 根据@AssertFalse的语义，此时验证失败，从而实现了“不能同时为null”的约束。
- message 属性: 可以在@AssertFalse注解中指定message属性，用于自定义验证失败时返回的错误信息，这对于用户体验和调试非常重要。
3. 如何在应用中使用
在Spring Boot等Web框架中，通常会在Controller层接收请求体时使用@Valid注解来触发Bean Validation。
import org.springframework.http.ResponseEntity;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
import javax.validation.Valid; // 确保导入正确的包
@RestController
@Validated // 如果需要在方法参数上使用 @Valid，通常 Controller 需要被 @Validated 标记
public class ExampleController {
@PostMapping("/examples")
public ResponseEntity createExample(@Valid @RequestBody Example example) {
// 如果 example 对象通过了所有验证，则执行业务逻辑
System.out.println("Received valid example: " + example.getMaybeA() + ", " + example.getMaybeB());
return ResponseEntity.ok("Example created successfully!");
}
} 当客户端发送一个maybeA和maybeB都为null的Example对象时，@Valid注解会触发验证，oneFieldHasToExist()方法会返回true，导致验证失败，Spring框架会自动捕获MethodArgumentNotValidException并返回一个400 Bad Request错误以及相应的错误信息。
4. 注意事项与总结
- 注解位置: AssertFalse（或其他@AssertTrue等）通常注解在方法上，而不是字段上。这个方法可以是私有的，因为Bean Validation框架会通过反射调用它。
- 逻辑反转: 使用@AssertFalse时，方法的返回true表示违反了约束（即验证失败），而不是满足约束。这一点需要特别注意，避免混淆。
- 错误信息: 始终为验证注解提供清晰的message，以便在验证失败时提供有用的反馈。
- 组合验证: 对于更复杂的跨字段验证逻辑，可以考虑创建自定义的组合注解。但这通常比直接使用@AssertFalse或@AssertTrue更复杂。
- Lombok与Validation: Lombok生成的代码（如构造函数、getter）与Bean Validation注解可以很好地协同工作，互不干扰。
通过上述方法，我们能够在保持Lombok的简洁性和开发效率的同时，有效地为复杂的数据模型添加自定义的跨字段验证规则，确保应用程序的数据完整性和业务逻辑的正确性。
