Skip to content

Fix broken link in Java doc comment - #894

Open
empwilli wants to merge 3 commits into
mainfrom
empwilli/fix_broken_link_java
Open

empwilli wants to merge 3 commits into
mainfrom
empwilli/fix_broken_link_java

Conversation

@empwilli

Copy link
Copy Markdown
Contributor

The java doc comments for XmlCommon contained a broken link to a generic
group of functions. This caused the documentation publishing step to
break. Replace the link with rendering in mono-space font.

Until now the code generation for Java did not emit empty constructors.
As Java does not permit to elide optional arguments, this made the
construction of classes with only optional attributes tedious: users
either had to use builders, or they had to provide a series of "null"
values on construction. Furthermore, the pattern was inconsistent with
how parameters are handled in general: we already generate constructors
with only mandatory parameters, leaving out the optional ones. With this
we address the issue and additionally generate empty constructors for
classes for that all attributes are optinal.
With more recent versions of `com.fasterxml.jackson.core` the `fields()`
accessor for json nodes has become deprecated. Instead, these the
properties are now accessible via the `properties()` method. Adapt the
code generation accordingly.
The java doc comments for XmlCommon contained a broken link to a generic
group of functions. This caused the documentation publishing step to
break. Replace the link with rendering in mono-space font.
@empwilli
empwilli requested a review from mristin November 18, 2026 14:04
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.

1 participant