X-Git-Url: http://git.nikiroo.be/?a=blobdiff_plain;f=src%2Fbe%2Fnikiroo%2Futils%2Fresources%2FMetaInfo.java;h=15ff762b9e3cd80d3a1777c912ecec505840c0dc;hb=35425f123ac142890223e0e62df8dcdc2acfe660;hp=3a6e71ae1571469a421c216761ae7208b98ff675;hpb=9e834013f84e8797acf26f5418ae3448044ad097;p=fanfix.git

diff --git a/src/be/nikiroo/utils/resources/MetaInfo.java b/src/be/nikiroo/utils/resources/MetaInfo.java
index 3a6e71a..15ff762 100644
--- a/src/be/nikiroo/utils/resources/MetaInfo.java
+++ b/src/be/nikiroo/utils/resources/MetaInfo.java
@@ -1,6 +1,7 @@
 package be.nikiroo.utils.resources;
 
 import java.util.ArrayList;
+import java.util.Iterator;
 import java.util.List;
 
 import be.nikiroo.utils.resources.Meta.Format;
@@ -14,18 +15,33 @@ import be.nikiroo.utils.resources.Meta.Format;
  * @param <E>
  *            the type of {@link Bundle} to edit
  */
-public class MetaInfo<E extends Enum<E>> {
+public class MetaInfo<E extends Enum<E>> implements Iterable<MetaInfo<E>> {
 	private final Bundle<E> bundle;
 	private final E id;
 
 	private Meta meta;
+	private List<MetaInfo<E>> children = new ArrayList<MetaInfo<E>>();
 
 	private String value;
-	private List<Runnable> reloadListeners = new ArrayList<Runnable>();
+	private List<Runnable> reloadedListeners = new ArrayList<Runnable>();
+	private List<Runnable> saveListeners = new ArrayList<Runnable>();
 
 	private String name;
 	private String description;
 
+	/**
+	 * Create a new {@link MetaInfo} from a value (without children).
+	 * <p>
+	 * For instance, you can call
+	 * <tt>new MetaInfo(Config.class, configBundle, Config.MY_VALUE)</tt>.
+	 * 
+	 * @param type
+	 *            the type of enum the value is
+	 * @param bundle
+	 *            the bundle this value belongs to
+	 * @param id
+	 *            the value itself
+	 */
 	public MetaInfo(Class<E> type, Bundle<E> bundle, E id) {
 		this.bundle = bundle;
 		this.id = id;
@@ -49,8 +65,14 @@ public class MetaInfo<E extends Enum<E>> {
 
 		if (description == null) {
 			description = meta.description();
+			if (description == null) {
+				description = "";
+			}
 			if (meta.info() != null && !meta.info().isEmpty()) {
-				description += "\n" + meta.info();
+				if (!description.isEmpty()) {
+					description += "\n\n";
+				}
+				description += meta.info();
 			}
 		}
 
@@ -67,7 +89,7 @@ public class MetaInfo<E extends Enum<E>> {
 	}
 
 	/**
-	 * THe name of this item, deduced from its ID.
+	 * The name of this item, deduced from its ID.
 	 * <p>
 	 * In other words, it is the ID but presented in a displayable form.
 	 * 
@@ -86,10 +108,53 @@ public class MetaInfo<E extends Enum<E>> {
 		return description;
 	}
 
+	/**
+	 * The format this item is supposed to follow
+	 * 
+	 * @return the format
+	 */
 	public Format getFormat() {
 		return meta.format();
 	}
 
+	/**
+	 * The allowed list of values that a {@link Format#FIXED_LIST} item is
+	 * allowed to be, or a list of suggestions for {@link Format#COMBO_LIST}
+	 * items.
+	 * 
+	 * @return the list of values
+	 */
+	public String[] getAllowedValues() {
+		return meta.list();
+	}
+
+	/**
+	 * This item is a comma-separated list of values instead of a single value.
+	 * <p>
+	 * The list items are separated by a comma, each surrounded by
+	 * double-quotes, with backslashes and double-quotes escaped by a backslash.
+	 * <p>
+	 * Example: <tt>"un", "deux"</tt>
+	 * 
+	 * @return TRUE if it is
+	 */
+	public boolean isArray() {
+		return meta.array();
+	}
+
+	/**
+	 * This item is only used as a group, not as an option.
+	 * <p>
+	 * For instance, you could have LANGUAGE_CODE as a group for which you won't
+	 * use the value in the program, and LANGUAGE_CODE_FR, LANGUAGE_CODE_EN
+	 * inside for which the value must be set.
+	 * 
+	 * @return TRUE if it is a group
+	 */
+	public boolean isGroup() {
+		return meta.group();
+	}
+
 	/**
 	 * The value stored by this item, as a {@link String}.
 	 * 
@@ -99,46 +164,113 @@ public class MetaInfo<E extends Enum<E>> {
 		return value;
 	}
 
+	/**
+	 * The default value of this item, as a {@link String}.
+	 * 
+	 * @return the default value
+	 */
 	public String getDefaultString() {
 		return meta.def();
 	}
 
+	/**
+	 * The value stored by this item, as a {@link Boolean}.
+	 * 
+	 * @return the value
+	 */
 	public Boolean getBoolean() {
 		return BundleHelper.parseBoolean(getString());
 	}
 
+	/**
+	 * The default value of this item, as a {@link Boolean}.
+	 * 
+	 * @return the default value
+	 */
 	public Boolean getDefaultBoolean() {
 		return BundleHelper.parseBoolean(getDefaultString());
 	}
 
+	/**
+	 * The value stored by this item, as a {@link Character}.
+	 * 
+	 * @return the value
+	 */
 	public Character getCharacter() {
 		return BundleHelper.parseCharacter(getString());
 	}
 
+	/**
+	 * The default value of this item, as a {@link Character}.
+	 * 
+	 * @return the default value
+	 */
 	public Character getDefaultCharacter() {
 		return BundleHelper.parseCharacter(getDefaultString());
 	}
 
+	/**
+	 * The value stored by this item, as an {@link Integer}.
+	 * 
+	 * @return the value
+	 */
 	public Integer getInteger() {
 		return BundleHelper.parseInteger(getString());
 	}
 
+	/**
+	 * The default value of this item, as an {@link Integer}.
+	 * 
+	 * @return the default value
+	 */
 	public Integer getDefaultInteger() {
 		return BundleHelper.parseInteger(getDefaultString());
 	}
 
+	/**
+	 * The value stored by this item, as 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.
+	 * 
+	 * @return the value
+	 */
 	public Integer getColor() {
 		return BundleHelper.parseColor(getString());
 	}
 
+	/**
+	 * The default value stored by this item, as 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.
+	 * 
+	 * @return the value
+	 */
 	public Integer getDefaultColor() {
 		return BundleHelper.parseColor(getDefaultString());
 	}
 
+	/**
+	 * A {@link String} representation of the list of values.
+	 * <p>
+	 * The list of values is comma-separated and each value is surrounded by
+	 * double-quotes; backslashes and double-quotes are escaped by a backslash.
+	 * 
+	 * @return the value
+	 */
 	public List<String> getList() {
 		return BundleHelper.parseList(getString());
 	}
 
+	/**
+	 * A {@link String} representation of the default list of values.
+	 * <p>
+	 * The list of values is comma-separated and each value is surrounded by
+	 * double-quotes; backslashes and double-quotes are escaped by a backslash.
+	 * 
+	 * @return the value
+	 */
 	public List<String> getDefaultList() {
 		return BundleHelper.parseList(getDefaultString());
 	}
@@ -153,32 +285,70 @@ public class MetaInfo<E extends Enum<E>> {
 		this.value = value;
 	}
 
+	/**
+	 * The value stored by this item, as a {@link Boolean}.
+	 * 
+	 * @param value
+	 *            the new value
+	 */
 	public void setBoolean(boolean value) {
 		setString(BundleHelper.fromBoolean(value));
 	}
 
+	/**
+	 * The value stored by this item, as a {@link Character}.
+	 * 
+	 * @param value
+	 *            the new value
+	 */
 	public void setCharacter(char value) {
 		setString(BundleHelper.fromCharacter(value));
 	}
 
+	/**
+	 * The value stored by this item, as an {@link Integer}.
+	 * 
+	 * @param value
+	 *            the new value
+	 */
 	public void setInteger(int value) {
 		setString(BundleHelper.fromInteger(value));
 	}
 
+	/**
+	 * The value stored by this item, as 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 value
+	 *            the value
+	 */
 	public void setColor(int value) {
 		setString(BundleHelper.fromColor(value));
 	}
 
+	/**
+	 * A {@link String} representation of the default list of values.
+	 * <p>
+	 * The list of values is comma-separated and each value is surrounded by
+	 * double-quotes; backslashes and double-quotes are escaped by a backslash.
+	 * 
+	 * @param value
+	 *            the {@link String} representation
+	 * 
+	 */
 	public void setList(List<String> value) {
 		setString(BundleHelper.fromList(value));
 	}
 
 	/**
-	 * Reload the value from the {@link Bundle}.
+	 * Reload the value from the {@link Bundle}, so the last value that was
+	 * saved will be used.
 	 */
 	public void reload() {
 		value = bundle.getString(id);
-		for (Runnable listener : reloadListeners) {
+		for (Runnable listener : reloadedListeners) {
 			try {
 				listener.run();
 			} catch (Exception e) {
@@ -188,17 +358,70 @@ public class MetaInfo<E extends Enum<E>> {
 		}
 	}
 
-	public void addReloadListener(Runnable listener) {
-		reloadListeners.add(listener);
+	/**
+	 * Add a listener that will be called <b>after</b> a reload operation.
+	 * <p>
+	 * You could use it to refresh the UI for instance.
+	 * 
+	 * @param listener
+	 *            the listener
+	 */
+	public void addReloadedListener(Runnable listener) {
+		reloadedListeners.add(listener);
 	}
 
 	/**
 	 * Save the current value to the {@link Bundle}.
 	 */
 	public void save() {
+		for (Runnable listener : saveListeners) {
+			try {
+				listener.run();
+			} catch (Exception e) {
+				// TODO: error management?
+				e.printStackTrace();
+			}
+		}
 		bundle.setString(id, value);
 	}
 
+	/**
+	 * Add a listener that will be called <b>before</b> a save operation.
+	 * <p>
+	 * You could use it to make some modification to the stored value before it
+	 * is saved.
+	 * 
+	 * @param listener
+	 *            the listener
+	 */
+	public void addSaveListener(Runnable listener) {
+		saveListeners.add(listener);
+	}
+
+	/**
+	 * The sub-items if any (if no sub-items, will return an empty list).
+	 * <p>
+	 * Sub-items are declared when a {@link Meta} has an ID that starts with the
+	 * ID of a {@link Meta#group()} {@link MetaInfo}.
+	 * <p>
+	 * For instance:
+	 * <ul>
+	 * <li>{@link Meta} <tt>MY_PREFIX</tt> is a {@link Meta#group()}</li>
+	 * <li>{@link Meta} <tt>MY_PREFIX_DESCRIPTION</tt> is another {@link Meta}</li>
+	 * <li><tt>MY_PREFIX_DESCRIPTION</tt> will be a child of <tt>MY_PREFIX</tt></li>
+	 * </ul>
+	 * 
+	 * @return the sub-items if any
+	 */
+	public List<MetaInfo<E>> getChildren() {
+		return children;
+	}
+
+	@Override
+	public Iterator<MetaInfo<E>> iterator() {
+		return children.iterator();
+	}
+
 	/**
 	 * Create a list of {@link MetaInfo}, one for each of the item in the given
 	 * {@link Bundle}.
@@ -215,12 +438,61 @@ public class MetaInfo<E extends Enum<E>> {
 	static public <E extends Enum<E>> List<MetaInfo<E>> getItems(Class<E> type,
 			Bundle<E> bundle) {
 		List<MetaInfo<E>> list = new ArrayList<MetaInfo<E>>();
+		List<MetaInfo<E>> shadow = new ArrayList<MetaInfo<E>>();
 		for (E id : type.getEnumConstants()) {
-			list.add(new MetaInfo<E>(type, bundle, id));
+			MetaInfo<E> info = new MetaInfo<E>(type, bundle, id);
+			list.add(info);
+			shadow.add(info);
+		}
+
+		for (int i = 0; i < list.size(); i++) {
+			MetaInfo<E> info = list.get(i);
+
+			MetaInfo<E> parent = findParent(info, shadow);
+			if (parent != null) {
+				list.remove(i--);
+				parent.children.add(info);
+			}
 		}
 
 		return list;
 	}
 
-	// TODO: by groups, a-là Authors/Sources
+	/**
+	 * Find the longest parent of the given {@link MetaInfo}, which means:
+	 * <ul>
+	 * <li>the parent is a {@link Meta#group()}</li>
+	 * <li>the parent Id is a substring of the Id of the given {@link MetaInfo}</li>
+	 * <li>there is no other parent sharing a substring for this
+	 * {@link MetaInfo} with a longer Id</li>
+	 * </ul>
+	 * 
+	 * @param <E>
+	 *            the kind of enum
+	 * @param info
+	 *            the info to look for a parent for
+	 * @param candidates
+	 *            the list of potential parents
+	 * 
+	 * @return the longest parent or NULL if no parent is found
+	 */
+	static private <E extends Enum<E>> MetaInfo<E> findParent(MetaInfo<E> info,
+			List<MetaInfo<E>> candidates) {
+		String id = info.id.toString();
+		MetaInfo<E> group = null;
+		for (MetaInfo<E> pcandidate : candidates) {
+			if (pcandidate.isGroup()) {
+				String candidateId = pcandidate.id.toString();
+				if (!id.equals(candidateId) && id.startsWith(candidateId)) {
+					if (group == null
+							|| group.id.toString().length() < candidateId
+									.length()) {
+						group = pcandidate;
+					}
+				}
+			}
+		}
+
+		return group;
+	}
 }