从 jaxb xjc 代迁移到 jakarta 和 Java 17
Migrating from jaxb xjc generation to jakarta and Java 17
我们正在研究将我们的应用程序从 JDK8 迁移到 JDK17。我们的一些模块使用基于 wsdl 的 Web 服务,其他一些使用 .xsd 模式等。无论如何,我们使用 JAXWS 和 JAXB api,它们自版本 11 以来已从 JDK 中删除并移至雅加达。
我已成功开始使用 jakarta 依赖项从 .wsdl 和 .xsd 文件生成源代码,并且源代码已通过 jakarta 导入正确生成
import jakarta.xml.bind.JAXBElement;
import jakarta.xml.bind.annotation.XmlAccessType;
import jakarta.xml.bind.annotation.XmlAccessorType;
import jakarta.xml.bind.annotation.XmlElementRef;
而之前它使用的是 javax.xml.bind.
编译时不再可用的东西。我的问题是,虽然我已经成功生成了基于模式的源代码,但新的生成器会生成不同的代码(class 名称、访问器等),我想在进行重构之前确认这是预期的行为。
示例:
我们的 .xsd 包含以下内容:
<xsd:complexType name="ForkStepType">
<xsd:annotation>
<xsd:appinfo>
<jxb:class name="ForkStep"/>
</xsd:appinfo>
</xsd:annotation>
<xsd:complexContent>
<xsd:extension base="tns:LinearStepType">
<xsd:sequence/>
<xsd:attribute name="forkLevel" type="tns:ForkLevelType" use="required"/>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
使用 jaxb 版本 2.2.11
的 old xjc 生成器会生成一个名为 ForkStep
的 class,我猜测基于 jxb:class
元素。另一方面,jakarta 3.0.1
生成器生成一个名为 ForkStepType
的 class,我猜它来自 xsd:complexType
元素。
这是预期的行为吗?在解释规范时旧的实现是否不正确,或者是否有我应该知道的 flag/spec 目标版本,以便正确重现我们应用程序的现有行为?
问题来自忘记将 jaxb 模式升级到 jakarta uri 和 3.0 版。
具体
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:jxb="http://java.sun.com/xml/ns/jaxb"
jxb:version="1.0"
必须改为
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:jxb="https://jakarta.ee/xml/ns/jaxb"
jxb:version="3.0"
作为参考,也必须对 .wsdl 文件进行类似的更改,例如 xmlns:jaxws="http://java.sun.com/xml/ns/jaxws"
→ xmlns:jaxws="https://jakarta.ee/xml/ns/jaxws"
我们正在研究将我们的应用程序从 JDK8 迁移到 JDK17。我们的一些模块使用基于 wsdl 的 Web 服务,其他一些使用 .xsd 模式等。无论如何,我们使用 JAXWS 和 JAXB api,它们自版本 11 以来已从 JDK 中删除并移至雅加达。
我已成功开始使用 jakarta 依赖项从 .wsdl 和 .xsd 文件生成源代码,并且源代码已通过 jakarta 导入正确生成
import jakarta.xml.bind.JAXBElement;
import jakarta.xml.bind.annotation.XmlAccessType;
import jakarta.xml.bind.annotation.XmlAccessorType;
import jakarta.xml.bind.annotation.XmlElementRef;
而之前它使用的是 javax.xml.bind.
编译时不再可用的东西。我的问题是,虽然我已经成功生成了基于模式的源代码,但新的生成器会生成不同的代码(class 名称、访问器等),我想在进行重构之前确认这是预期的行为。
示例:
我们的 .xsd 包含以下内容:
<xsd:complexType name="ForkStepType">
<xsd:annotation>
<xsd:appinfo>
<jxb:class name="ForkStep"/>
</xsd:appinfo>
</xsd:annotation>
<xsd:complexContent>
<xsd:extension base="tns:LinearStepType">
<xsd:sequence/>
<xsd:attribute name="forkLevel" type="tns:ForkLevelType" use="required"/>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
使用 jaxb 版本 2.2.11
的 old xjc 生成器会生成一个名为 ForkStep
的 class,我猜测基于 jxb:class
元素。另一方面,jakarta 3.0.1
生成器生成一个名为 ForkStepType
的 class,我猜它来自 xsd:complexType
元素。
这是预期的行为吗?在解释规范时旧的实现是否不正确,或者是否有我应该知道的 flag/spec 目标版本,以便正确重现我们应用程序的现有行为?
问题来自忘记将 jaxb 模式升级到 jakarta uri 和 3.0 版。
具体
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:jxb="http://java.sun.com/xml/ns/jaxb"
jxb:version="1.0"
必须改为
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:jxb="https://jakarta.ee/xml/ns/jaxb"
jxb:version="3.0"
作为参考,也必须对 .wsdl 文件进行类似的更改,例如 xmlns:jaxws="http://java.sun.com/xml/ns/jaxws"
→ xmlns:jaxws="https://jakarta.ee/xml/ns/jaxws"