新增行政区相关接口

zjugis-module-system/zjugis-module-system-api/src/main/java/com/zjugis/module/system/api/district/DistrictApi.java

@@ -0,0 +1,27 @@
+package com.zjugis.module.system.api.district;
+
+import com.zjugis.framework.common.pojo.CommonResult;
+import com.zjugis.module.system.enums.ApiConstants;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+
+/**
+ * @Author 陈俊
+ * @Date 2024/2/22 17:04
+ * @Version 1.0
+ */
+@FeignClient(name = ApiConstants.NAME)
+@Tag(name = "RPC 服务 - 行政区号")
+public interface DistrictApi {
+
+    String PREFIX = ApiConstants.PREFIX + "/district";
+
+    @GetMapping(PREFIX + "/get-qh-by-joincode")
+    @Operation(summary = "获取区号")
+    @Parameter(name = "joincode", description = "行政区号", example = "330100", required = true)
+    CommonResult<String> getQhByJoincode(@RequestParam("joincode") String joincode);
+}

zjugis-module-system/zjugis-module-system-biz/src/main/java/com/zjugis/module/system/api/district/DistrictApiImpl.java

@@ -0,0 +1,28 @@
+package com.zjugis.module.system.api.district;
+
+import com.zjugis.framework.common.pojo.CommonResult;
+import com.zjugis.module.system.service.district.DistrictService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.RestController;
+
+import javax.annotation.Resource;
+
+import static com.zjugis.framework.common.pojo.CommonResult.success;
+
+/**
+ * @Author 陈俊
+ * @Date 2024/2/22 17:08
+ * @Version 1.0
+ */
+@RestController // 提供 RESTful API 接口，给 Feign 调用
+@Validated
+public class DistrictApiImpl implements DistrictApi {
+
+    @Resource
+    private DistrictService districtService;
+
+    @Override
+    public CommonResult<String> getQhByJoincode(String joincode) {
+        return success(districtService.getQhByJoincode(joincode));
+    }
+}

zjugis-module-system/zjugis-module-system-biz/src/main/java/com/zjugis/module/system/dal/dataobject/district/DistrictDO.java

@@ -0,0 +1,33 @@
+package com.zjugis.module.system.dal.dataobject.district;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.zjugis.framework.mybatis.core.dataobject.BaseDO;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+/**
+ * @Author 陈俊
+ * @Date 2024/2/22 16:48
+ * @Version 1.0
+ */
+@TableName("system_district")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class DistrictDO extends BaseDO {
+
+    /**
+     * ID
+     */
+    @TableId(type = IdType.ASSIGN_UUID)
+    private String districtId;
+    /**
+     * 所有代码拼接
+     */
+    private String joincode;
+    /**
+     * 区号
+     */
+    private String qh;
+}

zjugis-module-system/zjugis-module-system-biz/src/main/java/com/zjugis/module/system/dal/mysql/district/DistrictMapper.java

@@ -0,0 +1,16 @@
+package com.zjugis.module.system.dal.mysql.district;
+
+import com.zjugis.framework.mybatis.core.mapper.BaseMapperX;
+import com.zjugis.module.system.dal.dataobject.district.DistrictDO;
+
+/**
+ * @Author 陈俊
+ * @Date 2024/2/22 16:57
+ * @Version 1.0
+ */
+public interface DistrictMapper extends BaseMapperX<DistrictDO> {
+    default String getQhByJoincode(String joincode) {
+        DistrictDO districtDO = selectOne(DistrictDO::getJoincode, joincode);
+        return districtDO.getQh();
+    }
+}

zjugis-module-system/zjugis-module-system-biz/src/main/java/com/zjugis/module/system/service/district/DistrictService.java

@@ -0,0 +1,15 @@
+package com.zjugis.module.system.service.district;
+
+/**
+ * @Author 陈俊
+ * @Date 2024/2/22 16:59
+ * @Version 1.0
+ */
+public interface DistrictService {
+    /**
+     * 通过行政区号获取区号
+     * @param joincode
+     * @return
+     */
+    String getQhByJoincode(String joincode);
+}

zjugis-module-system/zjugis-module-system-biz/src/main/java/com/zjugis/module/system/service/district/DistrictServiceImpl.java

@@ -0,0 +1,27 @@
+package com.zjugis.module.system.service.district;
+
+import com.zjugis.module.system.dal.mysql.district.DistrictMapper;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import javax.annotation.Resource;
+
+/**
+ * @Author 陈俊
+ * @Date 2024/2/22 17:00
+ * @Version 1.0
+ */
+@Service
+@Validated
+@Slf4j
+public class DistrictServiceImpl implements DistrictService {
+
+    @Resource
+    private DistrictMapper districtMapper;
+
+    @Override
+    public String getQhByJoincode(String joincode) {
+        return districtMapper.getQhByJoincode(joincode);
+    }
+}