JAX-WS:编译模式与 WSDL 分开
JAX-WS: Compile Schema separate from WSDL
如果有一个在多个 Web 服务中使用的相当大的模式,因此我想将 XSD 编译与 WSDL 编译分开。在一个简化的例子中,一步编译工作:
$ wsimport -verbose service.wsdl
parsing WSDL...
Generating code...
org/example/wsdl/mysvc/MySvcPortType.java
org/example/wsdl/mysvc/MySvcService.java
org/example/ns1/Element1.java
org/example/ns1/ObjectFactory.java
org/example/ns1/package-info.java
...
编译 xsd 并使用生成的剧集文件不起作用:
$ wsimport -b schema3.episode service.wsdl
parsing WSDL...
[ERROR] Schema descriptor {http://www.example.org/ns1}element1 in
message part "part1" is not defined and could not be bound to Java.
Perhaps the schema descriptor {http://www.example.org/ns1}element1 is
not defined in the schema imported/included in the WSDL. You can
either add such imports/includes or run wsimport and provide the
schema location using -b switch. line 9 of
file:...jaxepisode_element/service.wsdl
那么如何在 wsimport 中使用预编译模式?
附录:
在包含在另一个模式中时使用剧集可以避免新的编译(d3.jar 包含来自 schema3 + schema3.episode 的生成的 类 作为 META-INF/sun-jaxb.episode):
$ xjc schema4.xsd d3.jar -extension
parsing a schema...
compiling a schema...
org/example/ns2/Element2.java
org/example/ns2/ObjectFactory.java
org/example/ns2/package-info.java
没有预编译包:
$ xjc schema4.xsd -extension
parsing a schema...
compiling a schema...
org/example/ns1/Element1.java
org/example/ns1/ObjectFactory.java
org/example/ns1/package-info.java
org/example/ns2/Element2.java
org/example/ns2/ObjectFactory.java
org/example/ns2/package-info.java
WSDL:
<definitions xmlns="http://schemas.xmlsoap.org/wsdl/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://example.org/wsdl/MySvc" xmlns:ns="http://www.example.org/ns1" targetNamespace="http://example.org/wsdl/MySvc" name="MySvc">
<types>
<xsd:schema>
<xsd:import namespace="http://www.example.org/ns1" schemaLocation="schema3.xsd"/>
</xsd:schema>
</types>
<message name="myOpRequest">
<part name="part1" element="ns:element1"/>
</message>
<message name="myOpReply">
<part name="part1" element="ns:element1"/>
</message>
<portType name="MySvcPortType">
<operation name="myOp">
<input name="input1" message="tns:myOpRequest"/>
<output name="output1" message="tns:myOpReply"/>
</operation>
</portType>
<binding name="MySvcBinding" type="tns:MySvcPortType">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<operation name="myOp">
<soap:operation/>
<input name="input1">
<soap:body use="literal"/>
</input>
<output name="output1">
<soap:body use="literal"/>
</output>
</operation>
</binding>
<service name="MySvcService">
<port name="MySvcPort" binding="tns:MySvcBinding">
<soap:address location="http://localhost:8080/"/>
</port>
</service>
</definitions>
schema3.xsd:
<schema
xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/ns1"
xmlns:tns="http://www.example.org/ns1"
elementFormDefault="qualified">
<element name="element1" >
<complexType >
<sequence>
<element name="name" type="string" />
</sequence>
</complexType>
</element>
</schema>
schema4.xsd:
<schema
xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/ns2"
xmlns:tns="http://www.example.org/ns2"
xmlns:ns1="http://www.example.org/ns1"
elementFormDefault="qualified">
<import namespace="http://www.example.org/ns1" schemaLocation="schema3.xsd"/>
<element name="element2" >
<complexType >
<sequence>
<element ref="ns1:element1" />
</sequence>
</complexType>
</element>
</schema>
生成的剧集文件:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bindings version="2.1" xmlns="http://java.sun.com/xml/ns/jaxb">
<bindings scd="x-schema::tns" xmlns:tns="http://www.example.org/ns1">
<schemaBindings map="false">
<package name="org.example.ns1"/>
</schemaBindings>
<bindings scd="tns:element1">
<class ref="org.example.ns1.Element1"/>
</bindings>
</bindings>
</bindings>
您可以使用 maven,将每个分开并使用 Apache CXF 生成。
我有一个例子可以帮助你。
属性:
<properties>
<apache.cxf.version>3.0.4</apache.cxf.version>
<cxf-codegen-plugin.version>3.0.4</cxf-codegen-plugin.version>
<cxf-xjc-plugin.version>3.0.3</cxf-xjc-plugin.version>
</properties>
依赖项:
<dependencies>
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-rt-frontend-jaxws</artifactId>
<version>${apache.cxf.version}</version>
</dependency>
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-rt-transports-http</artifactId>
<version>${apache.cxf.version}</version>
</dependency>
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-rt-databinding-jaxb</artifactId>
<version>${apache.cxf.version}</version>
<exclusions>
<exclusion>
<groupId>com.sun.xml.bind</groupId>
<artifactId>jaxb-core</artifactId>
</exclusion>
<exclusion>
<groupId>com.sun.xml.bind</groupId>
<artifactId>jaxb-impl</artifactId>
</exclusion>
<exclusion>
<groupId>xalan</groupId>
<artifactId>xalan</artifactId>
</exclusion>
</exclusions>
</dependency>
</dependencies>
运行 --> mvn clean install -Pgenerates-nfe-services
<profile>
<id>generates-nfe-services</id>
<activation>
<property>
<name>generates-nfe-services</name>
</property>
</activation>
<build>
<plugins>
<plugin>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-codegen-plugin</artifactId>
<executions>
<execution>
<id>generate-sources</id>
<phase>generate-sources</phase>
<configuration>
<!--sourceRoot>${project.build.directory}/generated-sources</sourceRoot-->
<sourceRoot>${basedir}/src/main/java</sourceRoot>
<defaultOptions>
<extraargs>
<extraarg>-validate</extraarg>
<extraarg>-client</extraarg>
<extraarg>-verbose</extraarg>
<extraarg>-xjc-npa</extraarg>
<extraarg>-xjc-verbose</extraarg>
<extraarg>-xjc-extension</extraarg>
<extraarg>-exsh</extraarg>
<extraarg>true</extraarg>
<extraarg>-keep</extraarg>
</extraargs>
</defaultOptions>
<wsdlOptions>
<wsdlOption>
<wsdl>
${basedir}/src/main/wsdl/br/gov/rs/sefaz/nfe/homologacao/NfeConsultaCadastro.wsdl
</wsdl>
<extraargs>
<extraarg>-p</extraarg>
<extraarg>br.gov.rs.sefaz.nfe.consulta.cadastro</extraarg>
</extraargs>
</wsdlOption>
</wsdlOptions>
</configuration>
<goals>
<goal>wsdl2java</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
</profile>
运行 --> mvn clean install -Pgenerates-layouts-nfe
<profile>
<id>generates-layouts-nfe</id>
<activation>
<property>
<name>generates-layouts-nfe</name>
</property>
</activation>
<build>
<plugins>
<plugin>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-xjc-plugin</artifactId>
<version>${cxf-xjc-plugin.version}</version>
<executions>
<execution>
<id>generate-sources</id>
<phase>generate-sources</phase>
<goals>
<goal>xsdtojava</goal>
</goals>
<configuration>
<!--sourceRoot>${basedir}/target/generated-sources</sourceRoot-->
<sourceRoot>${basedir}/src/main/java</sourceRoot>
<xsdOptions>
<xsdOption>
<xsd>${basedir}/src/main/schemas/nfe/PL_008f/leiauteConsSitNFe_v3.10.xsd
</xsd>
<packagename>br.inf.portalfiscal.nfe.v310.leiaute.consulta.situacao.nfe
</packagename>
<extension>true</extension>
<extensionArgs>
<!--extensionArg>-npa</extensionArg-->
<extensionArg>-extension</extensionArg>
</extensionArgs>
</xsdOption>
</xsdOptions>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</profile>
您可以创建一个 Maven 项目来只生成 wsdl,另一个只生成 xsd。
注意:
如果他的项目不需要使用WSDL,切换到json-rest-api。
使用 REST 并快乐。 \o/
希望对您有所帮助。
如果有一个在多个 Web 服务中使用的相当大的模式,因此我想将 XSD 编译与 WSDL 编译分开。在一个简化的例子中,一步编译工作:
$ wsimport -verbose service.wsdl
parsing WSDL...
Generating code...
org/example/wsdl/mysvc/MySvcPortType.java
org/example/wsdl/mysvc/MySvcService.java
org/example/ns1/Element1.java
org/example/ns1/ObjectFactory.java
org/example/ns1/package-info.java
...
编译 xsd 并使用生成的剧集文件不起作用:
$ wsimport -b schema3.episode service.wsdl
parsing WSDL...
[ERROR] Schema descriptor {http://www.example.org/ns1}element1 in
message part "part1" is not defined and could not be bound to Java.
Perhaps the schema descriptor {http://www.example.org/ns1}element1 is
not defined in the schema imported/included in the WSDL. You can
either add such imports/includes or run wsimport and provide the
schema location using -b switch. line 9 of
file:...jaxepisode_element/service.wsdl
那么如何在 wsimport 中使用预编译模式?
附录: 在包含在另一个模式中时使用剧集可以避免新的编译(d3.jar 包含来自 schema3 + schema3.episode 的生成的 类 作为 META-INF/sun-jaxb.episode):
$ xjc schema4.xsd d3.jar -extension
parsing a schema...
compiling a schema...
org/example/ns2/Element2.java
org/example/ns2/ObjectFactory.java
org/example/ns2/package-info.java
没有预编译包:
$ xjc schema4.xsd -extension
parsing a schema...
compiling a schema...
org/example/ns1/Element1.java
org/example/ns1/ObjectFactory.java
org/example/ns1/package-info.java
org/example/ns2/Element2.java
org/example/ns2/ObjectFactory.java
org/example/ns2/package-info.java
WSDL:
<definitions xmlns="http://schemas.xmlsoap.org/wsdl/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://example.org/wsdl/MySvc" xmlns:ns="http://www.example.org/ns1" targetNamespace="http://example.org/wsdl/MySvc" name="MySvc">
<types>
<xsd:schema>
<xsd:import namespace="http://www.example.org/ns1" schemaLocation="schema3.xsd"/>
</xsd:schema>
</types>
<message name="myOpRequest">
<part name="part1" element="ns:element1"/>
</message>
<message name="myOpReply">
<part name="part1" element="ns:element1"/>
</message>
<portType name="MySvcPortType">
<operation name="myOp">
<input name="input1" message="tns:myOpRequest"/>
<output name="output1" message="tns:myOpReply"/>
</operation>
</portType>
<binding name="MySvcBinding" type="tns:MySvcPortType">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<operation name="myOp">
<soap:operation/>
<input name="input1">
<soap:body use="literal"/>
</input>
<output name="output1">
<soap:body use="literal"/>
</output>
</operation>
</binding>
<service name="MySvcService">
<port name="MySvcPort" binding="tns:MySvcBinding">
<soap:address location="http://localhost:8080/"/>
</port>
</service>
</definitions>
schema3.xsd:
<schema
xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/ns1"
xmlns:tns="http://www.example.org/ns1"
elementFormDefault="qualified">
<element name="element1" >
<complexType >
<sequence>
<element name="name" type="string" />
</sequence>
</complexType>
</element>
</schema>
schema4.xsd:
<schema
xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/ns2"
xmlns:tns="http://www.example.org/ns2"
xmlns:ns1="http://www.example.org/ns1"
elementFormDefault="qualified">
<import namespace="http://www.example.org/ns1" schemaLocation="schema3.xsd"/>
<element name="element2" >
<complexType >
<sequence>
<element ref="ns1:element1" />
</sequence>
</complexType>
</element>
</schema>
生成的剧集文件:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bindings version="2.1" xmlns="http://java.sun.com/xml/ns/jaxb">
<bindings scd="x-schema::tns" xmlns:tns="http://www.example.org/ns1">
<schemaBindings map="false">
<package name="org.example.ns1"/>
</schemaBindings>
<bindings scd="tns:element1">
<class ref="org.example.ns1.Element1"/>
</bindings>
</bindings>
</bindings>
您可以使用 maven,将每个分开并使用 Apache CXF 生成。
我有一个例子可以帮助你。
属性:
<properties>
<apache.cxf.version>3.0.4</apache.cxf.version>
<cxf-codegen-plugin.version>3.0.4</cxf-codegen-plugin.version>
<cxf-xjc-plugin.version>3.0.3</cxf-xjc-plugin.version>
</properties>
依赖项:
<dependencies>
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-rt-frontend-jaxws</artifactId>
<version>${apache.cxf.version}</version>
</dependency>
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-rt-transports-http</artifactId>
<version>${apache.cxf.version}</version>
</dependency>
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-rt-databinding-jaxb</artifactId>
<version>${apache.cxf.version}</version>
<exclusions>
<exclusion>
<groupId>com.sun.xml.bind</groupId>
<artifactId>jaxb-core</artifactId>
</exclusion>
<exclusion>
<groupId>com.sun.xml.bind</groupId>
<artifactId>jaxb-impl</artifactId>
</exclusion>
<exclusion>
<groupId>xalan</groupId>
<artifactId>xalan</artifactId>
</exclusion>
</exclusions>
</dependency>
</dependencies>
运行 --> mvn clean install -Pgenerates-nfe-services
<profile>
<id>generates-nfe-services</id>
<activation>
<property>
<name>generates-nfe-services</name>
</property>
</activation>
<build>
<plugins>
<plugin>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-codegen-plugin</artifactId>
<executions>
<execution>
<id>generate-sources</id>
<phase>generate-sources</phase>
<configuration>
<!--sourceRoot>${project.build.directory}/generated-sources</sourceRoot-->
<sourceRoot>${basedir}/src/main/java</sourceRoot>
<defaultOptions>
<extraargs>
<extraarg>-validate</extraarg>
<extraarg>-client</extraarg>
<extraarg>-verbose</extraarg>
<extraarg>-xjc-npa</extraarg>
<extraarg>-xjc-verbose</extraarg>
<extraarg>-xjc-extension</extraarg>
<extraarg>-exsh</extraarg>
<extraarg>true</extraarg>
<extraarg>-keep</extraarg>
</extraargs>
</defaultOptions>
<wsdlOptions>
<wsdlOption>
<wsdl>
${basedir}/src/main/wsdl/br/gov/rs/sefaz/nfe/homologacao/NfeConsultaCadastro.wsdl
</wsdl>
<extraargs>
<extraarg>-p</extraarg>
<extraarg>br.gov.rs.sefaz.nfe.consulta.cadastro</extraarg>
</extraargs>
</wsdlOption>
</wsdlOptions>
</configuration>
<goals>
<goal>wsdl2java</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
</profile>
运行 --> mvn clean install -Pgenerates-layouts-nfe
<profile>
<id>generates-layouts-nfe</id>
<activation>
<property>
<name>generates-layouts-nfe</name>
</property>
</activation>
<build>
<plugins>
<plugin>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-xjc-plugin</artifactId>
<version>${cxf-xjc-plugin.version}</version>
<executions>
<execution>
<id>generate-sources</id>
<phase>generate-sources</phase>
<goals>
<goal>xsdtojava</goal>
</goals>
<configuration>
<!--sourceRoot>${basedir}/target/generated-sources</sourceRoot-->
<sourceRoot>${basedir}/src/main/java</sourceRoot>
<xsdOptions>
<xsdOption>
<xsd>${basedir}/src/main/schemas/nfe/PL_008f/leiauteConsSitNFe_v3.10.xsd
</xsd>
<packagename>br.inf.portalfiscal.nfe.v310.leiaute.consulta.situacao.nfe
</packagename>
<extension>true</extension>
<extensionArgs>
<!--extensionArg>-npa</extensionArg-->
<extensionArg>-extension</extensionArg>
</extensionArgs>
</xsdOption>
</xsdOptions>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</profile>
您可以创建一个 Maven 项目来只生成 wsdl,另一个只生成 xsd。
注意:
如果他的项目不需要使用WSDL,切换到json-rest-api。
使用 REST 并快乐。 \o/
希望对您有所帮助。