com.devexperts.qd.util

Class QDConfig

java.lang.Object

com.devexperts.qd.util.QDConfig

public class QDConfig
extends Object

Configuration utility methods.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	QDConfig.Property

Field Summary

Fields

Modifier and Type	Field and Description
static char	ESCAPE_CHAR Backslash.

Method Summary

Modifier and Type	Method and Description
static String	escape(String s) Adds backslash escaped to all characters in the string that are consider special in QD configuration strings: '(', ')', '[', ']', ',', '+', '@', '\'.
static List<QDConfig.Property>	getProperties(Class<?> intf)
static List<String>	getProperties(Object instance)
static List<String>	getProperties(Object instance, Class<?> intf)
static String	parseProperties(String desc, Collection<String> kvList) Parses additional properties at the end of the given description string.
static void	setDefaultProperties(Object instance, Class<?> intf, String prefix)
static void	setProperties(Object instance, Class<?> intf, List<String> kvList)
static void	setProperties(Object instance, List<String> kvList)
static String[]	splitParenthesisedStringAt(String s, char atChar) Finds first occurrence of atChar while honoring quotation by '('..')' and '['...']' pairs.
static List<String>	splitParenthesisSeparatedString(String s) Splits a parenthesis-separated collection like '('<item>')'('<item>')...('<item>').
static String	unescape(String s) Removes backslash escapes from the string.

Methods inherited from class java.lang.Object

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

Field Detail

ESCAPE_CHAR

public static final char ESCAPE_CHAR

Backslash.

See Also:

Constant Field Values

Method Detail

unescape

public static String unescape(String s)

Removes backslash escapes from the string.

See Also:

ESCAPE_CHAR, escape(String)

escape

public static String escape(String s)

Adds backslash escaped to all characters in the string that are consider special in QD configuration strings: '(', ')', '[', ']', ',', '+', '@', '\'.

See Also:

ESCAPE_CHAR, unescape(String)

splitParenthesisSeparatedString

public static List<String> splitParenthesisSeparatedString(String s)

Splits a parenthesis-separated collection like '('<item>')'('<item>')...('<item>').

Parameters:

s - the original string.

Returns:

a list of items.

Throws:

AddressSyntaxException - if braces in string are unbalanced.

splitParenthesisedStringAt

public static String[] splitParenthesisedStringAt(String s,
                                                  char atChar)

Finds first occurrence of atChar while honoring quotation by '('..')' and '['...']' pairs.

Parameters:

s - the string.

atChar - the char to find.

Returns:

array of one or two items.

parseProperties

public static String parseProperties(String desc,
                                     Collection<String> kvList)
                              throws InvalidFormatException

Parses additional properties at the end of the given description string. Properties can be enclosed in pairs of matching '[...]' or '(...)' (the latter is deprecated). Multiple properties can be specified with multiple pair of braces or be comma-separated inside a single pair, so both "something[prop1,prop2]" and "something[prop1][prop2]" are valid properties specifications. All braces must go in matching pairs. Original string and all properties string are trimmed from extra space, so extra spaces around or inside braces are ignored. Special characters can be escaped with a backslash (ESCAPE_CHAR).

Parameters:

desc - Description string to parse.

kvList - Collection of strings where parsed properties are added to.

Returns:

The resulting description string without properties.

Throws:

InvalidFormatException - when description string is malformed.

getProperties

public static List<String> getProperties(Object instance)

setProperties

public static void setProperties(Object instance,
                                 List<String> kvList)
                          throws InvalidFormatException

Throws:

InvalidFormatException

getProperties

public static List<String> getProperties(Object instance,
                                         Class<?> intf)

setProperties

public static void setProperties(Object instance,
                                 Class<?> intf,
                                 List<String> kvList)
                          throws InvalidFormatException

Throws:

InvalidFormatException

setDefaultProperties

public static void setDefaultProperties(Object instance,
                                        Class<?> intf,
                                        String prefix)

getProperties

public static List<QDConfig.Property> getProperties(Class<?> intf)