Ver Fonte

refactor(api): 优化充电接口路径命名为下划线风格

- 将 ChargingBusinessController 中所有接口路径由驼峰命名改为下划线分隔
- 更新 ThirdPartyApiLogAspect 中对应接口说明的路径匹配,保持一致性
- 规范接口命名风格,提升代码可读性和统一性
SheepHy há 2 dias atrás
pai
commit
9d1bbe64f0

+ 7 - 7
src/main/java/com/zsElectric/boot/charging/aspect/ThirdPartyApiLogAspect.java

@@ -326,19 +326,19 @@ public class ThirdPartyApiLogAspect {
             return "设备状态变化推送";
         }
         // ChargingBusinessController 接口说明
-        else if (uri.contains("/queryEquipBusinessPolicy")) {
+        else if (uri.contains("/query_equip_business_policy")) {
             return "查询业务策略信息";
-        } else if (uri.contains("/queryEquipAuth")) {
+        } else if (uri.contains("/query_equip_auth")) {
             return "请求设备认证";
-        } else if (uri.contains("/queryStationsInfo")) {
+        } else if (uri.contains("/query_stations_info")) {
             return "查询充电站信息";
-        } else if (uri.contains("/queryStationStatus")) {
+        } else if (uri.contains("/query_station_status")) {
             return "设备接口状态查询";
-        } else if (uri.contains("/startCharging")) {
+        } else if (uri.contains("/query_start_charge")) {
             return "请求启动充电";
-        } else if (uri.contains("/queryChargingStatus")) {
+        } else if (uri.contains("/query_equip_charge_status")) {
             return "查询充电状态";
-        } else if (uri.contains("/stopCharging")) {
+        } else if (uri.contains("/query_stop_charge")) {
             return "请求停止充电";
         }
         

+ 7 - 7
src/main/java/com/zsElectric/boot/charging/controller/ChargingBusinessController.java

@@ -34,7 +34,7 @@ public class ChargingBusinessController {
      *
      */
     @Operation(summary = "查询业务策略信息")
-    @GetMapping("/queryEquipBusinessPolicy")
+    @GetMapping("/query_equip_business_policy")
     @Log(value = "查询业务策略信息", module = LogModuleEnum.PARKING_CALL, params = true, result = true)
     public Result<ChargingPricePolicyVO> queryEquipBusinessPolicy(@RequestParam("EquipBizSeq") @Schema(description = "设备业务流水号", example = "123456789123456789123456789") String EquipBizSeq,
                                                                    @RequestParam("ConnectorID") @Schema(description = "充电设备接口编码") String ConnectorID) throws Exception{
@@ -50,7 +50,7 @@ public class ChargingBusinessController {
      *
      */
     @Operation(summary = "请求设备认证")
-    @GetMapping("/queryEquipAuth")
+    @GetMapping("/query_equip_auth")
     @Log(value = "请求设备认证", module = LogModuleEnum.PARKING_CALL, params = true, result = true)
     public Result<EquipmentAuthResponseVO> queryEquipAuth(String EquipAuthSeq, String ConnectorID) throws JsonProcessingException {
         return Result.success(chargingBusinessService.queryEquipAuth(EquipAuthSeq, ConnectorID));
@@ -66,7 +66,7 @@ public class ChargingBusinessController {
      *
      */
     @Operation(summary = "查询充电站信息")
-    @GetMapping("/queryStationsInfo")
+    @GetMapping("/query_stations_info")
     @Log(value = "查询充电站信息", module = LogModuleEnum.PARKING_CALL, params = true, result = true)
     public Result<QueryStationsInfoVO> queryStationsInfo(@RequestParam(value = "LastQueryTime", required = false) @Schema(description = "最后一次查询时间") String LastQueryTime,
                                                          @RequestParam(value = "PageNo",defaultValue = "1") @Schema(description = "页码") Integer PageNo,
@@ -82,7 +82,7 @@ public class ChargingBusinessController {
      *
      */
     @Operation(summary = "设备接口状态查询")
-    @PostMapping("/queryStationStatus")
+    @PostMapping("/query_station_status")
     @Log(value = "设备接口状态查询", module = LogModuleEnum.PARKING_CALL, params = true, result = true)
      public Result<QueryStationStatusVO> queryStationStatus(@RequestBody List<String> stationIDs) throws JsonProcessingException {
         return Result.success(chargingBusinessService.queryStationStatus(stationIDs));
@@ -96,7 +96,7 @@ public class ChargingBusinessController {
      * @return 返回值描述,如无返回值则为void 返回值为类则包含{@link StartChargingResponseVO}
      */
     @Operation(summary = "请求启动充电")
-    @PostMapping("/startCharging")
+    @PostMapping("/query_start_charge")
     @Log(value = "请求启动充电", module = LogModuleEnum.PARKING_CALL, params = true, result = true)
     public Result<StartChargingResponseVO> startCharging(@RequestBody StartChargingRequestDTO requestDTO) throws JsonProcessingException {
         return Result.success(chargingBusinessService.startCharging(requestDTO));
@@ -107,7 +107,7 @@ public class ChargingBusinessController {
      * @author SheepHy
      */
     @Operation(summary = "查询充电状态")
-    @PostMapping("/queryChargingStatus")
+    @PostMapping("/query_equip_charge_status")
     @Log(value = "查询充电状态", module = LogModuleEnum.PARKING_CALL, params = true, result = true)
     public Result<ChargingStatusQueryResponseVO> queryChargingStatus(@RequestParam("StartChargeSeq") @Schema(description = "充电订单号(格式:运营商ID+唯一编号)") String StartChargeSeq) throws JsonProcessingException {
         return Result.success(chargingBusinessService.queryChargingStatus(StartChargeSeq));
@@ -118,7 +118,7 @@ public class ChargingBusinessController {
      * @author SheepHy
      */
     @Operation(summary = "请求停止充电")
-    @GetMapping("/stopCharging")
+    @GetMapping("/query_stop_charge")
     @Log(value = "请求停止充电", module = LogModuleEnum.PARKING_CALL, params = true, result = true)
     public Result<StopChargingOperationResponseVO> stopCharging(@RequestParam("StartChargeSeq") @Schema(description = "充电订单号(格式:运营商ID+唯一编号)") String StartChargeSeq,
                                                                 @RequestParam("ConnectorID") @Schema(description = "充电设备接口编码") String ConnectorID) throws JsonProcessingException {