IOUtils: new openResource with anchor class

[fanfix.git] / resources / BundleHelper.java

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.
	 * <p>
	 * 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.
	 * <p>
	 * 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.
	 * <p>
	 * Note: null, "strange text", ""... will all be converted to NULL
	 * (remember: any {@link String} whose length is not 1 is <b>not</b> 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.
	 * <p>
	 * 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.
	 * <p>
	 * 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<String> list = parseList(raw, -1);
		if (list == null) {
			return -1;
		}

		return list.size();
	}

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

		if (item >= 0) {
			str = getItem(str, item);
		}

		List<String> list = new ArrayList<String>();
		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.
	 * <p>
	 * NULL will be assimilated to an empty {@link String} if later non-null
	 * values exist, or just ignored if not.
	 * <p>
	 * Example:
	 * <ul>
	 * <li><tt>1</tt>,<tt>NULL</tt>, <tt>3</tt> will become <tt>1</tt>,
	 * <tt>""</tt>, <tt>3</tt></li>
	 * <li><tt>1</tt>,<tt>NULL</tt>, <tt>NULL</tt> will become <tt>1</tt></li>
	 * <li><tt>NULL</tt>, <tt>NULL</tt>, <tt>NULL</tt> will become an empty list
	 * </li>
	 * </ul>
	 * 
	 * @param list
	 *            the input value
	 * 
	 * @return the raw {@link String} value that correspond to it
	 */
	static public String fromList(List<String> list) {
		if (list == null) {
			list = new ArrayList<String>();
		}

		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.
	 * <p>
	 * NULL will be assimilated to an empty {@link String} if later non-null
	 * values exist, or just ignored if not.
	 * <p>
	 * Example:
	 * <ul>
	 * <li><tt>1</tt>,<tt>NULL</tt>, <tt>3</tt> will become <tt>1</tt>,
	 * <tt>""</tt>, <tt>3</tt></li>
	 * <li><tt>1</tt>,<tt>NULL</tt>, <tt>NULL</tt> will become <tt>1</tt></li>
	 * <li><tt>NULL</tt>, <tt>NULL</tt>, <tt>NULL</tt> will become an empty list
	 * </li>
	 * </ul>
	 * 
	 * @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<String> list, String value, int item) {
		if (list == null) {
			list = new ArrayList<String>();
		}

		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.
	 * <p>
	 * NULL will be assimilated to an empty {@link String} if later non-null
	 * values exist, or just ignored if not.
	 * <p>
	 * Example:
	 * <ul>
	 * <li><tt>1</tt>,<tt>NULL</tt>, <tt>3</tt> will become <tt>1</tt>,
	 * <tt>""</tt>, <tt>3</tt></li>
	 * <li><tt>1</tt>,<tt>NULL</tt>, <tt>NULL</tt> will become <tt>1</tt></li>
	 * <li><tt>NULL</tt>, <tt>NULL</tt>, <tt>NULL</tt> will become an empty list
	 * </li>
	 * </ul>
	 * 
	 * @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...).
	 * <p>
	 * 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).
	 * <p>
	 * 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 <tt>item</tt> if found,
	 *         NULL if not
	 */
	static private String getItem(String value, int item) {
		if (item >= 0) {
			value = null;
			List<String> values = parseList(value, -1);
			if (values != null && item < values.size()) {
				value = values.get(item);
			}
		}

		return value;
	}
}