Skip to content

Conversation

@runeflobakk
Copy link
Member

@runeflobakk runeflobakk commented Sep 14, 2023

Finishing touches before a 3.0.0 final release.

Basically getting dependencies and JAXB stuff up to speed with the recent restructuring of the https://github.com/highsource/jaxb-tools.

Also see commit message of c8ba048 for some wall-of-text explaining the rationale for modularizing the JAXB/XJC compilation.

@runeflobakk runeflobakk marked this pull request as ready for review September 15, 2023 12:54
Upgrades maven-jaxb2-plugin from 0.14.0 to 0.15.3. This upgrade broke
the current rig for piecing together the XSDs, and

Now, while gazing at the ton of increase in glorious XML, you ask
yourself: "why is all this worth the upgrade from 0.14 to 0.15?".

Well, JAXB gets messy and fragile once you have a non-trivial case, as
this is: mixed compilation of third party XSDs together with your own.
It would seem that the successful operation of the previous setup may
have been a bit accidental. The web of imports, includes, namespacing,
catalogs, and what not which is used to express this API schema was not
resolved as expected by the updated version of the plugin (JAXB, xjc, etc)
and produced duplicates which caused compilation errors.

This change is an effort to try to stay a bit ahead of the game, to
maybe also be able to upgrade to Jakarta JAXB down the road. This is
so-called "modularized XSD compilation" where the third party XSDs we
use are compiled separately, and the output of each compilation sted are
included as "episodes" in further compilation. This seems to resolve
that schemas which were imported by multiple other schemas are now only
compiled once.
@runeflobakk runeflobakk merged commit a249388 into main Sep 15, 2023
@runeflobakk runeflobakk deleted the finalize-v3 branch September 15, 2023 21:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants