289 lines
11 KiB
Markdown
289 lines
11 KiB
Markdown
# 订单服务开发文档 - Part 2（Service实现 + Controller）
|
||
|
||
## 四、Service 实现
|
||
|
||
### OrderServiceImpl.java
|
||
|
||
```java
|
||
package com.openclaw.service.impl;
|
||
|
||
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
|
||
import com.baomidou.mybatisplus.core.metadata.IPage;
|
||
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
|
||
import com.openclaw.constant.ErrorCode;
|
||
import com.openclaw.dto.*;
|
||
import com.openclaw.entity.*;
|
||
import com.openclaw.exception.BusinessException;
|
||
import com.openclaw.repository.*;
|
||
import com.openclaw.service.*;
|
||
import com.openclaw.util.IdGenerator;
|
||
import com.openclaw.vo.*;
|
||
import lombok.RequiredArgsConstructor;
|
||
import org.springframework.stereotype.Service;
|
||
import org.springframework.transaction.annotation.Transactional;
|
||
import java.math.BigDecimal;
|
||
import java.time.LocalDateTime;
|
||
import java.util.ArrayList;
|
||
import java.util.List;
|
||
|
||
@Service
|
||
@RequiredArgsConstructor
|
||
public class OrderServiceImpl implements OrderService {
|
||
|
||
private final OrderRepository orderRepo;
|
||
private final OrderItemRepository itemRepo;
|
||
private final OrderRefundRepository refundRepo;
|
||
private final SkillRepository skillRepo;
|
||
private final SkillDownloadRepository downloadRepo;
|
||
private final PointsService pointsService;
|
||
private final IdGenerator idGenerator;
|
||
|
||
private static final BigDecimal POINTS_RATE = new BigDecimal("0.01"); // 1积分=0.01元
|
||
|
||
@Override
|
||
@Transactional
|
||
public OrderVO createOrder(Long userId, OrderCreateDTO dto) {
|
||
List<Skill> skills = new ArrayList<>();
|
||
BigDecimal total = BigDecimal.ZERO;
|
||
|
||
for (Long skillId : dto.getSkillIds()) {
|
||
Skill skill = skillRepo.selectById(skillId);
|
||
if (skill == null || !"approved".equals(skill.getStatus()))
|
||
throw new BusinessException(ErrorCode.SKILL_NOT_FOUND);
|
||
if (downloadRepo.existsByUserIdAndSkillId(userId, skillId))
|
||
throw new BusinessException(ErrorCode.SKILL_ALREADY_OWNED);
|
||
skills.add(skill);
|
||
total = total.add(Boolean.TRUE.equals(skill.getIsFree()) ? BigDecimal.ZERO : skill.getPrice());
|
||
}
|
||
|
||
// 积分抵扣计算
|
||
int pts = dto.getPointsToUse() == null ? 0 : dto.getPointsToUse();
|
||
BigDecimal ptsDed = BigDecimal.ZERO;
|
||
if (pts > 0) {
|
||
if (!pointsService.hasEnoughPoints(userId, pts))
|
||
throw new BusinessException(ErrorCode.POINTS_NOT_ENOUGH);
|
||
ptsDed = new BigDecimal(pts).multiply(POINTS_RATE).min(total);
|
||
}
|
||
BigDecimal cash = total.subtract(ptsDed);
|
||
|
||
// 创建订单主记录
|
||
Order order = new Order();
|
||
order.setOrderNo(idGenerator.generateOrderNo());
|
||
order.setUserId(userId);
|
||
order.setTotalAmount(total);
|
||
order.setCashAmount(cash);
|
||
order.setPointsUsed(pts);
|
||
order.setPointsDeductAmount(ptsDed);
|
||
order.setStatus("pending");
|
||
order.setPaymentMethod(dto.getPaymentMethod());
|
||
order.setExpiredAt(LocalDateTime.now().plusMinutes(30));
|
||
orderRepo.insert(order);
|
||
|
||
// 创建订单项（快照商品信息）
|
||
for (Skill s : skills) {
|
||
OrderItem item = new OrderItem();
|
||
item.setOrderId(order.getId());
|
||
item.setSkillId(s.getId());
|
||
item.setSkillName(s.getName());
|
||
item.setSkillCover(s.getCoverImageUrl());
|
||
BigDecimal price = Boolean.TRUE.equals(s.getIsFree()) ? BigDecimal.ZERO : s.getPrice();
|
||
item.setUnitPrice(price);
|
||
item.setQuantity(1);
|
||
item.setTotalPrice(price);
|
||
itemRepo.insert(item);
|
||
}
|
||
|
||
// 冻结积分
|
||
if (pts > 0) pointsService.freezePoints(userId, pts, order.getId());
|
||
|
||
// 纯免费/纯积分支付直接完成，无需拉起支付
|
||
if (cash.compareTo(BigDecimal.ZERO) == 0) {
|
||
handlePaySuccess(order.getOrderNo(), null);
|
||
}
|
||
|
||
return buildOrderVO(order);
|
||
}
|
||
|
||
@Override
|
||
public OrderVO getOrderDetail(Long orderId, Long userId) {
|
||
Order order = orderRepo.selectById(orderId);
|
||
if (order == null || !order.getUserId().equals(userId))
|
||
throw new BusinessException(ErrorCode.ORDER_NOT_FOUND);
|
||
return buildOrderVO(order);
|
||
}
|
||
|
||
@Override
|
||
public IPage<OrderVO> listOrders(Long userId, String status, int pageNum, int pageSize) {
|
||
IPage<Order> page = orderRepo.selectPage(
|
||
new Page<>(pageNum, pageSize),
|
||
new LambdaQueryWrapper<Order>()
|
||
.eq(Order::getUserId, userId)
|
||
.eq(status != null, Order::getStatus, status)
|
||
.orderByDesc(Order::getCreatedAt));
|
||
return page.convert(this::buildOrderVO);
|
||
}
|
||
|
||
@Override
|
||
@Transactional
|
||
public void cancelOrder(Long orderId, Long userId, String reason) {
|
||
Order order = orderRepo.selectById(orderId);
|
||
if (order == null || !order.getUserId().equals(userId))
|
||
throw new BusinessException(ErrorCode.ORDER_NOT_FOUND);
|
||
if (!"pending".equals(order.getStatus()))
|
||
throw new BusinessException(ErrorCode.ORDER_STATUS_ERROR);
|
||
order.setStatus("cancelled");
|
||
order.setCancelReason(reason);
|
||
orderRepo.updateById(order);
|
||
// 解冻积分
|
||
if (order.getPointsUsed() != null && order.getPointsUsed() > 0)
|
||
pointsService.unfreezePoints(userId, order.getPointsUsed(), orderId);
|
||
}
|
||
|
||
@Override
|
||
@Transactional
|
||
public void handlePaySuccess(String orderNo, String transactionId) {
|
||
Order order = orderRepo.findByOrderNo(orderNo);
|
||
if (order == null) throw new BusinessException(ErrorCode.ORDER_NOT_FOUND);
|
||
if ("paid".equals(order.getStatus())) return; // 幂等处理
|
||
|
||
order.setStatus("paid");
|
||
order.setPaidAt(LocalDateTime.now());
|
||
orderRepo.updateById(order);
|
||
|
||
// 消耗冻结积分（正式扣减）
|
||
if (order.getPointsUsed() != null && order.getPointsUsed() > 0)
|
||
pointsService.consumePoints(order.getUserId(), order.getPointsUsed(), order.getId(), "order");
|
||
|
||
// 授权Skill访问权限
|
||
String dlType = (order.getPointsUsed() != null && order.getPointsUsed() > 0
|
||
&& order.getCashAmount().compareTo(BigDecimal.ZERO) == 0) ? "points" : "paid";
|
||
itemRepo.findByOrderId(order.getId()).forEach(item ->
|
||
downloadRepo.grantAccess(order.getUserId(), item.getSkillId(), order.getId(), dlType));
|
||
}
|
||
|
||
@Override
|
||
@Transactional
|
||
public void applyRefund(Long orderId, Long userId, RefundApplyDTO dto) {
|
||
Order order = orderRepo.selectById(orderId);
|
||
if (order == null || !order.getUserId().equals(userId))
|
||
throw new BusinessException(ErrorCode.ORDER_NOT_FOUND);
|
||
if (!"paid".equals(order.getStatus()) && !"completed".equals(order.getStatus()))
|
||
throw new BusinessException(ErrorCode.ORDER_STATUS_ERROR);
|
||
order.setStatus("refunding");
|
||
orderRepo.updateById(order);
|
||
|
||
OrderRefund refund = new OrderRefund();
|
||
refund.setOrderId(orderId);
|
||
refund.setRefundNo(idGenerator.generateRefundNo());
|
||
refund.setRefundAmount(order.getCashAmount());
|
||
refund.setRefundPoints(order.getPointsUsed());
|
||
refund.setReason(dto.getReason());
|
||
if (dto.getImages() != null) refund.setImages(dto.getImages().toString());
|
||
refund.setStatus("pending");
|
||
refundRepo.insert(refund);
|
||
}
|
||
|
||
private OrderVO buildOrderVO(Order order) {
|
||
OrderVO vo = new OrderVO();
|
||
vo.setId(order.getId());
|
||
vo.setOrderNo(order.getOrderNo());
|
||
vo.setTotalAmount(order.getTotalAmount());
|
||
vo.setCashAmount(order.getCashAmount());
|
||
vo.setPointsUsed(order.getPointsUsed());
|
||
vo.setPointsDeductAmount(order.getPointsDeductAmount());
|
||
vo.setStatus(order.getStatus());
|
||
vo.setStatusLabel(switch (order.getStatus()) {
|
||
case "pending" -> "待支付";
|
||
case "paid" -> "已支付";
|
||
case "completed" -> "已完成";
|
||
case "cancelled" -> "已取消";
|
||
case "refunding" -> "退款中";
|
||
case "refunded" -> "已退款";
|
||
default -> order.getStatus();
|
||
});
|
||
vo.setPaymentMethod(order.getPaymentMethod());
|
||
vo.setCreatedAt(order.getCreatedAt());
|
||
vo.setPaidAt(order.getPaidAt());
|
||
vo.setItems(itemRepo.findByOrderId(order.getId()).stream().map(i -> {
|
||
OrderItemVO iv = new OrderItemVO();
|
||
iv.setSkillId(i.getSkillId());
|
||
iv.setSkillName(i.getSkillName());
|
||
iv.setSkillCover(i.getSkillCover());
|
||
iv.setUnitPrice(i.getUnitPrice());
|
||
iv.setQuantity(i.getQuantity());
|
||
iv.setTotalPrice(i.getTotalPrice());
|
||
return iv;
|
||
}).toList());
|
||
return vo;
|
||
}
|
||
}
|
||
```
|
||
|
||
## 五、Controller
|
||
|
||
### OrderController.java
|
||
|
||
```java
|
||
package com.openclaw.controller;
|
||
|
||
import com.baomidou.mybatisplus.core.metadata.IPage;
|
||
import com.openclaw.common.Result;
|
||
import com.openclaw.dto.*;
|
||
import com.openclaw.service.OrderService;
|
||
import com.openclaw.util.UserContext;
|
||
import com.openclaw.vo.*;
|
||
import jakarta.validation.Valid;
|
||
import lombok.RequiredArgsConstructor;
|
||
import org.springframework.web.bind.annotation.*;
|
||
|
||
@RestController
|
||
@RequestMapping("/api/v1/orders")
|
||
@RequiredArgsConstructor
|
||
public class OrderController {
|
||
|
||
private final OrderService orderService;
|
||
|
||
/** 创建订单 */
|
||
@PostMapping
|
||
public Result<OrderVO> createOrder(@Valid @RequestBody OrderCreateDTO dto) {
|
||
return Result.ok(orderService.createOrder(UserContext.getUserId(), dto));
|
||
}
|
||
|
||
/** 订单详情 */
|
||
@GetMapping("/{id}")
|
||
public Result<OrderVO> getDetail(@PathVariable Long id) {
|
||
return Result.ok(orderService.getOrderDetail(id, UserContext.getUserId()));
|
||
}
|
||
|
||
/** 订单列表 */
|
||
@GetMapping
|
||
public Result<IPage<OrderVO>> listOrders(
|
||
@RequestParam(required = false) String status,
|
||
@RequestParam(defaultValue = "1") int pageNum,
|
||
@RequestParam(defaultValue = "10") int pageSize) {
|
||
return Result.ok(orderService.listOrders(UserContext.getUserId(), status, pageNum, pageSize));
|
||
}
|
||
|
||
/** 取消订单 */
|
||
@PutMapping("/{id}/cancel")
|
||
public Result<Void> cancelOrder(
|
||
@PathVariable Long id,
|
||
@RequestParam(required = false) String reason) {
|
||
orderService.cancelOrder(id, UserContext.getUserId(), reason);
|
||
return Result.ok();
|
||
}
|
||
|
||
/** 申请退款 */
|
||
@PostMapping("/{id}/refund")
|
||
public Result<Void> applyRefund(
|
||
@PathVariable Long id,
|
||
@Valid @RequestBody RefundApplyDTO dto) {
|
||
orderService.applyRefund(id, UserContext.getUserId(), dto);
|
||
return Result.ok();
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
**文档版本**：v1.0 | **创建日期**：2026-03-16
|