jaxb2-annotate-plugin 不工作答案

【问题标题】：jaxb2-annotate-plugin not workingjaxb2-annotate-plugin 不工作
【发布时间】：2015-02-27 14:10:02
【问题描述】：

我想在生成的“Doc”类之前生成“@java.lang.SuppressWarnings("all")”。

问题：jaxb2-annotate-plugin 不生成注释。

我的 pom.xml：

...
<build>
    <plugins>
        <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>jaxb2-maven-plugin</artifactId>
            <version>1.5</version>
            <executions>
                <execution>
                    <id>xjc</id>
                    <goals>
                        <goal>xjc</goal>
                    </goals>
                    <configuration>
                        <extension>true</extension>
                        <arguments>-Xannotate</arguments>
                        <args>
                        <arg>-Xannotate</arg>
                        </args>
                        <plugins>
                            <plugin>
                                <groupId>org.jvnet.jaxb2_commons</groupId>
                                <artifactId>jaxb2-basics-annotate</artifactId>
                            </plugin>
                            <plugin>
                                <groupId>org.jvnet.jaxb2_commons</groupId>
                                <artifactId>jaxb2-annotate-plugin-test-annox-annotations</artifactId>
                            </plugin>
                        </plugins>
                    </configuration>
                </execution>
            </executions>
            <dependencies>
                <dependency>
                    <groupId>org.jvnet.jaxb2_commons</groupId>
                    <artifactId>jaxb2-basics-annotate</artifactId>
                    <version>0.6.4</version>
                </dependency>
                <dependency>
                    <groupId>com.sun.codemodel</groupId>
                    <artifactId>codemodel</artifactId>
                    <version>2.6</version>
                </dependency>
            </dependencies>
        </plugin>
    </plugins>
</build>

<dependencies>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
    </dependency>
    <dependency>
        <groupId>org.jvnet.jaxb2_commons</groupId>
        <artifactId>jaxb2-basics-annotate</artifactId>
        <version>0.6.4</version>
    </dependency>
    <dependency>
        <groupId>com.sun.codemodel</groupId>
        <artifactId>codemodel</artifactId>
        <version>2.6</version>
    </dependency>
    <dependency>
        <groupId>javax.xml.bind</groupId>
        <artifactId>jaxb-api</artifactId>
        <version>${jaxb-api.version}</version>
    </dependency>
    <dependency>
        <groupId>com.sun.xml.bind</groupId>
        <artifactId>jaxb-impl</artifactId>
        <version>${jaxb.version}</version>
    </dependency>
    <dependency>
        <groupId>com.sun.xml.bind</groupId>
        <artifactId>jaxb-xjc</artifactId>
        <version>${jaxb.version}</version>
    </dependency>
</dependencies>

<properties>
    <jaxb.version>2.2.5-2</jaxb.version>
    <jaxb-api.version>2.1</jaxb-api.version>
</properties>

我的 XSD：

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns="..."
targetNamespace="..." elementFormDefault="qualified"
xmlns:jaxb="http://java.sun.com/xml/ns/jaxb" xmlns:annox="http://annox.dev.java.net"
jaxb:version="2.1" jaxb:extensionBindingPrefixes="annox">
<xs:element name="Doc">
    <xs:complexType>
        <xs:annotation>
            <xs:appinfo>
                <annox:annotate>@java.lang.SuppressWarnings("all")</annox:annotate>
                <annox:annotateClass>@java.lang.SuppressWarnings("all")
                </annox:annotateClass> 
                <annox:annotate target="class">@java.lang.SuppressWarnings("all")
                </annox:annotate>
            </xs:appinfo>
        </xs:annotation>
        <xs:sequence>
            <xs:element ref="info" />
        </xs:sequence>
    </xs:complexType> 
</xs:element>

我尝试了所有三种方法在 Doc 类之前生成“@java.lang.SuppressWarnings("all")”

【问题讨论】：

标签： java jaxb maven-plugin jaxb2-annotate-plugin

【解决方案1】：

我认为插件没有激活。您正在使用jaxb2-maven-plugin 并使用configuration/plugins/plugin 来配置jaxb2-annotate-plugin。问题是，plugins/plugin 是我的maven-jaxb2-plugin 的配置选项，而不是 Codehaus jaxb2-maven-plugin。

尝试切换到maven-jaxb2-plugin 或了解如何在jaxb2-maven-plugin 中激活 JAXB2 插件。

也使用较新的版本。您正在尝试使用 Java 语法，这是最近才开发的。请使用jaxb2-annotate-plugin的实际版本（当前为1.0.1）。

这是一个供参考的测试项目：

https://github.com/highsource/jaxb2-annotate-plugin/tree/master/tests/issues

