RFR: 8352755: Misconceptions about j.text.DecimalFormat digits during parsing
Justin Lu
jlu at openjdk.org
Wed Mar 26 20:35:39 UTC 2025
Please review this PR which clarifies the behavior for integer and fraction limits in NumberFormat and implementing classes. An associated CSR is filed.
There have been a few bugs submitted which indicate a misconception that these limits impact parsing. The actual behavior is that these limits only affect formatting. The specification is vague regarding this, and can be explicitly updated to eliminate confusion. As the implementing classes are updated to use `inheritDoc`, some shuffling around in the method specs are included in this change as well.
Alternatively I considered making this change as implementation specific to DecimalFormat and CompactNumberFormat only. (i.e. leave flexibility for other NumberFormat subclasses to define their own behavior on whether the limits affect parsing.) I am open to this option as well, but initially decided against it as
1) Unlike formatting, it seems like a rare use case that you would want to suppress the range of digits of accepted during parsing. `setParseIntegerOnly()` already provides functionality to toggle between integer and fraction parsing.
2) The limits affecting formatting only has been the long-standing behavior for all the subclasses of NumberFormat provided by the OpenJDK reference implementation.
-------------
Commit messages:
- init
Changes: https://git.openjdk.org/jdk/pull/24265/files
Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=24265&range=00
Issue: https://bugs.openjdk.org/browse/JDK-8352755
Stats: 109 lines in 3 files changed: 23 ins; 31 del; 55 mod
Patch: https://git.openjdk.org/jdk/pull/24265.diff
Fetch: git fetch https://git.openjdk.org/jdk.git pull/24265/head:pull/24265
PR: https://git.openjdk.org/jdk/pull/24265
More information about the core-libs-dev
mailing list