com.alee.managers.settings.SettingsManager Maven / Gradle / Ivy
The newest version!
/*
* This file is part of WebLookAndFeel library.
*
* WebLookAndFeel library is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* WebLookAndFeel library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with WebLookAndFeel library. If not, see globalSettingsListeners = new ArrayList ( 2 );
/**
* Specific settings change listeners.
*/
private static final Map>> specificSettingsListeners =
new HashMap>> ( 20 );
/**
* Settings files extension.
*/
private static String settingsFilesExtension = ".xml";
/**
* Backup files extension.
*/
private static String backupFilesExtension = ".backup";
/**
* Default settings directory location.
*/
private static String defaultSettingsDir = null;
/**
* Default settings directory name.
*/
private static String defaultSettingsDirName = ".weblaf";
/**
* Default settings group name.
*/
private static String defaultSettingsGroup = "default";
/**
* Redefined per-group settings save locations.
*/
private static final Map groupFileLocation = new HashMap ();
/**
* Group settings read success marks.
*/
private static final Map groupState = new HashMap ();
/**
* Cached settings map.
*/
private static final Map groups = new HashMap ();
/**
* Cached files map.
*/
private static final Map files = new HashMap ();
/**
* Whether should save settings right after any changes made or not.
*/
private static boolean saveOnChange = true;
/**
* Whether should save provided default value in "get" calls or not.
*/
private static boolean saveDefaultValues = true;
/**
* Save-on-change scheduler lock object.
*/
private static final Object saveOnChangeLock = new Object ();
/**
* Save-on-change save delay in milliseconds.
* If larger than 0 then settings will be accumulated and saved all at once as soon as no new changes came within the delay time.
*/
private static long saveOnChangeDelay = 500;
/**
* Save-on-change scheduler timer.
*/
private static WebTimer groupSaveScheduler = null;
/**
* Delayed settings groups to save.
*/
private static final List groupsToSaveOnChange = new ArrayList ();
/**
* Whether or not settings save logging is enabled.
*/
private static boolean saveLoggingEnabled = false;
/**
* Whether should allow saving settings into files or not.
* If set to false settings will be available only in runtime and will be lost after application finishes working.
*/
private static boolean allowSave = true;
/**
* Whether {@link SettingsManager} is initialized or not.
*/
private static boolean initialized = false;
/**
* Initializes {@link SettingsManager}.
*/
public static void initialize ()
{
if ( !initialized )
{
synchronized ( SettingsManager.class )
{
if ( !initialized )
{
// Aliases
XmlUtils.processAnnotations ( SettingsGroup.class );
XmlUtils.processAnnotations ( SettingsGroupState.class );
XmlUtils.processAnnotations ( ReadState.class );
// Updating initialization mark
initialized = true;
}
}
}
}
/**
* Returns list of all loaded settings groups.
*
* @return list of all loaded settings groups
*/
public static List getLoadedGroups ()
{
return CollectionUtils.copy ( groups.values () );
}
/**
* Returns map of all loaded settings groups.
*
* @return map of all loaded settings groups
*/
public static Map getLoadedGroupsMap ()
{
return groups;
}
/**
* Returns stored settings.
* The only type of exceptions that is ignored here is {@link ClassCastException}.
* Whenever a {@link ClassCastException} there will be a warning logged and default value will be used.
*
* @param key settings key
* @param settings type
* @return stored settings
*/
public static T get ( final String key )
{
return get ( getDefaultSettingsGroup (), key, null );
}
/**
* Returns stored settings.
* The only type of exceptions that is ignored here is {@link ClassCastException}.
* Whenever a {@link ClassCastException} there will be a warning logged and default value will be used.
*
* @param key settings key
* @param defaultValue default value
* @param settings type
* @return stored settings
*/
public static T get ( final String key, final T defaultValue )
{
return get ( getDefaultSettingsGroup (), key, defaultValue != null ? new StaticDefaultValue ( defaultValue ) : null );
}
/**
* Returns stored settings.
* The only type of exceptions that is ignored here is {@link ClassCastException}.
* Whenever a {@link ClassCastException} there will be a warning logged and default value will be used.
*
* @param key settings key
* @param defaultValueSupplier {@link Supplier} for default value
* @param settings type
* @return stored settings
*/
public static T get ( final String key, final Supplier defaultValueSupplier )
{
return get ( getDefaultSettingsGroup (), key, defaultValueSupplier );
}
/**
* Returns stored settings.
* The only type of exceptions that is ignored here is {@link ClassCastException}.
* Whenever a {@link ClassCastException} there will be a warning logged and default value will be used.
*
* @param group settings group
* @param key settings key
* @param defaultValue default value
* @param settings type
* @return stored settings
*/
public static T get ( final String group, final String key, final T defaultValue )
{
return get ( group, key, defaultValue != null ? new StaticDefaultValue ( defaultValue ) : null );
}
/**
* Returns stored settings.
* The only type of exceptions that is ignored here is {@link ClassCastException}.
* Whenever a {@link ClassCastException} there will be a warning logged and default value will be used.
*
* @param group settings group
* @param key settings key
* @param defaultValueSupplier {@link Supplier} for default value
* @param settings type
* @return stored settings
*/
public static T get ( final String group, final String key, final Supplier defaultValueSupplier )
{
// Checking manager initialization
initialize ();
// Resulting value
T value;
try
{
// Retrieving stored value
value = getSettingsGroup ( group ).get ( key );
}
catch ( final ClassCastException e )
{
// Informing about inappropriate settings type found
final String msg = "Unable to load settings value for group '%s' and key '%s' because it has inappropriate class type";
LoggerFactory.getLogger ( SettingsManager.class ).warn ( String.format ( msg, group, key ) );
// Value is not available
value = null;
}
// Applying default value if needed
if ( value == null && defaultValueSupplier != null )
{
// Retrieving default value
value = defaultValueSupplier.get ();
// Saving default value if needed
if ( saveDefaultValues )
{
set ( group, key, value );
}
}
return value;
}
/**
* Sets value for the specified settings key.
*
* @param key settings key
* @param object new value
* @param new value type
* @return old value for the specified settings key
*/
public static T set ( final String key, final T object )
{
return set ( getDefaultSettingsGroup (), key, object );
}
/**
* Sets value for the specified settings group and key.
*
* @param group settings group
* @param key settings key
* @param object new value
* @param new value type
* @return old value for the specified settings key
*/
public static T set ( final String group, final String key, final T object )
{
// Checking manager initialization
initialize ();
// Get SettingsGroup safely
final SettingsGroup settingsGroup = getSettingsGroup ( group );
// Put new value
final T oldValue = settingsGroup.put ( key, object );
// Save group if needed
if ( saveOnChange )
{
delayedSaveSettingsGroup ( group );
}
// Inform about changes
fireSettingsChanged ( group, key, oldValue, object );
return oldValue;
}
/**
* Resets all settings within the default settings group.
*/
public static void resetDefaultGroup ()
{
resetGroup ( getDefaultSettingsGroup () );
}
/**
* Resets all settings within the specified settings group.
* This will also reset saved settings to ensure they won't be read again.
*
* @param group settings group
*/
public static void resetGroup ( final String group )
{
// Removing group file if it exists
final File dir = new File ( getGroupFilePath ( group ) );
if ( dir.exists () && dir.isDirectory () )
{
final File file = getGroupFile ( group, dir );
final File backupFile = getGroupBackupFile ( group, dir );
FileUtils.deleteFiles ( file, backupFile );
}
// Resetting group if it was already loaded
if ( groups.containsKey ( group ) )
{
groups.remove ( group );
}
}
/**
* Resets settings under the key within the default settings group.
*
* @param key settings key to reset
* @param value type
* @return resetted value
*/
public static T resetValue ( final String key )
{
return resetValue ( getDefaultSettingsGroup (), key );
}
/**
* Resets settings under the key within the specified settings group.
*
* @param group settings group
* @param key settings key to reset
* @param value type
* @return resetted value
*/
public static T resetValue ( final String group, final String key )
{
T oldValue = null;
// Resetting settings under the specified key in the group
final SettingsGroup settingsGroup = getSettingsGroup ( group );
if ( settingsGroup != null )
{
oldValue = settingsGroup.remove ( key );
}
// Forcing settings group save in case value was reset
if ( oldValue != null )
{
saveSettingsGroup ( group );
}
return oldValue;
}
/**
* Returns settings group for the specified name.
*
* @param group settings group name
* @return settings group for the specified name
*/
public static SettingsGroup getSettingsGroup ( final String group )
{
if ( groups.containsKey ( group ) )
{
return groups.get ( group );
}
else
{
return loadSettingsGroup ( group );
}
}
/**
* Attempts to load {@link SettingsGroup} for the specified name and return it.
* If {@link SettingsGroup} doesn't exist yet it will be created.
*
* @param group {@link SettingsGroup} name
* @return {@link SettingsGroup} for the specified name
*/
private static SettingsGroup loadSettingsGroup ( final String group )
{
SettingsGroup settingsGroup = null;
// Settings group file
final File dir = new File ( getGroupFilePath ( group ) );
if ( dir.exists () && dir.isDirectory () )
{
final File file = getGroupFile ( group, dir );
final File backupFile = getGroupBackupFile ( group, dir );
// todo Modify read logic so that;
// todo 1. Backup reading occurs only if original file cannot be read
// todo 2. Do not delete the settings that cannot be read right away, just move them aside with ".failed" extension mark
if ( file.exists () && file.isFile () || backupFile.exists () && backupFile.isFile () )
{
// Check if there is a group backup file and restore it
boolean readFromBackup = false;
if ( backupFile.exists () && backupFile.isFile () )
{
// Replacing file with backup
FileUtils.copyFile ( backupFile, file );
// Removing backup file
FileUtils.deleteFile ( backupFile );
// Backup read mark
readFromBackup = true;
}
// Try reading SettingsGroup
if ( file.exists () && file.isFile () )
{
try
{
// Read single SettingsGroup
settingsGroup = XmlUtils.fromXML ( new FileResource ( file ) );
// Saving settings group read state
groupState.put ( group, new SettingsGroupState ( readFromBackup ? ReadState.restored : ReadState.ok ) );
final String state = readFromBackup ? "restored from backup" : "loaded";
final String msg = "Settings group '%s' %s successfully";
LoggerFactory.getLogger ( SettingsManager.class ).info ( String.format ( msg, group, state ) );
}
catch ( final Exception e )
{
// todo Probably provide different solution for different errors?
// todo CannotResolveClassException -> Probably settings class changed and not available anymore
// Logging cause
final String msg = "Unable to load settings group '%s' due to unexpected exception";
LoggerFactory.getLogger ( SettingsManager.class ).error ( String.format ( msg, group ), e );
// Delete incorrect SettingsGroup file
FileUtils.deleteFile ( file );
// Saving settings group read state
groupState.put ( group, new SettingsGroupState ( ReadState.failed, e ) );
}
}
}
else
{
// No group settings file or backup exists, new SettingsGroup will be created
groupState.put ( group, new SettingsGroupState ( ReadState.created ) );
final String msg = "Settings group '%s' created successfully";
LoggerFactory.getLogger ( SettingsManager.class ).info ( String.format ( msg, group ) );
}
}
else
{
// No group setting dir exists, new SettingsGroup will be created
groupState.put ( group, new SettingsGroupState ( ReadState.created ) );
final String msg = "Settings group '%s' created successfully";
LoggerFactory.getLogger ( SettingsManager.class ).info ( String.format ( msg, group ) );
}
// Create new SettingsGroup
if ( settingsGroup == null )
{
settingsGroup = new SettingsGroup ( group );
}
groups.put ( group, settingsGroup );
return settingsGroup;
}
/**
* Saves all {@link SettingsGroup}s and settings files.
*/
public static void saveSettings ()
{
// Saving all settings groups
for ( final Map.Entry entry : groups.entrySet () )
{
saveSettingsGroup ( entry.getValue () );
}
// Saving all settings files
for ( final Map.Entry entry : files.entrySet () )
{
saveSettings ( entry.getKey (), entry.getValue () );
}
}
/**
* Saves {@link SettingsGroup} with the specified name.
*
* @param group name of the {@link SettingsGroup} to save
*/
public static void saveSettingsGroup ( final String group )
{
saveSettingsGroup ( getSettingsGroup ( group ) );
}
/**
* Saves specified {@link SettingsGroup}.
*
* @param settingsGroup {@link SettingsGroup} to save
*/
public static void saveSettingsGroup ( final SettingsGroup settingsGroup )
{
if ( allowSave )
{
try
{
// Used values
final String group = settingsGroup.getName ();
final File dir = new File ( getGroupFilePath ( group ) );
// Ensure group settings directory exists and perform save
if ( FileUtils.ensureDirectoryExists ( dir ) )
{
// Settings file
final File file = getGroupFile ( group, dir );
// Creating settings backup if there are old settings
File backupFile = null;
if ( file.exists () )
{
backupFile = getGroupBackupFile ( group, dir );
FileUtils.copyFile ( file, backupFile );
}
// Saving settings
XmlUtils.toXML ( settingsGroup, file );
// Removing backup file if save was successful
if ( backupFile != null && backupFile.exists () )
{
FileUtils.deleteFile ( backupFile );
}
if ( saveLoggingEnabled )
{
final String msg = "Settings group '%s' saved successfully";
LoggerFactory.getLogger ( SettingsManager.class ).info ( String.format ( msg, group ) );
}
}
else
{
final String msg = "Cannot create settings directory: %s";
throw new SettingsException ( String.format ( msg, dir.getAbsolutePath () ) );
}
}
catch ( final Exception e )
{
final String msg = "Unable to save settings group '%s' due to unexpected exception";
LoggerFactory.getLogger ( SettingsManager.class ).error ( String.format ( msg, settingsGroup.getName () ), e );
}
}
}
/**
* Returns actual {@link SettingsGroup} file.
*
* @param group {@link SettingsGroup} name
* @param dir settings directory
* @return actual {@link SettingsGroup} file
*/
private static File getGroupFile ( final String group, final File dir )
{
return new File ( dir, group + settingsFilesExtension );
}
/**
* Returns backup {@link SettingsGroup} file.
*
* @param group {@link SettingsGroup} name
* @param dir settings directory
* @return backup {@link SettingsGroup} file
*/
private static File getGroupBackupFile ( final String group, final File dir )
{
return new File ( dir, group + settingsFilesExtension + backupFilesExtension );
}
/**
* Delays {@link SettingsGroup} save or performs it immediately according to {@link SettingsManager} configuration.
*
* @param group name of the {@link SettingsGroup} to save
*/
private static void delayedSaveSettingsGroup ( final String group )
{
// Determining when we should save changes into file system
if ( saveOnChangeDelay > 0 )
{
// Delaying save
synchronized ( saveOnChangeLock )
{
// Adding group for delayed save
if ( !groupsToSaveOnChange.contains ( group ) )
{
groupsToSaveOnChange.add ( group );
}
// Launching scheduler if it is not yet launched
if ( groupSaveScheduler == null || !groupSaveScheduler.isRunning () )
{
if ( groupSaveScheduler == null )
{
groupSaveScheduler = new WebTimer ( "SettingsManager.groupSaveScheduler", saveOnChangeDelay, new ActionListener ()
{
@Override
public void actionPerformed ( final ActionEvent e )
{
synchronized ( saveOnChangeLock )
{
for ( final String group : groupsToSaveOnChange )
{
saveSettingsGroup ( group );
}
groupsToSaveOnChange.clear ();
}
}
} );
groupSaveScheduler.setRepeats ( false );
}
else
{
groupSaveScheduler.setDelay ( saveOnChangeDelay );
}
groupSaveScheduler.start ();
}
}
}
else
{
// Saving right away
saveSettingsGroup ( group );
}
}
/**
* Returns {@link SettingsGroupState} for the {@link SettingsGroup} with the specified name.
*
* @param group {@link SettingsGroup} name to retrieve {@link SettingsGroupState} for
* @return {@link SettingsGroupState} for the {@link SettingsGroup} with the specified name
*/
public SettingsGroupState getSettingsGroupState ( final String group )
{
if ( !groupState.containsKey ( group ) )
{
groupState.put ( group, new SettingsGroupState ( ReadState.none ) );
}
return groupState.get ( group );
}
/**
* Returns value read from the settings file.
*
* @param fileName settings file name
* @return value read from the settings file
*/
public static Object getSettings ( final String fileName )
{
return getSettings ( fileName, null );
}
/**
* Returns value read from the settings file.
*
* @param fileName settings file name
* @param defaultValue default value
* @param default value type
* @return value read from the settings file
*/
public static T getSettings ( final String fileName, final T defaultValue )
{
return getSettings ( fileName, new Supplier ()
{
@Override
public T get ()
{
return defaultValue;
}
} );
}
/**
* Returns value read from the settings file.
*
* @param fileName settings file name
* @param defaultValue default value supplier
* @param default value type
* @return value read from the settings file
*/
public static T getSettings ( final String fileName, final Supplier defaultValue )
{
if ( files.containsKey ( fileName ) )
{
return ( T ) files.get ( fileName );
}
else
{
T value;
try
{
final File settingsFile = getSettingsFile ( fileName );
if ( settingsFile.exists () )
{
value = XmlUtils.fromXML ( new FileResource ( settingsFile ) );
}
else
{
value = defaultValue != null ? defaultValue.get () : null;
}
}
catch ( final Exception e )
{
final String msg = "Unable to load settings file '%s' due to unexpected exception";
LoggerFactory.getLogger ( SettingsManager.class ).error ( String.format ( msg, fileName ), e );
value = defaultValue != null ? defaultValue.get () : null;
}
files.put ( fileName, value );
return value;
}
}
/**
* Sets and saves value into settings file with the specified name.
*
* @param fileName settings file name
* @param settings value
*/
public static void setSettings ( final String fileName, final Object settings )
{
files.put ( fileName, settings );
if ( saveOnChange )
{
saveSettings ( fileName, settings );
}
}
/**
* Saves value into settings file with the specified name.
*
* @param fileName settings file name
* @param settings value
*/
private static void saveSettings ( final String fileName, final Object settings )
{
if ( allowSave )
{
final File settingsFile = getSettingsFile ( fileName );
final File dir = FileUtils.getParent ( settingsFile );
if ( FileUtils.ensureDirectoryExists ( dir ) )
{
XmlUtils.toXML ( settings, settingsFile );
}
else
{
final String msg = "Cannot create settings directory: %s";
throw new SettingsException ( String.format ( msg, dir ) );
}
}
}
/**
* Returns whether settings file with the specified name exists or not.
*
* @param fileName settings file name
* @return {@code true} if settings file with the specified name exists, {@code false} otherwise
*/
public static boolean settingsExists ( final String fileName )
{
return getSettingsFile ( fileName ).exists ();
}
/**
* Returns settings file for the specified file name.
*
* @param fileName settings file name
* @return settings file for the specified file name
*/
private static File getSettingsFile ( final String fileName )
{
return new File ( getDefaultSettingsDir (), fileName );
}
/**
* Returns settings files extension.
*
* @return settings files extension
*/
public static String getSettingsFilesExtension ()
{
return settingsFilesExtension;
}
/**
* Sets settings files extension
*
* @param settingsFilesExtension new settings files extension
*/
public static void setSettingsFilesExtension ( final String settingsFilesExtension )
{
SettingsManager.settingsFilesExtension = settingsFilesExtension;
}
/**
* Returns backup files extension.
*
* @return backup files extension
*/
public static String getBackupFilesExtension ()
{
return backupFilesExtension;
}
/**
* Sets backup files extension
*
* @param backupFilesExtension new backup files extension
*/
public static void setBackupFilesExtension ( final String backupFilesExtension )
{
SettingsManager.backupFilesExtension = backupFilesExtension;
}
/**
* Returns default settings directory.
*
* @return default settings directory
*/
public static String getDefaultSettingsDir ()
{
if ( defaultSettingsDir == null )
{
return FileUtils.getUserHomePath () + defaultSettingsDirName;
}
else
{
return defaultSettingsDir;
}
}
/**
* Sets default settings directory.
*
* @param defaultSettingsDir new default settings directory
*/
public static void setDefaultSettingsDir ( final String defaultSettingsDir )
{
SettingsManager.defaultSettingsDir = defaultSettingsDir;
}
/**
* Returns default settings directory name.
*
* @return default settings directory name
*/
public static String getDefaultSettingsDirName ()
{
return defaultSettingsDirName;
}
/**
* Sets default settings directory name.
*
* @param defaultSettingsDir new default settings directory name
*/
public static void setDefaultSettingsDirName ( final String defaultSettingsDir )
{
SettingsManager.defaultSettingsDirName = defaultSettingsDir;
}
/**
* Returns default {@link SettingsGroup} name.
*
* @return default {@link SettingsGroup} name
*/
public static String getDefaultSettingsGroup ()
{
return defaultSettingsGroup;
}
/**
* Sets default {@link SettingsGroup} name.
*
* @param defaultSettingsGroup new default {@link SettingsGroup} name
*/
public static void setDefaultSettingsGroup ( final String defaultSettingsGroup )
{
SettingsManager.defaultSettingsGroup = defaultSettingsGroup;
}
/**
* Sets custom directory where settings group file will be saved.
* Location that was used for this group before will be simply ignored.
*
* @param group settings group name
* @param dir settings group file directory
*/
public static void setGroupFilePath ( final String group, final String dir )
{
groupFileLocation.put ( group, dir );
}
/**
* Returns directory where settings group file is saved.
*
* @param group settings group name
* @return directory where settings group file is saved
*/
public static String getGroupFilePath ( final String group )
{
if ( groupFileLocation.containsKey ( group ) )
{
return groupFileLocation.get ( group );
}
else
{
return getDefaultSettingsDir ();
}
}
/**
* Returns whether should save settings right after any changes made or not.
*
* @return {@code true} if should save settings right after any changes made, {@code false} otherwise
*/
public static boolean isSaveOnChange ()
{
return saveOnChange;
}
/**
* Sets whether should save settings right after any changes made or not.
*
* @param saveOnChange whether should save settings right after any changes made or not
*/
public static void setSaveOnChange ( final boolean saveOnChange )
{
SettingsManager.saveOnChange = saveOnChange;
}
/**
* Sets whether or not should save default value created as a result of {@code get(...)} calls.
*
* @return {@code true} if should save default value created as a result of {@code get(...)} calls, {@code false} otherwise
*/
public static boolean isSaveDefaultValues ()
{
return saveDefaultValues;
}
/**
* Sets whether or not should save default value created as a result of {@code get(...)} calls.
*
* @param saveDefaultValues whether or not should save default value created as a result of {@code get(...)} calls
*/
public static void setSaveDefaultValues ( final boolean saveDefaultValues )
{
SettingsManager.saveDefaultValues = saveDefaultValues;
}
/**
* Returns save-on-change delay in milliseconds.
*
* @return save-on-change delay in milliseconds.
*/
public static long getSaveOnChangeDelay ()
{
return saveOnChangeDelay;
}
/**
* Sets save-on-change delay in milliseconds.
* If larger than 0 then settings will be accumulated and saved all at once as soon as no new changes came within the delay time.
*
* @param saveOnChangeDelay new save-on-change delay in milliseconds
*/
public static void setSaveOnChangeDelay ( final long saveOnChangeDelay )
{
SettingsManager.saveOnChangeDelay = saveOnChangeDelay;
}
/**
* Returns whether settings save log is enabled or not.
*
* @return {@code true} if settings save log is enabled, {@code false} otherwise
*/
public static boolean isSaveLoggingEnabled ()
{
return saveLoggingEnabled;
}
/**
* Sets whether settings save log is enabled or not.
*
* @param enabled whether settings save log is enabled or not
*/
public static void setSaveLoggingEnabled ( final boolean enabled )
{
SettingsManager.saveLoggingEnabled = enabled;
}
/**
* Returns whether should allow saving settings into files or not.
*
* @return {@code true} if should allow saving settings into files, {@code false} otherwise
*/
public static boolean isAllowSave ()
{
return allowSave;
}
/**
* Sets whether should allow saving settings into files or not.
*
* @param allowSave whether should allow saving settings into files or not
*/
public static void setAllowSave ( final boolean allowSave )
{
SettingsManager.allowSave = allowSave;
}
/**
* Disables saving settings into files.
*/
public static void disableSave ()
{
setAllowSave ( false );
}
/**
* Enables saving settings into files.
*/
public static void enableSave ()
{
setAllowSave ( true );
}
/**
* Adds new global {@link SettingsListener}.
*
* @param listener {@link SettingsListener} to add
*/
public static void addSettingsListener ( final SettingsListener listener )
{
globalSettingsListeners.add ( listener );
}
/**
* Adds new specific {@link SettingsListener}.
*
* @param key settings key to listen to
* @param listener {@link SettingsListener} to add
*/
public static void addSettingsListener ( final String key, final SettingsListener listener )
{
addSettingsListener ( getDefaultSettingsGroup (), key, listener );
}
/**
* Adds new specific {@link SettingsListener}.
*
* @param group name of the {@link SettingsGroup} to add {@link SettingsListener} for
* @param key settings key to listen to
* @param listener {@link SettingsListener} to add
*/
public static void addSettingsListener ( final String group, final String key, final SettingsListener listener )
{
if ( !specificSettingsListeners.containsKey ( group ) )
{
specificSettingsListeners.put ( group, new HashMap> () );
}
if ( !specificSettingsListeners.get ( group ).containsKey ( key ) )
{
specificSettingsListeners.get ( group ).put ( key, new ArrayList () );
}
specificSettingsListeners.get ( group ).get ( key ).add ( listener );
}
/**
* Removes global {@link SettingsListener}.
*
* @param listener {@link SettingsListener} to remove
*/
public static void removeSettingsListener ( final SettingsListener listener )
{
globalSettingsListeners.remove ( listener );
}
/**
* Removes specific {@link SettingsListener}.
*
* @param key listened settings key
* @param listener {@link SettingsListener} to remove
*/
public static void removeSettingsListener ( final String key, final SettingsListener listener )
{
removeSettingsListener ( getDefaultSettingsGroup (), key, listener );
}
/**
* Removes specific {@link SettingsListener}.
*
* @param group name of the {@link SettingsGroup} to remove {@link SettingsListener} from
* @param key listened settings key
* @param listener {@link SettingsListener} to remove
*/
public static void removeSettingsListener ( final String group, final String key, final SettingsListener listener )
{
if ( specificSettingsListeners.containsKey ( group ) )
{
if ( specificSettingsListeners.get ( group ).containsKey ( key ) )
{
specificSettingsListeners.get ( group ).get ( key ).remove ( listener );
}
}
}
/**
* Notifies that value for the {@link SettingsGroup} with the specified name and under specified key has changed.
*
* @param group {@link SettingsGroup} name
* @param key settings key
* @param oldValue old value
* @param newValue new value
*/
private static void fireSettingsChanged ( final String group, final String key, final Object oldValue, final Object newValue )
{
/**
* Firing global listeners.
*/
for ( final SettingsListener listener : CollectionUtils.copy ( globalSettingsListeners ) )
{
listener.settingsChanged ( group, key, oldValue, newValue );
}
/**
* Firing specific listeners.
*/
if ( specificSettingsListeners.containsKey ( group ) )
{
if ( specificSettingsListeners.get ( group ).containsKey ( key ) )
{
for ( final SettingsListener listener : CollectionUtils.copy ( specificSettingsListeners.get ( group ).get ( key ) ) )
{
listener.settingsChanged ( group, key, oldValue, newValue );
}
}
}
}
/**
* Simple {@link SerializableFunction} for holding static default values.
*
* @param {@link Serializable} value type
*/
private static class StaticDefaultValue implements Supplier
{
/**
* Static value.
*/
private final V value;
/**
* Csontructs new {@link StaticDefaultValue}.
*
* @param value static value
*/
public StaticDefaultValue ( final V value )
{
super ();
this.value = value;
}
@Override
public V get ()
{
return value;
}
}
} © 2015 - 2024 Weber Informatics LLC | Privacy Policy