From 0ed30a1c6589d82a5ed76e611c60c98eb3b13753 Mon Sep 17 00:00:00 2001 From: NiuZiYuan Date: Wed, 28 May 2025 15:38:10 +0800 Subject: [PATCH] dev --- .../com/syjiaer/clinic/server/BulidApi.java | 192 ------------ .../server/common/annotations/ApiParam.java | 19 ++ .../server/common/annotations/ApiParams.java | 12 + .../server/common/annotations/ApiReturn.java | 17 ++ .../clinic/server/common/doc/BulidApi.java | 16 + .../server/common/doc/entity/ApiInfo.java | 32 ++ .../server/common/doc/util/ScanUtil.java | 287 ++++++++++++++++++ .../clinic/server/common/doc/util/TsUtil.java | 58 ++++ .../charge/ChargeLogController.java | 42 ++- .../charge/ChargeOrderController.java | 39 +++ .../controller/charge/SocialController.java | 23 ++ .../server/controller/doc/ApiController.java | 30 ++ 12 files changed, 559 insertions(+), 208 deletions(-) delete mode 100644 src/main/java/com/syjiaer/clinic/server/BulidApi.java create mode 100644 src/main/java/com/syjiaer/clinic/server/common/annotations/ApiParam.java create mode 100644 src/main/java/com/syjiaer/clinic/server/common/annotations/ApiParams.java create mode 100644 src/main/java/com/syjiaer/clinic/server/common/annotations/ApiReturn.java create mode 100644 src/main/java/com/syjiaer/clinic/server/common/doc/BulidApi.java create mode 100644 src/main/java/com/syjiaer/clinic/server/common/doc/entity/ApiInfo.java create mode 100644 src/main/java/com/syjiaer/clinic/server/common/doc/util/ScanUtil.java create mode 100644 src/main/java/com/syjiaer/clinic/server/common/doc/util/TsUtil.java create mode 100644 src/main/java/com/syjiaer/clinic/server/controller/doc/ApiController.java diff --git a/src/main/java/com/syjiaer/clinic/server/BulidApi.java b/src/main/java/com/syjiaer/clinic/server/BulidApi.java deleted file mode 100644 index 481821a..0000000 --- a/src/main/java/com/syjiaer/clinic/server/BulidApi.java +++ /dev/null @@ -1,192 +0,0 @@ -package com.syjiaer.clinic.server; - -import com.alibaba.fastjson2.JSON; -import io.swagger.annotations.ApiOperation; -import lombok.*; -import org.springframework.beans.factory.config.BeanDefinition; -import org.springframework.core.annotation.AnnotationUtils; -import org.springframework.core.type.filter.AnnotationTypeFilter; -import org.springframework.stereotype.Controller; -import org.springframework.web.bind.annotation.RequestMapping; -import org.springframework.web.bind.annotation.RestController; -import org.springframework.context.annotation.ClassPathScanningCandidateComponentProvider; -import java.io.FileWriter; -import java.io.IOException; -import java.lang.reflect.Method; -import java.util.*; - - - -public class BulidApi { - public static void main(String[] args) { - List apiPaths = scanControllersWithDocs("com.syjiaer.clinic.server"); - Map nestedJson = convertToNestedJson(apiPaths); - generateAPITsFile(apiPaths, "D:\\API.ts"); - } - - private static String cleanPath(String originalPath) { - // 1. 移除路径参数 - String pathWithoutParams = originalPath.replaceAll("/\\{[^/]+}", ""); - - // 2. 分割路径并只保留前三级 - String[] parts = pathWithoutParams.replaceAll("^/|/$", "").split("/"); - if (parts.length > 3) { - return String.join("/", Arrays.copyOfRange(parts, 0, 3)); - } - - return pathWithoutParams; - } - - private static void generateNamespace(StringBuilder builder, Map map, int indentLevel) { - String indent = " ".repeat(indentLevel); - - for (Map.Entry entry : map.entrySet()) { - String key = entry.getKey(); - Object value = entry.getValue(); - - if (value instanceof Map) { - // 处理嵌套命名空间 - builder.append(indent).append("export namespace ").append(capitalize(key)).append(" {\n"); - generateNamespace(builder, (Map) value, indentLevel + 1); - builder.append(indent).append("}\n\n"); - } else if (value instanceof ApiInfo) { - // 处理API端点 - ApiInfo apiInfo = (ApiInfo) value; - String path = apiInfo.getPath().replaceAll("^/|/$", ""); - String comment = apiInfo.getComment().isEmpty() ? "" : "//" + apiInfo.getComment(); - - builder.append(indent).append("export const ") - .append(capitalize(key)).append(" = '") - .append(path).append("'") - .append(comment).append(";\n"); - } - } - } - - private static String capitalize(String str) { - if (str == null || str.isEmpty()) { - return str; - } - return str.substring(0, 1).toUpperCase() + str.substring(1); - } - public static void generateAPITsFile(List apiPaths, String outputPath) { - Map nestedJson = convertToNestedJson(apiPaths); - StringBuilder tsBuilder = new StringBuilder(); - tsBuilder.append("export namespace API {\n"); - - generateNamespace(tsBuilder, nestedJson, 1); - - tsBuilder.append("}\n"); - - try (FileWriter fileWriter = new FileWriter(outputPath)) { - fileWriter.write(tsBuilder.toString()); - System.out.println("成功写入 " + outputPath); - } catch (IOException e) { - throw new RuntimeException("文件写入失败", e); - } - } - public static Map convertToNestedJson(List apiPaths) { - Map root = new LinkedHashMap<>(); - - for (ApiInfo apiInfo : apiPaths) { - String path = apiInfo.getPath(); - // 去除开头和结尾的斜杠，并按斜杠分割 - String[] parts = path.replaceAll("^/|/$", "").split("/"); - - Map currentLevel = root; - // 处理路径的每一部分(除最后一部分) - for (int i = 0; i < parts.length - 1; i++) { - String part = parts[i]; - // 如果当前节点不是Map，说明是叶子节点，需要转换为Map - if (!(currentLevel.get(part) instanceof Map)) { - // 如果已有数据是ApiInfo，先保存到临时变量 - Object existingValue = currentLevel.get(part); - currentLevel.put(part, new LinkedHashMap()); - if (existingValue != null) { - // 将原有值放到特殊键下（如"_data"） - ((Map) currentLevel.get(part)).put("_data", existingValue); - } - } - currentLevel = (Map) currentLevel.get(part); - } - - // 最后一部分作为叶子节点 - String lastPart = parts[parts.length - 1]; - // 检查是否已经存在路径节点 - if (currentLevel.containsKey(lastPart) && currentLevel.get(lastPart) instanceof Map) { - // 如果已经存在Map节点，将API信息放入特殊键 - ((Map) currentLevel.get(lastPart)).put("_data", apiInfo); - } else { - currentLevel.put(lastPart, apiInfo); - } - } - - return root; - } - - public static List scanControllersWithDocs(String basePackage) { - List apiInfos = new ArrayList<>(); - - ClassPathScanningCandidateComponentProvider scanner = - new ClassPathScanningCandidateComponentProvider(false); - scanner.addIncludeFilter(new AnnotationTypeFilter(Controller.class)); - scanner.addIncludeFilter(new AnnotationTypeFilter(RestController.class)); - - Set beans = scanner.findCandidateComponents(basePackage); - - try { - for (BeanDefinition bean : beans) { - Class clazz = Class.forName(bean.getBeanClassName()); - - // 获取类注解 - RequestMapping classMapping = AnnotationUtils.findAnnotation(clazz, RequestMapping.class); - String classPath = classMapping != null && classMapping.value().length > 0 ? - classMapping.value()[0] : ""; - - // 扫描方法 - for (Method method : clazz.getMethods()) { - RequestMapping methodMapping = AnnotationUtils.findAnnotation(method, RequestMapping.class); - if (methodMapping != null) { - String methodPath = methodMapping.value().length > 0 ? - methodMapping.value()[0] : ""; - String fullPath = (classPath + "/" + methodPath).replaceAll("/+", "/"); - fullPath = cleanPath(fullPath); - - // 获取方法注释 - String comment = getMethodComment(method); - - apiInfos.add(new ApiInfo(fullPath, comment)); - } - } - } - } catch (Exception e) { - throw new RuntimeException("Controller扫描失败", e); - } - - return apiInfos; - } - - // 新增方法注释解析方法 - private static String getMethodComment(Method method) { - // 1. 优先获取Swagger的ApiOperation注解 - ApiOperation apiOperation = AnnotationUtils.findAnnotation(method, ApiOperation.class); - if (apiOperation != null) { - return apiOperation.value(); - } - - // 2. 次选JavaDoc注释（需额外实现） - return ""; // 暂留空 - } - - @Data - @NoArgsConstructor - @AllArgsConstructor - // 新增返回数据结构 - public static class ApiInfo { - private String path; - private String comment; - - - // 构造方法/getter/setter省略 - } -} diff --git a/src/main/java/com/syjiaer/clinic/server/common/annotations/ApiParam.java b/src/main/java/com/syjiaer/clinic/server/common/annotations/ApiParam.java new file mode 100644 index 0000000..06e0a08 --- /dev/null +++ b/src/main/java/com/syjiaer/clinic/server/common/annotations/ApiParam.java @@ -0,0 +1,19 @@ +package com.syjiaer.clinic.server.common.annotations; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.FIELD) +public @interface ApiParam { + String name(); + String value() default ""; + boolean required() default false; + String comment() default ""; + Class type() default Object.class; + String typeName() default ""; + + +} diff --git a/src/main/java/com/syjiaer/clinic/server/common/annotations/ApiParams.java b/src/main/java/com/syjiaer/clinic/server/common/annotations/ApiParams.java new file mode 100644 index 0000000..dac3f33 --- /dev/null +++ b/src/main/java/com/syjiaer/clinic/server/common/annotations/ApiParams.java @@ -0,0 +1,12 @@ +package com.syjiaer.clinic.server.common.annotations; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +@Retention(RetentionPolicy.RUNTIME) +@Target({ElementType.METHOD}) +public @interface ApiParams { + ApiParam[] value() default {} ; +} diff --git a/src/main/java/com/syjiaer/clinic/server/common/annotations/ApiReturn.java b/src/main/java/com/syjiaer/clinic/server/common/annotations/ApiReturn.java new file mode 100644 index 0000000..293efa6 --- /dev/null +++ b/src/main/java/com/syjiaer/clinic/server/common/annotations/ApiReturn.java @@ -0,0 +1,17 @@ +package com.syjiaer.clinic.server.common.annotations; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +@Retention(RetentionPolicy.RUNTIME) +@Target({ElementType.METHOD}) +public @interface ApiReturn { + boolean isArray() default false; + boolean isPage() default false; + Class type() default Object.class; + String name() default ""; + boolean isNull() default false; + String typeName() default ""; +} diff --git a/src/main/java/com/syjiaer/clinic/server/common/doc/BulidApi.java b/src/main/java/com/syjiaer/clinic/server/common/doc/BulidApi.java new file mode 100644 index 0000000..76cad38 --- /dev/null +++ b/src/main/java/com/syjiaer/clinic/server/common/doc/BulidApi.java @@ -0,0 +1,16 @@ +package com.syjiaer.clinic.server.common.doc; + +import com.alibaba.fastjson2.JSON; +import com.syjiaer.clinic.server.common.doc.entity.ApiInfo; +import com.syjiaer.clinic.server.common.doc.util.ScanUtil; + +import java.util.*; + + + +public class BulidApi { + public static void main(String[] args) { + List apiPaths = ScanUtil.scanPackageToList("com.syjiaer.clinic.server.controller.charge"); + System.out.println(JSON.toJSONString(apiPaths)); + } +} diff --git a/src/main/java/com/syjiaer/clinic/server/common/doc/entity/ApiInfo.java b/src/main/java/com/syjiaer/clinic/server/common/doc/entity/ApiInfo.java new file mode 100644 index 0000000..1ed6da2 --- /dev/null +++ b/src/main/java/com/syjiaer/clinic/server/common/doc/entity/ApiInfo.java @@ -0,0 +1,32 @@ +package com.syjiaer.clinic.server.common.doc.entity; + +import lombok.Data; + +import java.util.List; + +@Data +public class ApiInfo { + private String path; + private String comment; + private List requests; + private Response response; + + @Data + public static class BaseProperty { + private String name; + private String comment; + private String type; + private List children; + } + @Data + public static class Request extends BaseProperty { + // 原有结构保持不变 + } + + @Data + public static class Response extends BaseProperty { + private Boolean isNull; + private Boolean isArray; + private Boolean isPage; + } +} diff --git a/src/main/java/com/syjiaer/clinic/server/common/doc/util/ScanUtil.java b/src/main/java/com/syjiaer/clinic/server/common/doc/util/ScanUtil.java new file mode 100644 index 0000000..74f254d --- /dev/null +++ b/src/main/java/com/syjiaer/clinic/server/common/doc/util/ScanUtil.java @@ -0,0 +1,287 @@ +package com.syjiaer.clinic.server.common.doc.util; + +import com.syjiaer.clinic.server.common.doc.entity.ApiInfo; +import com.syjiaer.clinic.server.common.annotations.ApiParam; +import com.syjiaer.clinic.server.common.annotations.ApiParams; +import com.syjiaer.clinic.server.common.annotations.ApiReturn; +import io.swagger.annotations.ApiModelProperty; +import io.swagger.annotations.ApiOperation; +import org.springframework.beans.factory.config.BeanDefinition; +import org.springframework.context.annotation.ClassPathScanningCandidateComponentProvider; +import org.springframework.core.annotation.AnnotationUtils; +import org.springframework.core.type.filter.AnnotationTypeFilter; +import org.springframework.stereotype.Controller; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +import java.lang.reflect.Field; +import java.lang.reflect.Method; +import java.util.*; + +public class ScanUtil { + public static ApiInfo scanApiInfo(String path) { + // 1. 获取基础包路径（可配置或使用默认值） + String basePackage = "com.syjiaer.clinic.server.controller"; // 示例包路径 + + // 2. 获取所有API信息列表 + List apiInfos = scanPackageToList(basePackage); + + // 3. 标准化输入路径（移除前后斜杠，统一格式） + String normalizedPath = path.replaceAll("/+", "/") + .replaceAll("^/|/$", ""); + + // 4. 遍历查找匹配项 + for (ApiInfo apiInfo : apiInfos) { + String apiPath = apiInfo.getPath().replaceAll("^/|/$", ""); + if (apiPath.equals(normalizedPath)) { + return apiInfo; + } + } + + return null; // 未找到匹配项 + } + + public static Map scanPackageToCatalog( String basePackage ) { + // 使用默认基础包路径，或根据需要修改 + List apiInfos = scanPackageToList(basePackage); + Map catalog = new LinkedHashMap<>(); + + for (ApiInfo apiInfo : apiInfos) { + String path = apiInfo.getPath(); + String[] parts = path.replaceAll("^/|/$", "").split("/"); + + Map currentLevel = catalog; + // 构建路径树结构 + for (int i = 0; i < parts.length; i++) { + String part = parts[i]; + if (!currentLevel.containsKey(part)) { + // 如果是最后一部分，添加完整API信息 + if (i == parts.length - 1) { + Map leafNode = new LinkedHashMap<>(); + leafNode.put("path", path); + leafNode.put("comment", apiInfo.getComment()); + currentLevel.put(part, leafNode); + } else { + currentLevel.put(part, new LinkedHashMap()); + } + } + currentLevel = (Map) currentLevel.get(part); + } + } + return catalog; + } + + + public static List scanPackageToList(String basePackage) { + List apiInfos = new ArrayList<>(); + + + ClassPathScanningCandidateComponentProvider scanner = + new ClassPathScanningCandidateComponentProvider(false); + scanner.addIncludeFilter(new AnnotationTypeFilter(Controller.class)); + scanner.addIncludeFilter(new AnnotationTypeFilter(RestController.class)); + + Set beans = scanner.findCandidateComponents(basePackage); + + try { + for (BeanDefinition bean : beans) { + String beanClassName = bean.getBeanClassName(); + + // 排除包含dev的包 + if (beanClassName != null && beanClassName.contains(".doc.")) { + continue; + } + Class clazz = Class.forName(bean.getBeanClassName()); + + // 获取类注解 + RequestMapping classMapping = AnnotationUtils.findAnnotation(clazz, RequestMapping.class); + String classPath = classMapping != null && classMapping.value().length > 0 ? + classMapping.value()[0] : ""; + + // 扫描方法 + for (Method method : clazz.getMethods()) { + RequestMapping methodMapping = AnnotationUtils.findAnnotation(method, RequestMapping.class); + if (methodMapping != null) { + String methodPath = methodMapping.value().length > 0 ? + methodMapping.value()[0] : ""; + String fullPath = (classPath + "/" + methodPath).replaceAll("/+", "/"); + fullPath = cleanPath(fullPath); + + // 获取方法注释 + ApiInfo apiInfo = new ApiInfo(); + apiInfo.setPath(fullPath); + apiInfo.setComment(getMethodComment(method)); + apiInfo.setRequests(scanApiParams(method)); + apiInfo.setResponse(scanApiReturn(method)); + apiInfos.add(apiInfo); + } + } + } + } catch (Exception e) { + throw new RuntimeException("Controller扫描失败", e); + } + + return apiInfos; + } + private static String getMethodComment(Method method) { + // 1. 优先获取Swagger的ApiOperation注解 + ApiOperation apiOperation = AnnotationUtils.findAnnotation(method, ApiOperation.class); + if (apiOperation != null) { + return apiOperation.value(); + } + + // 2. 次选JavaDoc注释（需额外实现） + return ""; // 暂留空 + } + + private static List scanApiParams(Method method) { + List params = new ArrayList<>(); + + ApiParams implicitParams = AnnotationUtils.findAnnotation(method, ApiParams.class); + if (implicitParams != null) { + for (ApiParam param : implicitParams.value()) { + ApiInfo.Request apiParam = new ApiInfo.Request(); + apiParam.setComment(param.value()); + apiParam.setName(param.name()); + + // 设置参数类型 + if (!param.typeName().isEmpty()) { + apiParam.setType(param.typeName()); + } else if (!param.type().equals(Object.class)) { + apiParam.setType(param.type().getSimpleName()); + // 递归处理复杂类型属性 + if (isComplexType(param.type())) { + apiParam.setChildren(scanClassProperties(param.type())); + } + } + params.add(apiParam); + } + } + return params; + } + + // 判断是否为需要递归解析的复杂类型 + private static boolean isComplexType(Class clazz) { + return !clazz.isPrimitive() + && !clazz.getName().startsWith("java.") + && !clazz.isEnum(); + } + private static ApiInfo.Response scanApiReturn(Method method) { + ApiInfo.Response response = new ApiInfo.Response(); + + // 1. 处理ApiReturn注解 + ApiReturn apiReturn = AnnotationUtils.findAnnotation(method, ApiReturn.class); + if (apiReturn != null) { + response.setIsArray(apiReturn.isArray()); + response.setName(apiReturn.name()); + response.setIsPage(apiReturn.isPage()); + response.setIsNull(apiReturn.isNull()); + + // 设置返回类型 + if (!apiReturn.typeName().isEmpty()) { + response.setType(apiReturn.typeName()); + } else if (!apiReturn.type().equals(Object.class)) { + Class returnType = apiReturn.type(); + response.setType(returnType.getSimpleName()); + + // 递归处理复杂类型 + if (isComplexType(returnType)) { + response.setChildren(scanClassProperties(returnType)); + } + } + } + + + return response; + } + + + // 递归扫描类的属性 + private static List scanClassProperties(Class clazz) { + List properties = new ArrayList<>(); + + // 处理父类属性 + if (clazz.getSuperclass() != null && isComplexType(clazz.getSuperclass())) { + properties.addAll(scanClassProperties(clazz.getSuperclass())); + } + + // 处理当前类属性 + for (Field field : clazz.getDeclaredFields()) { + ApiInfo.BaseProperty fieldParam = new ApiInfo.BaseProperty(); + fieldParam.setName(field.getName()); + + // 处理字段注解 + ApiModelProperty modelProperty = field.getAnnotation(ApiModelProperty.class); + if (modelProperty != null) { + fieldParam.setComment(modelProperty.value()); + } + + Class fieldType = field.getType(); + fieldParam.setType(fieldType.getSimpleName()); + + // 递归处理复杂类型 + if (isComplexType(fieldType)) { + fieldParam.setChildren(scanClassProperties(fieldType)); + } + + properties.add(fieldParam); + } + return properties; + } + + + + private static String cleanPath(String originalPath) { + // 1. 移除路径参数 + String pathWithoutParams = originalPath.replaceAll("/\\{[^/]+}", ""); + + // 2. 分割路径并只保留前三级 + String[] parts = pathWithoutParams.replaceAll("^/|/$", "").split("/"); + if (parts.length > 3) { + return String.join("/", Arrays.copyOfRange(parts, 0, 3)); + } + + return pathWithoutParams; + } + + public static Map scanPackageToMap(String basePackage) { + List apiPaths = scanPackageToList(basePackage); + Map root = new LinkedHashMap<>(); + + for (ApiInfo apiInfo : apiPaths) { + String path = apiInfo.getPath(); + // 去除开头和结尾的斜杠，并按斜杠分割 + String[] parts = path.replaceAll("^/|/$", "").split("/"); + + Map currentLevel = root; + // 处理路径的每一部分(除最后一部分) + for (int i = 0; i < parts.length - 1; i++) { + String part = parts[i]; + // 如果当前节点不是Map，说明是叶子节点，需要转换为Map + if (!(currentLevel.get(part) instanceof Map)) { + // 如果已有数据是ApiInfo，先保存到临时变量 + Object existingValue = currentLevel.get(part); + currentLevel.put(part, new LinkedHashMap()); + if (existingValue != null) { + // 将原有值放到特殊键下（如"_data"） + ((Map) currentLevel.get(part)).put("_data", existingValue); + } + } + currentLevel = (Map) currentLevel.get(part); + } + + // 最后一部分作为叶子节点 + String lastPart = parts[parts.length - 1]; + // 检查是否已经存在路径节点 + if (currentLevel.containsKey(lastPart) && currentLevel.get(lastPart) instanceof Map) { + // 如果已经存在Map节点，将API信息放入特殊键 + ((Map) currentLevel.get(lastPart)).put("_data", apiInfo); + } else { + currentLevel.put(lastPart, apiInfo); + } + } + + return root; + } + +} diff --git a/src/main/java/com/syjiaer/clinic/server/common/doc/util/TsUtil.java b/src/main/java/com/syjiaer/clinic/server/common/doc/util/TsUtil.java new file mode 100644 index 0000000..e82d1b1 --- /dev/null +++ b/src/main/java/com/syjiaer/clinic/server/common/doc/util/TsUtil.java @@ -0,0 +1,58 @@ +package com.syjiaer.clinic.server.common.doc.util; + +import com.syjiaer.clinic.server.common.doc.entity.ApiInfo; + +import java.io.FileWriter; +import java.io.IOException; +import java.util.Map; + +public class TsUtil { + + public static void generateNamespace(StringBuilder builder, Map map, int indentLevel) { + String indent = " ".repeat(indentLevel); + + for (Map.Entry entry : map.entrySet()) { + String key = entry.getKey(); + Object value = entry.getValue(); + + if (value instanceof Map) { + // 处理嵌套命名空间 + builder.append(indent).append("export namespace ").append(capitalize(key)).append(" {\n"); + generateNamespace(builder, (Map) value, indentLevel + 1); + builder.append(indent).append("}\n\n"); + } else if (value instanceof ApiInfo) { + // 处理API端点 + ApiInfo apiInfo = (ApiInfo) value; + String path = apiInfo.getPath().replaceAll("^/|/$", ""); + String comment = apiInfo.getComment().isEmpty() ? "" : "//" + apiInfo.getComment(); + + builder.append(indent).append("export const ") + .append(capitalize(key)).append(" = '") + .append(path).append("'") + .append(comment).append(";\n"); + } + } + } + + private static String capitalize(String str) { + if (str == null || str.isEmpty()) { + return str; + } + return str.substring(0, 1).toUpperCase() + str.substring(1); + } + public static void generateAPITsFile(Map map, String outputPath) { + StringBuilder tsBuilder = new StringBuilder(); + tsBuilder.append("export namespace API {\n"); + + generateNamespace(tsBuilder, map, 1); + + tsBuilder.append("}\n"); + + try (FileWriter fileWriter = new FileWriter(outputPath)) { + fileWriter.write(tsBuilder.toString()); + System.out.println("成功写入 " + outputPath); + } catch (IOException e) { + throw new RuntimeException("文件写入失败", e); + } + } +} diff --git a/src/main/java/com/syjiaer/clinic/server/controller/charge/ChargeLogController.java b/src/main/java/com/syjiaer/clinic/server/controller/charge/ChargeLogController.java index a4eb933..08fb13c 100644 --- a/src/main/java/com/syjiaer/clinic/server/controller/charge/ChargeLogController.java +++ b/src/main/java/com/syjiaer/clinic/server/controller/charge/ChargeLogController.java @@ -1,5 +1,8 @@ package com.syjiaer.clinic.server.controller.charge; +import com.syjiaer.clinic.server.common.annotations.ApiParam; +import com.syjiaer.clinic.server.common.annotations.ApiParams; +import com.syjiaer.clinic.server.common.annotations.ApiReturn; import com.syjiaer.clinic.server.common.util.DateUtil; import com.syjiaer.clinic.server.common.vo.Page; import com.syjiaer.clinic.server.common.vo.Result; @@ -8,6 +11,8 @@ import com.syjiaer.clinic.server.entity.charge.ChargeLog; import com.syjiaer.clinic.server.entity.charge.ChargeOrder; import com.syjiaer.clinic.server.service.charge.ChargeService; import com.syjiaer.clinic.server.service.charge.vo.RetailOrderDailyChargingReportVo; +import io.swagger.annotations.ApiImplicitParam; +import io.swagger.annotations.ApiImplicitParams; import io.swagger.annotations.ApiOperation; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.RequestMapping; @@ -22,10 +27,14 @@ public class ChargeLogController extends BaseController { @Autowired private ChargeService chargeService; - /** - * 每日收费报表 - */ + @ApiOperation("每日收费报表") + @ApiParams({ + @ApiParam(name = "startDate", value = "开始时间", required = true,typeName = "String"), + @ApiParam(name = "endTime", value = "结束时间", required = true, typeName = "String"), + @ApiParam(name = "userId", value = "用户ID", required = true, typeName = "Integer") + }) + @ApiReturn(type = RetailOrderDailyChargingReportVo.class,isArray = true) @RequestMapping("/reportWithDays") public Result> dailyChargingReport() { String startDateStr = parmsUtil.getString("startDate", "请选择开始时间"); @@ -38,34 +47,37 @@ public class ChargeLogController extends BaseController { } - /** - * 病人付费记录 - * @return - */ + @ApiOperation("病人付费记录") @RequestMapping("/listByPatientId") + @ApiParams({ + @ApiParam(name = "patientId", value = "病人ID", required = true, typeName = "Integer") + }) + @ApiReturn(type = ChargeOrder.class,isArray = true) public Result> listByPatientId() { + Integer patientId = parmsUtil.getInteger("patientId"); return success(chargeService.getListByPatientId(patientId)); } - /** - * 收费记录 - * @return - */ @ApiOperation("收费记录") @RequestMapping("/list") + @ApiReturn(type = ChargeLog.class,isPage = true) public Result> list() { return success(chargeService.getChargeRecordPageList()); } - /** - * 获取收退费记录 - */ + @ApiOperation("获取收退费记录") @RequestMapping("listByDatetime") + @ApiParams({ + @ApiParam(name = "beginTime", value = "开始时间", required = true,typeName = "String"), + @ApiParam(name = "endTime", value = "结束时间", required = true, typeName = "String"), + @ApiParam(name = "userId", value = "用户ID", required = true, typeName = "Integer") + }) + @ApiReturn(type = ChargeLog.class,isArray = true) public Result> listByDatetime(){ String begin = parmsUtil.getString("beginTime","开始时间为空"); String end= parmsUtil.getString("endTime","结束时间为空"); @@ -73,8 +85,6 @@ public class ChargeLogController extends BaseController { LocalDateTime beginTime = DateUtil.getDateTime(begin); LocalDateTime endTime = DateUtil.getDateTime(end); List chargeLogs = chargeService.listChargeLog(beginTime,endTime,userId); - - return success(chargeLogs); } diff --git a/src/main/java/com/syjiaer/clinic/server/controller/charge/ChargeOrderController.java b/src/main/java/com/syjiaer/clinic/server/controller/charge/ChargeOrderController.java index e11aa63..2ff5a62 100644 --- a/src/main/java/com/syjiaer/clinic/server/controller/charge/ChargeOrderController.java +++ b/src/main/java/com/syjiaer/clinic/server/controller/charge/ChargeOrderController.java @@ -1,5 +1,8 @@ package com.syjiaer.clinic.server.controller.charge; +import com.syjiaer.clinic.server.common.annotations.ApiParam; +import com.syjiaer.clinic.server.common.annotations.ApiParams; +import com.syjiaer.clinic.server.common.annotations.ApiReturn; import com.syjiaer.clinic.server.common.annotations.RecordCommonLog; import com.syjiaer.clinic.server.common.api.output.OM2206A; import com.syjiaer.clinic.server.common.api.output.OM2207A; @@ -15,6 +18,8 @@ import com.syjiaer.clinic.server.entity.charge.vo.ChargeDetailVo; import com.syjiaer.clinic.server.entity.charge.vo.ChargeOrderPrintVo; import com.syjiaer.clinic.server.service.charge.ChargeService; import com.syjiaer.clinic.server.service.charge.vo.RetailOrderDailyChargingReportVo; +import io.swagger.annotations.ApiImplicitParam; +import io.swagger.annotations.ApiImplicitParams; import io.swagger.annotations.ApiOperation; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.RequestMapping; @@ -35,6 +40,10 @@ public class ChargeOrderController extends BaseController { @RecordCommonLog(operation = "生成订单") @ApiOperation("保存收费订单") @RequestMapping("/save") + @ApiParams({ + @ApiParam(name = "data",value = "收费订单信息", required = true, type = ChargeSaveDto.class) + }) + @ApiReturn(name = "订单编号",typeName = "String") public Result save() { ChargeSaveDto dto = parmsUtil.getObject("data", ChargeSaveDto.class); ChargeOrder chargeOrder = chargeService.save(dto); @@ -45,6 +54,10 @@ public class ChargeOrderController extends BaseController { */ @ApiOperation("根据诊断code和状态获取诊断信息") @RequestMapping("/getByDiagnosisCode") + @ApiReturn(isArray = true, type = ChargeOrder.class, name = "订单列表") + @ApiParams({ + @ApiParam(name = "diagnosisCode",value = "诊断code", required = true) + }) public Result getByDiagnosisCode() { String diagnosisCode = parmsUtil.getString("diagnosisCode","诊断code不能为空"); ChargeOrder chargeOrder = chargeService.getOrderByDiagnosisCode(diagnosisCode); @@ -58,6 +71,10 @@ public class ChargeOrderController extends BaseController { */ @ApiOperation("根据code查询订单详情") @RequestMapping("/getByCode") + @ApiReturn(type = ChargeDetailVo.class, name = "订单详情") + @ApiParams({ + @ApiParam(name = "code",value = "订单号", required = true) + }) public Result getByCode() { String code = parmsUtil.getString("code"); return success(chargeService.getDetail(code)); @@ -68,6 +85,10 @@ public class ChargeOrderController extends BaseController { */ @ApiOperation("根据订单号获取订单详情,小票打印用") @RequestMapping("getPrintInfoByCode") + @ApiReturn(type = ChargeOrderPrintVo.class, name = "打印订单详情") + @ApiParams({ + @ApiParam(name = "code",value = "订单号", required = true) + }) public Result getPrintInfoByCode() { String code = parmsUtil.getString("code", "订单号不能为空"); return success(chargeService.getPrintInfoByCode(code)); @@ -78,6 +99,10 @@ public class ChargeOrderController extends BaseController { */ @ApiOperation("查询list 只有订单信息") @RequestMapping("/list") + @ApiReturn(isPage = true, type = ChargeOrder.class, name = "订单列表") + @ApiParams({ + @ApiParam(name = "query",value = "查询参数", required = true, type = ChargeQuery.class) + }) public Result> list() { ChargeQuery chargeQuery = parmsUtil.getObject("query", ChargeQuery.class); return success(chargeService.pageList(chargeQuery)); @@ -88,6 +113,10 @@ public class ChargeOrderController extends BaseController { */ @ApiOperation("查询list 带详情") @RequestMapping("/listWithDetail") + @ApiParams({ + @ApiParam(name = "query",value = "查询参数", required = true, type = ChargeQuery.class) + }) + @ApiReturn(isPage = true, type = ChargeDetailVo.class, name = "订单列表") public Result> listWithDetail() { ChargeQuery chargeQuery = parmsUtil.getObject("query", ChargeQuery.class); return success(chargeService.pageDetailList(chargeQuery)); @@ -99,6 +128,11 @@ public class ChargeOrderController extends BaseController { @ApiOperation("完成订单") @RecordCommonLog(operation = "完成订单") @RequestMapping("/complete") + @ApiParams({ + @ApiParam(name = "id",value = "订单id", required = true), + @ApiParam(name = "payType",value = "支付方式", required = true) + }) + @ApiReturn(isNull = true) public Result complete() { Integer id = parmsUtil.getInteger("id"); Integer payType = parmsUtil.getInteger("payType"); @@ -113,6 +147,11 @@ public class ChargeOrderController extends BaseController { */ @RecordCommonLog(operation = "订单退款") @RequestMapping("/refund") + @ApiParams({ + @ApiParam(name = "changeOrderCode",value = "订单号", required = true) + }) + @ApiOperation("订单退款") + @ApiReturn(isNull = true) public Result refund() { String changeOrderCode = parmsUtil.getString("changeOrderCode","订单号为空"); chargeService.refund(changeOrderCode); diff --git a/src/main/java/com/syjiaer/clinic/server/controller/charge/SocialController.java b/src/main/java/com/syjiaer/clinic/server/controller/charge/SocialController.java index 464486e..7ed050e 100644 --- a/src/main/java/com/syjiaer/clinic/server/controller/charge/SocialController.java +++ b/src/main/java/com/syjiaer/clinic/server/controller/charge/SocialController.java @@ -1,5 +1,8 @@ package com.syjiaer.clinic.server.controller.charge; +import com.syjiaer.clinic.server.common.annotations.ApiParam; +import com.syjiaer.clinic.server.common.annotations.ApiParams; +import com.syjiaer.clinic.server.common.annotations.ApiReturn; import com.syjiaer.clinic.server.common.annotations.RecordCommonLog; import com.syjiaer.clinic.server.common.api.output.OM2206A; import com.syjiaer.clinic.server.common.api.output.OM2207A; @@ -22,6 +25,13 @@ public class SocialController extends BaseController { */ @ApiOperation("医保预支付") @RequestMapping("/prePay") + @ApiParams({ + @ApiParam(name = "changeOrderCode",value = "订单号"), + @ApiParam(name = "mdtrtCertType",value = "证件类型"), + @ApiParam(name = "mdtrtCertNo",value = "证件号码"), + @ApiParam(name = "insutype",value = "险种类型") + }) + @ApiReturn(type = OM2206A.class) public Result prePay(){ String changeOrderCode = parmsUtil.getString("changeOrderCode"); String mdtrtCertType = parmsUtil.getString("mdtrtCertType"); @@ -37,6 +47,15 @@ public class SocialController extends BaseController { @ApiOperation("医保真实支付") @RecordCommonLog(operation = "医保收费") @RequestMapping("/realPay") + @ApiParams({ + @ApiParam(name = "changeOrderCode",value = "订单号"), + @ApiParam(name = "mdtrtCertType",value = "证件类型"), + @ApiParam(name = "mdtrtCertNo",value = "证件号码"), + @ApiParam(name = "insutype",value = "险种类型"), + @ApiParam(name = "payType",value = "支付方式"), + @ApiParam(name = "curBalc",value = "当前余额") + }) + @ApiReturn(type = OM2207A.class) public Result realPay(){ String changeOrderCode = parmsUtil.getString("changeOrderCode"); String mdtrtCertType = parmsUtil.getString("mdtrtCertType"); @@ -55,6 +74,10 @@ public class SocialController extends BaseController { @ApiOperation("医保上传支付明细") @RecordCommonLog(operation = "上传医保费用明细") @RequestMapping("/upload") + @ApiParams({ + @ApiParam(name = "changeOrderCode",value = "订单号") + }) + @ApiReturn(isNull = true) public Result upload() { String changeOrderCode = parmsUtil.getString("changeOrderCode"); chargeService.uploadCostDetails(changeOrderCode); diff --git a/src/main/java/com/syjiaer/clinic/server/controller/doc/ApiController.java b/src/main/java/com/syjiaer/clinic/server/controller/doc/ApiController.java new file mode 100644 index 0000000..de1b69f --- /dev/null +++ b/src/main/java/com/syjiaer/clinic/server/controller/doc/ApiController.java @@ -0,0 +1,30 @@ +package com.syjiaer.clinic.server.controller.doc; + +import com.syjiaer.clinic.server.common.annotations.NoAuthCheck; +import com.syjiaer.clinic.server.common.doc.entity.ApiInfo; +import com.syjiaer.clinic.server.common.doc.util.ScanUtil; +import com.syjiaer.clinic.server.common.vo.Result; +import com.syjiaer.clinic.server.controller.BaseController; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +import java.util.Map; + +@RestController +@RequestMapping("/doc/base") +public class ApiController extends BaseController { + @RequestMapping("/getCatalog") + @NoAuthCheck + public Result> getCatalog(){ + Map map = ScanUtil.scanPackageToCatalog("com.syjiaer.clinic.server.controller.charge"); + return success(map); + } + + @RequestMapping("/getApiInfo") + @NoAuthCheck + public Result getApiInfo(){ + String path = parmsUtil.getString("path", "请输入path"); + ApiInfo apiInfo = ScanUtil.scanApiInfo(path); + return success(apiInfo); + } +}