Package com.inductiveautomation.ignition.designer

Class DesignerContextProxy

java.lang.Object

com.inductiveautomation.ignition.designer.DesignerContextProxy

All Implemented Interfaces:

ClientContext, CommonContext, DesignerContext

public class DesignerContextProxy
extends Object
implements DesignerContext

This is used for parts of the designer that hold onto a DesignerContext, even though every time you load a project a new designer context is made. So, this context can be permanent, and we just switch out the inner context delegate.

Field Summary

Fields inherited from interface com.inductiveautomation.ignition.designer.model.DesignerContext

SCRIPT_MANAGER_PROPERTY

Constructor Summary

Constructors

Constructor	Description
DesignerContextProxy()

Method Summary

Modifier and Type	Method	Description
void	addBeanInfoSearchPath(String packageName)	Adds the given fully-qualified path name to the Introspector's BeanInfo search path.
void	addPropertyChangeListener(PropertyChangeListener pcl)
void	addPropertyChangeListener(String property, PropertyChangeListener pcl)
void	addPropertyEditor(Class<? extends AbstractPropertyEditorPanel> pageClass)	Adds a property editor page that will be incorporated into the Designer's project property editing system.
boolean	canEditResourceProtection()	Checks whether or not the current logged in user can edit the protection bits of project resources.
XMLDeserializer	createDeserializer()	Returns an instance of the XMLDeserializer that can be used to deserialize project resources.
XMLSerializer	createSerializer()	Creates a new XML serializer that has been configured by all installed modules for custom serialization delegates
Object	deserialize(byte[] data, org.apache.log4j.Logger log)	Convenience function to deserialize a gzipped byte array into a single object.
void	editResourceDocs(ProjectResource resource)	Opens up the resource notes editor for the given project resources
void	exportResources(Collection<ResourcePath> resourceIds)	Shows the project export window (after doing a commit) with the given resource IDs checked.
String	getAuthProfileName()	Returns the current project's user source
Map<String,String>	getClientPermissionBundleKeys()
DesignerContext	getContext()
Action	getCopyAction()
Action	getCutAction()
String	getDefaultDatasourceName()	Returns the current project's default datasource name
String	getDefaultTagProviderName()	Returns the current project's default Tag provider
Action	getDeleteAction()
PersistentProperties	getDesignerPrefs()	Returns a PersistentProperties file that will be stored on a per-user basis for "persistent" but not project-encapsulated preferences
com.jidesoft.docking.DockingManager	getDockingManager()	Returns the JIDE DockingManager for the Designer
List<EdgeEdition>	getEdgeEditions()	Returns a list of currently available Edge editions (either licensed or in trial).
com.google.common.eventbus.EventBus	getEventBus()	This is a generic event bus that can be used by any part of Ignition within a single scope (jvm)
ExecutionManager	getExecutionManager()	Returns the shared task execution manager for this client
FunctionFactory	getExpressionFunctionFactory()	Returns the core function factory used by expressions.
Frame	getFrame()	Returns the owning frame of the designer.
LaunchContext	getLaunchContext()
LicenseState	getLicenseState(String moduleId)	Returns the license state for the given module
DesignerLocalizationManager	getLocalizationManager()
LogFilterSettings	getLoggingManager()
DesignerModuleHook	getModule(String id)	Returns the hook class for another module, used for modules that deal with each other's models.
List<ModuleInfo>	getModules()	Retrieve the list of all modules currently loaded in this context
NamedQueryManager	getNamedQueryManager()	Returns the appropriate named query rpc for the context.
OPCBrowserPanel	getOPCBrowser()	Returns the OPCBrowserPanel that can be used to browse and import OPC items
Action	getPasteAction()
ClientProgressManager	getProgressManager()	Returns the progress manager, which allows the execution of long running or async tasks.
DesignableProject	getProject()	Returns the project that this client is running.
ProjectBrowserRoot	getProjectBrowserRoot()	Returns the root node of the project browser tree, so that modules may add their own nodes.
String	getProjectName()	The name of the project this client will be / is running
QueryBrowser	getQueryBrowserPanel()	Returns the DB query browser tool
Action	getRenameAction()
DesignerResourceEditManager	getResourceEditManager()	Resource edit manager
RootPaneContainer	getRootPaneContainer()	Returns the RootPaneContainer that is currently the owner of the client
ScriptManager	getScriptManager()	Returns the ScriptManager that can be used to execute Python scripts.
SearchProvider	getSearchProvider(String id)
List<SearchProvider>	getSearchProviders()	Get the registered SearchProviders.
StatusBar	getStatusBar()	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-right
com.inductiveautomation.ignition.designer.tags.frame.TagBrowserFrame	getTagBrowser()	Returns the TagBrowserPanel that can be used to select Tags
TagEditor	getTagEditor()	Returns the TagEditorPanel that can be used to edit/add Tags
ClientTagManager	getTagManager()	Returns the manager that provides access to Ignition's tag system.
int	getTagPollRate()	Returns the rate at which Tags should be polled for updates
com.jidesoft.action.DockableBarManager	getToolbarManager()	Returns the JIDE dockable toolbar manager
com.google.common.eventbus.EventBus	getUIEventBus()	This event bus schedules event notification on the swing EDT.
void	registerClientPermissions(Map<String,String> bundleMap)	Register id-bundlekey pairs to limit client permissions
void	registerResourceWorkspace(ResourceWorkspace workspace)	Registers a new ResourceWorkspace, which is a main editing area for the designer.
void	registerSearchProvider(SearchProvider provider)	Registers a search provider that will be exposed through the find/replace system.
void	removePropertyChangeListener(PropertyChangeListener pcl)
void	removePropertyChangeListener(String property, PropertyChangeListener pcl)
void	setContext(DesignerContext context)

