getValues(boolean deep);
+
+ /**
+ * Checks if this {@link ConfigurationSection} contains the given path.
+ *
+ * If the value for the requested path does not exist but a default value
+ * has been specified, this will return true.
+ *
+ * @param path Path to check for existence.
+ * @return True if this section contains the requested path, either via
+ * default or being set.
+ * @throws IllegalArgumentException Thrown when path is {@code null}.
+ */
+ boolean contains(String path);
+
+ /**
+ * Checks if this {@link ConfigurationSection} has a value set for the
+ * given path.
+ *
+ *
If the value for the requested path does not exist but a default value
+ * has been specified, this will still return false.
+ *
+ * @param path Path to check for existence.
+ * @return True if this section contains the requested path, regardless of
+ * having a default.
+ * @throws IllegalArgumentException Thrown when path is {@code null}.
+ */
+ boolean isSet(String path);
+
+ /**
+ * Gets the path of this {@link ConfigurationSection} from its root {@link
+ * Configuration}.
+ *
+ *
For any {@link Configuration} themselves, this will return an empty
+ * string.
+ *
+ *
If the section is no longer contained within its root for any reason,
+ * such as being replaced with a different value,
+ * this may return {@code null}.
+ *
+ *
To retrieve the single name of this section, that is, the final part
+ * of the path returned by this method, you may use {@link #getName()}.
+ *
+ * @return Path of this section relative to its root
+ */
+ String getCurrentPath();
+
+ /**
+ * Gets the name of this individual {@link ConfigurationSection}, in the
+ * path.
+ *
+ *
This will always be the final part of {@link #getCurrentPath()}, unless
+ * the section is orphaned.
+ *
+ * @return Name of this section
+ */
+ String getName();
+
+ /**
+ * Gets the root {@link Configuration} that contains this {@link
+ * ConfigurationSection}
+ *
+ *
For any {@link Configuration} themselves, this will return its own
+ * object.
+ *
+ *
If the section is no longer contained within its root for any reason,
+ * such as being replaced with a different value,
+ * this may return {@code null}.
+ *
+ * @return Root configuration containing this section.
+ */
+ Configuration getRoot();
+
+ /**
+ * Gets the parent {@link ConfigurationSection} that directly contains
+ * this {@link ConfigurationSection}.
+ *
+ *
For any {@link Configuration} themselves, this will return
+ * {@code null}.
+ *
+ *
If the section is no longer contained within its parent for any
+ * reason, such as being replaced with a different value, this may
+ * return {@code null}.
+ *
+ * @return Parent section containing this section.
+ */
+ ConfigurationSection getParent();
+
+ /**
+ * Gets the requested Object by path.
+ *
+ *
If the Object does not exist but a default value has been specified,
+ * this will return the default value. If the Object does not exist and no
+ * default value was specified, this will return {@code null}.
+ *
+ * @param path Path of the Object to get.
+ * @return Requested Object.
+ */
+ Object get(String path);
+
+ /**
+ * Gets the requested Object by path, returning a default value if not
+ * found.
+ *
+ *
If the Object does not exist then the specified default value will
+ * returned regardless of if a default has been identified in the root
+ * {@link Configuration}.
+ *
+ * @param path Path of the Object to get.
+ * @param defaultValue The default value to return if the path is not found.
+ * @return Requested Object.
+ */
+ Object get(String path, Object defaultValue);
+
+ /**
+ * Sets the specified path to the given value.
+ *
+ *
If value is {@code null}, the entry will be removed. Any
+ * existing entry will be replaced, regardless of what the new value is.
+ *
+ *
Some implementations may have limitations on what you may store. See
+ * their individual javadoc for details. No implementations should allow
+ * you to store {@link Configuration}s or {@link ConfigurationSection}s,
+ * please use {@link #createSection(String)} for that.
+ *
+ * @param path Path of the object to set.
+ * @param value New value to set the path to.
+ */
+ void set(String path, Object value);
+
+ /**
+ * Creates an empty {@link ConfigurationSection} at the specified path.
+ *
+ *
Any value that was previously set at this path will be overwritten. If
+ * the previous value was itself a {@link ConfigurationSection}, it will
+ * be orphaned.
+ *
+ * @param path Path to create the section at.
+ * @return Newly created section
+ */
+ ConfigurationSection createSection(String path);
+
+ /**
+ * Creates a {@link ConfigurationSection} at the specified path, with
+ * specified values.
+ *
+ *
Any value that was previously set at this path will be overwritten. If
+ * the previous value was itself a {@link ConfigurationSection}, it will
+ * be orphaned.
+ *
+ * @param path Path to create the section at.
+ * @param map The values to used.
+ * @return Newly created section
+ */
+ ConfigurationSection createSection(String path, Map map);
+
+ // Primitives
+
+ /**
+ * Gets the requested String by path.
+ *
+ *
If the String does not exist but a default value has been specified,
+ * this will return the default value. If the String does not exist and no
+ * default value was specified, this will return {@code null}.
+ *
+ * @param path Path of the String to get.
+ * @return Requested String.
+ */
+ String getString(String path);
+
+ /**
+ * Gets the requested String by path, returning a default value if not
+ * found.
+ *
+ *
If the String does not exist then the specified default value will
+ * returned regardless of if a default has been identified in the root
+ * {@link Configuration}.
+ *
+ * @param path Path of the String to get.
+ * @param def The default value to return if the path is not found or is
+ * not a String.
+ * @return Requested String.
+ */
+ String getString(String path, String def);
+
+ /**
+ * Checks if the specified path is a String.
+ *
+ *
If the path exists but is not a String, this will return false. If
+ * the path does not exist, this will return false. If the path does not
+ * exist but a default value has been specified, this will check if that
+ * defaultvalue is a String and return appropriately.
+ *
+ * @param path Path of the String to check.
+ * @return Whether or not the specified path is a String.
+ */
+ boolean isString(String path);
+
+ /**
+ * Gets the requested int by path.
+ *
+ *
If the int does not exist but a default value has been specified, this
+ * will return the default value. If the int does not exist and no default
+ * value was specified, this will return 0.
+ *
+ * @param path Path of the int to get.
+ * @return Requested int.
+ */
+ int getInt(String path);
+
+ /**
+ * Gets the requested int by path, returning a default value if not found.
+ *
+ *
If the int does not exist then the specified default value will
+ * returned regardless of if a default has been identified in the root
+ * {@link Configuration}.
+ *
+ * @param path Path of the int to get.
+ * @param def The default value to return if the path is not found or is
+ * not an int.
+ * @return Requested int.
+ */
+ int getInt(String path, int def);
+
+ /**
+ * Checks if the specified path is an int.
+ *
+ *
If the path exists but is not a int, this will return false. If the
+ * path does not exist, this will return false. If the path does not exist
+ * but a default value has been specified, this will check if that default
+ * value is a int and return appropriately.
+ *
+ * @param path Path of the int to check.
+ * @return Whether or not the specified path is an int.
+ */
+ boolean isInt(String path);
+
+ /**
+ * Gets the requested boolean by path.
+ *
+ *
If the boolean does not exist but a default value has been specified,
+ * this will return the default value. If the boolean does not exist and
+ * no default value was specified, this will return false.
+ *
+ * @param path Path of the boolean to get.
+ * @return Requested boolean.
+ */
+ boolean getBoolean(String path);
+
+ /**
+ * Gets the requested boolean by path, returning a default value if not
+ * found.
+ *
+ *
If the boolean does not exist then the specified default value will
+ * returned regardless of if a default has been identified in the root
+ * {@link Configuration}.
+ *
+ * @param path Path of the boolean to get.
+ * @param defaultValue The default value to return if the path is not found or is
+ * not a boolean.
+ * @return Requested boolean.
+ */
+ boolean getBoolean(String path, boolean defaultValue);
+
+ /**
+ * Checks if the specified path is a boolean.
+ *
+ *
If the path exists but is not a boolean, this will return false. If the
+ * path does not exist, this will return false. If the path does not exist
+ * but a default value has been specified, this will check if that default
+ * value is a boolean and return appropriately.
+ *
+ * @param path Path of the boolean to check.
+ * @return Whether or not the specified path is a boolean.
+ */
+ boolean isBoolean(String path);
+
+ /**
+ * Gets the requested double by path.
+ *
+ *
If the double does not exist but a default value has been specified,
+ * this will return the default value. If the double does not exist and no
+ * default value was specified, this will return 0.
+ *
+ * @param path Path of the double to get.
+ * @return Requested double.
+ */
+ double getDouble(String path);
+
+ /**
+ * Gets the requested double by path, returning a default value if not
+ * found.
+ *
+ *
If the double does not exist then the specified default value will
+ * returned regardless of if a default has been identified in the root
+ * {@link Configuration}.
+ *
+ * @param path Path of the double to get.
+ * @param defaultValue The default value to return if the path is not found or is
+ * not a double.
+ * @return Requested double.
+ */
+ double getDouble(String path, double defaultValue);
+
+ /**
+ * Checks if the specified path is a double.
+ *
+ *
If the path exists but is not a double, this will return false. If the
+ * path does not exist, this will return false. If the path does not exist
+ * but a default value has been specified, this will check if that default
+ * value is a double and return appropriately.
+ *
+ * @param path Path of the double to check.
+ * @return Whether or not the specified path is a double.
+ */
+ boolean isDouble(String path);
+
+ /**
+ * Gets the requested long by path.
+ *
+ *
If the long does not exist but a default value has been specified, this
+ * will return the default value. If the long does not exist and no
+ * default value was specified, this will return 0.
+ *
+ * @param path Path of the long to get.
+ * @return Requested long.
+ */
+ long getLong(String path);
+
+ /**
+ * Gets the requested long by path, returning a default value if not
+ * found.
+ *
+ *
If the long does not exist then the specified default value will
+ * returned regardless of if a default has been identified in the root
+ * {@link Configuration}.
+ *
+ * @param path Path of the long to get.
+ * @param def The default value to return if the path is not found or is
+ * not a long.
+ * @return Requested long.
+ */
+ long getLong(String path, long def);
+
+ /**
+ * Checks if the specified path is a long.
+ *
+ *
If the path exists but is not a long, this will return false. If the
+ * path does not exist, this will return false. If the path does not exist
+ * but a default value has been specified, this will check if that default
+ * value is a long and return appropriately.
+ *
+ * @param path Path of the long to check.
+ * @return Whether or not the specified path is a long.
+ */
+ boolean isLong(String path);
+
+ // Java
+
+ /**
+ * Gets the requested List by path.
+ *
+ *
If the List does not exist but a default value has been specified, this
+ * will return the default value. If the List does not exist and no
+ * default value was specified, this will return null.
+ *
+ * @param path Path of the List to get.
+ * @return Requested List.
+ */
+ List getList(String path);
+
+ /**
+ * Gets the requested List by path, returning a default value if not
+ * found.
+ *
+ *
If the List does not exist then the specified default value will
+ * returned regardless of if a default has been identified in the root
+ * {@link Configuration}.
+ *
+ * @param path Path of the List to get.
+ * @param def The default value to return if the path is not found or is
+ * not a List.
+ * @return Requested List.
+ */
+ List getList(String path, List def);
+
+ /**
+ * Checks if the specified path is a List.
+ *
+ *
If the path exists but is not a List, this will return false. If the
+ * path does not exist, this will return false. If the path does not exist
+ * but a default value has been specified, this will check if that default
+ * value is a List and return appropriately.
+ *
+ * @param path Path of the List to check.
+ * @return Whether or not the specified path is a List.
+ */
+ boolean isList(String path);
+
+ /**
+ * Gets the requested List of String by path.
+ *
+ *
If the List does not exist but a default value has been specified,
+ * this will return the default value. If the List does not exist and no
+ * default value was specified, this will return an empty List.
+ *
+ *
This method will attempt to cast any values into a String if possible,
+ * but may miss any values out if they are not compatible.
+ *
+ * @param path Path of the List to get.
+ * @return Requested List of String.
+ */
+ List getStringList(String path);
+
+ /**
+ * Gets the requested List of Integer by path.
+ *
+ * If the List does not exist but a default value has been specified,
+ * this will return the default value. If the List does not exist and no
+ * default value was specified, this will return an empty List.
+ *
+ *
This method will attempt to cast any values into a Integer if
+ * possible, but may miss any values out if they are not compatible.
+ *
+ * @param path Path of the List to get.
+ * @return Requested List of Integer.
+ */
+ List getIntegerList(String path);
+
+ /**
+ * Gets the requested List of Boolean by path.
+ *
+ * If the List does not exist but a default value has been specified,
+ * this will return the default value. If the List does not exist and no
+ * default value was specified, this will return an empty List.
+ *
+ *
This method will attempt to cast any values into a Boolean if
+ * possible, but may miss any values out if they are not compatible.
+ *
+ * @param path Path of the List to get.
+ * @return Requested List of Boolean.
+ */
+ List getBooleanList(String path);
+
+ /**
+ * Gets the requested List of Double by path.
+ *
+ * If the List does not exist but a default value has been specified,
+ * this will return the default value. If the List does not exist and no
+ * default value was specified, this will return an empty List.
+ *
+ *
This method will attempt to cast any values into a Double if possible,
+ * but may miss any values out if they are not compatible.
+ *
+ * @param path Path of the List to get.
+ * @return Requested List of Double.
+ */
+ List getDoubleList(String path);
+
+ /**
+ * Gets the requested List of Float by path.
+ *
+ * If the List does not exist but a default value has been specified,
+ * this will return the default value. If the List does not exist and no
+ * default value was specified, this will return an empty List.
+ *
+ *
This method will attempt to cast any values into a Float if possible,
+ * but may miss any values out if they are not compatible.
+ *
+ * @param path Path of the List to get.
+ * @return Requested List of Float.
+ */
+ List getFloatList(String path);
+
+ /**
+ * Gets the requested List of Long by path.
+ *
+ *
+ 
+ 
+