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