Interface ViewController

All Known Implementing Classes:
MainViewController
public interface ViewController
Core architectural interface decoupling user interface interactions from business logic orchestration. Acts as the primary controller boundary for all GUI-driven events. * @author Tom Spirit

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    deleteSelectedDuplicates(SyncJobContext job)
    Triggers a destructive purging routine to eliminate identified duplicate entities within the scope of the given synchronization task context.
    void
    handleApplicationShutdown()
    Requests an orderly, programmatic termination of the entire application ecosystem.
    void
    handleAutostart(boolean autostart)
    Handles the configuration update for the application's operating system autostart behavior.
    void
    handleCreateNewJob()
    Handles the creation and append workflow for a new managed task synchronization context instance.
    void
    handleDeleteJob(SyncJobContext job)
    Permanently removes a task entity context from the global orchestrator matrix tracking layer.
    void
    handleDragJob(int thisIdx, int draggedIdx)
    Coordinates and processes drag-and-drop reordering requests originating from the job list.
    void
    handleDuplicateJob(SyncJobContext job)
    Creates an independent copy of the currently selected task parameters profile mapping.
    void
    handleExecuteTask(SyncJobContext job)
    Initiates execution of processing operations based on active configuration parameters.
    void
    handleNavigate(Gui.ViewState state)
    Handles switching between different primary view layers within the main viewport.
    void
    handleRenameJob(SyncJobContext job)
    Triggers the specialized configuration context dialog to change a job instance identification label.
    void
    handleSaveSettings(AppTheme targetTheme)
    Commits altered orchestration state variables using the encapsulated properties entity carrier.
    void
    handleStopTask(SyncJobContext job)
    Stop execution of processing operations based on active configuration parameters.
    void
    registerNativeShutdownHook()
    Registers a native host operating system runtime shutdown hook within the virtual machine to intercept external termination signals.
    void
    runInBackground(boolean bootDelay)
    Asynchronously dispatches the orchestration engine onto a background worker thread.

  • Method Details

    • registerNativeShutdownHook

      void registerNativeShutdownHook()
      Registers a native host operating system runtime shutdown hook within the virtual machine to intercept external termination signals.
      This hook acts as a defensive fallback mechanism that catches OS-level interrupts such as SIGTERM, unexpected system logoffs, or manual console terminations (e.g., Ctrl+C). Upon interception, it ensures a controlled transition to essential cleanup routines, allowing the application to preserve data integrity, flush pending transaction logs, and prevent file system corruption before the JVM process is completely killed by the host environment.

    • handleApplicationShutdown

      void handleApplicationShutdown()
      Requests an orderly, programmatic termination of the entire application ecosystem.
      Unlike defensive signal trapping, this method orchestrates the intentional, graceful shutdown lifecycle of active runtime components. It systematically cancels active synchronization tasks, halts scheduled background thread daemons, safely releases locked file descriptors, persists outstanding preference states to disk, and ultimately triggers a clean exit of the JavaFX platform runtime environment.

    • runInBackground

      void runInBackground(boolean bootDelay)
      Asynchronously dispatches the orchestration engine onto a background worker thread. Optionally defers the initial execution sequence to accommodate bootstrap stabilization, dependency initialization, or throttling requirements during application startup.
      Parameters:
      bootDelay - true to enforce an initial structural delay prior to thread execution; false for immediate background execution.

    • handleAutostart

      void handleAutostart(boolean autostart)
      Handles the configuration update for the application's operating system autostart behavior.
      This method is triggered upon user interaction with the global autostart controls. It delegates the registration or removal of the application's boot-time execution hooks to the system integration layer, enabling the application to load minimized during system startup.
      Parameters:
      autostart - true to register the application for automatic launch on system boot; false to remove the autostart registration hook

    • handleNavigate

      void handleNavigate(Gui.ViewState state)
      Handles switching between different primary view layers within the main viewport.
      Parameters:
      state - The target structural navigation layer.

    • handleCreateNewJob

      void handleCreateNewJob()
      Handles the creation and append workflow for a new managed task synchronization context instance.

    • handleRenameJob

      void handleRenameJob(SyncJobContext job)
      Triggers the specialized configuration context dialog to change a job instance identification label.
      Parameters:
      job - The source configuration instance payload.

    • handleDuplicateJob

      void handleDuplicateJob(SyncJobContext job)
      Creates an independent copy of the currently selected task parameters profile mapping.
      Parameters:
      job - The source configuration instance payload.

    • deleteSelectedDuplicates

      void deleteSelectedDuplicates(SyncJobContext job)
      Triggers a destructive purging routine to eliminate identified duplicate entities within the scope of the given synchronization task context. Mutates the active memory allocation state and immediately persists structural changes.
      Parameters:
      job - The specific synchronization runtime context targeting duplicate remediation.

    • handleDeleteJob

      void handleDeleteJob(SyncJobContext job)
      Permanently removes a task entity context from the global orchestrator matrix tracking layer.
      Parameters:
      job - The target configuration instance to wipe.

    • handleDragJob

      void handleDragJob(int thisIdx, int draggedIdx)
      Coordinates and processes drag-and-drop reordering requests originating from the job list. Acts as the bridge to pass index mutations from the view architecture back to the underlying sequential model registries.
      Parameters:
      thisIdx - The destination target index where the dragged element is dropped.
      draggedIdx - The original source index where the drag gesture was initiated.

    • handleExecuteTask

      void handleExecuteTask(SyncJobContext job)
      Initiates execution of processing operations based on active configuration parameters.
      Parameters:
      job - The active task configuration processing target.

    • handleStopTask

      void handleStopTask(SyncJobContext job)
      Stop execution of processing operations based on active configuration parameters.
      Parameters:
      job - The active task configuration processing target.

    • handleSaveSettings

      void handleSaveSettings(AppTheme targetTheme)
      Commits altered orchestration state variables using the encapsulated properties entity carrier.
      Parameters:
      targetTheme - Visual presentation theme strategy selection.