1
0

fix(jpa): 优化注释

This commit is contained in:
2026-01-21 22:18:40 +08:00
parent 2adf4951f7
commit e7fa23a365

View File

@@ -77,16 +77,6 @@ public abstract class SimpleServiceSupport<ENTITY extends SimpleEntity> implemen
this.repository = repository;
}
/**
* 保存实体对象
* <p>
* 使用saveOrUpdateByNotNullProperties方法保存实体只更新非空字段。
* 该方法具有事务性,遇到任何异常都会回滚。
* </p>
*
* @param entity 需要保存的实体对象
* @return 返回保存后的实体ID
*/
@Transactional(rollbackFor = Throwable.class)
@Override
public Long save(ENTITY entity) {
@@ -94,58 +84,24 @@ public abstract class SimpleServiceSupport<ENTITY extends SimpleEntity> implemen
return entity.getId();
}
/**
* 批量保存实体对象集合
* <p>
* 使用saveOrUpdateAllByNotNullProperties方法只更新非空字段。
* 该方法具有事务性,遇到任何异常都会回滚。
* </p>
*
* @param entities 需要保存的实体对象集合
*/
@Transactional(rollbackFor = Throwable.class)
@Override
public void save(Iterable<ENTITY> entities) {
repository.saveOrUpdateAllByNotNullProperties(entities);
}
/**
* 统计符合条件的实体数量
* <p>
* 根据listPredicate方法构建的条件统计实体数量。
* </p>
*
* @return 返回符合条件的实体数量
*/
@Transactional(readOnly = true)
@Override
public Long count() {
return repository.count(this::commonPredicates);
}
/**
* 获取所有符合条件的实体列表
* <p>
* 根据listPredicate方法构建的条件查询所有实体。
* </p>
*
* @return 返回符合条件的实体列表
*/
@Transactional(readOnly = true)
@Override
public List<ENTITY> list() {
return repository.findAll(this::commonPredicates);
}
/**
* 根据ID集合获取实体列表
* <p>
* 根据提供的ID集合查询对应的实体列表并结合listPredicate方法构建的条件。
* </p>
*
* @param ids ID集合
* @return 返回ID集合对应的实体列表
*/
@Transactional(readOnly = true)
@Override
public List<ENTITY> list(Set<Long> ids) {
@@ -167,16 +123,6 @@ public abstract class SimpleServiceSupport<ENTITY extends SimpleEntity> implemen
return null;
}
/**
* 根据查询条件分页获取实体列表
* <p>
* 支持复杂的查询条件和分页功能。
* 默认分页参数第1页每页10条记录按创建时间降序排列。
* </p>
*
* @param listQuery 查询条件对象
* @return 返回分页查询结果
*/
@Transactional(readOnly = true)
@Override
public Page<ENTITY> list(Query listQuery) {
@@ -236,15 +182,6 @@ public abstract class SimpleServiceSupport<ENTITY extends SimpleEntity> implemen
);
}
/**
* 根据ID获取实体详情
* <p>
* 如果实体不存在则返回null。
* </p>
*
* @param id 实体ID
* @return 返回实体详情不存在时返回null
*/
@Named("detail")
@Transactional(readOnly = true)
@Override
@@ -252,16 +189,6 @@ public abstract class SimpleServiceSupport<ENTITY extends SimpleEntity> implemen
return detailOptional(id).orElse(null);
}
/**
* 根据ID获取实体详情不存在时抛出异常
* <p>
* 如果实体不存在则抛出IdNotFoundException异常。
* </p>
*
* @param id 实体ID
* @return 返回实体详情
* @throws IdNotFoundException 当实体不存在时抛出
*/
@Named("detailOrThrow")
@Transactional(readOnly = true)
@Override
@@ -269,15 +196,6 @@ public abstract class SimpleServiceSupport<ENTITY extends SimpleEntity> implemen
return detailOptional(id).orElseThrow(() -> new IdNotFoundException(id));
}
/**
* 根据ID删除实体
* <p>
* 具有事务性,遇到任何异常都会回滚。
* 如果ID为空则不执行任何操作。
* </p>
*
* @param id 实体主键ID
*/
@Transactional(rollbackFor = Throwable.class)
@Override
public void remove(Long id) {
@@ -286,16 +204,6 @@ public abstract class SimpleServiceSupport<ENTITY extends SimpleEntity> implemen
}
}
/**
* 根据ID集合批量删除实体
* <p>
* 使用deleteAllById方法根据ID集合批量删除实体。
* 该方法具有事务性,遇到任何异常都会回滚。
* 如果ID集合为空则不执行任何操作。
* </p>
*
* @param ids 实体主键ID集合
*/
@Transactional(rollbackFor = Throwable.class)
@Override
public void remove(Set<Long> ids) {