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 list = parseList(raw, -1); if (list == null) { return -1; } return list.size(); } /** * Return a {@link String} representation of the given list of values. *

* 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 parseList(String str, int item) { if (str == null) { return null; } if (item >= 0) { str = getItem(str, item); } List list = new ArrayList(); try { boolean inQuote = false; boolean prevIsBackSlash = false; StringBuilder builder = new StringBuilder(); for (int i = 0; i < str.length(); i++) { char car = str.charAt(i); if (prevIsBackSlash) { // We don't process it here builder.append(car); prevIsBackSlash = false; } else { switch (car) { case '"': // We don't process it here builder.append(car); if (inQuote) { list.add(unescape(builder.toString())); builder.setLength(0); } inQuote = !inQuote; break; case '^': // We don't process it here builder.append(car); prevIsBackSlash = true; break; case ' ': case '\n': case '\r': if (inQuote) { builder.append(car); } break; case ',': if (!inQuote) { break; } // continue to default default: if (!inQuote) { // Bad format! return null; } builder.append(car); break; } } } if (inQuote || prevIsBackSlash) { // Bad format! return null; } } catch (Exception e) { return null; } return list; } /** * Return a {@link String} representation of the given list of values. *

* NULL will be assimilated to an empty {@link String} if later non-null * values exist, or just ignored if not. *

* Example: *

* * @param list * the input value * * @return the raw {@link String} value that correspond to it */ static public String fromList(List list) { if (list == null) { list = new ArrayList(); } int last = list.size() - 1; for (int i = 0; i < list.size(); i++) { if (list.get(i) != null) { last = i; } } StringBuilder builder = new StringBuilder(); for (int i = 0; i <= last; i++) { String item = list.get(i); if (item == null) { item = ""; } if (builder.length() > 0) { builder.append(", "); } builder.append(escape(item)); } return builder.toString(); } /** * Return a {@link String} representation of the given list of values. *

* NULL will be assimilated to an empty {@link String} if later non-null * values exist, or just ignored if not. *

* Example: *

* * @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 list, String value, int item) { if (list == null) { list = new ArrayList(); } while (item >= list.size()) { list.add(null); } list.set(item, value); return fromList(list); } /** * Return a {@link String} representation of the given list of values. *

* NULL will be assimilated to an empty {@link String} if later non-null * values exist, or just ignored if not. *

* Example: *

    *
  • 1,NULL, 3 will become 1, * "", 3
  • *
  • 1,NULL, NULL will become 1
  • *
  • NULL, NULL, NULL will become an empty 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...). *

* 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 values = parseList(value, -1); if (values != null && item < values.size()) { value = values.get(item); } } return value; } }