6201035: Document NPE for passing null insets to constructors and met…

…hods of several javax.swing.border.* classes

Reviewed-by: tr, prr, aivanov, serb

src/java.desktop/share/classes/javax/swing/border/AbstractBorder.java

@@ -84,7 +84,9 @@ public Insets getBorderInsets(Component c)       {
      * Reinitializes the insets parameter with this Border's current Insets.
      * @param c the component for which this border insets value applies
      * @param insets the object to be reinitialized
-     * @return the <code>insets</code> object
+     * @return the {@code insets} object
+     * @throws NullPointerException if the specified {@code insets}
+     *         is {@code null}
      */
     public Insets getBorderInsets(Component c, Insets insets) {
         insets.left = insets.top = insets.right = insets.bottom = 0;

src/java.desktop/share/classes/javax/swing/border/BevelBorder.java

@@ -142,6 +142,8 @@ public void paintBorder(Component c, Graphics g, int x, int y, int width, int he
      * Reinitialize the insets parameter with this Border's current Insets.
      * @param c the component for which this border insets value applies
      * @param insets the object to be reinitialized
+     * @throws NullPointerException if the specified {@code insets}
+     *         is {@code null}
      */
     public Insets getBorderInsets(Component c, Insets insets) {
         insets.set(2, 2, 2, 2);

src/java.desktop/share/classes/javax/swing/border/CompoundBorder.java

@@ -137,6 +137,8 @@ public void paintBorder(Component c, Graphics g, int x, int y, int width, int he
      * Reinitialize the insets parameter with this Border's current Insets.
      * @param c the component for which this border insets value applies
      * @param insets the object to be reinitialized
+     * @throws NullPointerException if the specified {@code insets}
+     *         is {@code null}
      */
     public Insets getBorderInsets(Component c, Insets insets) {
         Insets  nextInsets;

src/java.desktop/share/classes/javax/swing/border/EmptyBorder.java

@@ -83,6 +83,8 @@ public EmptyBorder(int top, int left, int bottom, int right)   {
     /**
      * Creates an empty border with the specified insets.
      * @param borderInsets the insets of the border
+     * @throws NullPointerException if the specified {@code borderInsets}
+     *         is {@code null}
      */
     @ConstructorProperties({"borderInsets"})
     public EmptyBorder(Insets borderInsets)   {
@@ -102,6 +104,8 @@ public void paintBorder(Component c, Graphics g, int x, int y, int width, int he
      * Reinitialize the insets parameter with this Border's current Insets.
      * @param c the component for which this border insets value applies
      * @param insets the object to be reinitialized
+     * @throws NullPointerException if the specified {@code insets}
+     *         is {@code null}
      */
     public Insets getBorderInsets(Component c, Insets insets) {
         insets.left = left;

src/java.desktop/share/classes/javax/swing/border/EtchedBorder.java

@@ -210,6 +210,8 @@ public void paintBorder(Component c, Graphics g, int x, int y, int width, int he
      *
      * @param c the component for which this border insets value applies
      * @param insets the object to be reinitialized
+     * @throws NullPointerException if the specified {@code insets}
+     *         is {@code null}
      */
     public Insets getBorderInsets(Component c, Insets insets) {
         insets.set(2, 2, 2, 2);

src/java.desktop/share/classes/javax/swing/border/LineBorder.java

@@ -219,6 +219,8 @@ public void paintBorder(Component c, Graphics g, int x, int y, int width, int he
      *
      * @param c the component for which this border insets value applies
      * @param insets the object to be reinitialized
+     * @throws NullPointerException if the specified {@code insets}
+     *         is {@code null}
      */
     public Insets getBorderInsets(Component c, Insets insets) {
         insets.set(thickness, thickness, thickness, thickness);

src/java.desktop/share/classes/javax/swing/border/MatteBorder.java

@@ -75,6 +75,8 @@ public MatteBorder(int top, int left, int bottom, int right, Color matteColor)
      * Creates a matte border with the specified insets and color.
      * @param borderInsets the insets of the border
      * @param matteColor the color rendered for the border
+     * @throws NullPointerException if the specified {@code borderInsets}
+     *         is {@code null}
      * @since 1.3
      */
     public MatteBorder(Insets borderInsets, Color matteColor)   {
@@ -99,6 +101,8 @@ public MatteBorder(int top, int left, int bottom, int right, Icon tileIcon)   {
      * Creates a matte border with the specified insets and tile icon.
      * @param borderInsets the insets of the border
      * @param tileIcon the icon to be used for tiling the border
+     * @throws NullPointerException if the specified {@code borderInsets}
+     *         is {@code null}
      * @since 1.3
      */
     public MatteBorder(Insets borderInsets, Icon tileIcon)   {
@@ -166,6 +170,8 @@ private void paintEdge(Component c, Graphics g, int x, int y, int width, int hei
      * Reinitialize the insets parameter with this Border's current Insets.
      * @param c the component for which this border insets value applies
      * @param insets the object to be reinitialized
+     * @throws NullPointerException if the specified {@code insets}
+     *         is {@code null}
      * @since 1.3
      */
     public Insets getBorderInsets(Component c, Insets insets) {

src/java.desktop/share/classes/javax/swing/border/SoftBevelBorder.java

@@ -152,6 +152,8 @@ public void paintBorder(Component c, Graphics g, int x, int y, int width, int he
      * Reinitialize the insets parameter with this Border's current Insets.
      * @param c the component for which this border insets value applies
      * @param insets the object to be reinitialized
+     * @throws NullPointerException if the specified {@code insets}
+     *         is {@code null}
      */
     public Insets getBorderInsets(Component c, Insets insets)       {
         insets.set(3, 3, 3, 3);

src/java.desktop/share/classes/javax/swing/border/TitledBorder.java

@@ -374,6 +374,8 @@ else if (border != null) {
      * Reinitialize the insets parameter with this Border's current Insets.
      * @param c the component for which this border insets value applies
      * @param insets the object to be reinitialized
+     * @throws NullPointerException if the specified {@code insets}
+     *         is {@code null}
      */
     public Insets getBorderInsets(Component c, Insets insets) {
         Border border = getBorder();

src/java.desktop/share/classes/javax/swing/plaf/BorderUIResource.java

@@ -172,6 +172,8 @@ public EmptyBorderUIResource(int top, int left, int bottom, int right)   {
         /**
          * Constructs an {@code EmptyBorderUIResource}.
          * @param insets the insets of the border
+         * @throws NullPointerException if the spcecified {@code insets}
+         *         is {@code null}
          */
         @ConstructorProperties({"borderInsets"})
         public EmptyBorderUIResource(Insets insets) {