Interface ClientContext

All Superinterfaces:
CommonContext
All Known Subinterfaces:
DesignerContext, VisionClientContext
All Known Implementing Classes:
AbstractClientContext, ClientContextImpl, DesignerContextImpl, DesignerContextProxy

public interface ClientContext extends CommonContext
  • Method Details

    • getTagManager

      ClientTagManager getTagManager()
      Description copied from interface: CommonContext
      Returns the manager that provides access to Ignition's tag system.
      Specified by:
      getTagManager in interface CommonContext
    • getExecutionManager

      ExecutionManager getExecutionManager()
      Returns the shared task execution manager for this client
    • getTagPollRate

      int getTagPollRate()
      Returns the rate at which Tags should be polled for updates
    • getDefaultDatasourceName

      String getDefaultDatasourceName()
      Returns the current project's default datasource name
    • getDefaultTagProviderName

      String getDefaultTagProviderName()
      Returns the current project's default Tag provider
    • getAuthProfileName

      String getAuthProfileName()
      Returns the current project's user source
    • addPropertyChangeListener

      void addPropertyChangeListener(PropertyChangeListener pcl)
    • addPropertyChangeListener

      void addPropertyChangeListener(String property, PropertyChangeListener pcl)
    • removePropertyChangeListener

      void removePropertyChangeListener(PropertyChangeListener pcl)
    • removePropertyChangeListener

      void removePropertyChangeListener(String property, PropertyChangeListener pcl)
    • getRootPaneContainer

      RootPaneContainer getRootPaneContainer()
      Returns the RootPaneContainer that is currently the owner of the client
    • deserialize

      Object deserialize(byte[] data, org.apache.log4j.Logger log) throws SerializationException
      Convenience function to deserialize a gzipped byte array into a single object. If multiple objects are found, they will be discarded. Warnings are logged to the given logger. If data is null or empty, null is returned.
      Throws:
      SerializationException
    • getModules

      List<ModuleInfo> getModules()
      Retrieve the list of all modules currently loaded in this context
    • getModule

      @Nullable Object getModule(String id)
      Returns the running hook object that the module with the given ID contributed to this scope. This is the live hook instance, not its Class. Modules use it to reach each other's APIs at runtime.

      The return type is Object because the hook type varies by scope — a ClientModuleHook in a Vision client, a DesignerModuleHook in the Designer (see DesignerContext#getModule(String), which narrows the return type accordingly). Callers narrow the result to an interface the target module publishes for this purpose — pattern matching covers the absent-module case in the same step:

      if (context.getModule(SFCModule.MODULE_ID) instanceof ClientStepRegistryProvider sfc) {
        var registry = sfc.getStepRegistry();
      }
      

      A null result is the usual way to detect that an optional module is unavailable, so account for it unless the module is a hard dependency of yours.

      Parameters:
      id - the module ID of the module whose hook you want.
      Returns:
      the module's hook instance, or null if the module is not installed or contributes no hook to this scope.
    • getLocalizationManager

      ClientLocalizationManager getLocalizationManager()
    • getLaunchContext

      LaunchContext getLaunchContext()
    • getUIEventBus

      com.google.common.eventbus.EventBus getUIEventBus()
      This event bus schedules event notification on the swing EDT. This is opposed to the event bus found on CommonContext.getEventBus(), which schedules event notification on a background thread.
      Since:
      7.9.2
    • getNamedQueryManager

      NamedQueryManager getNamedQueryManager()
      Returns the appropriate named query rpc for the context. In the gateway and client, we only want to use named queries that have been saved. In the designer, we want to use the current version so that reports and bindings can be seen and used for testing before the project is saved.
      Returns:
      The correct NamedQueryManager implementation for the scope.
      Since:
      7.9.3
    • getProjectName

      @NonNull String getProjectName()
      The name of the project this client will be / is running
    • getProject

      @Nullable ResourceCollection getProject()
      Returns the project that this client is running. Note that this may be null before the client is fully logged in and started, because the context is created before the project is downloaded.