archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-26 22:34:27 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8336787: Examine java.text.Format API for implSpec usage

Browse source 
Reviewed-by: liach
This commit is contained in:
Justin Lu 2024-07-24 20:08:13 +00:00
parent 4ea4d7c684
commit 9e8e359513
1 changed files with 6 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

12
src/java.base/share/classes/java/text/Format.java
View file

@ -149,12 +149,12 @@ public abstract class Format implements Serializable, Cloneable {
/**
* Formats an object to produce a string.
* This method returns a string that would be equal to the string returned by
*
* @implSpec This method returns a string that would be equal to the string returned by
* <blockquote>
* {@link #format(Object, StringBuffer, FieldPosition) format}<code>(obj,
* new StringBuffer(), new FieldPosition(0)).toString();</code>
* </blockquote>
*
* @param obj The object to format
* @return Formatted string.
* @throws IllegalArgumentException if the Format cannot format the given
@ -207,11 +207,11 @@ public abstract class Format implements Serializable, Cloneable {
* to define what the legal values are for each attribute in the
* {@code AttributedCharacterIterator}, but typically the attribute
* key is also used as the attribute value.
* <p>The default implementation creates an
* {@code AttributedCharacterIterator} with no attributes. Subclasses
* that support fields should override this and create an
* {@code AttributedCharacterIterator} with meaningful attributes.
*
* @apiNote Subclasses that support fields should override this and create an
* {@code AttributedCharacterIterator} with meaningful attributes.
* @implSpec The default implementation creates an
* {@code AttributedCharacterIterator} with no attributes.
* @throws NullPointerException if obj is null.
* @throws IllegalArgumentException when the Format cannot format the
* given object.