feat: 为ExampleService添加findFirst方法,用于查询条件匹配到多个结果导致findOne不适用的场景

Author: yindz

service/src/main/java/io/mybatis/service/AbstractService.java

@@ -259,6 +259,18 @@ public T findOne(Example<T> example) {
     return baseMapper.selectOneByExample(example).orElse(null);
   }
 
+  /**
+   * 根据 example 条件查询并返回第1个结果(当结果多于1个时不抛出异常)
+   *
+   * @param example 查询条件
+   * @return 实体
+   */
+  @Override
+  public T findFirst(Example<T> example) {
+    List<T> list = baseMapper.selectByExample(example);
+    return (list == null || list.isEmpty()) ? null : list.get(0);
+  }
+
   /**
    * 根据 example 条件查询
    *

service/src/main/java/io/mybatis/service/ExampleService.java

@@ -73,6 +73,14 @@ default Example<T> example() {
    */
   T findOne(Example<T> example);
 
+  /**
+   * 根据 example 条件查询并返回第1个结果(当结果多于1个时不抛出异常)
+   *
+   * @param example 查询条件
+   * @return 实体
+   */
+  T findFirst(Example<T> example);
+
   /**
    * 根据 example 条件查询
    *