您的自定义看起来不错，这三个中的任何一个都应该可以工作。

免责声明：我是jaxb2-annotate-plugin 和maven-jaxb2-plugin 的作者。

【讨论】：

使用 jaxb2-maven-plugin，您可以将 -Xannotate 替换为 -Xannotate，但它说：“参数 -Xannotate 未知”。那么注释插件是否有可能与 jaxb2-maven-plugin 一起使用？
@Tristan 您必须在 jaxb2-maven-plugin 的依赖项中添加 org.jvnet.jaxb2_commons:jaxb2-basics-annotate。这是example。
@Tristan 不保证，但是因为我自己不使用jaxb2-maven-plugin。

【解决方案2】：

试试这个 XSD ..

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
    targetNamespace="..." xmlns="..."
    elementFormDefault="qualified" attributeFormDefault="unqualified" version="0.0.1"
    xmlns:annox="http://annox.dev.java.net" xmlns:jaxb="http://java.sun.com/xml/ns/jaxb" jaxb:version="2.1"
    xmlns:jl="http://annox.dev.java.net/java.lang" jaxb:extensionBindingPrefixes="annox">

    <xs:element name="Doc">
        <xs:complexType>
            <xs:annotation>
                <xs:appinfo>
                    <annox:annotate>
                        <annox:annotate annox:class="java.lang.SuppressWarnings">all</annox:annotate>
                    </annox:annotate>
                </xs:appinfo>
            </xs:annotation>
            <xs:sequence>
                <xs:element ref="info" />
            </xs:sequence>
        </xs:complexType>
    </xs:element>

</xs:schema>

但我更喜欢这样的外部绑定（示例）

<bindings version="2.0" xmlns="http://java.sun.com/xml/ns/jaxb" xmlns:xs="http://www.w3.org/2001/XMLSchema"
    xmlns:xjc="http://java.sun.com/xml/ns/jaxb/xjc" xmlns:annox="http://annox.dev.java.net"
    xmlns:namespace="http://jaxb2-commons.dev.java.net/namespace-prefix" 
    xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
    jaxb:extensionBindingPrefixes="annox">

    <bindings schemaLocation="../Binding.xsd">

        <bindings node="//xs:complexType[@name='Bindings']">
            <annox:annotate>
                <annox:annotate annox:class="java.lang.SuppressWarnings" >all</annox:annotate>
            </annox:annotate>
        </bindings>

    </bindings>
</bindings>

使用的maven插件（一个例子）

<plugin>
    <groupId>org.jvnet.jaxb2.maven2</groupId>
    <artifactId>maven-jaxb2-plugin</artifactId>
    <version>0.11.0</version>
    <executions>
        <execution>
            <id>commun-generate</id>
            <goals>
                <goal>generate</goal>
            </goals>
            <configuration>
                <args>
                    <arg>-Xannotate</arg>
                    <arg>-nv</arg>
                    <arg>-Xnamespace-prefix</arg>
                </args>
                <bindingDirectory>${basedir}/src/main/resources/META-INF/schema/binding</bindingDirectory>
                <bindingIncludes>
                    <bindingInclude>global-binding.xjb</bindingInclude>
                    <bindingInclude>Binding.xjb</bindingInclude>
                </bindingIncludes>
                <generateDirectory>${basedir}/src/main/java/</generateDirectory>
                <schemas>
                    <schema>
                        <fileset>
                            <directory>${basedir}/src/main/resources/META-INF/schema</directory>
                            <includes>
                                <include>Binding.xsd</include>
                            </includes>
                        </fileset>
                    </schema>
                </schemas>
                <strict>false</strict>
                <extension>true</extension>
                <verbose>true</verbose>
                <forceRegenerate>true</forceRegenerate>
                <plugins>
                    <plugin>
                        <groupId>org.jvnet.jaxb2_commons</groupId>
                        <artifactId>jaxb2-basics</artifactId>
                        <version>0.6.0</version>
                    </plugin>
                    <plugin>
                        <groupId>org.jvnet.jaxb2_commons</groupId>
                        <artifactId>jaxb2-basics-annotate</artifactId>
                        <version>0.6.0</version>
                    </plugin>
                    <plugin>
                        <groupId>org.jvnet.jaxb2_commons</groupId>
                        <artifactId>jaxb2-namespace-prefix</artifactId>
                        <version>1.1</version>
                    </plugin>
                </plugins>
            </configuration>
        </execution>
    </executions>
</plugin>

【讨论】：

我同意外部绑定是要走的路。但是您提出了注释的“旧”XML 语法，并且在较新的版本中，您可以使用我推荐的 Java 语法。我不认为问题出在绑定中，我认为问题出在 Maven 插件配置或 jaxb2-annotate-plugin 的版本中。