使用 AI 辅助工具快速构建 Java 电商核心功能实战

第二步：接口设计与代码生成

表结构确定后，AI 可自动生成 Controller、Service 及 Mapper 层代码。以下为核心接口的实现示例。

1. 商品管理接口

package com.example.ecommerce.controller;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.example.ecommerce.common.Result;
import com.example.ecommerce.entity.Product;
import com.example.ecommerce.service.ProductService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.*;

import javax.annotation.Resource;
import java.util.List;

@RestController
@RequestMapping("/api/product")
@Slf4j
public class ProductController {

    @Resource
    private ProductService productService;

    /**
     * 新增商品
     */
    @PostMapping("/add")
    public Result<?> addProduct(@RequestBody Product product) {
        if (product.getPrice().compareTo(java.math.BigDecimal.ZERO) < 0) {
            return Result.fail("商品价格不能为负");
        }
        if (product.getStock() < 0) {
            return Result.fail("商品库存不能为负");
        }
        product.setStatus(1);
        boolean success = productService.save(product);
        if (success) {
            log.info("新增商品成功，商品 ID：{}", product.getId());
            return Result.success("新增商品成功", product.getId());
        }
        return Result.fail("新增商品失败");
    }

    /**
     * 商品列表查询
     */
    @GetMapping("/list")
    public Result<?> getProductList(
            @RequestParam(required = false) String productName,
            @RequestParam(defaultValue = "1") Integer pageNum,
            @RequestParam(defaultValue = "10") Integer pageSize,
            @RequestParam(defaultValue = "id") String sortField,
            @RequestParam(defaultValue = "desc") String sortType) {
        Page<Product> page = new Page<>(pageNum, pageSize);
        List<Product> productList = productService.getProductList(page, productName, sortField, sortType);
        page.setRecords(productList);
        log.info("查询商品列表成功，页码：{}，条数：{}", pageNum, productList.size());
        return Result.success("查询成功", page);
    }
}

2. 购物车接口（Redis 存储）

package com.example.ecommerce.controller;

import com.example.ecommerce.common.Result;
import com.example.ecommerce.entity.vo.CartVO;
import com.example.ecommerce.service.CartService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.*;

import javax.annotation.Resource;
import java.math.BigDecimal;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

@RestController
@RequestMapping("/api/cart")
@Slf4j
public class CartController {

    @Resource
    private CartService cartService;

    /**
     * 添加商品到购物车
     */
    @PostMapping("/add")
    public Result<?> addToCart(@RequestParam Long userId, @RequestParam Long productId, @RequestParam Integer buyNum) {
        String checkMsg = cartService.checkBeforeAdd(userId, productId, buyNum);
        if (checkMsg != null) {
            return Result.fail(checkMsg);
        }
        boolean success = cartService.addCart(userId, productId, buyNum);
        if (success) {
            log.info("添加购物车成功，用户 ID：{}，商品 ID：{}", userId, productId);
            return Result.success("添加购物车成功");
        }
        return Result.fail("添加购物车失败");
    }

    /**
     * 查询购物车列表
     */
    @GetMapping("/list")
    public Result<?> getCartList(@RequestParam Long userId) {
        List<CartVO> cartVOList = cartService.getCartList(userId);
        BigDecimal totalAmount = cartVOList.stream()
                .map(CartVO::getSubtotal)
                .reduce(java.math.BigDecimal.ZERO, java.math.BigDecimal::add);
        Map<String, Object> data = new HashMap<>();
        data.put("cartList", cartVOList);
        data.put("totalAmount", totalAmount);
        return Result.success("查询购物车成功", data);
    }
}

3. 订单核心接口

package com.example.ecommerce.controller;

import com.example.ecommerce.common.Result;
import com.example.ecommerce.entity.OrderInfo;
import com.example.ecommerce.entity.vo.OrderDetailVO;
import com.example.ecommerce.service.OrderService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.*;

import javax.annotation.Resource;
import java.util.List;

@RestController
@RequestMapping("/api/order")
@Slf4j
public class OrderController {

    @Resource
    private OrderService orderService;

