Package net.joseplay.allianceutils.api.configuration

Class AbstractConfig

java.lang.Object

net.joseplay.allianceutils.api.configuration.AbstractConfig

Direct Known Subclasses:

TimeCommandsConfig

public abstract class AbstractConfig
extends Object

Base abstraction for configuration systems. Handles loading, validation, caching and default value fallback.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	AbstractConfig.ConfigKey	Contract for configuration keys.
static enum	AbstractConfig.ValueType	Supported config value types.

Field Summary

Fields

Modifier and Type	Field	Description
protected org.bukkit.configuration.file.FileConfiguration	config
protected final String	configPath
protected final File	file
protected final Map<Enum<?>,Object>	values	Cached config values mapped by enum keys.

Constructor Summary

Constructors

Constructor	Description
AbstractConfig(File file, String configPath, Class<E> keys)	Initializes configuration file and loads all values.

Method Summary

Modifier and Type	Method	Description
protected <E extends Enum<E> & AbstractConfig.ConfigKey> void	createInexistentConfig(Class<E> keys)	Creates missing or null config paths with default values.
<P extends Enum & AbstractConfig.ConfigKey> boolean	getBoolean(P key)
protected abstract AbstractConfig.ConfigKey	getConfigKey(Enum<?> key)	Maps enum to ConfigKey.
protected abstract Object	getDefaultValue(Enum<?> key)	Provides default value for a key.
<P extends Enum & AbstractConfig.ConfigKey> double	getDouble(P key)
File	getFileInPlugin(File file)	Copies default config from plugin resources if file does not exist.
<P extends Enum & AbstractConfig.ConfigKey> int	getInt(P key)
<P extends Enum & AbstractConfig.ConfigKey> List<Integer>	getIntList(P key)
<P extends Enum & AbstractConfig.ConfigKey> long	getLong(P key)
<P extends Enum & AbstractConfig.ConfigKey> String	getString(P key)
<P extends Enum & AbstractConfig.ConfigKey> List<String>	getStringList(P key)
<T> T	getValue(Enum<?> key)	Retrieves a cached value or fallback default.
<P extends Enum & AbstractConfig.ConfigKey, C> C	getValue(P key, AbstractConfig.ValueType type)	Retrieves a typed value with validation.
protected <E extends Enum<E> & AbstractConfig.ConfigKey> void	initConfig(Class<E> keys)	Initializes config values and ensures missing entries are created.
protected void	loadConfig()	Ensures file structure exists.
protected <E extends Enum<E> & AbstractConfig.ConfigKey> void	loadValues(Class<E> enumClass)	Loads values from config into cache.
protected String	processMessage(String rawMsg)	Applies gradient formatting to messages.
void	saveConfig()	Saves configuration to disk.
boolean	setValue(Enum<?> key, Object value)	Updates config value in memory and persists to file.

Methods inherited from class java.lang.Object

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

Field Details

file

protected final File file

configPath

protected final String configPath

config

protected org.bukkit.configuration.file.FileConfiguration config

values

protected final Map<Enum<?>,Object> values

Cached config values mapped by enum keys.

Constructor Details

AbstractConfig

public AbstractConfig(File file,
 String configPath,
 Class<E> keys)

Initializes configuration file and loads all values.

Parameters:

file - Configuration file (e.g., config.yml)

configPath - Root path inside config (can be empty)

keys - Enum class implementing ConfigKey

Method Details

getFileInPlugin

public File getFileInPlugin(File file)

Copies default config from plugin resources if file does not exist.

loadConfig

protected void loadConfig()

Ensures file structure exists.

initConfig

protected <E extends Enum<E> & AbstractConfig.ConfigKey>
void initConfig(Class<E> keys)

Initializes config values and ensures missing entries are created.

createInexistentConfig

protected <E extends Enum<E> & AbstractConfig.ConfigKey>
void createInexistentConfig(Class<E> keys)

Creates missing or null config paths with default values.

processMessage

protected String processMessage(String rawMsg)

Applies gradient formatting to messages.

saveConfig

public void saveConfig()
                throws IOException

Saves configuration to disk.

Throws:

IOException

loadValues

protected <E extends Enum<E> & AbstractConfig.ConfigKey>
void loadValues(Class<E> enumClass)

Loads values from config into cache. Applies validation and fallback to default values.

getValue

public <T> T getValue(Enum<?> key)

Retrieves a cached value or fallback default.

getValue

public <P extends Enum & AbstractConfig.ConfigKey,
C>
C getValue(P key,
 AbstractConfig.ValueType type)

Retrieves a typed value with validation.

getString

public <P extends Enum & AbstractConfig.ConfigKey>
String getString(P key)

getStringList

public <P extends Enum & AbstractConfig.ConfigKey>
List<String> getStringList(P key)

getInt

public <P extends Enum & AbstractConfig.ConfigKey>
int getInt(P key)

getLong

public <P extends Enum & AbstractConfig.ConfigKey>
long getLong(P key)

getIntList

public <P extends Enum & AbstractConfig.ConfigKey>
List<Integer> getIntList(P key)

getBoolean

public <P extends Enum & AbstractConfig.ConfigKey>
boolean getBoolean(P key)

getDouble

public <P extends Enum & AbstractConfig.ConfigKey>
double getDouble(P key)

setValue

public boolean setValue(Enum<?> key,
 Object value)

Updates config value in memory and persists to file.

getDefaultValue

protected abstract Object getDefaultValue(Enum<?> key)

Provides default value for a key.

getConfigKey

protected abstract AbstractConfig.ConfigKey getConfigKey(Enum<?> key)

Maps enum to ConfigKey.