为已有XML文档自动生成XSD Schema

3次阅读

xsd.exe、trang 和 generateDS 是三种 xml 生成 XSD 的主流工具:xsd.exe 仅限 windows/.NET,推断简单但无语义分析;trang 跨平台、归纳能力强,输出更规范;generateDS 提供 Python 控制力,适合定制化场景;三者均无法自动生成枚举、必填约束和数值范围,需人工补全。

为已有XML文档自动生成XSD Schema

xsd.exe 从 XML 生成 XSD(Windows + .NET Framework)

这是最直接的方案,但仅限 Windows 环境且依赖 .NET Framework 安装。它不分析语义,只基于样本 XML 中出现的元素、属性和值推断类型(比如含数字的文本可能被定为 xsd:Integer,空字符串可能被忽略或设为 nillable="true")。

执行前确保 XML 文件格式良好(无未闭合标签、编码声明一致),否则 xsd.exe 会直接报错退出:

xsd.exe data.xml /outputdir:./schema /language:CS

生成的 data.xsd 通常只有一个根 xs:schema,所有类型内联定义;若 XML 含命名空间,需加 /nologo 和显式指定 /Namespace: 才能正确映射。

  • 不支持 XML 中的注释、处理指令或 CDATA 区段建模
  • 重复出现但值类型不一致的字段(如某处是 "123",另一处是 "abc")会被统一判为 xs:String,不会报错也不会警告
  • 生成的 XSD 默认不带 targetNamespace,后续用于验证时若 XML 声明了 namespace,必须手动补全并调整 xmlns 引用

trang 生成更稳健的 XSD(跨平台首选)

trang 是开源工具(基于 Java),比 xsd.exe 更擅长归纳结构共性,对可选元素、空值、混合内容的判断更合理,输出也更接近手写风格——类型分离、使用 xs:complexTypexs:group 提高复用性。

下载 trang.jar 后,运行:

java -jar trang.jar data.xml data.xsd

若 XML 有多个实例文件(如 order-01.xml, order-02.xml),可一次性输入全部,trang 会合并推导公共结构:

java -jar trang.jar order-*.xml order.xsd
  • 默认生成 XSD 1.0;如需 XSD 1.1(支持断言),加 -i xsd11
  • 对日期格式(如 "2023-10-05")倾向于生成 xs:date,但不会校验是否符合 ISO 8601;若样本中混用 "5/10/2023",仍会回退为 xs:string
  • 不识别 XML Schema 中已有的 xs:annotation 或自定义文档说明,生成结果不含注释

Python 中用 generateDS 动态构建 XSD

当需要嵌入逻辑(例如:根据某字段值动态决定子元素是否必填)、或批量处理大量 XML 并做预过滤时,generateDS 提供 Python API 层面的控制力。它本身不直接“生成 XSD”,而是先解析 XML 成 Python 对象,再调用其 writeXMLSchema() 方法输出。

安装后典型用法:

from generateDS import parse from generateDS.generateDS import writeXMLSchema  tree = parse("data.xml") writeXMLSchema(tree, "data.xsd")

关键限制在于:它依赖 minidom 解析,对 DTD、外部实体、命名空间前缀绑定较敏感;若 XML 含 声明,常因网络不可达的 DTD URI 导致解析失败,此时需预先移除或重写为内部子集。

  • 无法处理 XML 中的默认属性值(defaultfixed
  • xs:any 类型的通配字段,一律生成为 xs:any processContents="lax",不尝试反推实际允许的内容
  • 生成的 XSD 中所有 xs:element 默认 maxOccurs="1",即使样本中某元素重复出现多次,也不会自动设为 unbounded

生成后必须人工核查的三个硬伤点

所有自动化工具都基于样本统计,无法替代领域知识。以下三点几乎必然出错,跳过就会导致后续验证失效:

  • xs:requiredxs:nillable 混用:工具常把缺失字段标为 nillable="true",但业务上该字段可能是“不允许出现”而非“允许显式设为 nil”
  • 枚举值(xs:enumeration)完全缺失:哪怕 XML 中某个 只出现过 "active""inactive",工具也不会生成 xs:restriction,只会用 xs:string
  • 数值范围约束(xs:minInclusive / xs:pattern)为零:金额字段不会自动加 pattern="d+.d{2}",ID 字段也不会限制长度

真正可用的 XSD,总要在这几处补上手工定义。自动生成只是起点,不是闭环。

text=ZqhQzanResources