兼容旧接口路径的桥接实现方案.md 3.66 KB

Edit Raw Blame History Permalink


现状排查结论

material/out/listForPage：已迁移并存在，路径不变（POST）。位置：controller/admin/material/MaterialOutController.java:39
费用类接口已迁移到 garden 模块，但基础路径统一为 garden/*，查询接口统一使用 GET /page：


旧 /costfee/departmentcost/list → 新 GET /garden/department-cost/page（部门费用）位置：controller/admin/departmentcost/DepartmentCostController.java:83
旧 /costfee/mechanicalcost/list → 新 GET /garden/mechanical-cost/page（自有机械费用）位置：controller/admin/mechanicalcost/MechanicalCostController.java:107
旧 /costfee/rentalmechanicalcost/list → 新 GET /garden/rental-mechanical-cost/page（租赁机械费用）位置：controller/admin/rentalmechanicalcost/RentalMechanicalCostController.java:99
旧 /costfee/gardenwasterecord/list → 新 GET /garden/waste-record/page（园林废弃物）位置：controller/admin/wasterecord/WasteRecordController.java:83

系统用户分页：旧 /system/user/listForPage 不存在；新为 GET /system/user/page，位置：urbanops-module-system/controller/admin/user/UserController.java:99

目标

在不改动前端的情况下，兼容旧路径：为上述旧路径添加桥接（alias）接口，委托到现有服务或新路径，实现等价分页/列表能力。

实施方案

新增桥接控制器（不改现有业务控制器）：


controller/admin/costfee/DepartmentCostBridgeController：@RequestMapping("/costfee/departmentcost")


@GetMapping("/list") → 适配分页 VO，内部调用 departmentCostService.getDepartmentCostPage(...)

controller/admin/costfee/MechanicalCostBridgeController：@RequestMapping("/costfee/mechanicalcost")


@GetMapping("/list") → 委托 mechanicalCostService.getMechanicalCostPage(...)

controller/admin/costfee/RentalMechanicalCostBridgeController：@RequestMapping("/costfee/rentalmechanicalcost")


@GetMapping("/list") → 委托 rentalMechanicalCostService.getRentalMechanicalCostPage(...)

controller/admin/costfee/GardenWasteRecordBridgeController：@RequestMapping("/costfee/gardenwasterecord")


@GetMapping("/list") → 委托 wasteRecordService.getWasteRecordPage(...)


系统用户桥接：


在 urbanops-module-system 新增 controller/admin/user/UserBridgeController：@RequestMapping("/system/user")


@PostMapping("/listForPage") → 将请求体（或表单）转换为 UserPageReqVO，委托 AdminUserService.getUserPage(...) 返回分页。


统一返回结构：


所有桥接接口返回 CommonResult<PageResult<...>>，与现有新接口保持一致；如旧前端要求表格结构，按需封装字段但不改核心分页数据。

权限与审计：


复用现有权限标识：@PreAuthorize 与对应 garden:* 或 system:* 权限，不新增冗余权限点。

兼容性细节：


旧接口使用 list 命名且可能 GET；桥接按旧签名支持 GET 并允许 query 传参；必要时支持 POST（根据旧前端调用方式）。
字段名差异通过桥接层 VO 做轻量映射（如旧字段为 pageNum/pageSize）。


测试与验证

为每个桥接接口补充最小的集成测试：校验分页入参映射、权限与返回数据结构。
本地编译与启动后，用现有新接口的数据源验证桥接输出一致性。

变更范围控制

不改现有业务控制器和服务实现；新增仅限桥接控制器与必要的请求 VO（轻量）。
不改数据库结构与 Mapper。


请确认以上桥接方案；确认后我将按上述路径添加兼容接口并进行编译与验证。