Skip to content

WW-3364 docs: describe opt-in type converters in JSON serialization - #348

Merged
lukaszlenart merged 1 commit into
mainfrom
WW-3364-json-type-converters
Oct 10, 2026
Merged

lukaszlenart merged 1 commit into
mainfrom
WW-3364-json-type-converters

Conversation

@lukaszlenart

Copy link
Copy Markdown
Member

Fixes WW-3364

Documents the new struts.json.writer.useTypeConverters constant from apache/struts#2002 on the JSON plugin page, in a new "Using registered type converters" section after "Java records and Optional":

  • enabling the constant and a before/after example with a Money converter
  • which converters are used (per-type / application-wide only; superclass and interface registrations apply to subtypes; per-property mappings are not)
  • natively serialized types are never converted — including BigDecimal, which is the example on the Type Conversion page
  • @JSONFieldBridge precedence and the fallback when a converter fails
  • a converted value is a single string, so nested includeProperties / excludeProperties patterns and member @JSON annotations no longer apply to it

Merge after apache/struts#2002; the "Since Struts 7.5.0" marker follows the ticket's fix version.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@lukaszlenart
lukaszlenart marked this pull request as ready for review October 10, 2026 10:45
@asf-ci

asf-ci commented Oct 10, 2026

Copy link
Copy Markdown

Staged site is ready at https://struts.staged.apache.org/

@lukaszlenart
lukaszlenart merged commit a0592ab into main Oct 10, 2026
1 check passed
@lukaszlenart
lukaszlenart deleted the WW-3364-json-type-converters branch October 10, 2026 10:49
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