package be.nikiroo.utils.resources; import java.util.ArrayList; import java.util.List; /** * Internal class used to convert data to/from {@link String}s in the context of * {@link Bundle}s. * * @author niki */ class BundleHelper { /** * Convert the given {@link String} into a {@link Boolean} if it represents * a {@link Boolean}, or NULL if it doesn't. *
* Note: null, "strange text", ""... will all be converted to NULL. * * @param str * the input {@link String} * @param item * the item number to use for an array of values, or -1 for * non-arrays * * @return the converted {@link Boolean} or NULL */ static public Boolean parseBoolean(String str, int item) { str = getItem(str, item); if (str == null) { return null; } if (str.equalsIgnoreCase("true") || str.equalsIgnoreCase("on") || str.equalsIgnoreCase("yes")) return true; if (str.equalsIgnoreCase("false") || str.equalsIgnoreCase("off") || str.equalsIgnoreCase("no")) return false; return null; } /** * Return a {@link String} representation of the given {@link Boolean}. * * @param value * the input value * * @return the raw {@link String} value that correspond to it */ static public String fromBoolean(boolean value) { return Boolean.toString(value); } /** * Convert the given {@link String} into a {@link Integer} if it represents * a {@link Integer}, or NULL if it doesn't. *
* Note: null, "strange text", ""... will all be converted to NULL. * * @param str * the input {@link String} * @param item * the item number to use for an array of values, or -1 for * non-arrays * * @return the converted {@link Integer} or NULL */ static public Integer parseInteger(String str, int item) { str = getItem(str, item); if (str == null) { return null; } try { return Integer.parseInt(str); } catch (Exception e) { } return null; } /** * Return a {@link String} representation of the given {@link Integer}. * * @param value * the input value * * @return the raw {@link String} value that correspond to it */ static public String fromInteger(int value) { return Integer.toString(value); } /** * Convert the given {@link String} into a {@link Character} if it * represents a {@link Character}, or NULL if it doesn't. *
* Note: null, "strange text", ""... will all be converted to NULL * (remember: any {@link String} whose length is not 1 is not a * {@link Character}). * * @param str * the input {@link String} * @param item * the item number to use for an array of values, or -1 for * non-arrays * * @return the converted {@link Character} or NULL */ static public Character parseCharacter(String str, int item) { str = getItem(str, item); if (str == null) { return null; } String s = str.trim(); if (s.length() == 1) { return s.charAt(0); } return null; } /** * Return a {@link String} representation of the given {@link Boolean}. * * @param value * the input value * * @return the raw {@link String} value that correspond to it */ static public String fromCharacter(char value) { return Character.toString(value); } /** * Convert the given {@link String} into a colour (represented here as an * {@link Integer}) if it represents a colour, or NULL if it doesn't. *
* The returned colour value is an ARGB value. * * @param str * the input {@link String} * @param item * the item number to use for an array of values, or -1 for * non-arrays * * @return the converted colour as an {@link Integer} value or NULL */ static Integer parseColor(String str, int item) { str = getItem(str, item); if (str == null) { return null; } Integer rep = null; str = str.trim(); int r = 0, g = 0, b = 0, a = -1; if (str.startsWith("#") && (str.length() == 7 || str.length() == 9)) { try { r = Integer.parseInt(str.substring(1, 3), 16); g = Integer.parseInt(str.substring(3, 5), 16); b = Integer.parseInt(str.substring(5, 7), 16); if (str.length() == 9) { a = Integer.parseInt(str.substring(7, 9), 16); } else { a = 255; } } catch (NumberFormatException e) { // no changes } } // Try by name if still not found if (a == -1) { if ("black".equalsIgnoreCase(str)) { a = 255; r = 0; g = 0; b = 0; } else if ("white".equalsIgnoreCase(str)) { a = 255; r = 255; g = 255; b = 255; } else if ("red".equalsIgnoreCase(str)) { a = 255; r = 255; g = 0; b = 0; } else if ("green".equalsIgnoreCase(str)) { a = 255; r = 0; g = 255; b = 0; } else if ("blue".equalsIgnoreCase(str)) { a = 255; r = 0; g = 0; b = 255; } else if ("grey".equalsIgnoreCase(str) || "gray".equalsIgnoreCase(str)) { a = 255; r = 128; g = 128; b = 128; } else if ("cyan".equalsIgnoreCase(str)) { a = 255; r = 0; g = 255; b = 255; } else if ("magenta".equalsIgnoreCase(str)) { a = 255; r = 255; g = 0; b = 255; } else if ("yellow".equalsIgnoreCase(str)) { a = 255; r = 255; g = 255; b = 0; } } if (a != -1) { rep = ((a & 0xFF) << 24) // | ((r & 0xFF) << 16) // | ((g & 0xFF) << 8) // | ((b & 0xFF) << 0); } return rep; } /** * Return a {@link String} representation of the given colour. *
* The colour value is interpreted as an ARGB value.
*
* @param color
* the ARGB colour value
* @return the raw {@link String} value that correspond to it
*/
static public String fromColor(int color) {
int a = (color >> 24) & 0xFF;
int r = (color >> 16) & 0xFF;
int g = (color >> 8) & 0xFF;
int b = (color >> 0) & 0xFF;
String rs = Integer.toString(r, 16);
String gs = Integer.toString(g, 16);
String bs = Integer.toString(b, 16);
String as = "";
if (a < 255) {
as = Integer.toString(a, 16);
}
return "#" + rs + gs + bs + as;
}
/**
* The size of this raw list (note than a NULL list is of size 0).
*
* @param raw
* the raw list
*
* @return its size if it is a list (NULL is an empty list), -1 if it is not
* a list
*/
static public int getListSize(String raw) {
if (raw == null) {
return 0;
}
List
* The list of values is comma-separated and each value is surrounded by
* double-quotes; caret (^) and double-quotes (") are escaped by a caret.
*
* @param str
* the input value
* @param item
* the item number to use for an array of values, or -1 for
* non-arrays
*
* @return the raw {@link String} value that correspond to it
*/
static public List
* NULL will be assimilated to an empty {@link String} if later non-null
* values exist, or just ignored if not.
*
* Example:
*
* NULL will be assimilated to an empty {@link String} if later non-null
* values exist, or just ignored if not.
*
* Example:
*
* NULL will be assimilated to an empty {@link String} if later non-null
* values exist, or just ignored if not.
*
* Example:
*
* You can unescape it with {@link BundleHelper#unescape(String)}
*
* @param value
* the value to escape
*
* @return an escaped value that can unquoted by the reverse operation
* {@link BundleHelper#unescape(String)}
*/
static public String escape(String value) {
return '"' + value//
.replace("^", "^^") //
.replace("\"", "^\"") //
.replace("\n", "^\n") //
.replace("\r", "^\r") //
+ '"';
}
/**
* Unescape the given value for list formating (change ^n into NEWLINE and
* so on).
*
* You can escape it with {@link BundleHelper#escape(String)}
*
* @param value
* the value to escape
*
* @return an unescaped value that can reverted by the reverse operation
* {@link BundleHelper#escape(String)}, or NULL if it was badly
* formated
*/
static public String unescape(String value) {
if (value.length() < 2 || !value.startsWith("\"")
|| !value.endsWith("\"")) {
// Bad format
return null;
}
value = value.substring(1, value.length() - 1);
boolean prevIsBackslash = false;
StringBuilder builder = new StringBuilder();
for (char car : value.toCharArray()) {
if (prevIsBackslash) {
switch (car) {
case 'n':
case 'N':
builder.append('\n');
break;
case 'r':
case 'R':
builder.append('\r');
break;
default: // includes ^ and "
builder.append(car);
break;
}
prevIsBackslash = false;
} else {
if (car == '^') {
prevIsBackslash = true;
} else {
builder.append(car);
}
}
}
if (prevIsBackslash) {
// Bad format
return null;
}
return builder.toString();
}
/**
* Retrieve the specific item in the given value, assuming it is an array.
*
* @param value
* the value to look into
* @param item
* the item number to get for an array of values, or -1 for
* non-arrays (in that case, simply return the value as-is)
*
* @return the value as-is for non arrays, the item item if found,
* NULL if not
*/
static private String getItem(String value, int item) {
if (item >= 0) {
value = null;
List
*
*
* @param list
* the input value
*
* @return the raw {@link String} value that correspond to it
*/
static public String fromList(List
*
*
* @param list
* the input value
* @param value
* the value to insert
* @param item
* the position to insert it at
*
* @return the raw {@link String} value that correspond to it
*/
static public String fromList(List
*
*
* @param list
* the input value
* @param value
* the value to insert
* @param item
* the position to insert it at
*
* @return the raw {@link String} value that correspond to it
*/
static public String fromList(String list, String value, int item) {
return fromList(parseList(list, -1), value, item);
}
/**
* Escape the given value for list formating (no carets, no NEWLINES...).
*