如何将Schematron编译为带JAXB注解的Java类

首先明确：不存在和xjc等价、可直接将全量Schematron编译为JAXB注解Java类的原生工具，结合你只需要提取Schematron中可被XSD表达的结构约束、最终生成PEPPOL BIS Billing 3.0发票/贷记单的需求，完全不需要从Schematron反向提取规则，直接按以下路径实现即可：

核心逻辑 #

你提到的PEPPOL-EN16931-UBL.sch，是基于UBL 2.1编写的业务规则集：

• 其中所有元素层级、属性存在性、字段基数、数据类型这类本来就可以用XSD表达的结构约束，PEPPOL官方已经在配套发布的定制化UBL XSD中做了完整固化，和Schematron里的结构类规则完全对齐，你直接用xjc编译官方XSD就能得到符合要求的JAXB类，和你之前生成XML的工作流完全兼容。
• Schematron里剩下的跨字段校验、代码集匹配、上下文相关业务规则，本身就超出XSD的表达能力范围，也不可能通过静态编译的JAXB类在对象组装阶段自动生效，本来就不属于你需要的编译范畴。

具体操作步骤 #

• 第一步：获取PEPPOL BIS Billing 3.0对应版本的定制化UBL XSD包，不要直接使用原生UBL 2.1 XSD——原生XSD没有包含PEPPOL对结构的裁剪、约束调整，生成的类会包含很多规范不允许使用的节点。
• 第二步：用你之前熟悉的xjc命令编译XSD生成JAXB类，可搭配常用JAXB插件优化生成的代码：
  • 添加-Xfluent-api参数生成链式setter方法，大幅简化单据对象组装代码
  • 添加-XtoString、-Xequals、-XhashCode参数生成常用基础工具方法
    参考编译命令如下：

  xjc -d src/main/java -p com.yourcompany.peppol.bis3.ubl \
    -Xfluent-api -XtoString -Xequals -XhashCode \
    ./schemas/PEPPOL-EN16931-UBL-2.1.xsd
  

• 第三步：直接使用生成的JAXB类组装发票、贷记单对象，通过JAXB序列化输出的XML，天然满足目标Schematron中所有可被XSD表达的结构要求。

PEPPOL单据生成的实用建议 #

• 不要尝试用通用sch2xsd类工具从Schematron反向生成XSD，这类工具生成的XSD冗余度极高、结构和官方PEPPOL生态不兼容，后续升级、排错的成本非常高。
• 结构约束满足后，Schematron中剩余的业务规则校验，建议放在XML生成完成后单独执行，不要耦合到JAXB类的生成逻辑里。Java生态有成熟的Schematron校验库，可以直接加载目标sch文件对输出的XML做全量规则校验，确保单据完全合规。
• 如果不想自己维护XSD编译、规则校验的逻辑，可以直接使用社区维护的成熟PEPPOL Java工具包，这类工具包已经提前编译好了对应版本的JAXB类，内置了全量Schematron校验能力，直接调用API即可组装合规单据，省去自己处理Schema编译的工作量。

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