xjc 是 JDK 自带的 JAXB 工具,用于将 XSD 编译为带注解的 Java 类;JDK 6–8 原生支持,JDK 9+ 需手动引入 jaxb-xjc 依赖;支持指定包名、输出目录、绑定文件等选项,并可集成 Maven 自动化生成。

xjc 是 JDK 自带的 JAXB(Java Architecture for XML Binding)工具,用于将 XML Schema(XSD)文件编译生成对应的 Java 类。它能自动生成带注解的 POJO,支持序列化(XML → Java)和反序列化(Java → XML)。
确认 JDK 版本并检查 xjc 是否可用
JDK 6 到 JDK 8 原生包含 xjc;JDK 9+ 移除了 JAXB(包括 xjc),需手动引入依赖:
- JDK 6–8:xjc 默认在
$JAVA_HOME/bin/下,直接运行xjc -version可验证 - JDK 9+:需添加
jaxb-xjc工具包(如 Maven 引入org.glassfish.jaxb:jaxb-xjc),或使用独立的 JAXB Tools 发行版
基本用法:命令行执行 xjc
假设你有一个 person.xsd,想生成 Java 类到 src/main/java 目录:
- 最简命令:
xjc person.xsd—— 默认生成到当前目录的generated子目录 - 指定输出目录:
xjc -d src/main/java person.xsd - 指定 Java 包名:
xjc -p com.example.model -d src/main/java person.xsd - 启用调试与详细日志:
xjc -verbose person.xsd
常用选项与实用技巧
实际开发中常需定制生成行为:
立即学习“Java免费学习笔记(深入)”;
-
-extension:启用扩展模式(支持 xs:assert、xs:annotation 等高级特性) -
-b binding.xjb:使用外部绑定文件(.xjb)覆盖默认映射,例如重命名类、调整集合类型、忽略某些元素 -
-no-header:生成时不加自动生成声明头(如 “Generated by XJC…” 注释) -
-nv:跳过 XSD 验证(仅当 schema 有引用但本地不可达时临时使用,不推荐长期开启)
配合 Maven 自动化(推荐现代项目使用)
在 pom.xml 中配置 jaxb2-maven-plugin 或 org.codehaus.mojo:jaxb2-maven-plugin:
org.codehaus.mojo jaxb2-maven-plugin 2.5.0 xjc src/main/resources/schema/person.xsd com.example.model ${project.build.directory}/generated-sources/jaxb
执行 mvn generate-sources 即可自动编译 XSD 并加入编译路径。
不复杂但容易忽略:生成的类默认使用 @XmlRootElement 和 @XmlElement 等注解,无需额外配置即可用 JAXBContext 进行 XML 绑定。注意确保 XSD 中的命名空间、targetNamespace 与 Java 包结构逻辑一致,否则可能影响序列化结果。










