Spring Boot 项目Swagger 注解@Schema转换为word文档

 public static List<FieldInfo> parseModel(Class<?> clazz) {
        List<FieldInfo> fieldInfos = new ArrayList<>();
        Field[] fields = clazz.getDeclaredFields();

        for (Field field : fields) {
            io.swagger.v3.oas.annotations.media.Schema schema = field.getAnnotation(io.swagger.v3.oas.annotations.media.Schema.class);
            if (schema != null) {
                FieldInfo fieldInfo = new FieldInfo();
                fieldInfo.setName(field.getName());
                fieldInfo.setType(field.getType().getSimpleName());
                fieldInfo.setDescription(schema.description());
                fieldInfos.add(fieldInfo);
            }
        }

        return fieldInfos;
    }

    public static void parseOpenAPI(String filePath) throws Exception {
        // 解析 OpenAPI 文档
        OpenAPI openAPI = new OpenAPIV3Parser().read(filePath);
        // 获取模型定义
        Map<String, Schema> schemas = openAPI.getComponents().getSchemas();

        Map<String, List<FieldInfo>> fieldMap = new HashMap<>();

        for (Map.Entry<String, Schema> entry : schemas.entrySet()) {
            String modelName = entry.getKey();
            Schema schema = entry.getValue();

            System.out.println("Model: " + modelName);
            //System.out.println("Description: " + schema.getDescription());
            //System.out.println("Properties: " + schema.getProperties());
            Map<String, Schema> properties = schema.getProperties();
            List<FieldInfo> fieldInfos = new ArrayList<>();
            for (Map.Entry<String, Schema> propertyEntry : properties.entrySet()) {
                String propertyName = propertyEntry.getKey();
                Schema propertySchema = propertyEntry.getValue();

//                System.out.println("  Property: " + propertyName);
//                System.out.println("    Type: " + propertySchema.getType());
//                System.out.println("    Description: " + propertySchema.getDescription());
                FieldInfo fieldInfo = new FieldInfo(propertyName, propertySchema.getType(), propertySchema.getDescription());
                fieldInfos.add(fieldInfo);
            }
            fieldMap.put(modelName, fieldInfos);
        }

        generateWord(fieldMap, "D:\\swagger.docx");

    }

    /**
     * 添加标题到文档
     */
    private static void addTitle(XWPFDocument document, String titleText, int level) {
        XWPFParagraph title = document.createParagraph();
        title.setAlignment(ParagraphAlignment.CENTER); // 居中对齐
        title.setStyle("Heading" + level); // 设置标题样式

        XWPFRun titleRun = title.createRun();
        titleRun.setText(titleText);
        titleRun.setBold(true);
        titleRun.setFontSize(18);
    }

    /**
     * 添加段落到文档
     */
    private static void addParagraph(XWPFDocument document, String paragraphText) {
        XWPFParagraph paragraph = document.createParagraph();
        paragraph.setAlignment(ParagraphAlignment.LEFT); // 左对齐

        XWPFRun run = paragraph.createRun();
        run.setText(paragraphText);
        run.setFontSize(12);
    }

    private static void addTable(XWPFDocument document, List<FieldInfo> fieldInfos){
        // 创建表格
        XWPFTable table = document.createTable();
        table.setWidth("100%");

        // 添加表头
        XWPFTableRow headerRow = table.getRow(0);
        headerRow.getCell(0).setText("字段");
        headerRow.addNewTableCell().setText("类型");
        headerRow.addNewTableCell().setText("说明");

        // 添加数据行
        for (FieldInfo fieldInfo : fieldInfos) {
            XWPFTableRow dataRow = table.createRow();
            dataRow.getCell(0).setText(fieldInfo.getName());
            dataRow.getCell(1).setText(fieldInfo.getType());
            dataRow.getCell(2).setText(fieldInfo.getDescription());
        }

    }

    public static void generateWord(Map<String, List<FieldInfo>> fieldMap, String filePath) throws Exception {
        // 创建 Word 文档
        XWPFDocument document = new XWPFDocument();
        fieldMap.forEach((modelName, fieldInfos) -> {
            addParagraph(document, modelName);
            addParagraph(document, "");
            addTable(document, fieldInfos);
            addParagraph(document, "");
        });
        // 保存文档
        try (FileOutputStream out = new FileOutputStream(filePath)) {
            document.write(out);
        }

        document.close();
    }

    
    private static class FieldInfo {
        String name;
        String type;
        String description ;

        public FieldInfo() {
        }

        public FieldInfo(String name, String type, String description) {
            this.name = name;
            this.type = type;
            this.description = description;
        }

        public String getName() {
            return name;
        }

        public void setName(String name) {
            this.name = name;
        }

        public String getType() {
            return type;
        }

        public void setType(String type) {
            this.type = type;
        }

        public String getDescription() {
            return description;
        }

        public void setDescription(String description) {
            this.description = description;
        }
    }