BorderFactory.java

/*
 * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation. Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */
packagejavax.swing;

importjava.awt.BasicStroke;
importjava.awt.Color;
importjava.awt.Font;
importjava.awt.Paint;
importjavax.swing.border.*;

/**
 * Factory class for vending standard <code>Border</code> objects. Wherever
 * possible, this factory will hand out references to shared
 * <code>Border</code> instances.
 * For further information and examples see
 * <a href="https://docs.oracle.com/javase/tutorial/uiswing/components/border.html">How
 to Use Borders</a>,
 * a section in <em>The Java Tutorial</em>.
 *
 * @author David Kloba
 * @since 1.2
 */
publicclassBorderFactory
{

/** Don't let anyone instantiate this class */
privateBorderFactory() {
 }


//// LineBorder ///////////////////////////////////////////////////////////////
/**
 * Creates a line border with the specified color.
 *
 * @param color a <code>Color</code> to use for the line
 * @return the <code>Border</code> object
 */
publicstaticBordercreateLineBorder(Colorcolor) {
returnnewLineBorder(color, 1);
 }

/**
 * Creates a line border with the specified color
 * and width. The width applies to all four sides of the
 * border. To specify widths individually for the top,
 * bottom, left, and right, use
 * {@link #createMatteBorder(int,int,int,int,Color)}.
 *
 * @param color a <code>Color</code> to use for the line
 * @param thickness an integer specifying the width in pixels
 * @return the <code>Border</code> object
 */
publicstaticBordercreateLineBorder(Colorcolor, intthickness) {
returnnewLineBorder(color, thickness);
 }

/**
 * Creates a line border with the specified color, thickness, and corner shape.
 *
 * @param color the color of the border
 * @param thickness the thickness of the border
 * @param rounded whether or not border corners should be round
 * @return the {@code Border} object
 *
 * @see LineBorder#LineBorder(Color, int, boolean)
 * @since 1.7
 */
publicstaticBordercreateLineBorder(Colorcolor, intthickness, booleanrounded) {
returnnewLineBorder(color, thickness, rounded);
 }

//// BevelBorder /////////////////////////////////////////////////////////////
///////////////////////////////////////////////////////////////////////////////
staticfinalBordersharedRaisedBevel = newBevelBorder(BevelBorder.RAISED);
staticfinalBordersharedLoweredBevel = newBevelBorder(BevelBorder.LOWERED);

/**
 * Creates a border with a raised beveled edge, using
 * brighter shades of the component's current background color
 * for highlighting, and darker shading for shadows.
 * (In a raised border, highlights are on top and shadows
 * are underneath.)
 *
 * @return the <code>Border</code> object
 */
publicstaticBordercreateRaisedBevelBorder() {
returncreateSharedBevel(BevelBorder.RAISED);
 }

/**
 * Creates a border with a lowered beveled edge, using
 * brighter shades of the component's current background color
 * for highlighting, and darker shading for shadows.
 * (In a lowered border, shadows are on top and highlights
 * are underneath.)
 *
 * @return the <code>Border</code> object
 */
publicstaticBordercreateLoweredBevelBorder() {
returncreateSharedBevel(BevelBorder.LOWERED);
 }

/**
 * Creates a beveled border of the specified type, using
 * brighter shades of the component's current background color
 * for highlighting, and darker shading for shadows.
 * (In a lowered border, shadows are on top and highlights
 * are underneath.)
 *
 * @param type an integer specifying either
 * <code>BevelBorder.LOWERED</code> or
 * <code>BevelBorder.RAISED</code>
 * @return the <code>Border</code> object
 */
publicstaticBordercreateBevelBorder(inttype) {
returncreateSharedBevel(type);
 }

/**
 * Creates a beveled border of the specified type, using
 * the specified highlighting and shadowing. The outer
 * edge of the highlighted area uses a brighter shade of
 * the highlight color. The inner edge of the shadow area
 * uses a brighter shade of the shadow color.
 *
 * @param type an integer specifying either
 * <code>BevelBorder.LOWERED</code> or
 * <code>BevelBorder.RAISED</code>
 * @param highlight a <code>Color</code> object for highlights
 * @param shadow a <code>Color</code> object for shadows
 * @return the <code>Border</code> object
 */
publicstaticBordercreateBevelBorder(inttype, Colorhighlight, Colorshadow) {
returnnewBevelBorder(type, highlight, shadow);
 }

/**
 * Creates a beveled border of the specified type, using
 * the specified colors for the inner and outer highlight
 * and shadow areas.
 *
 * @param type an integer specifying either
 * <code>BevelBorder.LOWERED</code> or
 * <code>BevelBorder.RAISED</code>
 * @param highlightOuter a <code>Color</code> object for the
 * outer edge of the highlight area
 * @param highlightInner a <code>Color</code> object for the
 * inner edge of the highlight area
 * @param shadowOuter a <code>Color</code> object for the
 * outer edge of the shadow area
 * @param shadowInner a <code>Color</code> object for the
 * inner edge of the shadow area
 * @return the <code>Border</code> object
 */
publicstaticBordercreateBevelBorder(inttype,
ColorhighlightOuter, ColorhighlightInner,
ColorshadowOuter, ColorshadowInner) {
returnnewBevelBorder(type, highlightOuter, highlightInner,
shadowOuter, shadowInner);
 }

staticBordercreateSharedBevel(inttype) {
if(type == BevelBorder.RAISED) {
returnsharedRaisedBevel;
 } elseif(type == BevelBorder.LOWERED) {
returnsharedLoweredBevel;
 }
returnnull;
 }

//// SoftBevelBorder ///////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////

privatestaticBordersharedSoftRaisedBevel;
privatestaticBordersharedSoftLoweredBevel;

/**
 * Creates a beveled border with a raised edge and softened corners,
 * using brighter shades of the component's current background color
 * for highlighting, and darker shading for shadows.
 * In a raised border, highlights are on top and shadows are underneath.
 *
 * @return the {@code Border} object
 *
 * @since 1.7
 */
publicstaticBordercreateRaisedSoftBevelBorder() {
if (sharedSoftRaisedBevel == null) {
sharedSoftRaisedBevel = newSoftBevelBorder(BevelBorder.RAISED);
 }
returnsharedSoftRaisedBevel;
 }

/**
 * Creates a beveled border with a lowered edge and softened corners,
 * using brighter shades of the component's current background color
 * for highlighting, and darker shading for shadows.
 * In a lowered border, shadows are on top and highlights are underneath.
 *
 * @return the {@code Border} object
 *
 * @since 1.7
 */
publicstaticBordercreateLoweredSoftBevelBorder() {
if (sharedSoftLoweredBevel == null) {
sharedSoftLoweredBevel = newSoftBevelBorder(BevelBorder.LOWERED);
 }
returnsharedSoftLoweredBevel;
 }

/**
 * Creates a beveled border of the specified type with softened corners,
 * using brighter shades of the component's current background color
 * for highlighting, and darker shading for shadows.
 * The type is either {@link BevelBorder#RAISED} or {@link BevelBorder#LOWERED}.
 *
 * @param type a type of a bevel
 * @return the {@code Border} object or {@code null}
 * if the specified type is not valid
 *
 * @see BevelBorder#BevelBorder(int)
 * @since 1.7
 */
publicstaticBordercreateSoftBevelBorder(inttype) {
if (type == BevelBorder.RAISED) {
returncreateRaisedSoftBevelBorder();
 }
if (type == BevelBorder.LOWERED) {
returncreateLoweredSoftBevelBorder();
 }
returnnull;
 }

/**
 * Creates a beveled border of the specified type with softened corners,
 * using the specified highlighting and shadowing.
 * The type is either {@link BevelBorder#RAISED} or {@link BevelBorder#LOWERED}.
 * The outer edge of the highlight area uses
 * a brighter shade of the {@code highlight} color.
 * The inner edge of the shadow area uses
 * a brighter shade of the {@code shadow} color.
 *
 * @param type a type of a bevel
 * @param highlight a basic color of the highlight area
 * @param shadow a basic color of the shadow area
 * @return the {@code Border} object
 *
 * @see BevelBorder#BevelBorder(int, Color, Color)
 * @since 1.7
 */
publicstaticBordercreateSoftBevelBorder(inttype, Colorhighlight, Colorshadow) {
returnnewSoftBevelBorder(type, highlight, shadow);
 }

/**
 * Creates a beveled border of the specified type with softened corners,
 * using the specified colors for the inner and outer edges
 * of the highlight and the shadow areas.
 * The type is either {@link BevelBorder#RAISED} or {@link BevelBorder#LOWERED}.
 * Note: The shadow inner and outer colors are switched
 * for a lowered bevel border.
 *
 * @param type a type of a bevel
 * @param highlightOuter a color of the outer edge of the highlight area
 * @param highlightInner a color of the inner edge of the highlight area
 * @param shadowOuter a color of the outer edge of the shadow area
 * @param shadowInner a color of the inner edge of the shadow area
 * @return the {@code Border} object
 *
 * @see BevelBorder#BevelBorder(int, Color, Color, Color, Color)
 * @since 1.7
 */
publicstaticBordercreateSoftBevelBorder(inttype, ColorhighlightOuter, ColorhighlightInner, ColorshadowOuter, ColorshadowInner) {
returnnewSoftBevelBorder(type, highlightOuter, highlightInner, shadowOuter, shadowInner);
 }

//// EtchedBorder ///////////////////////////////////////////////////////////

staticfinalBordersharedEtchedBorder = newEtchedBorder();
privatestaticBordersharedRaisedEtchedBorder;

/**
 * Creates a border with an "etched" look using
 * the component's current background color for
 * highlighting and shading.
 *
 * @return the <code>Border</code> object
 */
publicstaticBordercreateEtchedBorder() {
returnsharedEtchedBorder;
 }

/**
 * Creates a border with an "etched" look using
 * the specified highlighting and shading colors.
 *
 * @param highlight a <code>Color</code> object for the border highlights
 * @param shadow a <code>Color</code> object for the border shadows
 * @return the <code>Border</code> object
 */
publicstaticBordercreateEtchedBorder(Colorhighlight, Colorshadow) {
returnnewEtchedBorder(highlight, shadow);
 }

/**
 * Creates a border with an "etched" look using
 * the component's current background color for
 * highlighting and shading.
 *
 * @param type one of <code>EtchedBorder.RAISED</code>, or
 * <code>EtchedBorder.LOWERED</code>
 * @return the <code>Border</code> object
 * @throws IllegalArgumentException if type is not either
 * <code>EtchedBorder.RAISED</code> or
 * <code>EtchedBorder.LOWERED</code>
 * @since 1.3
 */
publicstaticBordercreateEtchedBorder(inttype) {
switch (type) {
caseEtchedBorder.RAISED:
if (sharedRaisedEtchedBorder == null) {
sharedRaisedEtchedBorder = newEtchedBorder
 (EtchedBorder.RAISED);
 }
returnsharedRaisedEtchedBorder;
caseEtchedBorder.LOWERED:
returnsharedEtchedBorder;
default:
thrownewIllegalArgumentException("type must be one of EtchedBorder.RAISED or EtchedBorder.LOWERED");
 }
 }

/**
 * Creates a border with an "etched" look using
 * the specified highlighting and shading colors.
 *
 * @param type one of <code>EtchedBorder.RAISED</code>, or
 * <code>EtchedBorder.LOWERED</code>
 * @param highlight a <code>Color</code> object for the border highlights
 * @param shadow a <code>Color</code> object for the border shadows
 * @return the <code>Border</code> object
 * @since 1.3
 */
publicstaticBordercreateEtchedBorder(inttype, Colorhighlight,
Colorshadow) {
returnnewEtchedBorder(type, highlight, shadow);
 }

//// TitledBorder ////////////////////////////////////////////////////////////
/**
 * Creates a new titled border with the specified title,
 * the default border type (determined by the current look and feel),
 * the default text position (determined by the current look and feel),
 * the default justification (leading), and the default
 * font and text color (determined by the current look and feel).
 *
 * @param title a <code>String</code> containing the text of the title
 * @return the <code>TitledBorder</code> object
 */
publicstaticTitledBordercreateTitledBorder(Stringtitle) {
returnnewTitledBorder(title);
 }

/**
 * Creates a new titled border with an empty title,
 * the specified border object,
 * the default text position (determined by the current look and feel),
 * the default justification (leading), and the default
 * font and text color (determined by the current look and feel).
 *
 * @param border the <code>Border</code> object to add the title to; if
 * <code>null</code> the <code>Border</code> is determined
 * by the current look and feel.
 * @return the <code>TitledBorder</code> object
 */
publicstaticTitledBordercreateTitledBorder(Borderborder) {
returnnewTitledBorder(border);
 }

/**
 * Adds a title to an existing border,
 * with default positioning (determined by the current look and feel),
 * default justification (leading) and the default
 * font and text color (determined by the current look and feel).
 *
 * @param border the <code>Border</code> object to add the title to
 * @param title a <code>String</code> containing the text of the title
 * @return the <code>TitledBorder</code> object
 */
publicstaticTitledBordercreateTitledBorder(Borderborder,
Stringtitle) {
returnnewTitledBorder(border, title);
 }

/**
 * Adds a title to an existing border, with the specified
 * positioning and using the default
 * font and text color (determined by the current look and feel).
 *
 * @param border the <code>Border</code> object to add the title to
 * @param title a <code>String</code> containing the text of the title
 * @param titleJustification an integer specifying the justification
 * of the title -- one of the following:
 *<ul>
 *<li><code>TitledBorder.LEFT</code>
 *<li><code>TitledBorder.CENTER</code>
 *<li><code>TitledBorder.RIGHT</code>
 *<li><code>TitledBorder.LEADING</code>
 *<li><code>TitledBorder.TRAILING</code>
 *<li><code>TitledBorder.DEFAULT_JUSTIFICATION</code> (leading)
 *</ul>
 * @param titlePosition an integer specifying the vertical position of
 * the text in relation to the border -- one of the following:
 *<ul>
 *<li><code> TitledBorder.ABOVE_TOP</code>
 *<li><code>TitledBorder.TOP</code> (sitting on the top line)
 *<li><code>TitledBorder.BELOW_TOP</code>
 *<li><code>TitledBorder.ABOVE_BOTTOM</code>
 *<li><code>TitledBorder.BOTTOM</code> (sitting on the bottom line)
 *<li><code>TitledBorder.BELOW_BOTTOM</code>
 *<li><code>TitledBorder.DEFAULT_POSITION</code> (the title position
 * is determined by the current look and feel)
 *</ul>
 * @return the <code>TitledBorder</code> object
 */
publicstaticTitledBordercreateTitledBorder(Borderborder,
Stringtitle,
inttitleJustification,
inttitlePosition) {
returnnewTitledBorder(border, title, titleJustification,
titlePosition);
 }

/**
 * Adds a title to an existing border, with the specified
 * positioning and font, and using the default text color
 * (determined by the current look and feel).
 *
 * @param border the <code>Border</code> object to add the title to
 * @param title a <code>String</code> containing the text of the title
 * @param titleJustification an integer specifying the justification
 * of the title -- one of the following:
 *<ul>
 *<li><code>TitledBorder.LEFT</code>
 *<li><code>TitledBorder.CENTER</code>
 *<li><code>TitledBorder.RIGHT</code>
 *<li><code>TitledBorder.LEADING</code>
 *<li><code>TitledBorder.TRAILING</code>
 *<li><code>TitledBorder.DEFAULT_JUSTIFICATION</code> (leading)
 *</ul>
 * @param titlePosition an integer specifying the vertical position of
 * the text in relation to the border -- one of the following:
 *<ul>
 *<li><code> TitledBorder.ABOVE_TOP</code>
 *<li><code>TitledBorder.TOP</code> (sitting on the top line)
 *<li><code>TitledBorder.BELOW_TOP</code>
 *<li><code>TitledBorder.ABOVE_BOTTOM</code>
 *<li><code>TitledBorder.BOTTOM</code> (sitting on the bottom line)
 *<li><code>TitledBorder.BELOW_BOTTOM</code>
 *<li><code>TitledBorder.DEFAULT_POSITION</code> (the title position
 * is determined by the current look and feel)
 *</ul>
 * @param titleFont a Font object specifying the title font
 * @return the TitledBorder object
 */
publicstaticTitledBordercreateTitledBorder(Borderborder,
Stringtitle,
inttitleJustification,
inttitlePosition,
FonttitleFont) {
returnnewTitledBorder(border, title, titleJustification,
titlePosition, titleFont);
 }

/**
 * Adds a title to an existing border, with the specified
 * positioning, font and color.
 *
 * @param border the <code>Border</code> object to add the title to
 * @param title a <code>String</code> containing the text of the title
 * @param titleJustification an integer specifying the justification
 * of the title -- one of the following:
 *<ul>
 *<li><code>TitledBorder.LEFT</code>
 *<li><code>TitledBorder.CENTER</code>
 *<li><code>TitledBorder.RIGHT</code>
 *<li><code>TitledBorder.LEADING</code>
 *<li><code>TitledBorder.TRAILING</code>
 *<li><code>TitledBorder.DEFAULT_JUSTIFICATION</code> (leading)
 *</ul>
 * @param titlePosition an integer specifying the vertical position of
 * the text in relation to the border -- one of the following:
 *<ul>
 *<li><code> TitledBorder.ABOVE_TOP</code>
 *<li><code>TitledBorder.TOP</code> (sitting on the top line)
 *<li><code>TitledBorder.BELOW_TOP</code>
 *<li><code>TitledBorder.ABOVE_BOTTOM</code>
 *<li><code>TitledBorder.BOTTOM</code> (sitting on the bottom line)
 *<li><code>TitledBorder.BELOW_BOTTOM</code>
 *<li><code>TitledBorder.DEFAULT_POSITION</code> (the title position
 * is determined by the current look and feel)
 *</ul>
 * @param titleFont a <code>Font</code> object specifying the title font
 * @param titleColor a <code>Color</code> object specifying the title color
 * @return the <code>TitledBorder</code> object
 */
publicstaticTitledBordercreateTitledBorder(Borderborder,
Stringtitle,
inttitleJustification,
inttitlePosition,
FonttitleFont,
ColortitleColor) {
returnnewTitledBorder(border, title, titleJustification,
titlePosition, titleFont, titleColor);
 }
//// EmptyBorder ///////////////////////////////////////////////////////////
staticfinalBorderemptyBorder = newEmptyBorder(0, 0, 0, 0);

/**
 * Creates an empty border that takes up no space. (The width
 * of the top, bottom, left, and right sides are all zero.)
 *
 * @return the <code>Border</code> object
 */
publicstaticBordercreateEmptyBorder() {
returnemptyBorder;
 }

/**
 * Creates an empty border that takes up space but which does
 * no drawing, specifying the width of the top, left, bottom, and
 * right sides.
 *
 * @param top an integer specifying the width of the top,
 * in pixels
 * @param left an integer specifying the width of the left side,
 * in pixels
 * @param bottom an integer specifying the width of the bottom,
 * in pixels
 * @param right an integer specifying the width of the right side,
 * in pixels
 * @return the <code>Border</code> object
 */
publicstaticBordercreateEmptyBorder(inttop, intleft,
intbottom, intright) {
returnnewEmptyBorder(top, left, bottom, right);
 }

//// CompoundBorder ////////////////////////////////////////////////////////
/**
 * Creates a compound border with a <code>null</code> inside edge and a
 * <code>null</code> outside edge.
 *
 * @return the <code>CompoundBorder</code> object
 */
publicstaticCompoundBordercreateCompoundBorder() {
returnnewCompoundBorder();
 }

/**
 * Creates a compound border specifying the border objects to use
 * for the outside and inside edges.
 *
 * @param outsideBorder a <code>Border</code> object for the outer
 * edge of the compound border
 * @param insideBorder a <code>Border</code> object for the inner
 * edge of the compound border
 * @return the <code>CompoundBorder</code> object
 */
publicstaticCompoundBordercreateCompoundBorder(BorderoutsideBorder,
BorderinsideBorder) {
returnnewCompoundBorder(outsideBorder, insideBorder);
 }

//// MatteBorder ////////////////////////////////////////////////////////
/**
 * Creates a matte-look border using a solid color. (The difference between
 * this border and a line border is that you can specify the individual
 * border dimensions.)
 *
 * @param top an integer specifying the width of the top,
 * in pixels
 * @param left an integer specifying the width of the left side,
 * in pixels
 * @param bottom an integer specifying the width of the right side,
 * in pixels
 * @param right an integer specifying the width of the bottom,
 * in pixels
 * @param color a <code>Color</code> to use for the border
 * @return the <code>MatteBorder</code> object
 */
publicstaticMatteBordercreateMatteBorder(inttop, intleft, intbottom, intright,
Colorcolor) {
returnnewMatteBorder(top, left, bottom, right, color);
 }

/**
 * Creates a matte-look border that consists of multiple tiles of a
 * specified icon. Multiple copies of the icon are placed side-by-side
 * to fill up the border area.
 * <p>
 * Note:<br>
 * If the icon doesn't load, the border area is painted gray.
 *
 * @param top an integer specifying the width of the top,
 * in pixels
 * @param left an integer specifying the width of the left side,
 * in pixels
 * @param bottom an integer specifying the width of the right side,
 * in pixels
 * @param right an integer specifying the width of the bottom,
 * in pixels
 * @param tileIcon the <code>Icon</code> object used for the border tiles
 * @return the <code>MatteBorder</code> object
 */
publicstaticMatteBordercreateMatteBorder(inttop, intleft, intbottom, intright,
IcontileIcon) {
returnnewMatteBorder(top, left, bottom, right, tileIcon);
 }

//// StrokeBorder //////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////

/**
 * Creates a border of the specified {@code stroke}.
 * The component's foreground color will be used to render the border.
 *
 * @param stroke the {@link BasicStroke} object used to stroke a shape
 * @return the {@code Border} object
 *
 * @throws NullPointerException if the specified {@code stroke} is {@code null}
 *
 * @since 1.7
 */
publicstaticBordercreateStrokeBorder(BasicStrokestroke) {
returnnewStrokeBorder(stroke);
 }

/**
 * Creates a border of the specified {@code stroke} and {@code paint}.
 * If the specified {@code paint} is {@code null},
 * the component's foreground color will be used to render the border.
 *
 * @param stroke the {@link BasicStroke} object used to stroke a shape
 * @param paint the {@link Paint} object used to generate a color
 * @return the {@code Border} object
 *
 * @throws NullPointerException if the specified {@code stroke} is {@code null}
 *
 * @since 1.7
 */
publicstaticBordercreateStrokeBorder(BasicStrokestroke, Paintpaint) {
returnnewStrokeBorder(stroke, paint);
 }

//// DashedBorder //////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////

privatestaticBordersharedDashedBorder;

/**
 * Creates a dashed border of the specified {@code paint}.
 * If the specified {@code paint} is {@code null},
 * the component's foreground color will be used to render the border.
 * The width of a dash line is equal to {@code 1}.
 * The relative length of a dash line and
 * the relative spacing between dash lines are equal to {@code 1}.
 * A dash line is not rounded.
 *
 * @param paint the {@link Paint} object used to generate a color
 * @return the {@code Border} object
 *
 * @since 1.7
 */
publicstaticBordercreateDashedBorder(Paintpaint) {
returncreateDashedBorder(paint, 1.0f, 1.0f, 1.0f, false);
 }

/**
 * Creates a dashed border of the specified {@code paint},
 * relative {@code length}, and relative {@code spacing}.
 * If the specified {@code paint} is {@code null},
 * the component's foreground color will be used to render the border.
 * The width of a dash line is equal to {@code 1}.
 * A dash line is not rounded.
 *
 * @param paint the {@link Paint} object used to generate a color
 * @param length the relative length of a dash line
 * @param spacing the relative spacing between dash lines
 * @return the {@code Border} object
 *
 * @throws IllegalArgumentException if the specified {@code length} is less than {@code 1}, or
 * if the specified {@code spacing} is less than {@code 0}
 * @since 1.7
 */
publicstaticBordercreateDashedBorder(Paintpaint, floatlength, floatspacing) {
returncreateDashedBorder(paint, 1.0f, length, spacing, false);
 }

/**
 * Creates a dashed border of the specified {@code paint}, {@code thickness},
 * line shape, relative {@code length}, and relative {@code spacing}.
 * If the specified {@code paint} is {@code null},
 * the component's foreground color will be used to render the border.
 *
 * @param paint the {@link Paint} object used to generate a color
 * @param thickness the width of a dash line
 * @param length the relative length of a dash line
 * @param spacing the relative spacing between dash lines
 * @param rounded whether or not line ends should be round
 * @return the {@code Border} object
 *
 * @throws IllegalArgumentException if the specified {@code thickness} is less than {@code 1}, or
 * if the specified {@code length} is less than {@code 1}, or
 * if the specified {@code spacing} is less than {@code 0}
 * @since 1.7
 */
publicstaticBordercreateDashedBorder(Paintpaint, floatthickness, floatlength, floatspacing, booleanrounded) {
booleanshared = !rounded && (paint == null) && (thickness == 1.0f) && (length == 1.0f) && (spacing == 1.0f);
if (shared && (sharedDashedBorder != null)) {
returnsharedDashedBorder;
 }
if (thickness < 1.0f) {
thrownewIllegalArgumentException("thickness is less than 1");
 }
if (length < 1.0f) {
thrownewIllegalArgumentException("length is less than 1");
 }
if (spacing < 0.0f) {
thrownewIllegalArgumentException("spacing is less than 0");
 }
intcap = rounded ? BasicStroke.CAP_ROUND : BasicStroke.CAP_SQUARE;
intjoin = rounded ? BasicStroke.JOIN_ROUND : BasicStroke.JOIN_MITER;
float[] array = { thickness * (length - 1.0f), thickness * (spacing + 1.0f) };
Borderborder = createStrokeBorder(newBasicStroke(thickness, cap, join, thickness * 2.0f, array, 0.0f), paint);
if (shared) {
sharedDashedBorder = border;
 }
returnborder;
 }
}