org.bukkit.configuration.file
Class FileConfiguration

java.lang.Object
  org.bukkit.configuration.MemorySection
      org.bukkit.configuration.MemoryConfiguration
          org.bukkit.configuration.file.FileConfiguration

All Implemented Interfaces:

Configuration, ConfigurationSection

Direct Known Subclasses:

YamlConfiguration

public abstract class FileConfiguration
extends MemoryConfiguration

This is a base class for all File based implementations of Configuration

Field Summary

static boolean	SYSTEM_UTF Deprecated. temporary compatibility measure
static boolean	UTF_BIG Deprecated. temporary compatibility measure
static boolean	UTF8_OVERRIDE Deprecated. temporary compatibility measure

Fields inherited from class org.bukkit.configuration.MemoryConfiguration

defaults, options

Fields inherited from class org.bukkit.configuration.MemorySection

map

Constructor Summary

FileConfiguration()
Creates an empty FileConfiguration with no default values.

FileConfiguration(Configuration defaults)
Creates an empty FileConfiguration using the specified Configuration as a source for all default values.

Method Summary

protected abstract String	buildHeader() Compiles the header for this FileConfiguration and returns the result.
void	load(File file) Loads this FileConfiguration from the specified location.
void	load(InputStream stream) Deprecated. This does not consider encoding
void	load(Reader reader) Loads this FileConfiguration from the specified reader.
void	load(String file) Loads this FileConfiguration from the specified location.
abstract void	loadFromString(String contents) Loads this FileConfiguration from the specified string, as opposed to from file.
FileConfigurationOptions	options() Gets the ConfigurationOptions for this Configuration.
void	save(File file) Saves this FileConfiguration to the specified location.
void	save(String file) Saves this FileConfiguration to the specified location.
abstract String	saveToString() Saves this FileConfiguration to a string, and returns it.

Methods inherited from class org.bukkit.configuration.MemoryConfiguration

addDefault, addDefaults, addDefaults, getDefaults, getParent, setDefaults

Methods inherited from class org.bukkit.configuration.MemorySection

contains, createPath, createPath, createSection, createSection, get, get, getBoolean, getBoolean, getBooleanList, getByteList, getCharacterList, getColor, getColor, getConfigurationSection, getCurrentPath, getDefault, getDefaultSection, getDouble, getDouble, getDoubleList, getFloatList, getInt, getInt, getIntegerList, getItemStack, getItemStack, getKeys, getList, getList, getLong, getLong, getLongList, getMapList, getName, getOfflinePlayer, getOfflinePlayer, getRoot, getShortList, getString, getString, getStringList, getValues, getVector, getVector, isBoolean, isColor, isConfigurationSection, isDouble, isInt, isItemStack, isList, isLong, isOfflinePlayer, isPrimitiveWrapper, isSet, isString, isVector, mapChildrenKeys, mapChildrenValues, set, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.bukkit.configuration.ConfigurationSection

contains, createSection, createSection, get, get, getBoolean, getBoolean, getBooleanList, getByteList, getCharacterList, getColor, getColor, getConfigurationSection, getCurrentPath, getDefaultSection, getDouble, getDouble, getDoubleList, getFloatList, getInt, getInt, getIntegerList, getItemStack, getItemStack, getKeys, getList, getList, getLong, getLong, getLongList, getMapList, getName, getOfflinePlayer, getOfflinePlayer, getRoot, getShortList, getString, getString, getStringList, getValues, getVector, getVector, isBoolean, isColor, isConfigurationSection, isDouble, isInt, isItemStack, isList, isLong, isOfflinePlayer, isSet, isString, isVector, set

Field Detail

UTF8_OVERRIDE

@Deprecated
public static final boolean UTF8_OVERRIDE

Deprecated. temporary compatibility measure

This value specified that the system default encoding should be completely ignored, as it cannot handle the ASCII character set, or it is a strict-subset of UTF8 already (plain ASCII).

UTF_BIG

@Deprecated
public static final boolean UTF_BIG

Deprecated. temporary compatibility measure

This value specifies if the system default encoding is unicode, but cannot parse standard ASCII.

SYSTEM_UTF

@Deprecated
public static final boolean SYSTEM_UTF

Deprecated. temporary compatibility measure

This value specifies if the system supports unicode.

Constructor Detail

FileConfiguration

public FileConfiguration()

Creates an empty FileConfiguration with no default values.

FileConfiguration

public FileConfiguration(Configuration defaults)

Creates an empty FileConfiguration using the specified Configuration as a source for all default values.

Parameters:

