Class AbstractSwingAsiContainer

java.lang.Object
uno.anahata.asi.agi.event.BasicPropertyChangeSource
uno.anahata.asi.AbstractAsiContainer
uno.anahata.asi.swing.AbstractSwingAsiContainer
All Implemented Interfaces:
PropertyChangeSource, Rebindable
Direct Known Subclasses:
AsiDesktopAsiContainer, IntellijAsiContainer
public abstract class AbstractSwingAsiContainer extends AbstractAsiContainer
A Swing-specific base class for Anahata ASI containers.

This class bridges the gap between model-agnostic session logic and the Swing UI environment. It provides shared utilities for UI-based session imports and defines the hooks for environment-specific window/tab management.

Author:
anahata

  • Field Details

    • javaFxVersionInfo

      protected static String javaFxVersionInfo

    • AVAILABLE_PROVIDER_CLASSES

      public static final List<Class<? extends AbstractAiProvider>> AVAILABLE_PROVIDER_CLASSES
      List of all known AI Providers.

    • settingsFrame

      private AsiContainerSettingsFrame settingsFrame
      The single-instance Settings Command Center frame for this container.

  • Constructor Details

    • AbstractSwingAsiContainer

      public AbstractSwingAsiContainer(String hostApplicationId) throws IOException
      Constructs a new Swing ASI container.
      Parameters:
      hostApplicationId - The unique ID of the host application.
      Throws:
      IOException

  • Method Details

    • isJavaFxAvailable

      public static boolean isJavaFxAvailable()
      Checks if the JavaFX Platform class is present on the classpath without loading it.
      Returns:
      true if JavaFX is available.

    • getJavaFxVersionInfo

      public static String getJavaFxVersionInfo()
      Returns the detected JavaFX version and supported conditional features string, initializing the platform lazily via JavaFxBridge if available on the classpath.
      Returns:
      formatted JavaFX version and feature string, or null if JavaFX is not available.

    • getDirectory

      public Path getDirectory() throws IOException
      Gets the root working directory for this specific host application instance. e.g., ~/.anahata/asi/netbeans or ~/.anahata/asi/netbeans/1.2.0

      Intercepts container directory resolution prior to creation to detect predecessor version directories. Prompts the user via Swing UI dialog and automatically migrates persistent settings if requested.

      Overrides:
      getDirectory in class AbstractAsiContainer
      Returns:
      The application-specific working directory path.
      Throws:
      IOException - If creating the directory fails.

    • promptUpgrade

      protected boolean promptUpgrade(String previousVersion, String currentVersion)
      Prompts the user via a native Swing dialog asking whether they would like to import persistent settings from an earlier detected version.
      Parameters:
      previousVersion - The predecessor version string.
      currentVersion - The running container version string.
      Returns:
      true if the user elected to import, false to start fresh.

    • showImportSuccess

      private void showImportSuccess(int count, String prevVerStr)
      Displays an informational dialog confirming that settings were successfully imported from an earlier version.
      Parameters:
      count - The number of entities imported.
      prevVerStr - The predecessor version string.

    • showSettings

      public void showSettings()
      Displays the global ASI settings Command Center in maximized mode.

    • showSettings

      public void showSettings(int initialTabIndex)
      Displays the global ASI settings Command Center with a specific tab selected.

      Reuses the existing AsiContainerSettingsFrame instance if already open, bringing it to front and selecting the requested tab index.

      Parameters:
      initialTabIndex - The index of the tab to open.

    • getAgiPanel

      public AgiPanel getAgiPanel(Agi agi)
      Retrieves the AgiPanel associated with a specific Agi session.
      Parameters:
      agi - The session.
      Returns:
      The AgiPanel instance.

    • onAgiOpened

      protected void onAgiOpened(Agi agi)
      Hook invoked when a session has been logically opened.

      Implementation details: Marshals the logical 'open' intent to the Event Dispatch Thread (EDT) and delegates to the environment-specific focusUI(Agi) method. This guarantees safe UI manipulation regardless of the calling thread.

      Specified by:
      onAgiOpened in class AbstractAsiContainer
      Parameters:
      agi - The opened session.

    • onAgiClosed

      protected void onAgiClosed(Agi agi)
      Hook invoked when a session has been logically closed.

      Implementation details: Marshals the logical 'close' intent to the Event Dispatch Thread (EDT) and delegates to the environment-specific closeUI(Agi) method. This guarantees safe UI manipulation regardless of the calling thread.

      Specified by:
      onAgiClosed in class AbstractAsiContainer
      Parameters:
      agi - The closed session.

    • focusUI

      protected abstract void focusUI(Agi agi)
      Environment-specific logic to visually focus or select the UI component associated with the given session.
      Parameters:
      agi - The session to focus.

    • closeUI

      protected abstract void closeUI(Agi agi)
      Environment-specific logic to visually close or hide the UI component associated with the given session.
      Parameters:
      agi - The session to close.

    • importSessionWithUI

      public void importSessionWithUI(Component parent)
      Opens a standard Swing JFileChooser to allow the user to select a saved session (.kryo) for import.
      Parameters:
      parent - The parent component for the dialog.