8313205: Modernize java.text.Format with StringBuilder

[justin-curtis-lu]

Please review this PR which adds public StringBuilder overloads to the formatting methods of java.text.Format and implementing subclasses.

While Format, NumberFormat, and DateFormat are abstract, these new methods are not added as abstract to prevent compatibility concerns. Instead they are added as non-abstract methods, with a default implementation that throws UOE and a recommendation that subclasses override and provide their own implementations. These new methods use the same specification as the StringBuffer ones, with exception of MessageFormat.format(format(Object[] arguments, StringBuilder result, FieldPosition pos) which omits the table, and instead links to it.

The JDK implementing Format classes, (such as DecimalFormat) leverage the StringBuf proxy methods.

A corresponding CSR has been drafted: https://bugs.openjdk.org/browse/JDK-8337141, which goes into detail on motivation/history. (Holding off on uploading the specification to CSR until wording finalized).

---

Progress

• Change must be properly reviewed (1 review required, with at least 1 Reviewer)
• Change must not contain extraneous whitespace
• Commit message must refer to an issue
• Change requires CSR request JDK-8337141 to be approved

Issues

• JDK-8313205: Modernize java.text.Format with StringBuilder (Enhancement - P4)
• JDK-8337141: Modernize java.text.Format with StringBuilder (CSR)

Reviewing

Using git

Checkout this PR locally:
$ git fetch https://git.openjdk.org/jdk.git pull/20337/head:pull/20337
$ git checkout pull/20337

Update a local copy of the PR:
$ git checkout pull/20337
$ git pull https://git.openjdk.org/jdk.git pull/20337/head

Using Skara CLI tools

Checkout this PR locally:
$ git pr checkout 20337

View PR using the GUI difftool:
$ git pr show -t 20337

Using diff file

Download this PR as a diff file:
https://git.openjdk.org/jdk/pull/20337.diff

Webrev

Link to Webrev Comment

[bridgekeeper]

👋 Welcome back jlu! A progress list of the required criteria for merging this PR into master will be added to the body of your pull request. There are additional pull request commands available for use with this pull request.

[openjdk]

❗ This change is not yet ready to be integrated.
See the Progress checklist in the description for automated requirements.

[openjdk]

@justin-curtis-lu The following labels will be automatically applied to this pull request:

• core-libs
• i18n

When this pull request is ready to be reviewed, an "RFR" email will be sent to the corresponding mailing lists. If you would like to change these labels, use the /label pull request command.

[mlbridge]

Webrevs

• 02: Full - Incremental (0e4a70c8)
• 01: Full - Incremental (314b8d7b)
• 00: Full (3c78d9ac)

[liach]

You should add @since tags on all these new API additions.

[justin-curtis-lu]

You should add @since tags on all these new API additions.

Thanks for the reminder. Updated.

[bridgekeeper]

@justin-curtis-lu This pull request has been inactive for more than 4 weeks and will be automatically closed if another 4 weeks passes without any activity. To avoid this, simply add a new comment to the pull request. Feel free to ask for assistance if you need help with progressing this pull request towards integration!

[bridgekeeper]

@justin-curtis-lu This pull request has been inactive for more than 8 weeks and will now be automatically closed. If you would like to continue working on this pull request in the future, feel free to reopen it! This can be done using the /open pull request command.