Class DesignerContextImpl
- java.lang.Object
-
- com.inductiveautomation.ignition.client.model.AbstractClientContext
-
- com.inductiveautomation.ignition.designer.DesignerContextImpl
-
- All Implemented Interfaces:
ClientContext,CommonContext,DesignerContext
public class DesignerContextImpl extends AbstractClientContext implements DesignerContext
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class com.inductiveautomation.ignition.client.model.AbstractClientContext
AbstractClientContext.ClientContextResourceListener
-
-
Field Summary
-
Fields inherited from class com.inductiveautomation.ignition.client.model.AbstractClientContext
changeSupport, globalProps, log, loggingManager, project, projectDescription, projectTitle
-
Fields inherited from interface com.inductiveautomation.ignition.designer.model.DesignerContext
SCRIPT_MANAGER_PROPERTY
-
-
Constructor Summary
Constructors Constructor Description DesignerContextImpl(IgnitionDesigner designerGui, LaunchContext launchContext, DesignableProject project)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidaddBeanInfoSearchPath(java.lang.String packageName)Adds the given fully-qualified path name to the Introspector's BeanInfo search path.voidaddLegacyScriptNode()Adds the Legacy Script project node for pre-7.7 script modules that have been imported by the user.voidaddPropertyEditor(java.lang.Class<? extends AbstractPropertyEditorPanel> pageClass)Adds a property editor page that will be incorporated into the Designer's project property editing system.booleancanEditResourceProtection()Checks whether or not the current logged in user can edit the protection bits of project resources.XMLDeserializercreateDeserializer()Returns an instance of the XMLDeserializer that can be used to deserialize project resources.FunctionFactorycreateExpressionFunctionFactory()XMLSerializercreateSerializer()Creates a new XML serializer that has been configured by all installed modules for custom serialization delegatesjava.lang.Objectdeserialize(byte[] data, org.apache.log4j.Logger log)Convenience function to deserialize a gzipped byte array into a single object.voideditResourceDocs(ProjectResource resource)Opens up the resource notes editor for the given project resourcesvoidexportResources(java.util.Collection<ResourcePath> resourceIds)Shows the project export window (after doing a commit) with the given resource IDs checked.voidfireScriptManagerInitialized()java.util.Map<java.lang.String,java.lang.String>getClientPermissionBundleKeys()javax.swing.ActiongetCopyAction()javax.swing.ActiongetCutAction()javax.swing.ActiongetDeleteAction()PersistentPropertiesgetDesignerPrefs()Returns a PersistentProperties file that will be stored on a per-user basis for "persistent" but not project-encapsulated preferencescom.jidesoft.docking.DockingManagergetDockingManager()Returns the JIDE DockingManager for the DesignerExecutionManagergetExecutionManager()Returns the shared task execution manager for this clientjava.awt.FramegetFrame()Returns the owning frame of the designer.LicenseStategetLicenseState(java.lang.String moduleId)Returns the license state for the given moduleDesignerLocalizationManagergetLocalizationManager()protected LoggerExgetLogger()java.lang.ObjectgetModule(java.lang.String id)Returns the hook class for another module, used for modules that deal with each other's models.java.util.List<ModuleInfo>getModules()Retrieve the list of all modules currently loaded in this contextNamedQueryManagergetNamedQueryManager()Returns the appropriate named query rpc for the context.OPCBrowserPanelgetOPCBrowser()Returns the OPCBrowserPanel that can be used to browse and import OPC itemsjavax.swing.ActiongetPasteAction()DesignerProjectTreeImplgetProject()Returns the project that this client is running.ProjectBrowserRootgetProjectBrowserRoot()Returns the root node of the project browser tree, so that modules may add their own nodes.QueryBrowsergetQueryBrowserPanel()Returns the DB query browser tooljava.lang.StringgetResourceCategoryKey(ProjectResourceId id)java.lang.StringgetResourceDisplayName(ProjectResourceId id)DesignerResourceEditManagergetResourceEditManager()Resource edit managerjavax.swing.IcongetResourceIcon(ProjectResourceId id)javax.swing.RootPaneContainergetRootPaneContainer()Returns the RootPaneContainer that is currently the owner of the clientScriptManagergetScriptManager()Returns the ScriptManager that can be used to execute Python scripts.java.util.List<SearchProvider>getSearchProviders()Get the registered SearchProviders.StatusBargetStatusBar()The StatusBar at the bottom of the Designer can be used to display temporary messages and for adding always-present little components that appear in the bottom-rightcom.inductiveautomation.ignition.designer.tags.frame.TagBrowserFramegetTagBrowser()Returns the TagBrowserPanel that can be used to select TagsTagEditorgetTagEditor()Returns the TagEditorPanel that can be used to edit/add TagsClientTagManagergetTagManager()Returns the manager that provides access to Ignition's tag system.com.jidesoft.action.DockableBarManagergetToolbarManager()Returns the JIDE dockable toolbar managervoidregisterClientPermissions(java.util.Map<java.lang.String,java.lang.String> bundleMap)Register id-bundlekey pairs to limit client permissionsvoidregisterResourceWorkspace(ResourceWorkspace workspace)Registers a newResourceWorkspace, which is a main editing area for the designer.voidregisterSearchProvider(SearchProvider provider)Registers a search provider that will be exposed through the find/replace system.protected voidshowError(java.lang.Exception e)protected voidshowError(java.lang.String message)protected voidshowError(java.lang.String message, java.lang.Exception e)voidshutdown()-
Methods inherited from class com.inductiveautomation.ignition.client.model.AbstractClientContext
addPropertyChangeListener, addPropertyChangeListener, getAuthProfileName, getDefaultDatasourceName, getDefaultTagProviderName, getEdgeEditions, getEventBus, getExpressionFunctionFactory, getGlobalProps, getLaunchContext, getLoggingManager, getOrDefault, getProgressManager, getProjectDescription, getProjectName, getProjectTitle, getTagPollRate, getUIEventBus, initProject, installLegacyScriptLibrary, newProjectResourceListener, resetExpressionFunctionFactory, setGlobalProps
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface com.inductiveautomation.ignition.client.model.ClientContext
addPropertyChangeListener, addPropertyChangeListener, getAuthProfileName, getDefaultDatasourceName, getDefaultTagProviderName, getLaunchContext, getProgressManager, getProjectName, getTagPollRate, getUIEventBus
-
Methods inherited from interface com.inductiveautomation.ignition.common.model.CommonContext
getEdgeEditions, getEventBus, getExpressionFunctionFactory, getLoggingManager
-
-
-
-
Constructor Detail
-
DesignerContextImpl
public DesignerContextImpl(IgnitionDesigner designerGui, LaunchContext launchContext, DesignableProject project)
-
-
Method Detail
-
getProject
public DesignerProjectTreeImpl getProject()
Description copied from interface:ClientContextReturns 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.- Specified by:
getProjectin interfaceClientContext- Specified by:
getProjectin interfaceDesignerContext
-
getLocalizationManager
@Nonnull public DesignerLocalizationManager getLocalizationManager()
- Specified by:
getLocalizationManagerin interfaceClientContext- Specified by:
getLocalizationManagerin interfaceDesignerContext
-
getNamedQueryManager
public NamedQueryManager getNamedQueryManager()
Description copied from interface:ClientContextReturns 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.- Specified by:
getNamedQueryManagerin interfaceClientContext- Returns:
- The correct NamedQueryManager implementation for the scope.
-
getExecutionManager
public ExecutionManager getExecutionManager()
Description copied from interface:ClientContextReturns the shared task execution manager for this client- Specified by:
getExecutionManagerin interfaceClientContext
-
getModule
public java.lang.Object getModule(java.lang.String id)
Description copied from interface:CommonContextReturns the hook class for another module, used for modules that deal with each other's models. Example: The reporting plugin's designer hook uses this to get FactoryPMI's palette.- Specified by:
getModulein interfaceCommonContext
-
getModules
public java.util.List<ModuleInfo> getModules()
Description copied from interface:ClientContextRetrieve the list of all modules currently loaded in this context- Specified by:
getModulesin interfaceClientContext
-
getLicenseState
public LicenseState getLicenseState(java.lang.String moduleId)
Description copied from interface:CommonContextReturns the license state for the given module- Specified by:
getLicenseStatein interfaceCommonContext
-
exportResources
public void exportResources(@Nonnull java.util.Collection<ResourcePath> resourceIds)Description copied from interface:DesignerContextShows the project export window (after doing a commit) with the given resource IDs checked.- Specified by:
exportResourcesin interfaceDesignerContext- Parameters:
resourceIds- Collection of ProjectResourceIds. Not null, but may be empty.
-
createExpressionFunctionFactory
public FunctionFactory createExpressionFunctionFactory()
- Specified by:
createExpressionFunctionFactoryin classAbstractClientContext
-
fireScriptManagerInitialized
public void fireScriptManagerInitialized()
-
getResourceCategoryKey
public java.lang.String getResourceCategoryKey(@Nonnull ProjectResourceId id)
-
getResourceDisplayName
public java.lang.String getResourceDisplayName(@Nonnull ProjectResourceId id)
-
getResourceIcon
public javax.swing.Icon getResourceIcon(@Nonnull ProjectResourceId id)
-
registerResourceWorkspace
public void registerResourceWorkspace(@Nonnull ResourceWorkspace workspace)Description copied from interface:DesignerContextRegisters a newResourceWorkspace, which is a main editing area for the designer. The workspace has menus and toolbars associated with it that become visible when the workspace is focused.- Specified by:
registerResourceWorkspacein interfaceDesignerContext- Parameters:
workspace- TheResourceWorkspaceto register with the designer
-
getSearchProviders
@Nonnull public java.util.List<SearchProvider> getSearchProviders()
Description copied from interface:DesignerContextGet the registered SearchProviders.- Specified by:
getSearchProvidersin interfaceDesignerContext- Returns:
- Not null.
-
registerClientPermissions
public void registerClientPermissions(java.util.Map<java.lang.String,java.lang.String> bundleMap)
Description copied from interface:DesignerContextRegister id-bundlekey pairs to limit client permissions- Specified by:
registerClientPermissionsin interfaceDesignerContext- Parameters:
bundleMap- Map of ids to bundlekeys. Not null.
-
getClientPermissionBundleKeys
@Nonnull public java.util.Map<java.lang.String,java.lang.String> getClientPermissionBundleKeys()
- Specified by:
getClientPermissionBundleKeysin interfaceDesignerContext
-
registerSearchProvider
public void registerSearchProvider(@Nonnull SearchProvider provider)Description copied from interface:DesignerContextRegisters a search provider that will be exposed through the find/replace system.- Specified by:
registerSearchProviderin interfaceDesignerContext
-
getFrame
@Nonnull public java.awt.Frame getFrame()
Description copied from interface:DesignerContextReturns the owning frame of the designer. Handy for dialog parents- Specified by:
getFramein interfaceDesignerContext
-
getCutAction
@Nonnull public javax.swing.Action getCutAction()
- Specified by:
getCutActionin interfaceDesignerContext
-
getCopyAction
@Nonnull public javax.swing.Action getCopyAction()
- Specified by:
getCopyActionin interfaceDesignerContext
-
getPasteAction
@Nonnull public javax.swing.Action getPasteAction()
- Specified by:
getPasteActionin interfaceDesignerContext
-
getDeleteAction
@Nonnull public javax.swing.Action getDeleteAction()
- Specified by:
getDeleteActionin interfaceDesignerContext
-
getTagManager
public ClientTagManager getTagManager()
Description copied from interface:CommonContextReturns the manager that provides access to Ignition's tag system.- Specified by:
getTagManagerin interfaceClientContext- Specified by:
getTagManagerin interfaceCommonContext
-
addBeanInfoSearchPath
public void addBeanInfoSearchPath(@Nonnull java.lang.String packageName)Description copied from interface:DesignerContextAdds the given fully-qualified path name to the Introspector's BeanInfo search path. BeanInfos can be important for not only visual beans, but for controlling serialization.- Specified by:
addBeanInfoSearchPathin interfaceDesignerContext- Parameters:
packageName- fully-qualified path name. Not null.
-
createSerializer
public XMLSerializer createSerializer()
Description copied from interface:DesignerContextCreates a new XML serializer that has been configured by all installed modules for custom serialization delegates- Specified by:
createSerializerin interfaceDesignerContext- Returns:
- Not null.
-
createDeserializer
public XMLDeserializer createDeserializer()
Description copied from interface:CommonContextReturns an instance of the XMLDeserializer that can be used to deserialize project resources. Note that this is the only safe way to obtain an instance of XMLDeserializer, because the context will pass the new deserializer around to all loaded modules, giving them a chance to initialize any custom deserialization deletes on it first.- Specified by:
createDeserializerin interfaceCommonContext
-
getStatusBar
public StatusBar getStatusBar()
Description copied from interface:DesignerContextThe StatusBar at the bottom of the Designer can be used to display temporary messages and for adding always-present little components that appear in the bottom-right- Specified by:
getStatusBarin interfaceDesignerContext- Returns:
- Not null.
-
getResourceEditManager
public DesignerResourceEditManager getResourceEditManager()
Description copied from interface:DesignerContextResource edit manager- Specified by:
getResourceEditManagerin interfaceDesignerContext
-
shutdown
public void shutdown()
-
getRootPaneContainer
public javax.swing.RootPaneContainer getRootPaneContainer()
Description copied from interface:ClientContextReturns the RootPaneContainer that is currently the owner of the client- Specified by:
getRootPaneContainerin interfaceClientContext
-
getProjectBrowserRoot
@Nonnull public ProjectBrowserRoot getProjectBrowserRoot()
Description copied from interface:DesignerContextReturns the root node of the project browser tree, so that modules may add their own nodes.- Specified by:
getProjectBrowserRootin interfaceDesignerContext- See Also:
AbstractNavTreeNode
-
deserialize
public java.lang.Object deserialize(byte[] data, org.apache.log4j.Logger log) throws SerializationExceptionDescription copied from interface:ClientContextConvenience 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.- Specified by:
deserializein interfaceClientContext- Throws:
SerializationException
-
addPropertyEditor
public void addPropertyEditor(@Nonnull java.lang.Class<? extends AbstractPropertyEditorPanel> pageClass)Description copied from interface:DesignerContextAdds a property editor page that will be incorporated into the Designer's project property editing system. This class will be instantiated the first time that the property editor is displayed, and must have either a nullary constructor or a constructor that takes a DesignerContext.
The Property Editing framework is designed around the idea that modules will store properties in opaquely xml-serialized project resources which can be uniquely identified by their module ID and resource type. The property editing UI will handle the de/serialization and project syncing tasks so that the property editor pages can simply focus on UI.
- Specified by:
addPropertyEditorin interfaceDesignerContext
-
getScriptManager
public ScriptManager getScriptManager()
Description copied from interface:CommonContextReturns the ScriptManager that can be used to execute Python scripts.- Specified by:
getScriptManagerin interfaceCommonContext
-
getDockingManager
@Nonnull public com.jidesoft.docking.DockingManager getDockingManager()
Description copied from interface:DesignerContextReturns the JIDE DockingManager for the Designer- Specified by:
getDockingManagerin interfaceDesignerContext
-
getToolbarManager
@Nonnull public com.jidesoft.action.DockableBarManager getToolbarManager()
Description copied from interface:DesignerContextReturns the JIDE dockable toolbar manager- Specified by:
getToolbarManagerin interfaceDesignerContext
-
getTagEditor
@Nonnull public TagEditor getTagEditor()
Description copied from interface:DesignerContextReturns the TagEditorPanel that can be used to edit/add Tags- Specified by:
getTagEditorin interfaceDesignerContext
-
getTagBrowser
@Nonnull public com.inductiveautomation.ignition.designer.tags.frame.TagBrowserFrame getTagBrowser()
Description copied from interface:DesignerContextReturns the TagBrowserPanel that can be used to select Tags- Specified by:
getTagBrowserin interfaceDesignerContext
-
getOPCBrowser
@Nonnull public OPCBrowserPanel getOPCBrowser()
Description copied from interface:DesignerContextReturns the OPCBrowserPanel that can be used to browse and import OPC items- Specified by:
getOPCBrowserin interfaceDesignerContext
-
getQueryBrowserPanel
@Nonnull public QueryBrowser getQueryBrowserPanel()
Description copied from interface:DesignerContextReturns the DB query browser tool- Specified by:
getQueryBrowserPanelin interfaceDesignerContext
-
editResourceDocs
public void editResourceDocs(@Nonnull ProjectResource resource)Description copied from interface:DesignerContextOpens up the resource notes editor for the given project resources- Specified by:
editResourceDocsin interfaceDesignerContext
-
getDesignerPrefs
@Nonnull public PersistentProperties getDesignerPrefs()
Description copied from interface:DesignerContextReturns a PersistentProperties file that will be stored on a per-user basis for "persistent" but not project-encapsulated preferences- Specified by:
getDesignerPrefsin interfaceDesignerContext
-
canEditResourceProtection
public boolean canEditResourceProtection()
Description copied from interface:DesignerContextChecks whether or not the current logged in user can edit the protection bits of project resources.- Specified by:
canEditResourceProtectionin interfaceDesignerContext
-
addLegacyScriptNode
public void addLegacyScriptNode()
Adds the Legacy Script project node for pre-7.7 script modules that have been imported by the user.
-
showError
protected void showError(java.lang.String message)
-
showError
protected void showError(java.lang.Exception e)
-
showError
protected void showError(java.lang.String message, java.lang.Exception e)
-
getLogger
protected LoggerEx getLogger()
-
-