XSD-9 在 Maven 項目使用 XJC 代碼生成器

9 在 Maven 項目使用 XJC 代碼生成器

使用 Maven 的 maven-archetype-quickstart 的代碼模板快速搭建測試項目：

mvn archetype:generate -DgroupId=net.csdn -DartifactId=JaxbGen -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

在 Maven 的 pom.xml 文件中添加如下內容：

<plugin>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>jaxb2-maven-plugin</artifactId>
  <version>1.6</version>
  <executions>
    <execution>
      <id>xjc</id>
      <phase>generate-sources</phase>
      <goals>
        <goal>xjc</goal>
      </goals>
    </execution>
  </executions>
  <configuration>
    <schemaDirectory>${project.basedir}/src/main/resources/config</schemaDirectory>
    <packageName>com.csdn.xml</packageName>
    <outputDirectory>${project.basedir}/src/jaxb-gen/java-gen</outputDirectory>
    <extension>true</extension>
  </configuration>
</plugin>

使用 org.codehaus.mojo 組織的 jaxb2-maven-plugin 插件，在官網是這麼介紹的：

org.codehaus.mojo/jaxb2-maven-plugin
Generates Java classes from XML Schemas (and binding files) and creates XML Schemas from annotated Java classes, using JAXB2.

• <schemaDirectory>，指示 xsd schema 文件的位置，其中 ${project.basedir} 是 maven pom.xml 內嵌的變量，指示該項目根目錄的絕對路徑；
• <packageName>，指示由 xjc 生成的 Java Bean Class 的類包名稱，在 Java 中，類包名稱以點號(.)分隔，對應操作系統的文件樹；
• <outputDirectory>，指示由 xjc 生成的 Java Bean Class，存放的根目錄；假如，<outputDirectory>C:/</outputDirectory>，並且<packageName>net.csdn.xml</packageName>，那麼針對<xs:complexType name="Student"/> 複雜類型生成的 Java Bean Class 的存儲位置爲 C:/net/csdn/xml/Student.java；
• <extension>，指示 xjc 的 extension 參數；

即可實現與以下指令相同的執行效果：

xjc -b ${project.basedir}/src/main/resources/config -d ${project.basedir}/src/jaxb-gen -p com.csdn.xml -extension

注：org.codehaus.mojo/jaxb2-maven-plugin 版本 2.5.0 將標籤 <schemaDirectory> 移除，約定在 ~/src/main/xjb/ 與 ~/src/main/xsd/ 存放 schema 文件；而如果使用 1.6 版本，則必須指定標籤 <schemaDirectory>，插件才能找到對應的 xsd 文件。

以下是 org.codehaus.mojo/jaxb2-maven-plugin(version 2.5.0) 的編譯輸出。

[INFO] --- jaxb2-maven-plugin:2.5.0:xjc (xjc) @ JaxbGen ---
[WARNING] Using platform encoding [GBK], i.e. build is platform dependent!
[INFO] Created EpisodePath [C:\java\JaxbGen\src\jaxb-gen\META-INF\JAXB]: true
[INFO] Ignored given or default xjbSources [C:\java\JaxbGen\src\main\xjb], since it is not an existent file or directory.
[INFO] Ignored given or default sources [C:\java\JaxbGen\src\main\xsd], since it is not an existent file or directory.
[WARNING] No XSD files found. Please check your plugin configuration.

---

上一章：XSD-8 JAXB 驗證 XSD Schema 限定
目錄：學習 JAXB
下一章：XSD-10 XSD Schema 的應用場景

---