    /**
     * 创建订单
     */
    @PostMapping("/create")
    public Result<?> createOrder(@RequestParam Long userId, @RequestParam String productIds) {
        String requestId = userId + "_" + System.currentTimeMillis();
        boolean isRepeat = orderService.checkRepeatRequest(requestId);
        if (isRepeat) {
            return Result.fail("请勿重复提交订单");
        }
        try {
            String orderNo = orderService.createOrder(userId, productIds);
            log.info("创建订单成功，用户 ID：{}，订单编号：{}", userId, orderNo);
            return Result.success("创建订单成功", orderNo);
        } catch (Exception e) {
            log.error("创建订单失败，用户 ID：{}，错误信息：{}", userId, e.getMessage());
            return Result.fail("创建订单失败：" + e.getMessage());
        }
    }

    /**
     * 查询订单列表
     */
    @GetMapping("/list")
    public Result<?> getOrderList(@RequestParam Long userId, @RequestParam(defaultValue = "1") Integer pageNum, @RequestParam(defaultValue = "10") Integer pageSize) {
        List<OrderInfo> orderList = orderService.getOrderList(userId, pageNum, pageSize);
        return Result.success("查询订单列表成功", orderList);
    }
}

第三步：测试与优化建议

1. 接口验证

启动项目后，可使用 Postman 进行接口测试。例如调用购物车添加接口：

• 地址：http://localhost:8080/api/cart/add
• 参数：userId=1&productId=1&buyNum=2
• 预期响应：{"code": 200, "msg": "添加购物车成功", "data": null}

若库存不足，系统应返回明确的错误提示，避免静默失败。

2. 工程化优化

在实际生产环境中，除了基础功能外，还需考虑以下优化点：

• 库存预热：高并发场景下，将热门商品库存缓存至 Redis，减少数据库压力。
• 订单超时取消：利用定时任务扫描超过 30 分钟未支付的订单，自动取消并恢复库存。
• 接口限流：对创建订单接口实施限流策略，防止恶意请求导致服务不可用。

以下为订单超时取消任务的示例代码：

package com.example.ecommerce.task;

import com.example.ecommerce.entity.OrderInfo;
import com.example.ecommerce.mapper.OrderInfoMapper;
import com.example.ecommerce.mapper.OrderItemMapper;
import com.example.ecommerce.mapper.ProductMapper;
import lombok.extern.slf4j.Slf4j;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
import org.springframework.transaction.annotation.Transactional;

import javax.annotation.Resource;
import java.time.LocalDateTime;
import java.util.List;

@Component
@Slf4j
public class OrderTimeoutTask {

    @Resource
    private OrderInfoMapper orderInfoMapper;

    @Resource
    private OrderItemMapper orderItemMapper;

    @Resource
    private ProductMapper productMapper;

    /**
     * 每 5 分钟执行一次：查询超过 30 分钟未支付的订单，改为已取消并恢复库存
     */
    @Scheduled(cron = "0 0/5 * * * ?")
    @Transactional(rollbackFor = Exception.class)
    public void cancelTimeoutOrder() {
        LocalDateTime timeoutTime = LocalDateTime.now().minusMinutes(30);
        List<OrderInfo> timeoutOrders = orderInfoMapper.selectTimeoutOrders(0, timeoutTime);
        for (OrderInfo order : timeoutOrders) {
            order.setPayStatus(2);
            order.setUpdateTime(LocalDateTime.now());
            orderInfoMapper.updateById(order);

            List<OrderItem> orderItems = orderItemMapper.selectByOrderId(order.getId());
            for (OrderItem item : orderItems) {
                var product = productMapper.selectById(item.getProductId());
                if (product != null) {
                    product.setStock(product.getStock() + item.getBuyNum());
                    productMapper.updateById(product);
                }
            }
            log.info("取消超时订单，订单编号：{}", order.getOrderNo());
        }
    }
}

四、总结

回顾整个开发流程，主要工作集中在需求梳理、SQL 建表及接口测试上。AI 工具承担了大部分样板代码编写、事务管理及异常处理逻辑，显著降低了重复劳动。相比传统开发模式，这种协作方式不仅缩短了交付周期，也减少了因人为疏忽导致的低级错误。对于希望提升研发效率的团队而言，合理引入 AI 辅助工具已成为一种趋势。