Skip to content

JAXB Tools Migration Guide

Jump to bottom Edit New page
Laurent Schoelens edited this page Sep 18, 2023 · 16 revisions

Migration Guide

This migration guide will help you migrate through major version of JAXB Tools

Migration from previous version (0.x / 1.x) to v2

Starting from v2 of jaxb-tools, the following breaking changes occurs :

  • JDK8 Baseline : minimal support of jdk is JDK8; code is tested against JDK8 / JDK11 / JDK17
  • Drop of v2.0 / v2.1 / v2.2 plugins : older version of JAXB (prior to 2.3) are no longer supported
  • Artifact renaming / package changes : in order to provide a full set of tools, group and artifacts have been reorganized.
Artifact Older coordinates New coordinated
maven-plugin 
<groupId>org.jvnet.jaxb2.maven2</groupId>
<artifactId>maven-jaxb2-plugin</artifactId>
<version>0.15.x</version>
 
<groupId>org.jvnet.jaxb</groupId>
<artifactId>jaxb-maven-plugin</artifactId>
<version>2.0.9</version>
jaxb2-basics 
<groupId>org.jvnet.jaxb2_commons</groupId>
<artifactId>jaxb2-basics</artifactId>
<version>0.13.x</version>
 
<groupId>org.jvnet.jaxb</groupId>
<artifactId>jaxb2-basics</artifactId>
<version>2.0.9</version>
annox 
<groupId>org.jvnet.annox</groupId>
<artifactId>annox</artifactId>
<version>1.0.2</version>
 
<groupId>org.jvnet.jaxb</groupId>
<artifactId>annox</artifactId>
<version>2.0.9</version>
jaxb2-annotate 
<groupId>org.jvnet.jaxb2_commons</groupId>
<artifactId>jaxb2-basics-annotate</artifactId>
<version>1.1.0</version>
 
<groupId>org.jvnet.jaxb</groupId>
<artifactId>jaxb-basics-annotate</artifactId>
<version>2.0.9</version>
hyperjaxb3 
<groupId>org.jvnet.hyperjaxb3</groupId>
<artifactId>hyperjaxb3-ejb-plugin</artifactId>
<version>0.6.x</version>
 
<groupId>org.jvnet.jaxb</groupId>
<artifactId>hyperjaxb3-ejb-plugin</artifactId>
<version>2.0.9</version>

Migration from v2 to v3

Work in progress

Starting from v3 of jaxb-tools, the following breaking changes occurs :

  • JakartaEE9 support : this version supports v3 of JAXB-API and Runtime (major change is javax.* to jakarta.* package change)
  • Artifact renaming / package changes : in order to drop references to JAXB2, and avoid classes collision, some artifacts and packages has been renamed.
Artifact Older coordinates New coordinated
jaxb2-basics 
<groupId>org.jvnet.jaxb</groupId>
<artifactId>jaxb2-basics</artifactId>
<version>2.0.9</version>
 
<groupId>org.jvnet.jaxb</groupId>
<artifactId>jaxb-basics</artifactId>
<version>3.0.0</version>

Migration from v3 to v4

** Work in progress ** Starting from v4 of jaxb-tools, the following breaking changes occurs :

  • JakartaEE10 support : this version supports v4 of JAXB-API and Runtime
  • JDK11 baseline : since JakartaEE10 has JDK11 baseline, this version minimal support of jdk will be JDK11; code is tested against JDK11 / JDK17
Add a custom footer
Clone this wiki locally