Methods inherited from class java.lang.Object

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

Constructor Details

DesignerContextProxy

public DesignerContextProxy()

Method Details

getContext

public DesignerContext getContext()

setContext

public void setContext(DesignerContext context)

getProjectName

@Nonnull
public String getProjectName()

Description copied from interface: ClientContext

The name of the project this client will be / is running

Specified by:

getProjectName in interface ClientContext

getLoggingManager

public LogFilterSettings getLoggingManager()

Specified by:

getLoggingManager in interface CommonContext

getEventBus

public com.google.common.eventbus.EventBus getEventBus()

Description copied from interface: CommonContext

This is a generic event bus that can be used by any part of Ignition within a single scope (jvm)

Specified by:

getEventBus in interface CommonContext

getUIEventBus

public com.google.common.eventbus.EventBus getUIEventBus()

Description copied from interface: ClientContext

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.

Specified by:

getUIEventBus in interface ClientContext

getNamedQueryManager

public NamedQueryManager getNamedQueryManager()

Description copied from interface: ClientContext

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.

Specified by:

getNamedQueryManager in interface ClientContext

Returns:

The correct NamedQueryManager implementation for the scope.

getExpressionFunctionFactory

public FunctionFactory getExpressionFunctionFactory()

Description copied from interface: CommonContext

Returns the core function factory used by expressions. Includes extension functions registered by modules.

Specified by:

getExpressionFunctionFactory in interface CommonContext

getLocalizationManager

@Nonnull
public DesignerLocalizationManager getLocalizationManager()

Specified by:

getLocalizationManager in interface ClientContext

Specified by:

getLocalizationManager in interface DesignerContext

getLaunchContext

public LaunchContext getLaunchContext()

Specified by:

getLaunchContext in interface ClientContext

addBeanInfoSearchPath

public void addBeanInfoSearchPath(@Nonnull
 String packageName)

Description copied from interface: DesignerContext

Adds 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:

addBeanInfoSearchPath in interface DesignerContext

Parameters:

packageName - fully-qualified path name. Not null.

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener pcl)

Specified by:

addPropertyChangeListener in interface ClientContext

addPropertyChangeListener

public void addPropertyChangeListener(String property,
 PropertyChangeListener pcl)

Specified by:

addPropertyChangeListener in interface ClientContext

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener pcl)

Specified by:

removePropertyChangeListener in interface ClientContext

removePropertyChangeListener

public void removePropertyChangeListener(String property,
 PropertyChangeListener pcl)

Specified by:

removePropertyChangeListener in interface ClientContext

exportResources

public void exportResources(@Nonnull
 Collection<ResourcePath> resourceIds)

Description copied from interface: DesignerContext

Shows the project export window (after doing a commit) with the given resource IDs checked.

Specified by:

exportResources in interface DesignerContext

Parameters:

resourceIds - Collection of ProjectResourceIds. Not null, but may be empty.

getExecutionManager

public ExecutionManager getExecutionManager()

Description copied from interface: ClientContext

Returns the shared task execution manager for this client

