package be.nikiroo.utils.resources; import java.util.ArrayList; import java.util.Iterator; import java.util.List; import be.nikiroo.utils.resources.Meta.Format; /** * A graphical item that reflect a configuration option from the given * {@link Bundle}. * * @author niki * * @param * the type of {@link Bundle} to edit */ public class MetaInfo> implements Iterable> { private final Bundle bundle; private final E id; private Meta meta; private List> children = new ArrayList>(); private String value; private List reloadedListeners = new ArrayList(); private List saveListeners = new ArrayList(); private String name; private String description; /** * Create a new {@link MetaInfo} from a value (without children). *

* For instance, you can call * new MetaInfo(Config.class, configBundle, Config.MY_VALUE). * * @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 type, Bundle bundle, E id) { this.bundle = bundle; this.id = id; try { this.meta = type.getDeclaredField(id.name()).getAnnotation( Meta.class); } catch (NoSuchFieldException e) { } catch (SecurityException e) { } // We consider that if a description bundle is used, everything is in it String description = null; if (bundle.getDescriptionBundle() != null) { description = bundle.getDescriptionBundle().getString(id); if (description != null && description.trim().isEmpty()) { description = null; } } if (description == null) { description = meta.description(); if (description == null) { description = ""; } if (meta.info() != null && !meta.info().isEmpty()) { if (!description.isEmpty()) { description += "\n\n"; } description += meta.info(); } } String name = id.toString(); if (name.length() > 1) { name = name.substring(0, 1) + name.substring(1).toLowerCase(); name = name.replace("_", " "); } this.name = name; this.description = description; reload(); } /** * The name of this item, deduced from its ID. *

* In other words, it is the ID but presented in a displayable form. * * @return the name */ public String getName() { return name; } /** * The description of this item (information to present to the user). * * @return the description */ public String getDescription() { 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. *

* The list items are separated by a comma, each surrounded by * double-quotes, with backslashes and double-quotes escaped by a backslash. *

* Example: "un", "deux" * * @return TRUE if it is */ public boolean isArray() { return meta.array(); } /** * This item is only used as a group, not as an option. *

* 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}. * * @return the value */ public String getString() { 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. *

* 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. *

* 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. *

* 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 getList() { return BundleHelper.parseList(getString()); } /** * A {@link String} representation of the default list of values. *

* 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 getDefaultList() { return BundleHelper.parseList(getDefaultString()); } /** * The value stored by this item, as a {@link String}. * * @param value * the new value */ public void setString(String value) { 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. *

* 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. *

* 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 value) { setString(BundleHelper.fromList(value)); } /** * 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 : reloadedListeners) { try { listener.run(); } catch (Exception e) { // TODO: error management? e.printStackTrace(); } } } /** * Add a listener that will be called after a reload operation. *

* 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 before a save operation. *

* 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). *

* Sub-items are declared when a {@link Meta} has an ID that starts with the * ID of a {@link Meta#group()} {@link MetaInfo}. *

* For instance: *

    *
  • {@link Meta} MY_PREFIX is a {@link Meta#group()}
  • *
  • {@link Meta} MY_PREFIX_DESCRIPTION is another {@link Meta}
  • *
  • MY_PREFIX_DESCRIPTION will be a child of MY_PREFIX
  • *
* * @return the sub-items if any */ public List> getChildren() { return children; } @Override public Iterator> iterator() { return children.iterator(); } /** * Create a list of {@link MetaInfo}, one for each of the item in the given * {@link Bundle}. * * @param * the type of {@link Bundle} to edit * @param type * a class instance of the item type to work on * @param bundle * the {@link Bundle} to sort through * * @return the list */ static public > List> getItems(Class type, Bundle bundle) { List> list = new ArrayList>(); List> shadow = new ArrayList>(); for (E id : type.getEnumConstants()) { MetaInfo info = new MetaInfo(type, bundle, id); list.add(info); shadow.add(info); } for (int i = 0; i < list.size(); i++) { MetaInfo info = list.get(i); MetaInfo parent = findParent(info, shadow); if (parent != null) { list.remove(i--); parent.children.add(info); } } return list; } /** * Find the longest parent of the given {@link MetaInfo}, which means: *
    *
  • the parent is a {@link Meta#group()}
  • *
  • the parent Id is a substring of the Id of the given {@link MetaInfo}
  • *
  • there is no other parent sharing a substring for this * {@link MetaInfo} with a longer Id
  • *
* * @param * 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 > MetaInfo findParent(MetaInfo info, List> candidates) { String id = info.id.toString(); MetaInfo group = null; for (MetaInfo 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; } }