Class UIDefaultsLoader

java.lang.Object

com.formdev.flatlaf.UIDefaultsLoader

class UIDefaultsLoader
extends Object

Load UI defaults from properties files associated to Flat LaF classes and add to UI defaults. Each class that extend the LaF class may have its own .properties file in the same package as the class. Properties from superclasses are loaded first to give subclasses a chance to override defaults. E.g. if running FlatDarkLaf, then the FlatLaf.properties is loaded first and FlatDarkLaf.properties loaded second.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static enum	UIDefaultsLoader.ValueType

Field Summary

Fields

Modifier and Type	Field	Description
private static final SoftCache<String,Object>	fontCache
private static Map<Class<?>, UIDefaultsLoader.ValueType>	javaValueTypes
(package private) static final String	KEY_PROPERTIES
(package private) static final String	KEY_VARIABLES
private static Map<String, UIDefaultsLoader.ValueType>	knownValueTypes
private static final String	OPTIONAL_PREFIX
private static int	parseColorDepth
private static final String	PROPERTY_PREFIX
private static Map<String, ColorUIResource>	systemColorCache
private static final UIDefaultsLoader.ValueType[]	tempResultValueType
private static final String	TYPE_PREFIX
private static final String	TYPE_PREFIX_END
private static final String	VARIABLE_PREFIX
private static final String	WILDCARD_PREFIX

Constructor Summary

Constructors

Constructor	Description
UIDefaultsLoader()

Method Summary

