JDK8不支持JDK8(WS客户端)
我有一个非常简单的(现有的)Web服务,我想生成一个Web服务客户端来反对使用JDK8。
我使用纯JDK8工具链,这意味着我使用JDK8目录中的wsimport工具。
现在到这个问题:由JDK8中的wsimport工具生成的Java源代码不符合JDK8 Javadoc标准。 您可能已经知道Javadoc工具在JDK8中变得更加严格。
考虑以下简单的模式:
<xs:schema version="1.0" targetNamespace="http://mavenwsserver.ws.mytest.org/">
<xs:element name="operation" type="tns:operation"/>
<xs:element name="operationResponse" type="tns:operationResponse"/>
<xs:complexType name="operation">
<xs:sequence>
<xs:element name="person" type="tns:person" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="person">
<xs:sequence>
<xs:element name="firstName" type="xs:string" minOccurs="0"/>
<xs:element name="lastName" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="operationResponse">
<xs:sequence>
<xs:element name="return" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:schema>
为此, wsimport工具将生成Java代码,如下所示:
package org.mytest.ws.mavenwsclient;
import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlType;
/**
* <p>Java class for person complex type.
*
* <p>The following schema fragment specifies the expected content contained within this class.
*
* <pre>
* <complexType name="person">
* <complexContent>
* <restriction base="{http://www.w3.org/2001/XMLSchema}anyType">
* <sequence>
* <element name="firstName" type="{http://www.w3.org/2001/XMLSchema}string" minOccurs="0"/>
* <element name="lastName" type="{http://www.w3.org/2001/XMLSchema}string" minOccurs="0"/>
* </sequence>
* </restriction>
* </complexContent>
* </complexType>
* </pre>
*
*
*/
@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(name = "person", propOrder = {
"firstName",
"lastName"
})
public class Person {
protected String firstName;
protected String lastName;
/**
* Gets the value of the firstName property.
*
* @return
* possible object is
* {@link String }
*
*/
public String getFirstName() {
return firstName;
}
/**
* Sets the value of the firstName property.
*
* @param value
* allowed object is
* {@link String }
*
*/
public void setFirstName(String value) {
this.firstName = value;
}
/**
* Gets the value of the lastName property.
*
* @return
* possible object is
* {@link String }
*
*/
public String getLastName() {
return lastName;
}
/**
* Sets the value of the lastName property.
*
* @param value
* allowed object is
* {@link String }
*
*/
public void setLastName(String value) {
this.lastName = value;
}
}
问题是这个类生成的评论。 虽然这种类型的注释会被JDK7中的Javadoc编译器接受,但它不再适用于JDK8。 (为了在JDK8中它是正确的,end>必须被替换为>
)。 这些无效评论的结果是生成失败。
我知道我可以在JDK8中关闭doclint,但是我想知道我在这里做错了什么。 这只是纯粹的JDK8工具。 没有什么花哨。 这些工具应该一起工作吗? 并且在Oracle发布之前已经通过了相互彻底的测试? 所以我假设我做错了什么。 像什么?
谢谢。
重现步骤
链接到WSDL(包含模式)
将此文件下载到硬盘上的某个地方。
我使用这样的wsimport
命令行:
mkdir D:JavaDevHGMavenWSClienttargetgenerated-sourcesjaxws-wsimport
"C:Program FilesJavajdk1.8.0_05binwsimport" -keep ^
-s D:JavaDevHGMavenWSClienttargetgenerated-sourcesjaxws-wsimport ^
D:/JavaDevHG/MavenWSClient/src/main/wsdl/myWSDL.xml
现在在生成的源代码上运行javadoc
:
"C:Program FilesJavajdk1.8.0_05binjavadoc" ^
-sourcepath D:JavaDevHGMavenWSClienttargetgenerated-sourcesjaxws-wsimport ^
-subpackages org
你会看到这样的东西:
Loading source files for package org.mytest.ws.mavenwsserver...
Constructing Javadoc information...
Standard Doclet version 1.8.0_05
Building tree for all the packages and classes...
Generating .orgmytestwsmavenwsserverHelloWorldWebService.html...
...
...
Generating .orgmytestwsmavenwsserverPerson.html...
......targetgenerated-sourcesjaxws-wsimportorgmytestwsmavenwsserverPerson.java:15: error: bad use of '>'
* <complexType name="person">
^
......targetgenerated-sourcesjaxws-wsimportorgmytestwsmavenwsserverPerson.java:16: error: bad use of '>'
* <complexContent>
...
... ^
请注意,Javadoc工具也会产生一堆警告。 我可以忍受这一点。 这是使构建失败的错误。
我只能确认你的发现。 由于重现这一点所需的设置很少,而且没有松散的结局,所以迄今为止唯一合理的结论是,这是OpenJDK 8打包的wsimport
工具中的一个bug。此工具根本没有更新以反映施加的新限制由相同的JDK包的javadoc
工具。