Summary

Make the exceptional behavior of java.awt.font.TextMeasurer and java.awt.font.LineBreakMeasurer more explicitly specified for exception conditions on text insertion and deletion.

Problem

. The specification for the methods - insertChar and deleteChar of classes
     . java.awt.font.TextMeasurer and
     . java.awt.font.LineBreakMeasurer
mention that the methods are to be used to insert or delete a single character from the respective objects.
. However, the specification does not mention the outcome when a programmer attempts to insert or delete multiple characters from these objects.

Solution

. Update the specification to explicitly mention the outcome - IllegalArgumentException, when programmer attempts to insert or delete multiple characters from TextMeasurer and LineBreakMeasurer Objects.

Specification

File: TextMeasurer.java Method: insertChar

 /**
  * Updates the {@code TextMeasurer} after a single character has
  * been inserted
  * into the paragraph currently represented by this
  * {@code TextMeasurer}.
  ...
++ * @throws IllegalArgumentException if multiple characters are inserted
++ * in the text represented by {@code newParagraph}
   ...
  */

File TextMeasurer.java Method: deleteChar
 /**
  * Updates the {@code TextMeasurer} after a single character has
  * been deleted
  * from the paragraph currently represented by this
  * {@code TextMeasurer}.
  ...
++ * @throws IllegalArgumentException if multiple characters are deleted from
++ * the text represented by {@code newParagraph}
  ...
  */

File: LineBreakMeasurer.java Method: insertChar
  /**
   * Updates this {@code LineBreakMeasurer} after a single
   * character is inserted into the text, and sets the current
   * position to the beginning of the paragraph.
   ...
++ * @throws IllegalArgumentException if multiple characters are inserted
++ * in the text represented by {@code newParagraph}
   ...
   */

File: LineBreakMeasurer.java Method: deleteChar
  /**
   * Updates this {@code LineBreakMeasurer} after a single
   * character is deleted from the text, and sets the current
   * position to the beginning of the paragraph.
   ...
++ * @throws IllegalArgumentException if multiple characters are deleted from
++ * the text represented by {@code newParagraph}
   ...
   */