Modifier and Type	Method	Description
private static Class<?>	findClass(String className, List<ClassLoader> addonClassLoaders)
(package private) static ArrayList<Class<?>>	getLafClassesForDefaultsLoading(Class<?> lookAndFeelClass)
private static ColorUIResource	getSystemColor(String name)
private static Object	invokeConstructorOrStaticMethod(Executable[] constructorsOrMethods, List<String> parts, Function<String,String> resolver)
(package private) static Object	lazyUIManagerGet(String uiKey)	For use in LazyValue to get value for given key from UIManager and report error if not found.
(package private) static void	loadDefaultsFromProperties(List<Class<?>> lafClasses, List<FlatDefaultsAddon> addons, Consumer<Properties> intellijThemesHook, Properties additionalDefaults, boolean dark, UIDefaults defaults)
(package private) static void	logParseError(String key, String value, RuntimeException ex, boolean severe)
private static IllegalArgumentException	newInvalidColorException(String value)
private static UIDefaults.LazyValue	newLazyColorFunction(String uiKey, ColorFunctions.ColorFunction function)
private static IllegalArgumentException	newMissingParametersException(String value)
(package private) static Properties	newUIProperties(boolean dark)
private static Boolean	parseBoolean(String value)
private static Object	parseBorder(String value, Function<String,String> resolver, List<ClassLoader> addonClassLoaders)
private static Character	parseCharacter(String value)
private static Object	parseClass(String value, List<ClassLoader> addonClassLoaders)
(package private) static ColorUIResource	parseColor(String value)	Parses a hex color in #RGB, #RGBA, #RRGGBB or #RRGGBBAA format and returns it as color object.
private static Object	parseColorChange(int hslIndex, List<String> params, Function<String,String> resolver)	Syntax: changeHue(color,value[,options]) or changeSaturation(color,value[,options]) or changeLightness(color,value[,options]) or changeAlpha(color,value[,options]) - color: a color (e.g.
private static Object	parseColorContrast(List<String> params, Function<String,String> resolver)	Syntax: contrast(color,dark,light[,threshold]) - color: a color to compare against - dark: a designated dark color (e.g.
private static Object	parseColorFade(List<String> params, Function<String,String> resolver)	Syntax: fade(color,amount[,options]) - color: a color (e.g.
private static Object	parseColorFunctions(String value, Function<String,String> resolver)
private static Object	parseColorHSLIncreaseDecrease(int hslIndex, boolean increase, List<String> params, Function<String,String> resolver)	Syntax: lighten(color,amount[,options]) or darken(color,amount[,options]) or saturate(color,amount[,options]) or desaturate(color,amount[,options]) or fadein(color,amount[,options]) or fadeout(color,amount[,options]) - color: a color (e.g.
private static ColorUIResource	parseColorHslOrHsla(boolean hasAlpha, List<String> params)	Syntax: hsl(hue,saturation,lightness) or hsla(hue,saturation,lightness,alpha) - hue: an integer 0-360 representing degrees - saturation: a percentage 0-100% - lightness: a percentage 0-100% - alpha: a percentage 0-100%
private static Object	parseColorIf(String value, List<String> params, Function<String,String> resolver)	Syntax: if(condition,trueValue,falseValue)
private static Object	parseColorLazy(String value, List<String> params, Function<String,String> resolver)	Syntax: lazy(uiKey)
private static Object	parseColorMix(String color1Str, List<String> params, Function<String,String> resolver)	Syntax: mix(color1,color2[,weight][,options]) or tint(color[,weight][,options]) or shade(color[,weight][,options]) - color1: a color (e.g.
private static Object	parseColorOrFunction(String value, Function<String,String> resolver)
private static ColorUIResource	parseColorOver(List<String> params, Function<String,String> resolver)	Syntax: over(foreground,background) - foreground: a foreground color (e.g.
(package private) static int	parseColorRGBA(String value)	Parses a hex color in #RGB, #RGBA, #RRGGBB or #RRGGBBAA format and returns it as rgba integer suitable for Color, which includes alpha component in bits 24-31.
private static ColorUIResource	parseColorRgbOrRgba(boolean hasAlpha, List<String> params, Function<String,String> resolver)	Syntax: rgb(red,green,blue) or rgba(red,green,blue,alpha) - red: an integer 0-255 or a percentage 0-100% - green: an integer 0-255 or a percentage 0-100% - blue: an integer 0-255 or a percentage 0-100% - alpha: an integer 0-255 or a percentage 0-100%
private static Object	parseColorSpin(List<String> params, Function<String,String> resolver)	Syntax: spin(color,angle[,options]) - color: a color (e.g.
private static Object	parseColorSystemColor(String value, List<String> params, Function<String,String> resolver)	Syntax: systemColor(name[,defaultValue]) - name: system color name - defaultValue: default color value used if system color is not available
private static boolean	parseCondition(String condition, Function<String,String> resolver, List<ClassLoader> addonClassLoaders)
private static Dimension	parseDimension(String value)
private static Float	parseFloat(String value)
private static Object	parseFont(String value)	Syntax: [normal] [bold|+bold|-bold] [italic|+italic|-italic] [|+|-|%] [family[, family]] [$baseFontKey]
private static Object	parseFunctionBaseColor(String colorStr, ColorFunctions.ColorFunction function, boolean derived, Function<String,String> resolver)
private static Object	parseGrayFilter(String value)
private static Insets	parseInsets(String value)
private static Object	parseInstance(String value, Function<String,String> resolver, List<ClassLoader> addonClassLoaders)
private static Integer	parseInteger(String value)
private static Integer	parseInteger(String value, int min, int max, boolean allowPercentage)
private static Number	parseIntegerOrFloat(String value)
private static Object[]	parseMethodParams(Class<?>[] paramTypes, List<String> parts, Function<String,String> resolver)
private static int	parsePercentage(String value)
private static UIDefaults.ActiveValue	parseScaledDimension(String value)
private static UIDefaults.ActiveValue	parseScaledFloat(String value)
private static UIDefaults.ActiveValue	parseScaledInsets(String value)
private static UIDefaults.ActiveValue	parseScaledInteger(String value)
(package private) static Object	parseValue(String key, String value, Class<?> valueType)
(package private) static Object	parseValue(String key, String value, Class<?> javaValueType, UIDefaultsLoader.ValueType[] resultValueType, Function<String,String> resolver, List<ClassLoader> addonClassLoaders)
(package private) static String	resolveValue(String value, Function<String,String> propertiesGetter)
(package private) static String	resolveValueFromUIManager(String value)
(package private) static String	simpleClassName(Class<?> cls)	Similar to Class.getSimpleName(), but includes enclosing class for nested classes.
private static List<String>	splitFunctionParams(String str, char delim)	Splits function parameters and allows using functions as parameters.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

TYPE_PREFIX

private static final String TYPE_PREFIX

See Also:

• Constant Field Values

TYPE_PREFIX_END

private static final String TYPE_PREFIX_END

See Also:

• Constant Field Values

VARIABLE_PREFIX

private static final String VARIABLE_PREFIX

See Also:

• Constant Field Values

PROPERTY_PREFIX

private static final String PROPERTY_PREFIX

See Also:

• Constant Field Values

OPTIONAL_PREFIX

private static final String OPTIONAL_PREFIX

See Also:

• Constant Field Values

WILDCARD_PREFIX

private static final String WILDCARD_PREFIX

See Also:

• Constant Field Values

KEY_VARIABLES

static final String KEY_VARIABLES

See Also:

• Constant Field Values

KEY_PROPERTIES

static final String KEY_PROPERTIES

See Also:

• Constant Field Values

parseColorDepth

private static int parseColorDepth

systemColorCache

private static Map<String, ColorUIResource> systemColorCache

fontCache

private static final SoftCache<String,Object> fontCache

tempResultValueType

private static final UIDefaultsLoader.ValueType[] tempResultValueType

javaValueTypes

private static Map<Class<?>, UIDefaultsLoader.ValueType> javaValueTypes

knownValueTypes

private static Map<String, UIDefaultsLoader.ValueType> knownValueTypes

Constructor Details

UIDefaultsLoader

UIDefaultsLoader()

Method Details

getLafClassesForDefaultsLoading

static ArrayList<Class<?>> getLafClassesForDefaultsLoading(Class<?> lookAndFeelClass)

newUIProperties

static Properties newUIProperties(boolean dark)

loadDefaultsFromProperties

static void loadDefaultsFromProperties(List<Class<?>> lafClasses,
 List<FlatDefaultsAddon> addons,
 Consumer<Properties> intellijThemesHook,
 Properties additionalDefaults,
 boolean dark,
 UIDefaults defaults)

simpleClassName

static String simpleClassName(Class<?> cls)

Similar to Class.getSimpleName(), but includes enclosing class for nested classes.

logParseError

static void logParseError(String key,
 String value,
 RuntimeException ex,
 boolean severe)

resolveValue

static String resolveValue(String value,
 Function<String,String> propertiesGetter)
                    throws IllegalArgumentException

Throws:

IllegalArgumentException

resolveValueFromUIManager

static String resolveValueFromUIManager(String value)
                                 throws IllegalArgumentException

Throws:

IllegalArgumentException

parseValue

static Object parseValue(String key,
 String value,
 Class<?> valueType)
                  throws IllegalArgumentException

Throws:

IllegalArgumentException

parseValue

static Object parseValue(String key,
 String value,
 Class<?> javaValueType,
 UIDefaultsLoader.ValueType[] resultValueType,
 Function<String,String> resolver,
 List<ClassLoader> addonClassLoaders)
                  throws IllegalArgumentException

Throws:

IllegalArgumentException

parseCondition

private static boolean parseCondition(String condition,
 Function<String,String> resolver,
 List<ClassLoader> addonClassLoaders)

parseBorder

private static Object parseBorder(String value,
 Function<String,String> resolver,
 List<ClassLoader> addonClassLoaders)
                           throws IllegalArgumentException

Throws:

IllegalArgumentException

parseInstance

private static Object parseInstance(String value,
 Function<String,String> resolver,
 List<ClassLoader> addonClassLoaders)

parseClass

private static Object parseClass(String value,
 List<ClassLoader> addonClassLoaders)

findClass

private static Class<?> findClass(String className,
 List<ClassLoader> addonClassLoaders)
                           throws ClassNotFoundException

Throws:

ClassNotFoundException

parseInsets

private static Insets parseInsets(String value)
                           throws IllegalArgumentException

Throws:

IllegalArgumentException

parseDimension

private static Dimension parseDimension(String value)
                                 throws IllegalArgumentException

Throws:

IllegalArgumentException

parseColorOrFunction

private static Object parseColorOrFunction(String value,
 Function<String,String> resolver)
                                    throws IllegalArgumentException

Throws:

IllegalArgumentException

parseColor

static ColorUIResource parseColor(String value)
                           throws IllegalArgumentException

Parses a hex color in #RGB, #RGBA, #RRGGBB or #RRGGBBAA format and returns it as color object.

Throws:

IllegalArgumentException

parseColorRGBA

static int parseColorRGBA(String value)
                   throws IllegalArgumentException

Parses a hex color in #RGB, #RGBA, #RRGGBB or #RRGGBBAA format and returns it as rgba integer suitable for Color, which includes alpha component in bits 24-31.

Throws:

IllegalArgumentException

newInvalidColorException

private static IllegalArgumentException newInvalidColorException(String value)

parseColorFunctions

private static Object parseColorFunctions(String value,
 Function<String,String> resolver)
                                   throws IllegalArgumentException

Throws:

IllegalArgumentException

parseColorIf

private static Object parseColorIf(String value,
 List<String> params,
 Function<String,String> resolver)
                            throws IllegalArgumentException

Syntax: if(condition,trueValue,falseValue)

This "if" function is only used if the "if" is passed as parameter to another color function. Otherwise, the general "if" function is used.

Throws:

IllegalArgumentException

parseColorLazy

private static Object parseColorLazy(String value,
 List<String> params,
 Function<String,String> resolver)
                              throws IllegalArgumentException

Syntax: lazy(uiKey)

This "lazy" function is only used if the "lazy" is passed as parameter to another color function. Otherwise, the general "lazy" function is used.

Note: The color is resolved immediately, not lazy, because it is passed as parameter to another color function. So e.g. darken(lazy(List.background), 10%) is the same as darken($List.background, 10%).

Only useful if a property is defined as lazy and that property is used in another property's color function. E.g.

someProperty = lazy(List.background)
anotherProperty = darken($someProperty, 10%)

Throws:

IllegalArgumentException

parseColorSystemColor

private static Object parseColorSystemColor(String value,
 List<String> params,
 Function<String,String> resolver)
                                     throws IllegalArgumentException

Syntax: systemColor(name[,defaultValue]) - name: system color name - defaultValue: default color value used if system color is not available

Throws:

IllegalArgumentException

getSystemColor

private static ColorUIResource getSystemColor(String name)

parseColorRgbOrRgba

private static ColorUIResource parseColorRgbOrRgba(boolean hasAlpha,
 List<String> params,
 Function<String,String> resolver)
                                            throws IllegalArgumentException

Syntax: rgb(red,green,blue) or rgba(red,green,blue,alpha) - red: an integer 0-255 or a percentage 0-100% - green: an integer 0-255 or a percentage 0-100% - blue: an integer 0-255 or a percentage 0-100% - alpha: an integer 0-255 or a percentage 0-100%

Throws:

IllegalArgumentException

parseColorHslOrHsla

private static ColorUIResource parseColorHslOrHsla(boolean hasAlpha,
 List<String> params)
                                            throws IllegalArgumentException

Syntax: hsl(hue,saturation,lightness) or hsla(hue,saturation,lightness,alpha) - hue: an integer 0-360 representing degrees - saturation: a percentage 0-100% - lightness: a percentage 0-100% - alpha: a percentage 0-100%

Throws:

IllegalArgumentException

parseColorHSLIncreaseDecrease

private static Object parseColorHSLIncreaseDecrease(int hslIndex,
 boolean increase,
 List<String> params,
 Function<String,String> resolver)
                                             throws IllegalArgumentException

Syntax: lighten(color,amount[,options]) or darken(color,amount[,options]) or saturate(color,amount[,options]) or desaturate(color,amount[,options]) or fadein(color,amount[,options]) or fadeout(color,amount[,options]) - color: a color (e.g. #f00) or a color function - amount: percentage 0-100% - options: [relative] [autoInverse] [noAutoInverse] [derived] [lazy]

Throws:

IllegalArgumentException

parseColorFade

private static Object parseColorFade(List<String> params,
 Function<String,String> resolver)
                              throws IllegalArgumentException

Syntax: fade(color,amount[,options]) - color: a color (e.g. #f00) or a color function - amount: percentage 0-100% - options: [derived] [lazy]

Throws:

IllegalArgumentException

parseColorSpin

private static Object parseColorSpin(List<String> params,
 Function<String,String> resolver)
                              throws IllegalArgumentException

Syntax: spin(color,angle[,options]) - color: a color (e.g. #f00) or a color function - angle: number of degrees to rotate - options: [derived] [lazy]

Throws:

IllegalArgumentException

parseColorChange

private static Object parseColorChange(int hslIndex,
 List<String> params,
 Function<String,String> resolver)
                                throws IllegalArgumentException

Syntax: changeHue(color,value[,options]) or changeSaturation(color,value[,options]) or changeLightness(color,value[,options]) or changeAlpha(color,value[,options]) - color: a color (e.g. #f00) or a color function - value: for hue: number of degrees; otherwise: percentage 0-100% - options: [derived] [lazy]

Throws:

IllegalArgumentException

parseColorMix

private static Object parseColorMix(String color1Str,
 List<String> params,
 Function<String,String> resolver)
                             throws IllegalArgumentException

Syntax: mix(color1,color2[,weight][,options]) or tint(color[,weight][,options]) or shade(color[,weight][,options]) - color1: a color (e.g. #f00) or a color function - color2: a color (e.g. #f00) or a color function - weight: the weight (in range 0-100%) to mix the two colors larger weight uses more of first color, smaller weight more of second color - options: [derived] [lazy]

Throws:

IllegalArgumentException

parseColorContrast

private static Object parseColorContrast(List<String> params,
 Function<String,String> resolver)
                                  throws IllegalArgumentException

Syntax: contrast(color,dark,light[,threshold]) - color: a color to compare against - dark: a designated dark color (e.g. #000) or a color function - light: a designated light color (e.g. #fff) or a color function - threshold: the threshold (in range 0-100%) to specify where the transition from "dark" to "light" is (default is 43%)

Throws:

IllegalArgumentException

parseColorOver

private static ColorUIResource parseColorOver(List<String> params,
 Function<String,String> resolver)
                                       throws IllegalArgumentException

Syntax: over(foreground,background) - foreground: a foreground color (e.g. #f00) or a color function; the alpha of this color is used as weight to mix the two colors - background: a background color (e.g. #f00) or a color function

Throws:

IllegalArgumentException

parseFunctionBaseColor

private static Object parseFunctionBaseColor(String colorStr,
 ColorFunctions.ColorFunction function,
 boolean derived,
 Function<String,String> resolver)
                                      throws IllegalArgumentException

Throws:

IllegalArgumentException

newLazyColorFunction

private static UIDefaults.LazyValue newLazyColorFunction(String uiKey,
 ColorFunctions.ColorFunction function)

parseFont

private static Object parseFont(String value)
                         throws IllegalArgumentException

Syntax: [normal] [bold|+bold|-bold] [italic|+italic|-italic] [|+|-|%] [family[, family]] [$baseFontKey]

Throws:

IllegalArgumentException

parsePercentage

private static int parsePercentage(String value)
                            throws IllegalArgumentException,
NumberFormatException

Throws:

IllegalArgumentException

NumberFormatException

parseBoolean

private static Boolean parseBoolean(String value)
                             throws IllegalArgumentException

Throws:

IllegalArgumentException

parseCharacter

private static Character parseCharacter(String value)
                                 throws IllegalArgumentException

Throws:

IllegalArgumentException

parseInteger

private static Integer parseInteger(String value,
 int min,
 int max,
 boolean allowPercentage)
                             throws IllegalArgumentException,
NumberFormatException

Throws:

IllegalArgumentException

NumberFormatException

parseInteger

private static Integer parseInteger(String value)
                             throws NumberFormatException

Throws:

NumberFormatException

parseIntegerOrFloat

private static Number parseIntegerOrFloat(String value)
                                   throws NumberFormatException

Throws:

NumberFormatException

parseFloat

private static Float parseFloat(String value)
                         throws NumberFormatException

Throws:

NumberFormatException

parseScaledInteger

private static UIDefaults.ActiveValue parseScaledInteger(String value)
                                                  throws NumberFormatException

Throws:

NumberFormatException

parseScaledFloat

private static UIDefaults.ActiveValue parseScaledFloat(String value)
                                                throws NumberFormatException

Throws:

NumberFormatException

parseScaledInsets

private static UIDefaults.ActiveValue parseScaledInsets(String value)
                                                 throws IllegalArgumentException

Throws:

IllegalArgumentException

parseScaledDimension

private static UIDefaults.ActiveValue parseScaledDimension(String value)
                                                    throws IllegalArgumentException

Throws:

IllegalArgumentException

parseGrayFilter

private static Object parseGrayFilter(String value)
                               throws IllegalArgumentException

Throws:

IllegalArgumentException

splitFunctionParams

private static List<String> splitFunctionParams(String str,
 char delim)

Splits function parameters and allows using functions as parameters. In other words: Delimiters surrounded by '(' and ')' are ignored.

invokeConstructorOrStaticMethod

private static Object invokeConstructorOrStaticMethod(Executable[] constructorsOrMethods,
 List<String> parts,
 Function<String,String> resolver)
                                               throws Exception

Throws:

Exception

parseMethodParams

private static Object[] parseMethodParams(Class<?>[] paramTypes,
 List<String> parts,
 Function<String,String> resolver)

lazyUIManagerGet

static Object lazyUIManagerGet(String uiKey)

For use in LazyValue to get value for given key from UIManager and report error if not found. If key is prefixed by '?', then no error is reported.

newMissingParametersException

private static IllegalArgumentException newMissingParametersException(String value)