@Slf4j @Controller @RequestMapping("/order") public class ForeOrderController { @Autowired private ProductService productService; @Autowired private ProductOrderItemService productOrderItemService; @Autowired private AddressService addressService; @Autowired private CategoryService categoryService; @Autowired private ProductImageService productImageService; @Autowired private ProductOrderService productOrderService; @Autowired private ReviewService reviewService; @Autowired private LastIDService lastIDService;

### 若依框架 Controller 的二次开发详解 若依框架是一个基于 Spring Boot 和 Vue.js 开发的企业级前后端分离架构平台，其设计目标是快速构建中小型互联网系统。在实际项目中，Controller 层作为前端请求与业务逻辑之间的桥梁，通常需要进行大量的定制化开发以满足不同的需求。 #### 1. **Controller 基础结构** 若依框架的 Controller 主要遵循 RESTful API 设计风格，采用统一返回格式封装响应数据。以下是典型的 Controller 方法结构： ```java @RestController @RequestMapping("/user") public class UserController { @Autowired private IUserService userService; /** * 查询用户列表 */ @GetMapping("/list") public AjaxResult list(User user, PageRequest pageRequest) { startPage(pageRequest); List<User> userList = userService.selectUserList(user); return AjaxResult.success(new PageInfo<>(userList)); } /** * 新增用户 */ @PostMapping("/add") public AjaxResult add(@RequestBody User user) { return toAjax(userService.insertUser(user)); } } ``` 上述代码展示了如何通过 `@RestController` 注解定义一个控制器类，并利用 `@RequestMapping` 明确 URL 路径映射关系[^2]。 --- #### 2. **参数校验** 为了提高系统的健壮性和用户体验，在接收客户端传参时应加入必要的校验机制。可以通过 Hibernate Validator 提供的标准注解完成字段级别的约束设置。 ```java @Data public class AddUserDto { @NotBlank(message = "用户名不能为空") private String username; @Email(message = "邮箱格式不正确") private String email; @Min(value = 0L, message = "年龄不能小于零") private Integer age; } ``` 当接收到不符合规则的数据时，会自动触发全局异常处理器并返回友好的提示信息给调用方。 --- #### 3. **分页查询增强** 若依默认集成了 MyBatis-Plus 工具库来简化 CRUD 操作流程，同时也支持配合第三方插件如 PageHelper 来实现复杂场景下的分页功能。下面给出一段自定义分页服务的例子： ```java @Service public class UserServiceImpl implements IUserService { @Override public IPage<User> selectUserPage(PageRequest pageRequest, User queryParam) { LambdaQueryWrapper<User> wrapper = new QueryWrapper<>(); if (StringUtils.isNotEmpty(queryParam.getUsername())) { wrapper.like(User::getUsername, queryParam.getUsername()); } return this.page( new Page<>(pageRequest.getPageNum(), pageRequest.getPageSize()), wrapper ); } } ``` 此片段说明了如何灵活运用动态 SQL 构建条件表达式以及适配不同类型的筛选项。 --- #### 4. **文件上传下载扩展** 针对大文件传输或者批量处理的需求，可以借助 Apache Commons FileUpload 或者 Spring MVC 自带的支持能力来进行改造升级。例如以下展示了一个安全可靠的文档存储方案： ```java @PostMapping("/upload") public AjaxResult uploadFile(MultipartFile file) throws IOException { // 文件大小限制判断 long maxSize = 10 * 1024 * 1024; // 10MB if (file.getSize() > maxSize) { throw new CustomException("单个文件不得超过10MB！"); } // 存储路径拼接 String fileName = UUID.randomUUID().toString(); String filePath = System.getProperty("user.dir") + "/uploads/" + fileName; Files.copy(file.getInputStream(), Paths.get(filePath), StandardCopyOption.REPLACE_EXISTING); return AjaxResult.success(fileName); } @GetMapping("/download/{fileName}") public ResponseEntity<Resource> downloadFile(@PathVariable String fileName) throws MalformedURLException { Path path = Paths.get(System.getProperty("user.dir"), "uploads", fileName); Resource resource = new UrlResource(path.toUri()); HttpHeaders headers = new HttpHeaders(); headers.add(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + URLEncoder.encode(resource.getFilename(), Charset.defaultCharset()) + "\""); return ResponseEntity.ok() .headers(headers) .contentLength(Files.size(path)) .body(resource); } ``` 这里不仅实现了基本的功能模块，还考虑到了边界情况比如超限检测、随机命名防覆盖等问题。 --- #### 5. **事务管理与幂等性保障** 对于涉及资金变动或者其他敏感操作的任务来说，确保每次提交都能唯一生效至关重要。推荐使用 Redis 分布锁加数据库乐观锁相结合的方式解决并发冲突风险。 ```java @Transactional(rollbackFor = Exception.class) public void updateStock(String productId, int quantity) { Product product = productService.findById(productId); if (product == null || product.getQuantity() < quantity) { throw new RuntimeException("库存不足"); } try (Jedis jedis = redisPool.getResource()) { String lockKey = "lock:" + productId; boolean acquiredLock = false; while (!acquiredLock) { Long result = jedis.setnx(lockKey, String.valueOf(System.currentTimeMillis())); if (result != null && result.equals(1L)) { // 成功获得锁 jedis.expire(lockKey, 10); // 设置有效时间为10秒防止死锁 acquiredLock = true; synchronized (this.getClass()) { // 双重锁定模式进一步减少竞争开销 product.decrease(quantity); productService.save(product); break; } } else { Thread.sleep(100); // 等待一段时间再尝试重新获取资源占用权 } } } catch (InterruptedException e) { log.error(e.getMessage(), e); } } ``` 该算法综合考量了效率与可靠性两方面因素，适用于大多数高并发环境下的更新作业。 --- #### 6. **日志记录与性能追踪** 最后别忘了为重要环节增加审计痕迹以便后续排查定位问题所在之处。结合 AOP 切面技术和 ELK 日志收集体系能够极大地方便运维人员的工作负担。 ```java @Aspect @Component @Slf4j public class LogAspect { @Pointcut("@annotation(com.ruoyi.common.annotation.Log)") public void logPointCut() {} @Around("logPointCut()") public Object around(ProceedingJoinPoint point) throws Throwable { StopWatch stopwatch = new StopWatch(); try { stopwatch.start(); Object proceed = point.proceed(); stopwatch.stop(); HttpServletRequest request = ((ServletRequestAttributes) RequestContextHolder.getRequestAttributes()).getRequest(); log.info("{} {} {} ms", request.getMethod(), request.getRequestURI(), stopwatch.getTotalTimeMillis()); return proceed; } finally { stopwatch.close(); } } } ``` 以上实例体现了良好的编码习惯有助于延长软件生命周期的同时降低维护成本。 ---