如何将XSD全量维度、注解信息转换为Swagger JSON与Java对象

• 自定义XJC插件扩展原生生成逻辑：不要直接跑原生xjc命令生成Java类，原生逻辑只识别基础类型、出现次数这类基础属性，<annotation><documentation>里的文档内容、自定义的维度约束标签会全部丢失。直接写XJC插件挂载解析生命周期，解析到每个complexType、simpleType、element、attribute节点的时候，把节点上的维度标识、documentation文本、长度/正则/枚举/取值范围这类约束全提取出来，生成类和字段的时候自动打在自定义注解上，比如自定义@XsdMeta注解，类、字段级各一个，把所有元信息全存在注解参数里，后续用的时候直接读注解即可。
• 用Apache XmlSchema库手动解析建模：如果不想折腾XJC插件，直接引入Apache XmlSchema依赖，自己递归遍历整个XSD节点树，从根schema开始把所有类型定义、元素、属性、节点间的引用/继承关系全扫一遍，提取所有元信息后组装到自定义的Java元模型里——比如建两个核心类XsdTypeMeta、XsdFieldMeta，分别存类型、字段的全量属性，这种方式灵活度最高，哪怕XSD里加了非标准的自定义属性，也能100%提取出来，不会受框架默认逻辑限制。
• 避坑提醒：别用DOM/SAX这类原生XML解析器硬写，也别用Jackson XML直接映射，处理XSD的跨文件引用、类型继承、命名空间映射的时候非常容易漏信息，尤其是多XSD文件互相import的场景，解析出来的结构大概率不全。

• 扩展Swagger/OpenAPI的模型转换扩展点：不管用老版SpringFox还是现在主流的SpringDoc，都开放了自定义模型转换的SPI。前面生成的Java类上已经带了存全量元信息的自定义注解，直接实现对应的ModelConverter接口，在框架扫描Java类生成Swagger模型节点的时候，把注解里的信息逐字段填进去：
  • 字段、类的documentation描述直接赋值给Swagger模型的description字段
  • 维度标识这类Swagger原生规范不支持的业务属性，统一放到x-*开头的自定义扩展字段里，Swagger原生支持这类扩展属性，不会和官方字段冲突，下游消费JSON的时候直接读对应扩展字段即可
  • 长度、正则、枚举、取值范围这类标准约束，直接映射到Swagger原生的maxLength/minLength/pattern/enum/maximum/minimum字段，不需要放扩展里
• 跳过Java生成环节直接组装Swagger JSON：如果前面是用Apache XmlSchema手动解析得到了全量XSD元模型，完全可以跳过生成Java类这一步，直接按照Swagger/OpenAPI的JSON结构规范，把元模型里的类型、字段、约束、文档、维度信息逐节点映射成JSON结构，这种方案链路最短，没有Java类转Swagger模型的中间损耗，信息保留率最高，也不用写自定义注解、扩展Swagger转换器，逻辑更可控。
• 加校验环节兜底：JSON生成完之后，把原始XSD解析出来的全量元信息清单和JSON里的字段做一一比对，检查每个字段的文档、维度、约束是不是都存在，避免转换逻辑的边界case丢信息。

注意：别直接用网上现成的xsd转swagger工具包，这类工具基本只做基础类型的映射，自定义维度标识、annotation文档默认都会丢弃，必须自己扩展逻辑才能保留全量信息。

内容的提问来源于stack exchange，提问作者user10666933