service;
-
- /**
- * 保存实体对象
- *
- * 将保存项转换为实体对象后保存，返回保存后的实体ID。
- * 支持新增和更新操作，通过事务保证数据一致性。
- *
- *
- * @param item 需要保存的项
- * @return 返回保存后的实体ID响应对象，格式：{status: 0, message: "OK", data: 实体ID}
- * @throws Exception 保存过程中可能抛出的异常
- */
- @Transactional(rollbackFor = Throwable.class)
- @PostMapping(SAVE)
- @Override
- public GlobalResponse save(@RequestBody SAVE_ITEM item) throws Exception {
- var mapper = saveItemMapper();
- return GlobalResponse.responseSuccess(service.save(mapper.apply(item)));
- }
-
- /**
- * 获取所有实体列表
- *
- * 查询所有记录，不带任何过滤条件，返回分页格式的数据。
- * 将实体对象转换为列表项对象后返回。
- *
- *
- * @return 返回实体列表响应对象，格式：{status: 0, message: "OK", data: {items: [...], total: total}}
- * @throws Exception 查询过程中可能抛出的异常
- */
- @Transactional(readOnly = true)
- @GetMapping(LIST)
- @Override
- public GlobalResponse> list() throws Exception {
- var mapper = listItemMapper();
- var result = service.list();
- return GlobalResponse.responseListData(
- result
- .stream()
- .map(entity -> {
- try {
- return mapper.apply(entity);
- } catch (Exception e) {
- throw new RuntimeException(e);
- }
- })
- .toList(),
- result.size()
- );
- }
-
- /**
- * 根据查询条件获取实体列表
- *
- * 支持复杂的查询条件、排序和分页，返回符合条件的数据。
- * 将实体对象转换为列表项对象后返回。
- *
- *
- * @param query 查询条件对象，包含过滤条件、排序规则和分页信息
- * @return 返回符合条件的实体列表响应对象，格式：{status: 0, message: "OK", data: {items: [...], total: total}}
- * @throws Exception 查询过程中可能抛出的异常
- */
- @Transactional(readOnly = true)
- @PostMapping(LIST)
- @Override
- public GlobalResponse> list(@RequestBody Query query) throws Exception {
- if (ObjectHelper.isNull(query)) {
- return GlobalResponse.responseListData();
- }
- var mapper = listItemMapper();
- var result = service.list(query);
- return GlobalResponse.responseListData(
- result.items()
- .stream()
- .map(entity -> {
- try {
- return mapper.apply(entity);
- } catch (Exception e) {
- throw new RuntimeException(e);
- }
- })
- .toList(),
- result.total()
- );
- }
-
- /**
- * 根据ID获取实体详情
- *
- * 根据主键ID查询单条记录的详细信息，转换为详情项对象后返回。
- * 如果记录不存在则抛出异常。
- *
- *
- * @param id 实体主键ID
- * @return 返回实体详情响应对象，格式：{status: 0, message: "OK", data: 详情数据}
- * @throws Exception 查询过程中可能抛出的异常
- */
- @Transactional(readOnly = true)
- @GetMapping(DETAIL)
- @Override
- public GlobalResponse detail(@PathVariable("id") Long id) throws Exception {
- var mapper = detailItemMapper();
- return GlobalResponse.responseSuccess(mapper.apply(service.detailOrThrow(id)));
- }
-
- /**
- * 根据ID删除实体对象
- *
- * 根据主键ID删除指定的记录，执行成功后返回成功响应。
- * 通过事务保证删除操作的一致性。
- *
- *
- * @param id 需要删除的实体主键ID
- * @return 返回删除结果响应对象，格式：{status: 0, message: "OK", data: null}
- * @throws Exception 删除过程中可能抛出的异常
- */
- @Transactional(rollbackFor = Throwable.class)
- @GetMapping(REMOVE)
- @Override
- public GlobalResponse