Specified by:

getExecutionManager in interface ClientContext

getProgressManager

public ClientProgressManager getProgressManager()

Description copied from interface: ClientContext

Returns the progress manager, which allows the execution of long running or async tasks.

Specified by:

getProgressManager in interface ClientContext

createSerializer

public XMLSerializer createSerializer()

Description copied from interface: DesignerContext

Creates a new XML serializer that has been configured by all installed modules for custom serialization delegates

Specified by:

createSerializer in interface DesignerContext

Returns:

Not null.

getDesignerPrefs

@Nonnull
public PersistentProperties getDesignerPrefs()

Description copied from interface: DesignerContext

Returns a PersistentProperties file that will be stored on a per-user basis for "persistent" but not project-encapsulated preferences

Specified by:

getDesignerPrefs in interface DesignerContext

getDefaultDatasourceName

public String getDefaultDatasourceName()

Description copied from interface: ClientContext

Returns the current project's default datasource name

Specified by:

getDefaultDatasourceName in interface ClientContext

getDefaultTagProviderName

public String getDefaultTagProviderName()

Description copied from interface: ClientContext

Returns the current project's default Tag provider

Specified by:

getDefaultTagProviderName in interface ClientContext

getAuthProfileName

public String getAuthProfileName()

Description copied from interface: ClientContext

Returns the current project's user source

Specified by:

getAuthProfileName in interface ClientContext

getSearchProviders

@Nonnull
public List<SearchProvider> getSearchProviders()

Description copied from interface: DesignerContext

Get the registered SearchProviders.

Specified by:

getSearchProviders in interface DesignerContext

Returns:

Not null.

getSearchProvider

@Nullable
public SearchProvider getSearchProvider(String id)

Specified by:

getSearchProvider in interface DesignerContext

registerClientPermissions

public void registerClientPermissions(Map<String,String> bundleMap)

Description copied from interface: DesignerContext

Register id-bundlekey pairs to limit client permissions

Specified by:

registerClientPermissions in interface DesignerContext

Parameters:

bundleMap - Map of ids to bundlekeys. Not null.

getClientPermissionBundleKeys

@Nonnull
public Map<String,String> getClientPermissionBundleKeys()

Specified by:

getClientPermissionBundleKeys in interface DesignerContext

canEditResourceProtection

public boolean canEditResourceProtection()

Description copied from interface: DesignerContext

Checks whether or not the current logged in user can edit the protection bits of project resources.

Specified by:

canEditResourceProtection in interface DesignerContext

registerSearchProvider

public void registerSearchProvider(@Nonnull
 SearchProvider provider)

Description copied from interface: DesignerContext

Registers a search provider that will be exposed through the find/replace system.

Specified by:

registerSearchProvider in interface DesignerContext

getFrame

@Nonnull
public Frame getFrame()

Description copied from interface: DesignerContext

Returns the owning frame of the designer. Handy for dialog parents

Specified by:

getFrame in interface DesignerContext

getCopyAction

@Nonnull
public Action getCopyAction()

Specified by:

getCopyAction in interface DesignerContext

getCutAction

@Nonnull
public Action getCutAction()

Specified by:

getCutAction in interface DesignerContext

getDeleteAction

@Nonnull
public Action getDeleteAction()

Specified by:

getDeleteAction in interface DesignerContext

getPasteAction

@Nonnull
public Action getPasteAction()

Specified by:

getPasteAction in interface DesignerContext

getRenameAction

@Nonnull
public Action getRenameAction()

Specified by:

getRenameAction in interface DesignerContext

getRootPaneContainer

public RootPaneContainer getRootPaneContainer()

Description copied from interface: ClientContext

Returns the RootPaneContainer that is currently the owner of the client

Specified by:

getRootPaneContainer in interface ClientContext

getTagPollRate

public int getTagPollRate()

Description copied from interface: ClientContext

Returns the rate at which Tags should be polled for updates

Specified by:

getTagPollRate in interface ClientContext

getStatusBar

public StatusBar getStatusBar()

Description copied from interface: DesignerContext

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-right

Specified by:

getStatusBar in interface DesignerContext

Returns:

Not null.

getResourceEditManager

public DesignerResourceEditManager getResourceEditManager()

Description copied from interface: DesignerContext

Resource edit manager

Specified by:

getResourceEditManager in interface DesignerContext

getTagManager

public ClientTagManager getTagManager()