defaults - Default value provider

Method Detail

save

public void save(File file)
          throws IOException

Saves this FileConfiguration to the specified location.

If the file does not exist, it will be created. If already exists, it will be overwritten. If it cannot be overwritten or created, an exception will be thrown.

This method will save using the system default encoding, or possibly using UTF8.

Parameters:

file - File to save to.

Throws:

IOException - Thrown when the given file cannot be written to for any reason.

IllegalArgumentException - Thrown when file is null.

save

public void save(String file)
          throws IOException

Saves this FileConfiguration to the specified location.

If the file does not exist, it will be created. If already exists, it will be overwritten. If it cannot be overwritten or created, an exception will be thrown.

This method will save using the system default encoding, or possibly using UTF8.

Parameters:

file - File to save to.

Throws:

IOException - Thrown when the given file cannot be written to for any reason.

IllegalArgumentException - Thrown when file is null.

saveToString

public abstract String saveToString()

Saves this FileConfiguration to a string, and returns it.

Returns:

String containing this configuration.

load

public void load(File file)
          throws FileNotFoundException,
                 IOException,
                 InvalidConfigurationException

Loads this FileConfiguration from the specified location.

All the values contained within this configuration will be removed, leaving only settings and defaults, and the new values will be loaded from the given file.

If the file cannot be loaded for any reason, an exception will be thrown.

This will attempt to use the Charset.defaultCharset() for files, unless UTF8_OVERRIDE but not UTF_BIG is specified.

Parameters:

file - File to load from.

Throws:

FileNotFoundException - Thrown when the given file cannot be opened.

IOException - Thrown when the given file cannot be read.

InvalidConfigurationException - Thrown when the given file is not a valid Configuration.

IllegalArgumentException - Thrown when file is null.

load

@Deprecated
public void load(InputStream stream)
          throws IOException,
                 InvalidConfigurationException

Deprecated. This does not consider encoding

Loads this FileConfiguration from the specified stream.

All the values contained within this configuration will be removed, leaving only settings and defaults, and the new values will be loaded from the given stream.

This will attempt to use the Charset.defaultCharset(), unless UTF8_OVERRIDE or UTF_BIG is specified.

Parameters:

stream - Stream to load from

Throws:

IOException - Thrown when the given file cannot be read.

InvalidConfigurationException - Thrown when the given file is not a valid Configuration.

IllegalArgumentException - Thrown when stream is null.

See Also:

load(Reader)

load

public void load(Reader reader)
          throws IOException,
                 InvalidConfigurationException

Loads this FileConfiguration from the specified reader.

All the values contained within this configuration will be removed, leaving only settings and defaults, and the new values will be loaded from the given stream.

Parameters:

reader - the reader to load from

Throws:

IOException - thrown when underlying reader throws an IOException

InvalidConfigurationException - thrown when the reader does not represent a valid Configuration

IllegalArgumentException - thrown when reader is null

load

public void load(String file)
          throws FileNotFoundException,
                 IOException,
                 InvalidConfigurationException

Loads this FileConfiguration from the specified location.

All the values contained within this configuration will be removed, leaving only settings and defaults, and the new values will be loaded from the given file.

If the file cannot be loaded for any reason, an exception will be thrown.

Parameters:

file - File to load from.

Throws:

FileNotFoundException - Thrown when the given file cannot be opened.

IOException - Thrown when the given file cannot be read.

InvalidConfigurationException - Thrown when the given file is not a valid Configuration.

IllegalArgumentException - Thrown when file is null.

loadFromString

public abstract void loadFromString(String contents)
                             throws InvalidConfigurationException

Loads this FileConfiguration from the specified string, as opposed to from file.

All the values contained within this configuration will be removed, leaving only settings and defaults, and the new values will be loaded from the given string.

If the string is invalid in any way, an exception will be thrown.

Parameters:

contents - Contents of a Configuration to load.

Throws:

InvalidConfigurationException - Thrown if the specified string is invalid.

IllegalArgumentException - Thrown if contents is null.

buildHeader

protected abstract String buildHeader()

Compiles the header for this FileConfiguration and returns the result.

This will use the header from options() -> FileConfigurationOptions.header(), respecting the rules of FileConfigurationOptions.copyHeader() if set.

Returns:

Compiled header

options

public FileConfigurationOptions options()

Description copied from interface: Configuration

Gets the ConfigurationOptions for this Configuration.

All setters through this method are chainable.

Specified by:

options in interface Configuration

Overrides:

options in class MemoryConfiguration

Returns:

Options for this configuration