Как использовать настройку класса для разрешения конфликтов создания файлов

Я пытаюсь использовать Maven для создания файлов JAXB, которые будут использоваться средой Spring, но Maven отображает следующие ошибки:

Я понимаю, что он не может генерировать файлы с именами, но я не уверен, как решить проблему. До сих пор я посещал следующие ссылки. 1, 2, 3

org.xml.sax.SAXParseException; systemId: http://www5v80.elsyarres.net/service.asmx?wsdl; lineNumber: 5; columnNumber: 39; A class/interface with the same name "hello.wsdl.SearchFlights" is already in use. Use a class customization to resolve this conflict.
....
org.xml.sax.SAXParseException; systemId: http://www5v80.elsyarres.net/service.asmx?wsdl; lineNumber: 12; columnNumber: 43; (Relevant to above error) another "SearchFlights" is generated from here.
....
org.xml.sax.SAXParseException; systemId: http://www5v80.elsyarres.net/service.asmx?wsdl; lineNumber: 371; columnNumber: 42; A class/interface with the same name "hello.wsdl.GetFlightDetails" is already in use. Use a class customization to resolve this conflict.
....

Плагин Maven

    <plugin>
        <artifactId>maven-war-plugin</artifactId>
        <version>2.4</version>
        <configuration>
            <warSourceDirectory>WebContent</warSourceDirectory>
        </configuration>
    </plugin>
    <plugin>
        <groupId>org.jvnet.jaxb2.maven2</groupId>
        <artifactId>maven-jaxb2-plugin</artifactId>
        <version>0.12.3</version>
        <executions>
            <execution>
                <goals>
                    <goal>generate</goal>
                </goals>
            </execution>
        </executions>
        <configuration>
            <schemaLanguage>WSDL</schemaLanguage>
            <generatePackage>hello.wsdl</generatePackage>
            <schemas>
                <schema>
                    <url>http://www5v80.elsyarres.net/service.asmx?wsdl</url>
                </schema>
            </schemas>
        </configuration>
    </plugin>

Я добавил следующий файл package-info.java в пакет hello.wsdl, но это не помогло.

@XmlSchema( 
    namespace = "ElsyArres.API",
    elementFormDefault = XmlNsForm.QUALIFIED) 
package hello.wsdl;

import javax.xml.bind.annotation.XmlNsForm;
import javax.xml.bind.annotation.XmlSchema;

Ответ 1

Сообщение об ошибке, с которым вы сталкиваетесь, в основном утверждает, что некоторые имена в разделе types вашего wsdl используются два раза. В вашем случае все теги <element> имеют то же имя, что и их соответствующие типы (определенные как <complexType>).

Пример:

  <s:element name="SearchFlights">
    <s:complexType>
      <s:sequence>
        <s:element minOccurs="0" maxOccurs="1" name="SoapMessage" type="tns:SearchFlights" />
      </s:sequence>
    </s:complexType>
  </s:element>

  <s:complexType name="SearchFlights">
    <s:complexContent mixed="false">
      <s:extension base="tns:SoapMessageBase">
        <s:sequence>
          <s:element minOccurs="0" maxOccurs="1" name="Request" type="tns:SearchFlightsRequest" />
          <s:element minOccurs="0" maxOccurs="1" name="Response" type="tns:SearchFlightsResponse" />
        </s:sequence>
      </s:extension>
    </s:complexContent>
  </s:complexType>

Это довольно редко.

Существует два варианта решения этих проблем:

Использовать autoNameResolution

 <plugin>
     <groupId>org.jvnet.jaxb2.maven2</groupId>
     <artifactId>maven-jaxb2-plugin</artifactId>
     <version>0.13.1</version>
     <executions>
         <execution>
             <goals>
                 <goal>generate</goal>
             </goals>
         </execution>
     </executions>
     <configuration>

         <args>
             <arg>-XautoNameResolution</arg>
         </args>

         <schemaLanguage>WSDL</schemaLanguage>
         <generatePackage>hello.wsdl</generatePackage>
         <schemas>
             <schema>
                 <url>http://www5v80.elsyarres.net/service.asmx?wsdl</url>
             </schema>
          </schemas>
      </configuration>
  </plugin>

