|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface ConfigurationSection
Represents a section of a Configuration
Method Summary | |
---|---|
void |
addDefault(String path,
Object value)
Sets the default value in the root at the given path as provided. |
boolean |
contains(String path)
Checks if this ConfigurationSection contains the given path. |
ConfigurationSection |
createSection(String path)
Creates an empty ConfigurationSection at the specified path. |
ConfigurationSection |
createSection(String path,
Map<?,?> map)
Creates a ConfigurationSection at the specified path, with specified values. |
Object |
get(String path)
Gets the requested Object by path. |
Object |
get(String path,
Object def)
Gets the requested Object by path, returning a default value if not found. |
boolean |
getBoolean(String path)
Gets the requested boolean by path. |
boolean |
getBoolean(String path,
boolean def)
Gets the requested boolean by path, returning a default value if not found. |
List<Boolean> |
getBooleanList(String path)
Gets the requested List of Boolean by path. |
List<Byte> |
getByteList(String path)
Gets the requested List of Byte by path. |
List<Character> |
getCharacterList(String path)
Gets the requested List of Character by path. |
Color |
getColor(String path)
Gets the requested Color by path. |
Color |
getColor(String path,
Color def)
Gets the requested Color by path, returning a default value if not found. |
ConfigurationSection |
getConfigurationSection(String path)
Gets the requested ConfigurationSection by path. |
String |
getCurrentPath()
Gets the path of this ConfigurationSection from its root Configuration
For any Configuration themselves, this will return an empty string. |
ConfigurationSection |
getDefaultSection()
Gets the equivalent ConfigurationSection from the default Configuration defined in getRoot() . |
double |
getDouble(String path)
Gets the requested double by path. |
double |
getDouble(String path,
double def)
Gets the requested double by path, returning a default value if not found. |
List<Double> |
getDoubleList(String path)
Gets the requested List of Double by path. |
List<Float> |
getFloatList(String path)
Gets the requested List of Float by path. |
int |
getInt(String path)
Gets the requested int by path. |
int |
getInt(String path,
int def)
Gets the requested int by path, returning a default value if not found. |
List<Integer> |
getIntegerList(String path)
Gets the requested List of Integer by path. |
ItemStack |
getItemStack(String path)
Gets the requested ItemStack by path. |
ItemStack |
getItemStack(String path,
ItemStack def)
Gets the requested ItemStack by path, returning a default value if not found. |
Set<String> |
getKeys(boolean deep)
Gets a set containing all keys in this section. |
List<?> |
getList(String path)
Gets the requested List by path. |
List<?> |
getList(String path,
List<?> def)
Gets the requested List by path, returning a default value if not found. |
long |
getLong(String path)
Gets the requested long by path. |
long |
getLong(String path,
long def)
Gets the requested long by path, returning a default value if not found. |
List<Long> |
getLongList(String path)
Gets the requested List of Long by path. |
List<Map<?,?>> |
getMapList(String path)
Gets the requested List of Maps by path. |
String |
getName()
Gets the name of this individual ConfigurationSection , in the path. |
OfflinePlayer |
getOfflinePlayer(String path)
Gets the requested OfflinePlayer by path. |
OfflinePlayer |
getOfflinePlayer(String path,
OfflinePlayer def)
Gets the requested OfflinePlayer by path, returning a default value if not found. |
ConfigurationSection |
getParent()
Gets the parent ConfigurationSection that directly contains this
ConfigurationSection . |
Configuration |
getRoot()
Gets the root Configuration that contains this ConfigurationSection
For any Configuration themselves, this will return its own object. |
List<Short> |
getShortList(String path)
Gets the requested List of Short by path. |
String |
getString(String path)
Gets the requested String by path. |
String |
getString(String path,
String def)
Gets the requested String by path, returning a default value if not found. |
List<String> |
getStringList(String path)
Gets the requested List of String by path. |
Map<String,Object> |
getValues(boolean deep)
Gets a Map containing all keys and their values for this section. |
Vector |
getVector(String path)
Gets the requested Vector by path. |
Vector |
getVector(String path,
Vector def)
Gets the requested Vector by path, returning a default value if not found. |
boolean |
isBoolean(String path)
Checks if the specified path is a boolean. |
boolean |
isColor(String path)
Checks if the specified path is a Color. |
boolean |
isConfigurationSection(String path)
Checks if the specified path is a ConfigurationSection. |
boolean |
isDouble(String path)
Checks if the specified path is a double. |
boolean |
isInt(String path)
Checks if the specified path is an int. |
boolean |
isItemStack(String path)
Checks if the specified path is an ItemStack. |
boolean |
isList(String path)
Checks if the specified path is a List. |
boolean |
isLong(String path)
Checks if the specified path is a long. |
boolean |
isOfflinePlayer(String path)
Checks if the specified path is an OfflinePlayer. |
boolean |
isSet(String path)
Checks if this ConfigurationSection has a value set for the given path. |
boolean |
isString(String path)
Checks if the specified path is a String. |
boolean |
isVector(String path)
Checks if the specified path is a Vector. |
void |
set(String path,
Object value)
Sets the specified path to the given value. |
Method Detail |
---|
Set<String> getKeys(boolean deep)
ConfigurationSection
s (and their children, etc). These will be in a
valid path notation for you to use.
If deep is set to false, then this will contain only the keys of any direct children,
and not their own children.
deep
- Whether or not to get a deep list, as opposed to a shallow list.
Map<String,Object> getValues(boolean deep)
ConfigurationSection
s (and their children, etc). These
keys will be in a valid path notation for you to use.
If deep is set to false, then this will contain only the keys and values of any
direct children, and not their own children.
deep
- Whether or not to get a deep list, as opposed to a shallow list.
boolean contains(String path)
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.
path
- Path to check for existence.
IllegalArgumentException
- Thrown when path is null.boolean isSet(String path)
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.
path
- Path to check for existence.
IllegalArgumentException
- Thrown when path is null.String getCurrentPath()
ConfigurationSection
from its root Configuration
For any 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 null.
To retrieve the single name of this section, that is, the final part of the path
returned by this method, you may use getName()
.
String getName()
ConfigurationSection
, in the path.
This will always be the final part of getCurrentPath()
, unless the
section is orphaned.
Configuration getRoot()
Configuration
that contains this ConfigurationSection
For any 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 null.
ConfigurationSection getParent()
ConfigurationSection
that directly contains this
ConfigurationSection
.
For any Configuration
themselves, this will return 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 null.
Object get(String path)
path
- Path of the Object to get.
Object get(String path, Object def)
Configuration
.
path
- Path of the Object to get.def
- The default value to return if the path is not found.
void set(String path, Object value)
Configuration
s or ConfigurationSection
s, please use
createSection(java.lang.String)
for that.
path
- Path of the object to set.value
- New value to set the path to.ConfigurationSection createSection(String path)
ConfigurationSection
at the specified path.
Any value that was previously set at this path will be overwritten. If the
previous value was itself a ConfigurationSection
, it will be orphaned.
path
- Path to create the section at.
ConfigurationSection createSection(String path, Map<?,?> map)
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 ConfigurationSection
, it will be orphaned.
path
- Path to create the section at.map
- The values to used.
String getString(String path)
path
- Path of the String to get.
String getString(String path, String def)
Configuration
.
path
- Path of the String to get.def
- The default value to return if the path is not found or is not a String.
boolean isString(String path)
path
- Path of the String to check.
int getInt(String path)
path
- Path of the int to get.
int getInt(String path, int def)
Configuration
.
path
- Path of the int to get.def
- The default value to return if the path is not found or is not an int.
boolean isInt(String path)
path
- Path of the int to check.
boolean getBoolean(String path)
path
- Path of the boolean to get.
boolean getBoolean(String path, boolean def)
Configuration
.
path
- Path of the boolean to get.def
- The default value to return if the path is not found or is not a boolean.
boolean isBoolean(String path)
path
- Path of the boolean to check.
double getDouble(String path)
path
- Path of the double to get.
double getDouble(String path, double def)
Configuration
.
path
- Path of the double to get.def
- The default value to return if the path is not found or is not a double.
boolean isDouble(String path)
path
- Path of the double to check.
long getLong(String path)
path
- Path of the long to get.
long getLong(String path, long def)
Configuration
.
path
- Path of the long to get.def
- The default value to return if the path is not found or is not a long.
boolean isLong(String path)
path
- Path of the long to check.
List<?> getList(String path)
path
- Path of the List to get.
List<?> getList(String path, List<?> def)
Configuration
.
path
- Path of the List to get.def
- The default value to return if the path is not found or is not a List.
boolean isList(String path)
path
- Path of the List to check.
List<String> getStringList(String path)
path
- Path of the List to get.
List<Integer> getIntegerList(String path)
path
- Path of the List to get.
List<Boolean> getBooleanList(String path)
path
- Path of the List to get.
List<Double> getDoubleList(String path)
path
- Path of the List to get.
List<Float> getFloatList(String path)
path
- Path of the List to get.
List<Long> getLongList(String path)
path
- Path of the List to get.
List<Byte> getByteList(String path)
path
- Path of the List to get.
List<Character> getCharacterList(String path)
path
- Path of the List to get.
List<Short> getShortList(String path)
path
- Path of the List to get.
List<Map<?,?>> getMapList(String path)
path
- Path of the List to get.
Vector getVector(String path)
path
- Path of the Vector to get.
Vector getVector(String path, Vector def)
Vector
by path, returning a default value if not found.
If the Vector does not exist then the specified default value will returned
regardless of if a default has been identified in the root Configuration
.
path
- Path of the Vector to get.def
- The default value to return if the path is not found or is not a Vector.
boolean isVector(String path)
path
- Path of the Vector to check.
OfflinePlayer getOfflinePlayer(String path)
path
- Path of the OfflinePlayer to get.
OfflinePlayer getOfflinePlayer(String path, OfflinePlayer def)
OfflinePlayer
by path, returning a default value if not found.
If the OfflinePlayer does not exist then the specified default value will returned
regardless of if a default has been identified in the root Configuration
.
path
- Path of the OfflinePlayer to get.def
- The default value to return if the path is not found or is not an OfflinePlayer.
boolean isOfflinePlayer(String path)
path
- Path of the OfflinePlayer to check.
ItemStack getItemStack(String path)
path
- Path of the ItemStack to get.
ItemStack getItemStack(String path, ItemStack def)
ItemStack
by path, returning a default value if not found.
If the ItemStack does not exist then the specified default value will returned
regardless of if a default has been identified in the root Configuration
.
path
- Path of the ItemStack to get.def
- The default value to return if the path is not found or is not an ItemStack.
boolean isItemStack(String path)
path
- Path of the ItemStack to check.
Color getColor(String path)
path
- Path of the Color to get.
Color getColor(String path, Color def)
Color
by path, returning a default value if not found.
If the Color does not exist then the specified default value will returned
regardless of if a default has been identified in the root Configuration
.
path
- Path of the Color to get.def
- The default value to return if the path is not found or is not an Color.
boolean isColor(String path)
path
- Path of the Color to check.
ConfigurationSection getConfigurationSection(String path)
path
- Path of the ConfigurationSection to get.
boolean isConfigurationSection(String path)
path
- Path of the ConfigurationSection to check.
ConfigurationSection getDefaultSection()
ConfigurationSection
from the default Configuration
defined in getRoot()
.
If the root contains no defaults, or the defaults doesn't contain a value
for this path, or the value at this path is not a ConfigurationSection
then
this will return null.
void addDefault(String path, Object value)
Configuration
was provided as a default collection,
then a new MemoryConfiguration
will be created to hold the new default
value.
If value is null, the value will be removed from the default Configuration source.
If the value as returned by getDefaultSection()
is null,
then this will create a new section at the path, replacing anything that
may have existed there previously.
path
- Path of the value to set.value
- Value to set the default to.
IllegalArgumentException
- Thrown if path is null.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |