Class PreferenceManager

java.lang.Object
de.spiritscorp.datasync.io.PreferenceManager
public final class PreferenceManager extends Object
Thread-safe global configurations orchestrator managing persistent JSON configurations. Coordinates multi-profile I/O read/write operations for independent replication synchronization tasks and global application states. Implements the Singleton pattern to ensure centralized state control.
Version:
1.0.1
Author:
Tom Spirit

  • Method Summary

    Modifier and Type
    Method
    Description
    Preference
    createProfile(String jobName, boolean withSave)
    Allocates and provisions a new, distinct profile configuration data scope unit.
    Path
    getConfigPath()
    Retrieves the persistent dynamic configuration storage path target locator.
    Path
    getDebugPath()
    Retrieves the system console output debug log tracking path locator.
    Path
    getErrorPath()
    Retrieves the localized tracking error diagnostic path locator.
    static PreferenceManager
    getInstance()
    Gets the global Singleton instance.
    List<Preference>
    getLoadedProfiles()
    Exposes the active, in-memory configuration profile list registry.
    Path
    getLogPath()
    Retrieves the persistent operational event synchronization logging path locator.
    int
    getMaxLogCount()
    Returns the maximum number of historical backup log files to retain.
    long
    getMaxLogSize()
    Returns the maximum size threshold in bytes before a log file is rotated.
    Preference
    getProfile(String jobName)
    Retrieves an allocated configuration tracking state context signature via its workspace identifier.
    Path
    getRootPath()
    Retrieves the absolute configuration root storage path locator.
    AppTheme
    getTheme()
    Gets the currently configured application theme.
    void
    initGlobalRootConfigPath(Path customRoot)
    Reconfigures and overrides the global operational ecosystem workspace root coordinates.
    boolean
    isCustomConfigDir()
    Verifies whether the active execution environment deviates from the standard system workspace path.
    boolean
    isGlobalAutoStart()
    Evaluates whether the application ecosystem is provisioned to launch automatically upon host operating system startup sequences.
    boolean
    loadAllPreferences()
    Hydrates the global storage matrix layer and multi-job profile cache records from the persistent disk token.
    boolean
    moveProfile(int newIdx, int draggedIdx, Preference pref)
    Adjusts the sequential position of an automation profile within the structural execution queue.
    boolean
    removeProfile(String jobName)
    Atomically removes an active synchronization job context tracking assignment.
    boolean
    renameProfile(String oldName, String newName, Preference pref)
    Atomically handles profile rename routines inside the synchronization runtime context.
    boolean
    saveAllPreferences()
    Compiles all active in-memory profile matrices and flushes them into a single unified JSON structure.
    void
    setGlobalAutoStart(boolean globalAutoStart)
    Modifies the global automation startup property state parameter.
    Preference
    setNewProfile(String jobName, Preference pref)
    Atomically set a copy of an active synchronization job context tracking assignment.
    void
    setTheme(AppTheme theme)
    Sets the visual theme of the application.

    Methods inherited from class Object

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

  • Method Details

    • getInstance

      public static PreferenceManager getInstance()
      Gets the global Singleton instance.
      Returns:
      The singleton manager instance.

    • initGlobalRootConfigPath

      public void initGlobalRootConfigPath(Path customRoot)
      Reconfigures and overrides the global operational ecosystem workspace root coordinates. Re-initializes all system-dependent structural path mappings dynamically.

      Fallback at (user.home)/DataSync if the target path is not writeable or not valid

      Parameters:
      customRoot - The new target base directory path, or null to retain the home default context.

    • createProfile

      public Preference createProfile(String jobName, boolean withSave)
      Allocates and provisions a new, distinct profile configuration data scope unit. Automatically appends the freshly constructed tracking unit block into active memory structures.
      Parameters:
      jobName - Unique target workspace identifier.
      Returns:
      The new configuration instance, or null if the configuration allready exists.

    • getProfile

      public Preference getProfile(String jobName)
      Retrieves an allocated configuration tracking state context signature via its workspace identifier.
      Parameters:
      jobName - The unique profile registry lookup key.
      Returns:
      The matching configuration instance state, or null if no mapping tracks the parameter.

    • setNewProfile

      public Preference setNewProfile(String jobName, Preference pref)
      Atomically set a copy of an active synchronization job context tracking assignment. Evicts cached properties from memory and updates the primary configuration storage file.
      Parameters:
      jobName - The high-level UI task context container targeted for decommissioning.
      pref - Associated configuration parameters data segment instance.
      Returns:
      The new configuration copy, or null if the configuration allready exists.

    • moveProfile

      public boolean moveProfile(int newIdx, int draggedIdx, Preference pref)
      Adjusts the sequential position of an automation profile within the structural execution queue. Mutates the underlying tracking sequence under the active synchronization runtime lock and flushes the updated order to disk immediately.
      Parameters:
      newIdx - The target destination index where the profile should be relocated.
      draggedIdx - The current source index of the profile being manipulated.
      pref - Associated configuration parameters data segment instance.
      Returns:
      true if reordering and persistence succeeded; false if parameters were invalid or execution failed.

    • renameProfile

      public boolean renameProfile(String oldName, String newName, Preference pref)
      Atomically handles profile rename routines inside the synchronization runtime context. Mutates the tracking key structural state identifier map and flushes changes to disk immediately.
      Parameters:
      oldName - Original task profile identifier key.
      newName - Target replacement unique identifier string.
      pref - Associated configuration parameters data segment instance.
      Returns:
      true if persistence succeeded; false if parameters were invalid or execution failed.

    • removeProfile

      public boolean removeProfile(String jobName)
      Atomically removes an active synchronization job context tracking assignment. Evicts cached properties from memory and updates the primary configuration storage file.
      Parameters:
      jobName - The job name targeted for decommissioning.
      Returns:
      true if jobname exists and deleted successfuly.

    • getLoadedProfiles

      public List<Preference> getLoadedProfiles()
      Exposes the active, in-memory configuration profile list registry. Wrapped in an unmodifiable view to preserve structural mutation thread safety bounds.
      Returns:
      An unmodifiable structural read-only view tracking live preference profiles.

    • saveAllPreferences

      public boolean saveAllPreferences()
      Compiles all active in-memory profile matrices and flushes them into a single unified JSON structure. Truncates any existing configuration state assets dynamically during filesystem stream allocation.
      Returns:
      true if structural file flushing and underlying persistence executed without errors.

    • loadAllPreferences

      public boolean loadAllPreferences()
      Hydrates the global storage matrix layer and multi-job profile cache records from the persistent disk token. Validates individual structural segments during structural ingestion parsing.
      Returns:
      true if filesystem parsing completed entirely; false if tracking token was absent or corrupt.

    • isGlobalAutoStart

      public boolean isGlobalAutoStart()
      Evaluates whether the application ecosystem is provisioned to launch automatically upon host operating system startup sequences.
      Returns:
      true if the global background autostart configuration sequence is enabled.

    • setGlobalAutoStart

      public void setGlobalAutoStart(boolean globalAutoStart)
      Modifies the global automation startup property state parameter. This execution updates the structural configuration variable memory cache layers.
      Parameters:
      globalAutoStart - Target state flag to determine automated deployment behavior.

    • getConfigPath

      public Path getConfigPath()
      Retrieves the persistent dynamic configuration storage path target locator.
      Returns:
      The absolute filesystem path directing to the primary 'conf.json' token.

    • getLogPath

      public Path getLogPath()
      Retrieves the persistent operational event synchronization logging path locator.
      Returns:
      The absolute filesystem path directing to the structural 'log.json' entity.

    • getDebugPath

      public Path getDebugPath()
      Retrieves the system console output debug log tracking path locator.
      Returns:
      The absolute filesystem path directing to the standard runtime 'debug.log' file.

    • getErrorPath

      public Path getErrorPath()
      Retrieves the localized tracking error diagnostic path locator.
      Returns:
      The absolute filesystem path directing to the critical runtime 'debug.err' stream dump.

    • setTheme

      public void setTheme(AppTheme theme)
      Sets the visual theme of the application.
      Parameters:
      theme - The new AppTheme

    • getTheme

      public AppTheme getTheme()
      Gets the currently configured application theme.
      Returns:
      the active AppTheme

    • isCustomConfigDir

      public boolean isCustomConfigDir()
      Verifies whether the active execution environment deviates from the standard system workspace path. Evaluates the structural equality of the root path against the default deployment home directory.
      Returns:
      true if a user-defined custom configuration directory is active; false if using the default home path.

    • getRootPath

      public Path getRootPath()
      Retrieves the absolute configuration root storage path locator.
      Returns:
      The absolute filesystem path directing to the root config path.

    • getMaxLogSize

      public long getMaxLogSize()
      Returns the maximum size threshold in bytes before a log file is rotated.
      Returns:
      the maximum log file size in bytes

    • getMaxLogCount

      public int getMaxLogCount()
      Returns the maximum number of historical backup log files to retain.
      Returns:
      the maximum allowed number of backup files