本文详细介绍了如何在lombok构建的对象中，为两个可空字段添加“至少一个必须存在”的业务约束。通过结合jsr 303 bean validation规范中的`@assertfalse`注解和自定义校验方法，可以优雅地实现当两个字段同时为空时触发校验失败，从而确保数据完整性，并提供了示例代码及注意事项。
业务场景：两个可选字段，至少一个必填
在构建数据模型时，我们经常会遇到这样的业务需求：一个对象中包含两个或多个字段，它们都可以是空值（nullable），但业务逻辑要求在任何给定实例中，这些字段中至少有一个必须被赋值。例如，一个联系人信息可能允许提供邮箱或电话号码，但不能两者都为空。Lombok库通过@Builder和@RequiredArgsConstructor等注解极大地简化了Java对象的创建，但其本身并不直接提供处理此类复杂业务约束的机制。
结合JSR 303 Bean Validation解决约束问题
Java的JSR 303（Bean Validation）规范提供了一种标准化的方式来定义和验证Java对象的约束。我们可以利用其内置的注解，特别是javax.validation.constraints.AssertFalse，来解决“两个可选字段至少一个必填”的问题。
@AssertFalse注解用于标记一个返回boolean类型的方法，它要求该方法的返回值必须为false才能通过验证。这为我们提供了一个灵活的机制：我们可以编写一个方法，当且仅当出现“两个字段都为空”的无效状态时，该方法返回true，然后用@AssertFalse来确保这种情况不会发生。
实现步骤与示例代码
假设我们有一个Example类，其中包含maybeA和maybeB两个String类型的字段，我们要求它们不能同时为空。
import lombok.Builder;import lombok.Getter;import lombok.RequiredArgsConstructor;import javax.validation.constraints.AssertFalse; // 确保已引入javax.validation-api依赖@Getter@Builder@RequiredArgsConstructorclass Example { private final String maybeA; private final String maybeB; /** * 自定义校验方法，用于检查maybeA和maybeB是否同时为空。 * 当且仅当maybeA和maybeB都为null时，返回true，表示出现无效状态。 * @return 如果两个字段都为空，则返回true；否则返回false。 */ @AssertFalse(message = "maybeA和maybeB不能同时为空，至少需要提供一个值。") private boolean oneFieldHasToExists() { // 当maybeA和maybeB都为null时，我们认为这是无效状态，返回true return maybeA == null && maybeB == null; } // 可以在此处添加main方法或其他测试代码来验证 public static void main(String[] args) { // 示例1: A和B都存在 - 应该通过校验 Example example1 = Example.builder().maybeA("ValueA").maybeB("ValueB").build(); System.out.println("Example 1: " + example1.getMaybeA() + ", " + example1.getMaybeB()); // 实际应用中，会通过Validator实例来校验 // 示例2: 只有A存在 - 应该通过校验 Example example2 = Example.builder().maybeA("ValueA").build(); System.out.println("Example 2: " + example2.getMaybeA() + ", " + example2.getMaybeB()); // 示例3: 只有B存在 - 应该通过校验 Example example3 = Example.builder().maybeB("ValueB").build(); System.out.println("Example 3: " + example3.getMaybeA() + ", " + example3.getMaybeB()); // 示例4: A和B都不存在 - 应该触发校验失败 Example example4 = Example.builder().build(); System.out.println("Example 4: " + example4.getMaybeA() + ", " + example4.getMaybeB()); }}
在上述代码中：
存了个图
视频图片解析/字幕/剪辑，视频高清保存/图片源图提取
17 查看详情 我们定义了一个私有的boolean类型方法oneFieldHasToExists()。这个方法的核心逻辑是return maybeA == null && maybeB == null;。这意味着只有当maybeA和maybeB都为null时，该方法才返回true。我们在oneFieldHasToExists()方法上添加了@AssertFalse注解。根据@AssertFalse的语义，它要求被注解的方法返回false才能通过校验。因此，当maybeA和maybeB同时为null时，oneFieldHasToExists()返回true，@AssertFalse就会触发校验失败。message属性用于自定义校验失败时返回的错误信息。
集成与注意事项
要使上述校验生效，您的项目需要集成一个JSR 303的实现，例如Hibernate Validator。通常，在Spring Boot应用中，只需添加spring-boot-starter-validation依赖即可自动配置。
org.springframework.boot spring-boot-starter-validation javax.validation validation-api 2.0.1.Final org.hibernate.validator hibernate-validator 6.0.13.Final
在实际使用时，您需要在需要校验Example对象的地方（例如REST控制器的方法参数、服务层逻辑等）使用@Valid注解触发校验：
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;@RestControllerpublic class ExampleController { @PostMapping("/examples") public String createExample(@Valid @RequestBody Example example) { // 如果example对象校验通过，则执行业务逻辑 return "Example created successfully: A=" + example.getMaybeA() + ", B=" + example.getMaybeB(); }}
当example对象的maybeA和maybeB都为null时，@Valid注解会触发校验，oneFieldHasToExists()方法返回true，@AssertFalse导致校验失败，进而抛出MethodArgumentNotValidException（在Spring MVC中），通常会被全局异常处理器捕获并返回相应的错误响应。
总结
通过巧妙地利用JSR 303 Bean Validation规范中的@AssertFalse注解，我们可以为Lombok构建的对象添加复杂的业务约束，例如“两个可选字段至少一个必填”的场景。这种方法将校验逻辑内聚到模型类中，保持了代码的整洁性和可维护性，并且与标准的Java验证框架无缝集成。对于更复杂的跨字段校验，也可以考虑自定义约束注解，但对于此类特定场景，@AssertFalse提供了一个简洁而有效的解决方案。
以上就是Lombok对象中实现两个可选字段至少一个存在的约束的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/286608.html
微信扫一扫 
支付宝扫一扫 
