ConfigurationSection
MemoryConfiguration
public class MemorySection extends Object implements ConfigurationSection
ConfigurationSection
that is stored in memory.Modifier | Constructor | Description |
---|---|---|
protected |
MemorySection() |
Creates an empty MemorySection for use as a root
Configuration
section. |
protected |
MemorySection(ConfigurationSection parent,
String path) |
Creates an empty MemorySection with the specified parent and path.
|
Modifier and Type | Method | Description |
---|---|---|
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. |
boolean |
contains(String path,
boolean ignoreDefault) |
Checks if this
ConfigurationSection contains the given path. |
static String |
createPath(ConfigurationSection section,
String key) |
Creates a full path to the given
ConfigurationSection from its
root Configuration . |
static String |
createPath(ConfigurationSection section,
String key,
ConfigurationSection relativeTo) |
Creates a relative path to the given
ConfigurationSection from
the given relative section. |
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 |
protected Object |
getDefault(String path) |
|
ConfigurationSection |
getDefaultSection() |
Gets the equivalent
ConfigurationSection from the default
Configuration defined in ConfigurationSection.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.
|
Location |
getLocation(String path) |
Gets the requested Location by path.
|
Location |
getLocation(String path,
Location def) |
Gets the requested
Location 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. |
<T> T |
getObject(String path,
Class<T> clazz) |
Gets the requested object at the given path.
|
<T> T |
getObject(String path,
Class<T> clazz,
T def) |
Gets the requested object at the given 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
Configuration . |
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 |
<T extends ConfigurationSerializable> |
getSerializable(String path,
Class<T> clazz) |
Gets the requested
ConfigurationSerializable object at the given
path. |
<T extends ConfigurationSerializable> |
getSerializable(String path,
Class<T> clazz,
T def) |
Gets the requested
ConfigurationSerializable object at the given
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
Configuration . |
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 |
isLocation(String path) |
Checks if the specified path is a Location.
|
boolean |
isLong(String path) |
Checks if the specified path is a long.
|
boolean |
isOfflinePlayer(String path) |
Checks if the specified path is an OfflinePlayer.
|
protected boolean |
isPrimitiveWrapper(Object input) |
|
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.
|
protected void |
mapChildrenKeys(Set<String> output,
ConfigurationSection section,
boolean deep) |
|
protected void |
mapChildrenValues(Map<String,Object> output,
ConfigurationSection section,
boolean deep) |
|
void |
set(String path,
Object value) |
Sets the specified path to the given value.
|
String |
toString() |
protected MemorySection()
Configuration
section.
Note that calling this without being yourself a Configuration
will throw an exception!
IllegalStateException
- Thrown if this is not a Configuration
root.protected MemorySection(@NotNull ConfigurationSection parent, @NotNull String path)
parent
- Parent section that contains this own section.path
- Path that you may access this section from via the root
Configuration
.IllegalArgumentException
- Thrown is parent or path is null, or
if parent contains no root Configuration.@NotNull public Set<String> getKeys(boolean deep)
ConfigurationSection
If deep is set to true, then this will contain all the keys within any
child 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.
getKeys
in interface ConfigurationSection
deep
- Whether or not to get a deep list, as opposed to a shallow
list.@NotNull public Map<String,Object> getValues(boolean deep)
ConfigurationSection
If deep is set to true, then this will contain all the keys and values
within any child 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.
getValues
in interface ConfigurationSection
deep
- Whether or not to get a deep list, as opposed to a shallow
list.public boolean contains(@NotNull String path)
ConfigurationSection
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.
contains
in interface ConfigurationSection
path
- Path to check for existence.public boolean contains(@NotNull String path, boolean ignoreDefault)
ConfigurationSection
ConfigurationSection
contains the given path.
If the value for the requested path does not exist, the boolean parameter of true has been specified, a default value for the path exists, this will return true.
If a boolean parameter of false has been specified, true will only be returned if there is a set value for the specified path.
contains
in interface ConfigurationSection
path
- Path to check for existence.ignoreDefault
- Whether or not to ignore if a default value for the
specified path exists.public boolean isSet(@NotNull String path)
ConfigurationSection
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.
isSet
in interface ConfigurationSection
path
- Path to check for existence.@NotNull public String getCurrentPath()
ConfigurationSection
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 ConfigurationSection.getName()
.
getCurrentPath
in interface ConfigurationSection
@NotNull public String getName()
ConfigurationSection
ConfigurationSection
, in the
path.
This will always be the final part of ConfigurationSection.getCurrentPath()
, unless
the section is orphaned.
getName
in interface ConfigurationSection
@Nullable public Configuration getRoot()
ConfigurationSection
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.
getRoot
in interface ConfigurationSection
@Nullable public ConfigurationSection getParent()
ConfigurationSection
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.
getParent
in interface ConfigurationSection
public void addDefault(@NotNull String path, @Nullable Object value)
ConfigurationSection
If no source 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 ConfigurationSection.getDefaultSection()
is null, then
this will create a new section at the path, replacing anything that may
have existed there previously.
addDefault
in interface ConfigurationSection
path
- Path of the value to set.value
- Value to set the default to.@Nullable public ConfigurationSection getDefaultSection()
ConfigurationSection
ConfigurationSection
from the default
Configuration
defined in ConfigurationSection.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.
getDefaultSection
in interface ConfigurationSection
public void set(@NotNull String path, @Nullable Object value)
ConfigurationSection
If value is 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 javadocs for details. No implementations should allow
you to store Configuration
s or ConfigurationSection
s,
please use ConfigurationSection.createSection(java.lang.String)
for that.
set
in interface ConfigurationSection
path
- Path of the object to set.value
- New value to set the path to.@Nullable public Object get(@NotNull String path)
ConfigurationSection
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 null.
get
in interface ConfigurationSection
path
- Path of the Object to get.@Nullable public Object get(@NotNull String path, @Nullable Object def)
ConfigurationSection
If the Object does not exist then the specified default value will
returned regardless of if a default has been identified in the root
Configuration
.
get
in interface ConfigurationSection
path
- Path of the Object to get.def
- The default value to return if the path is not found.@NotNull public ConfigurationSection createSection(@NotNull String path)
ConfigurationSection
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.
createSection
in interface ConfigurationSection
path
- Path to create the section at.@NotNull public ConfigurationSection createSection(@NotNull String path, @NotNull Map<?,?> map)
ConfigurationSection
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.
createSection
in interface ConfigurationSection
path
- Path to create the section at.map
- The values to used.@Nullable public String getString(@NotNull String path)
ConfigurationSection
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 null.
getString
in interface ConfigurationSection
path
- Path of the String to get.@Nullable public String getString(@NotNull String path, @Nullable String def)
ConfigurationSection
If the String does not exist then the specified default value will
returned regardless of if a default has been identified in the root
Configuration
.
getString
in interface ConfigurationSection
path
- Path of the String to get.def
- The default value to return if the path is not found or is
not a String.public boolean isString(@NotNull String path)
ConfigurationSection
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 default value is a String and return appropriately.
isString
in interface ConfigurationSection
path
- Path of the String to check.public int getInt(@NotNull String path)
ConfigurationSection
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.
getInt
in interface ConfigurationSection
path
- Path of the int to get.public int getInt(@NotNull String path, int def)
ConfigurationSection
If the int does not exist then the specified default value will
returned regardless of if a default has been identified in the root
Configuration
.
getInt
in interface ConfigurationSection
path
- Path of the int to get.def
- The default value to return if the path is not found or is
not an int.public boolean isInt(@NotNull String path)
ConfigurationSection
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.
isInt
in interface ConfigurationSection
path
- Path of the int to check.public boolean getBoolean(@NotNull String path)
ConfigurationSection
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.
getBoolean
in interface ConfigurationSection
path
- Path of the boolean to get.public boolean getBoolean(@NotNull String path, boolean def)
ConfigurationSection
If the boolean does not exist then the specified default value will
returned regardless of if a default has been identified in the root
Configuration
.
getBoolean
in interface ConfigurationSection
path
- Path of the boolean to get.def
- The default value to return if the path is not found or is
not a boolean.public boolean isBoolean(@NotNull String path)
ConfigurationSection
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.
isBoolean
in interface ConfigurationSection
path
- Path of the boolean to check.public double getDouble(@NotNull String path)
ConfigurationSection
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.
getDouble
in interface ConfigurationSection
path
- Path of the double to get.public double getDouble(@NotNull String path, double def)
ConfigurationSection
If the double does not exist then the specified default value will
returned regardless of if a default has been identified in the root
Configuration
.
getDouble
in interface ConfigurationSection
path
- Path of the double to get.def
- The default value to return if the path is not found or is
not a double.public boolean isDouble(@NotNull String path)
ConfigurationSection
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.
isDouble
in interface ConfigurationSection
path
- Path of the double to check.public long getLong(@NotNull String path)
ConfigurationSection
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.
getLong
in interface ConfigurationSection
path
- Path of the long to get.public long getLong(@NotNull String path, long def)
ConfigurationSection
If the long does not exist then the specified default value will
returned regardless of if a default has been identified in the root
Configuration
.
getLong
in interface ConfigurationSection
path
- Path of the long to get.def
- The default value to return if the path is not found or is
not a long.public boolean isLong(@NotNull String path)
ConfigurationSection
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.
isLong
in interface ConfigurationSection
path
- Path of the long to check.@Nullable public List<?> getList(@NotNull String path)
ConfigurationSection
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.
getList
in interface ConfigurationSection
path
- Path of the List to get.@Nullable public List<?> getList(@NotNull String path, @Nullable List<?> def)
ConfigurationSection
If the List does not exist then the specified default value will
returned regardless of if a default has been identified in the root
Configuration
.
getList
in interface ConfigurationSection
path
- Path of the List to get.def
- The default value to return if the path is not found or is
not a List.public boolean isList(@NotNull String path)
ConfigurationSection
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.
isList
in interface ConfigurationSection
path
- Path of the List to check.@NotNull public List<String> getStringList(@NotNull String path)
ConfigurationSection
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.
getStringList
in interface ConfigurationSection
path
- Path of the List to get.@NotNull public List<Integer> getIntegerList(@NotNull String path)
ConfigurationSection
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.
getIntegerList
in interface ConfigurationSection
path
- Path of the List to get.@NotNull public List<Boolean> getBooleanList(@NotNull String path)
ConfigurationSection
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.
getBooleanList
in interface ConfigurationSection
path
- Path of the List to get.@NotNull public List<Double> getDoubleList(@NotNull String path)
ConfigurationSection
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.
getDoubleList
in interface ConfigurationSection
path
- Path of the List to get.@NotNull public List<Float> getFloatList(@NotNull String path)
ConfigurationSection
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.
getFloatList
in interface ConfigurationSection
path
- Path of the List to get.@NotNull public List<Long> getLongList(@NotNull String path)
ConfigurationSection
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 Long if possible, but may miss any values out if they are not compatible.
getLongList
in interface ConfigurationSection
path
- Path of the List to get.@NotNull public List<Byte> getByteList(@NotNull String path)
ConfigurationSection
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 Byte if possible, but may miss any values out if they are not compatible.
getByteList
in interface ConfigurationSection
path
- Path of the List to get.@NotNull public List<Character> getCharacterList(@NotNull String path)
ConfigurationSection
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 Character if possible, but may miss any values out if they are not compatible.
getCharacterList
in interface ConfigurationSection
path
- Path of the List to get.@NotNull public List<Short> getShortList(@NotNull String path)
ConfigurationSection
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 Short if possible, but may miss any values out if they are not compatible.
getShortList
in interface ConfigurationSection
path
- Path of the List to get.@NotNull public List<Map<?,?>> getMapList(@NotNull String path)
ConfigurationSection
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 Map if possible, but may miss any values out if they are not compatible.
getMapList
in interface ConfigurationSection
path
- Path of the List to get.@Nullable public <T> T getObject(@NotNull String path, @NotNull Class<T> clazz)
ConfigurationSection
#getString(path)
because
#getString(path)
converts internally all
Objects to Strings. However, #getObject(path, Boolean.class) is
equivalent to #getBoolean(path)
for example.getObject
in interface ConfigurationSection
T
- the type of the requested objectpath
- the path to the object.clazz
- the type of the requested object@Nullable public <T> T getObject(@NotNull String path, @NotNull Class<T> clazz, @Nullable T def)
ConfigurationSection
Configuration
.
Note: For example #getObject(path, String.class, def) is
not equivalent to
#getString(path, def)
because
#getString(path, def)
converts
internally all Objects to Strings. However, #getObject(path,
Boolean.class, def) is equivalent to #getBoolean(path,
def)
for example.getObject
in interface ConfigurationSection
T
- the type of the requested objectpath
- the path to the object.clazz
- the type of the requested objectdef
- the default object to return if the object is not present at
the path@Nullable public <T extends ConfigurationSerializable> T getSerializable(@NotNull String path, @NotNull Class<T> clazz)
ConfigurationSection
ConfigurationSerializable
object at the given
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 null.getSerializable
in interface ConfigurationSection
T
- the type of ConfigurationSerializable
path
- the path to the object.clazz
- the type of ConfigurationSerializable
ConfigurationSerializable
object@Nullable public <T extends ConfigurationSerializable> T getSerializable(@NotNull String path, @NotNull Class<T> clazz, @Nullable T def)
ConfigurationSection
ConfigurationSerializable
object at the given
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
Configuration
.getSerializable
in interface ConfigurationSection
T
- the type of ConfigurationSerializable
path
- the path to the object.clazz
- the type of ConfigurationSerializable
def
- the default object to return if the object is not present at
the pathConfigurationSerializable
object@Nullable public Vector getVector(@NotNull String path)
ConfigurationSection
If the Vector does not exist but a default value has been specified, this will return the default value. If the Vector does not exist and no default value was specified, this will return null.
getVector
in interface ConfigurationSection
path
- Path of the Vector to get.@Nullable public Vector getVector(@NotNull String path, @Nullable Vector def)
ConfigurationSection
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
.
getVector
in interface ConfigurationSection
path
- Path of the Vector to get.def
- The default value to return if the path is not found or is
not a Vector.public boolean isVector(@NotNull String path)
ConfigurationSection
If the path exists but is not a Vector, 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 Vector and return appropriately.
isVector
in interface ConfigurationSection
path
- Path of the Vector to check.@Nullable public OfflinePlayer getOfflinePlayer(@NotNull String path)
ConfigurationSection
If the OfflinePlayer does not exist but a default value has been specified, this will return the default value. If the OfflinePlayer does not exist and no default value was specified, this will return null.
getOfflinePlayer
in interface ConfigurationSection
path
- Path of the OfflinePlayer to get.@Nullable public OfflinePlayer getOfflinePlayer(@NotNull String path, @Nullable OfflinePlayer def)
ConfigurationSection
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
.
getOfflinePlayer
in interface ConfigurationSection
path
- Path of the OfflinePlayer to get.def
- The default value to return if the path is not found or is
not an OfflinePlayer.public boolean isOfflinePlayer(@NotNull String path)
ConfigurationSection
If the path exists but is not a OfflinePlayer, 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 OfflinePlayer and return appropriately.
isOfflinePlayer
in interface ConfigurationSection
path
- Path of the OfflinePlayer to check.@Nullable public ItemStack getItemStack(@NotNull String path)
ConfigurationSection
If the ItemStack does not exist but a default value has been specified, this will return the default value. If the ItemStack does not exist and no default value was specified, this will return null.
getItemStack
in interface ConfigurationSection
path
- Path of the ItemStack to get.@Nullable public ItemStack getItemStack(@NotNull String path, @Nullable ItemStack def)
ConfigurationSection
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
.
getItemStack
in interface ConfigurationSection
path
- Path of the ItemStack to get.def
- The default value to return if the path is not found or is
not an ItemStack.public boolean isItemStack(@NotNull String path)
ConfigurationSection
If the path exists but is not a ItemStack, 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 ItemStack and return appropriately.
isItemStack
in interface ConfigurationSection
path
- Path of the ItemStack to check.@Nullable public Color getColor(@NotNull String path)
ConfigurationSection
If the Color does not exist but a default value has been specified, this will return the default value. If the Color does not exist and no default value was specified, this will return null.
getColor
in interface ConfigurationSection
path
- Path of the Color to get.@Nullable public Color getColor(@NotNull String path, @Nullable Color def)
ConfigurationSection
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
.
getColor
in interface ConfigurationSection
path
- Path of the Color to get.def
- The default value to return if the path is not found or is
not a Color.public boolean isColor(@NotNull String path)
ConfigurationSection
If the path exists but is not a Color, 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 Color and return appropriately.
isColor
in interface ConfigurationSection
path
- Path of the Color to check.@Nullable public Location getLocation(@NotNull String path)
ConfigurationSection
If the Location does not exist but a default value has been specified, this will return the default value. If the Location does not exist and no default value was specified, this will return null.
getLocation
in interface ConfigurationSection
path
- Path of the Location to get.@Nullable public Location getLocation(@NotNull String path, @Nullable Location def)
ConfigurationSection
Location
by path, returning a default value if
not found.
If the Location does not exist then the specified default value will
returned regardless of if a default has been identified in the root
Configuration
.
getLocation
in interface ConfigurationSection
path
- Path of the Location to get.def
- The default value to return if the path is not found or is not
a Location.public boolean isLocation(@NotNull String path)
ConfigurationSection
If the path exists but is not a Location, 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 Location and return appropriately.
isLocation
in interface ConfigurationSection
path
- Path of the Location to check.@Nullable public ConfigurationSection getConfigurationSection(@NotNull String path)
ConfigurationSection
If the ConfigurationSection does not exist but a default value has been specified, this will return the default value. If the ConfigurationSection does not exist and no default value was specified, this will return null.
getConfigurationSection
in interface ConfigurationSection
path
- Path of the ConfigurationSection to get.public boolean isConfigurationSection(@NotNull String path)
ConfigurationSection
If the path exists but is not a ConfigurationSection, 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 ConfigurationSection and return appropriately.
isConfigurationSection
in interface ConfigurationSection
path
- Path of the ConfigurationSection to check.protected boolean isPrimitiveWrapper(@Nullable Object input)
protected void mapChildrenKeys(@NotNull Set<String> output, @NotNull ConfigurationSection section, boolean deep)
protected void mapChildrenValues(@NotNull Map<String,Object> output, @NotNull ConfigurationSection section, boolean deep)
@NotNull public static String createPath(@NotNull ConfigurationSection section, @Nullable String key)
ConfigurationSection
from its
root Configuration
.
You may use this method for any given ConfigurationSection
, not
only MemorySection
.
section
- Section to create a path for.key
- Name of the specified section.@NotNull public static String createPath(@NotNull ConfigurationSection section, @Nullable String key, @Nullable ConfigurationSection relativeTo)
ConfigurationSection
from
the given relative section.
You may use this method for any given ConfigurationSection
, not
only MemorySection
.
section
- Section to create a path for.key
- Name of the specified section.relativeTo
- Section to create the path relative to.Copyright © 2019. All rights reserved.