Description copied from interface: CommonContext

Returns the manager that provides access to Ignition's tag system.

Specified by:

getTagManager in interface ClientContext

Specified by:

getTagManager in interface CommonContext

registerResourceWorkspace

public void registerResourceWorkspace(@Nonnull
 ResourceWorkspace workspace)

Description copied from interface: DesignerContext

Registers a new ResourceWorkspace, 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:

registerResourceWorkspace in interface DesignerContext

Parameters:

workspace - The ResourceWorkspace to register with the designer

createDeserializer

public XMLDeserializer createDeserializer()

Description copied from interface: CommonContext

Returns 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:

createDeserializer in interface CommonContext

getProjectBrowserRoot

@Nonnull
public ProjectBrowserRoot getProjectBrowserRoot()

Description copied from interface: DesignerContext

Returns the root node of the project browser tree, so that modules may add their own nodes.

Specified by:

getProjectBrowserRoot in interface DesignerContext

See Also:

• AbstractNavTreeNode

deserialize

public Object deserialize(byte[] data,
 org.apache.log4j.Logger log)
                   throws SerializationException

Description copied from interface: ClientContext

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.

Specified by:

deserialize in interface ClientContext

Throws:

SerializationException

addPropertyEditor

public void addPropertyEditor(@Nonnull
 Class<? extends AbstractPropertyEditorPanel> pageClass)

Description copied from interface: DesignerContext

Adds 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:

addPropertyEditor in interface DesignerContext

getScriptManager

public ScriptManager getScriptManager()

Description copied from interface: CommonContext

Returns the ScriptManager that can be used to execute Python scripts.

Specified by:

getScriptManager in interface CommonContext

getDockingManager

@Nonnull
public com.jidesoft.docking.DockingManager getDockingManager()

Description copied from interface: DesignerContext

Returns the JIDE DockingManager for the Designer

Specified by:

getDockingManager in interface DesignerContext

getToolbarManager

@Nonnull
public com.jidesoft.action.DockableBarManager getToolbarManager()

Description copied from interface: DesignerContext

Returns the JIDE dockable toolbar manager

Specified by:

getToolbarManager in interface DesignerContext

getTagBrowser

@Nonnull
public com.inductiveautomation.ignition.designer.tags.frame.TagBrowserFrame getTagBrowser()

Description copied from interface: DesignerContext

Returns the TagBrowserPanel that can be used to select Tags

Specified by:

getTagBrowser in interface DesignerContext

getOPCBrowser

@Nonnull
public OPCBrowserPanel getOPCBrowser()

Description copied from interface: DesignerContext

Returns the OPCBrowserPanel that can be used to browse and import OPC items

Specified by:

getOPCBrowser in interface DesignerContext

getTagEditor

@Nonnull
public TagEditor getTagEditor()

Description copied from interface: DesignerContext

Returns the TagEditorPanel that can be used to edit/add Tags

Specified by:

getTagEditor in interface DesignerContext

getQueryBrowserPanel

@Nonnull
public QueryBrowser getQueryBrowserPanel()

Description copied from interface: DesignerContext

Returns the DB query browser tool

Specified by:

getQueryBrowserPanel in interface DesignerContext

getProject

public DesignableProject getProject()

Description copied from interface: ClientContext

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.

Specified by:

getProject in interface ClientContext

Specified by:

getProject in interface DesignerContext

getModule

@Nullable
public DesignerModuleHook getModule(String id)

Description copied from interface: CommonContext

Returns 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:

getModule in interface CommonContext

Specified by:

getModule in interface DesignerContext

getModules

public List<ModuleInfo> getModules()

Description copied from interface: ClientContext

Retrieve the list of all modules currently loaded in this context

Specified by:

getModules in interface ClientContext

editResourceDocs

public void editResourceDocs(@Nonnull
 ProjectResource resource)

Description copied from interface: DesignerContext

Opens up the resource notes editor for the given project resources

Specified by:

editResourceDocs in interface DesignerContext

getLicenseState

public LicenseState getLicenseState(String moduleId)

Description copied from interface: CommonContext

Returns the license state for the given module

Specified by:

getLicenseState in interface CommonContext

getEdgeEditions

public List<EdgeEdition> getEdgeEditions()

Description copied from interface: CommonContext

Returns a list of currently available Edge editions (either licensed or in trial). Does not check if any required modules are installed and running.

Specified by:

getEdgeEditions in interface CommonContext