Added list support to Configuration.

This commit is contained in:
sk89q
2011-01-15 01:44:20 -08:00
parent fc63e38ea2
commit 9a1bf38b60
2 changed files with 377 additions and 166 deletions

View File

@@ -10,22 +10,49 @@ import org.yaml.snakeyaml.constructor.SafeConstructor;
import org.yaml.snakeyaml.reader.UnicodeReader;
/**
* YAML configuration loader. This class is very far from finished, as it
* only supports simple property lookup at the moment. Lists and nodes will be
* supported in the future. For specifying node paths in the various get*()
* methods, they support SK's path notation, allowing you to select child nodes
* by using syntax in the form of root.parent.child. All node names are case
* sensitive. YAML files are loaded safely and Java objects will not
* be created if they are specified in the YAML file.
* YAML configuration loader. To use this class, construct it with path to
* a file and call its load() method. For specifying node paths in the
* various get*() methods, they support SK's path notation, allowing you to
* select child nodes by delimiting node names with periods.
*
* <p>
* For example, given the following configuration file:</p>
*
* <pre>members:
* - Hollie
* - Jason
* - Bobo
* - Aya
* - Tetsu
* worldguard:
* fire:
* spread: false
* blocks: [cloth, rock, glass]
* craftbook:
* midi: true
* sturmeh:
* cool: false
* lame: true
* likes:
* cuteasianboys: true
* eats:
* babies: true</pre>
*
* <p>Calling code could access sturmeh's baby eating state by using
* <code>getBoolean("sturmeh.eats.babies", false)</code>. For lists, there are
* methods such as <code>getStringList</code> that will return a type safe list.
*
* <p>This class is currently incomplete. It is not yet possible to get a node.
* </p>
*
* @author sk89q
*/
public class Configuration {
public class Configuration extends ConfigurationNode {
private Yaml yaml = new Yaml(new SafeConstructor());
private File file;
private Map<String, Object> root;
public Configuration(File file) {
super(new HashMap<String, Object>());
this.file = file;
}
@@ -60,160 +87,4 @@ public class Configuration {
throw new ConfigurationException("Root document must be an key-value structure");
}
}
/**
* Gets a property at a location. This will either return an Object
* or null, with null meaning that no configuration value exists at
* that location. This could potentially return a default value (not yet
* implemented) as defined by a plugin, if this is a plugin-tied
* configuration.
*
* @param path SK's dot notation supported
* @return object or null
*/
@SuppressWarnings("unchecked")
public Object getProperty(String path) {
if (!path.contains(".")) {
Object val = root.get(path);
if (val == null) {
return null;
}
return val;
}
String[] parts = path.split("\\.");
Map<String, Object> node = root;
for (int i = 0; i < parts.length; i++) {
Object o = node.get(parts[i]);
if (o == null) {
return null;
}
if (i == parts.length - 1) {
return o;
}
try {
node = (Map<String, Object>)o;
} catch (ClassCastException e) {
return null;
}
}
return null;
}
/**
* Gets a string at a location. This will either return an String
* or null, with null meaning that no configuration value exists at
* that location. If the object at the particular location is not actually
* a string, it will be converted to its string representation.
*
* @param path SK's dot notation supported
* @return string or null
*/
public String getString(String path) {
Object o = getProperty(path);
if (o == null) {
return null;
}
return o.toString();
}
/**
* Gets a string at a location. This will either return an String
* or the default value. If the object at the particular location is not
* actually a string, it will be converted to its string representation.
*
* @param path SK's dot notation supported
* @param def default value
* @return string or default
*/
public String getString(String path, String def) {
String o = getString(path);
if (o == null) {
return def;
}
return o;
}
/**
* Gets an integer at a location. This will either return an integer
* or the default value. If the object at the particular location is not
* actually a integer, the default value will be returned. However, other
* number types will be casted to an integer.
*
* @param path SK's dot notation supported
* @param def default value
* @return int or default
*/
public int getInt(String path, int def) {
Object o = getProperty(path);
if (o == null) {
return def;
} else if (o instanceof Byte) {
return (Byte)o;
} else if (o instanceof Integer) {
return (Integer)o;
} else if (o instanceof Double) {
return (int)(double)(Double)o;
} else if (o instanceof Float) {
return (int)(float)(Float)o;
} else if (o instanceof Long) {
return (int)(long)(Long)o;
} else {
return def;
}
}
/**
* Gets a double at a location. This will either return an double
* or the default value. If the object at the particular location is not
* actually a double, the default value will be returned. However, other
* number types will be casted to an double.
*
* @param path SK's dot notation supported
* @param def default value
* @return double or default
*/
public double getDouble(String path, double def) {
Object o = getProperty(path);
if (o == null) {
return def;
} else if (o instanceof Float) {
return (Float)o;
} else if (o instanceof Double) {
return (Double)o;
} else if (o instanceof Byte) {
return (Byte)o;
} else if (o instanceof Integer) {
return (Integer)o;
} else if (o instanceof Long) {
return (Long)o;
} else {
return def;
}
}
/**
* Gets a boolean at a location. This will either return an boolean
* or the default value. If the object at the particular location is not
* actually a boolean, the default value will be returned.
*
* @param path SK's dot notation supported
* @param def default value
* @return boolean or default
*/
public boolean getBoolean(String path, boolean def) {
Object o = getProperty(path);
if (o == null) {
return def;
} else if (o instanceof Boolean) {
return (Boolean)o;
} else {
return def;
}
}
}