Плагин разрешит все конфликты имен путем добавления чисел к каждому сталкивающемуся имени. В вышеупомянутом случае SearchFlights это приведет к созданию SearchFlights и SearchFlights2.

Лучший способ - использовать файл привязки для разрешения всех конфликтов имен заранее. Файлы привязки в основном содержат правила выражения и преобразования XPATH. Файл привязки, который добавляется к каждому объявлению, следующий:

<?xml version="1.0" encoding="UTF-8"?>
<jaxws:bindings wsdlLocation="http://www5v80.elsyarres.net/service.asmx?wsdl"
            xmlns:jaxws="http://java.sun.com/xml/ns/jaxws"
            xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
            xmlns:jaxb="http://java.sun.com/xml/ns/jaxb" version="2.1"
            xmlns:xs="http://www.w3.org/2001/XMLSchema">

    <jaxws:bindings node="wsdl:definitions/wsdl:types/xs:schema[@targetNamespace='ElsyArres.API']">
        <jaxb:schemaBindings>
            <jaxb:nameXmlTransform>
                <jaxb:elementName suffix="Elem"/>
            </jaxb:nameXmlTransform>
        </jaxb:schemaBindings>
    </jaxws:bindings>
</jaxws:bindings>

Существуют и другие опции для jaxb:nameXmlTransform, такие как суффиксы и добавление к другим типам элементов xml (например, типы).

К сожалению, я не мог заставить работать этот файл привязки с org.jvnet.jaxb2.maven2:maven-jaxb2-plugin (но я уверен, что есть рабочая конфигурация)

Тем не менее он работает с org.codehaus.mojo:jaxws-maven-plugin и следующей конфигурацией.

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>jaxws-maven-plugin</artifactId>
    <version>2.4.1</version>
    <executions>
        <execution>
            <goals>
                <goal>wsimport</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <bindingFiles>
         <bindingFile>${basedir}/src/main/resources/bindings.xjb</bindingFile>
        </bindingFiles>
        <wsdlUrls>
            <wsdlUrl>http://www5v80.elsyarres.net/service.asmx?wsdl</wsdlUrl>
        </wsdlUrls>
        <vmArgs>
            <vmArg>-Djavax.xml.accessExternalSchema=all</vmArg>
        </vmArgs>
    </configuration>
</plugin>

Ответ 2

Если исправление autoNameResolution

 <args>
     <arg>-XautoNameResolution</arg>
 </args>

не работает, попробуйте:

 <args>
     <arg>-B-XautoNameResolution</arg>
 </args>

Ответ 3

Удаление тега <generatePackage></generatePackage> решает проблему.

Однако следствием этого удаления является то, что ваши пакеты будут созданы из пространства имен xml. Например, пространство имен example.com/xyz приведет к пакету com.example.xyz

Ответ 4

Удаление generatePackage, как упоминает hamid-mohayeji, исправляет множество случаев (по крайней мере, когда ваш xsds нормален). Параметр пытается поместить все сущности в одно и то же пространство имен, и в непростых случаях это может привести к ошибкам. Однако, опуская пакет, вы получаете пакеты, созданные из пространства имен. Например, http://www.co.com/srvc/api/common станет пакетом com.co.srvc.api.common.

Это можно исправить, добавив простой файл привязки. Сконфигурируйте <bindingDirectory>src/main/resources/bindings</bindingDirectory> в pom и добавьте файл привязки нечто .xjb в каталог привязок. Здесь вам нужно обратиться к человеку относительно этого файла.

Этот файл устанавливает пакеты для каждого xsd файла индивидуально:

<?xml version="1.0" encoding="UTF-8"?>
<jaxb:bindings xmlns:jaxb="http://java.sun.com/xml/ns/jaxb" jaxb:version="2.0">

    <jaxb:bindings schemaLocation="../schemas/common.xsd">
        <jaxb:schemaBindings>
            <jaxb:package name="com.mycomp.myapp.co.common" />
        </jaxb:schemaBindings>
    </jaxb:bindings>

    ... more bindings

</jaxb:bindings>