org.eclipse.rse.core.subsystems
Interface ISubSystemConfiguration

All Superinterfaces:

IAdaptable, IRSEPersistableContainer, ISystemFilterPoolManagerProvider

All Known Subinterfaces:

IFileServiceSubSystemConfiguration, IProcessServiceSubSystemConfiguration, IRemoteCmdSubSystemConfiguration, IRemoteFileSubSystemConfiguration, IRemoteProcessSubSystemConfiguration, IShellServiceSubSystemConfiguration

All Known Implementing Classes:

FileServiceSubSystemConfiguration, ProcessServiceSubSystemConfiguration, RemoteCmdSubSystemConfiguration, RemoteFileSubSystemConfiguration, RemoteProcessSubSystemConfiguration, ShellServiceSubSystemConfiguration, SubSystemConfiguration

public interface ISubSystemConfiguration

extends ISystemFilterPoolManagerProvider, IRSEPersistableContainer

Subsystem Configuration interface.

Field Summary

static boolean	FORCE_INTO_MEMORY
static boolean	LAZILY

Fields inherited from interface org.eclipse.rse.core.model.IRSEPersistableContainer

NO_CHILDREN

Method Summary

void	changingSystemProfileActiveStatus(ISystemProfile profile, boolean newStatus) Called by SystemRegistry when we have toggled the active-status of a profile
ISubSystem	cloneSubSystem(ISubSystem oldSubsystem, IHost newConnection, boolean copyProfileOperation) Clone a given subsystem into the given connection.
boolean	commit() Saves absolutely everything to disk.
ISystemFilterPoolManager	copyFilterPoolManager(ISystemProfile oldProfile, ISystemProfile newProfile) Copy the filter pool manager and return a new one.
IServerLauncherProperties	createServerLauncher(IConnectorService connectorService) Overridable entry for child classes to contribute a server launcher instance for a given subsystem.
ISubSystem	createSubSystem(IHost conn, boolean creatingConnection, ISubSystemConfigurator[] configurators) Creates a new subsystem instance that is associated with the given connection object.
ISubSystem	createSubSystemAfterTheFact(IHost conn)
ISubSystem	createSubSystemInternal(IHost conn)
boolean	deleteSubSystem(ISubSystem subsystem) Deletes a given subsystem instance from the list maintained by this factory.
void	deleteSubSystemsByConnection(IHost conn) Called by SystemRegistry's deleteConnection method to ensure we delete all our subsystems for a given connection.
void	deletingSystemProfile(ISystemProfile profile) Called by SystemRegistry when we are about to delete a profile.
void	disconnectAllSubSystems() Disconnect all subsystems currently connected.
ISystemFilterPoolManager[]	getAllSystemFilterPoolManagers() Retrieves all the filter pool managers for all the profiles, active or not.
String	getCategory() Return the category this subsystem factory subscribes to.
IConnectorService	getConnectorService(IHost host) Get the connector service for a particular host.
ISystemFilterPool	getDefaultFilterPool(ISystemProfile profile, String oldProfileName)
ISystemFilterPool	getDefaultSystemFilterPool(ISubSystem subsys) Given a subsystem, return the first (hopefully only) default pool for this subsystem's profile.
String	getDescription() Return description of this factory.
ISystemFilterPoolManager	getFilterPoolManager(ISystemProfile profile) Get the filter pool manager for the given profile.
ISystemFilterPoolManager	getFilterPoolManager(ISystemProfile profile, boolean force) Get the filter pool manager for the given profile.
List	getFilterPoolManagerList() Private.
String	getId() Return unique id of this factory.
String	getName() Return name of this factory.
IService	getService(IHost host) Get the actual service associated with a particular host.
Class	getServiceImplType() Get the implementation type of the service associated with this subsystem configuration.
Class	getServiceType() Get the service type associated with this subsystem configuration.
ISubSystemConfigurationProxy	getSubSystemConfigurationProxy() Private method
List	getSubSystemList() Private.
ISubSystem[]	getSubSystems(boolean force) Returns a list of all subsystem objects for all connections.
ISubSystem[]	getSubSystems(IHost conn, boolean force) Returns a list of subsystem objects existing for the given connection.
ISystemProfile	getSystemProfile(ISystemFilterPool pool) Get owning profile object given a filter pool object
ISystemProfile	getSystemProfile(String name)
IRSESystemType[]	getSystemTypes() Return the system types this subsystem factory supports.
String	getTranslatedFilterTypeProperty(ISystemFilter selectedFilter) Return the translated string to show in the property sheet for the type property when a filter is selected.
String	getVendor() Return vendor of this factory.
boolean	isCaseSensitive() Tell us if filter strings are case sensitive.
boolean	isFactoryFor(Class subSystemType) Determines whether this factory is responsible for the creation of subsytems of the specified type Subsystem factories should override this to indicate which subsystems they support.
boolean	isPortEditable() Return true (default) or false to indicate if subsystems of this factory support user-editable port numbers.
boolean	isSubSystemsDeletable() Returns true if this factory allows users to delete instances of subsystem objects.
void	preTestRenameSubSystemProfile(String oldProfileName) Called by SystemRegistry's renameSystemProfile method to pre-test if we are going to run into errors on a profile rename, due to file or folder in use.
boolean	providesCustomDropInFilters() Return true if filters of this subsystem factory provide a custom implementation of drop support.
void	renameFilterPoolManager(ISystemProfile profile)
void	renameSubSystem(ISubSystem subsystem, String newName) Renames a subsystem.
void	renameSubSystemProfile(ISubSystem subsystem, String oldProfileName, String newProfileName) Called by SystemRegistry's renameSystemProfile method to ensure we update our subsystem names within each subsystem.
void	renameSubSystemProfile(String oldProfileName, String newProfileName) Callback method called after renaming a subsystem profile.
void	renameSubSystemsByConnection(IHost conn, String newConnectionName) Called by SystemRegistry's renameConnection method to ensure we update our connection names within each subsystem.
void	reset() Reset for a full refresh from disk, such as after a team synch.
void	saveSubSystem(ISubSystem subsys) Save one subsystem to disk.
void	setConnection(IHost connection) Called by adapters prior to asking for actions, in case the connection of the currently selected object is required by the action.
void	setConnectorService(IHost host, IConnectorService connectorService) Set the connector service for a particular host.
void	setCurrentSelection(Object[] selection) Called by adapters prior to asking for actions.
void	setShowFilterPools(boolean show) If we support filters, should we show filter pools in the remote system explorer?
void	setSubSystemConfigurationProxy(ISubSystemConfigurationProxy proxy) Private method called by RSEUIPlugin
void	setSubSystemPort(ISubSystem subsystem, int port) Update the port for the given subsystem instance.
void	setSubSystemUserId(ISubSystem subsystem, String userId) Update the user ID for the given subsystem instance.
boolean	showChangeFilterStringsPropertyPage(ISystemFilter filter) Given a filter, decide whether to show the Filter Strings property page for this filter.
boolean	showFilterPools() If we support filters, should we show filter pools in the remote system explorer?
boolean	showGenericShowInTableOnFilter() Return true if we should show the show in table action in the popup for the given element.
boolean	showRefreshOnFilter() Return true if we should show the refresh action in the popup for the given element.
boolean	supportsCommands() Return true if subsystem instances from this factory support remote command execution Returns false in default implementation, and is usually only true for command subsystems.
boolean	supportsDeferredQueries() Return true if deferred queries are supported.
boolean	supportsDropInFilters() Return true if filters of this subsystem factory support dropping into.
boolean	supportsEncoding(IHost host) Test whether subsystems managed by this configuration support custom encodings.
boolean	supportsFileTypes() Return true if you support user-defined/managed named file types Returns false in default implementation.
boolean	supportsFilterCaching() Required method for subsystem factory child classes.
boolean	supportsFilterChildren() Indicates whether the subsystem supports displaying children under its filters.
boolean	supportsFilters() Required method for subsystem factory child classes.
boolean	supportsFilterStringExport() Return true if the subsystem supports the exporting of filter strings from it's filters RETURNS true BY DEFAULT
boolean	supportsMultipleFilterStrings() Required method for subsystem factory child classes.
boolean	supportsMultiStringFilters() Return true if the subsystem supports more than one filter string RETURNS true BY DEFAULT
boolean	supportsNestedFilters() Required method for subsystem factory child classes if returning true from supportsFilters.
boolean	supportsProperties() Return true if subsystem instances from this factory support getting and setting properties Returns false in default implementation, and not actually used yet.
boolean	supportsQuickFilters() Return true if you support quick filters.
boolean	supportsServerLaunchProperties(IHost host) Tell us if this subsystem factory supports server launch properties, which allow the user to configure how the server-side code for these subsystems are started.
boolean	supportsServerLaunchType(ServerLaunchType serverLaunchType) If supportsServerLaunchProperties(IHost) returns true, this method may be called by the server launcher to decide if a given remote server launch type is supported or not.
boolean	supportsSubSystemConnect() Return true if subsystem instances from this factory support connect and disconnect actions Returns true in default implementation.
boolean	supportsTargets() Tell us if this subsystem factory supports targets, which are destinations for pushes and builds.
ISubSystem[]	testForActiveReferences(ISystemProfile profile) Test if any filter pools in the given profile are referenced by other profiles, which are active.
void	updateSubSystem(ISubSystem subsystem, boolean updateUserId, String userId, boolean updatePort, int port) Updates user-editable attributes of an existing subsystem instance.

Methods inherited from interface org.eclipse.rse.core.filters.ISystemFilterPoolManagerProvider

filterEventFilterCreated, filterEventFilterDeleted, filterEventFilterPoolCreated, filterEventFilterPoolDeleted, filterEventFilterPoolRenamed, filterEventFilterPoolsRePositioned, filterEventFilterRenamed, filterEventFiltersRePositioned, filterEventFilterStringCreated, filterEventFilterStringDeleted, filterEventFilterStringsRePositioned, filterEventFilterStringUpdated, filterEventFilterUpdated, getReferencableSystemFilterPoolManagers, getSystemFilterPoolForBrokenReference, getSystemFilterPoolManager, getSystemFilterPoolManagers

Methods inherited from interface org.eclipse.core.runtime.IAdaptable

getAdapter

Methods inherited from interface org.eclipse.rse.core.model.IRSEPersistableContainer

getPersistableChildren, getPersistableParent, isDirty, isTainted, setDirty, setTainted, setWasRestored, wasRestored

Field Detail

FORCE_INTO_MEMORY

public static final boolean FORCE_INTO_MEMORY

See Also:

Constant Field Values

LAZILY

public static final boolean LAZILY

See Also:

Constant Field Values

Method Detail

reset

public void reset()

Reset for a full refresh from disk, such as after a team synch.

getAllSystemFilterPoolManagers

public ISystemFilterPoolManager[] getAllSystemFilterPoolManagers()

Retrieves all the filter pool managers for all the profiles, active or not. This allows cross references from one subsystem in one profile to filter pools in any other profile.

supportsEncoding

public boolean supportsEncoding(IHost host)

Test whether subsystems managed by this configuration support custom encodings. Encodings specify the way how binary data on the remote system is translated into Java Unicode Strings. RSE provides some means for the User to specify a particular encoding to use; typically, all subsystems that do support custom encodings specified should use the same encoding such that they can interoperate. Therefore, encodings are usually obtained from IHost.getDefaultEncoding(boolean). It's possible, however, that a particular subsystem "knows" that its resources are always encoded in a particular way, and there is no possibility to ever change that. The Subsystem Configuration would return false here in this case. Another possibility is that encodings for a particular subsystem can be changed, but in a way that's different than what RSE usually does. The default case, however, should be that subsystems fall back to the setting specified by the host or its underlying system type such that existing subsystem configurations can be re-used in an environment where the encoding to use is pre-defined by the system type or host connection. If no subsystem registered against a given host supports encodings, the corresponding UI controls on the IHost level are disabled in order to avoid confusion to the user.

Returns:

true if the RSE mechanisms for specifying custom encodings are observed and supported by the subsystems managed by this configuration for the given host.

Since:

org.eclipse.rse.core 3.0

See Also:

IRSESystemType.PROPERTY_SUPPORTS_ENCODING

supportsMultiStringFilters

public boolean supportsMultiStringFilters()

Return true if the subsystem supports more than one filter string

RETURNS true BY DEFAULT

supportsFilterStringExport

public boolean supportsFilterStringExport()

Return true if the subsystem supports the exporting of filter strings from it's filters

RETURNS true BY DEFAULT

supportsSubSystemConnect

public boolean supportsSubSystemConnect()

Return true if subsystem instances from this factory support connect and disconnect actions

Returns true in default implementation.

isPortEditable

public boolean isPortEditable()

Return true (default) or false to indicate if subsystems of this factory support user-editable port numbers.

Returns true in default implementation.

supportsCommands

public boolean supportsCommands()

Return true if subsystem instances from this factory support remote command execution

Returns false in default implementation, and is usually only true for command subsystems. NOTE: command subsystems are special because their filters don't yield children or allow drilling into them via Show In Table, Open In New Window or Go Into. See bug 249245 and bug 254605 for further explanation.

supportsProperties

public boolean supportsProperties()

Return true if subsystem instances from this factory support getting and setting properties

Returns false in default implementation, and not actually used yet.

supportsFilters

public boolean supportsFilters()

Required method for subsystem factory child classes. Return true if you support filters, false otherwise. If you support filters, then some housekeeping will be done for you automatically. Specifically, they will be saved and restored for you automatically.

Returns true in default implementation.

supportsFilterChildren

public boolean supportsFilterChildren()

Indicates whether the subsystem supports displaying children under its filters. By default, this will return true, but if filters that can't be expanded are desired, this can be overridden to return false.

supportsFilterCaching

public boolean supportsFilterCaching()

Required method for subsystem factory child classes. Return true if you filter caching. If you support filter caching, then the views will always check the in-memory cache for filter results before attempting a query.

Returns true in default implementation.

supportsMultipleFilterStrings

public boolean supportsMultipleFilterStrings()

Required method for subsystem factory child classes. Return true if you support filters, and you support multiple filter strings per filter. Return false to restrict the user to one string per filter.

Returns true in default implementation.

supportsNestedFilters

public boolean supportsNestedFilters()

Required method for subsystem factory child classes if returning true from supportsFilters. Return true if you support filters within filters, false otherwise.

Returns false in default implementation.

supportsQuickFilters

public boolean supportsQuickFilters()

Return true if you support quick filters. These allow the user to subset a remote system object at the time they expand it in the remote system explorer tree view.

Not supported yet

supportsDropInFilters

public boolean supportsDropInFilters()

Return true if filters of this subsystem factory support dropping into.

supportsDeferredQueries

public boolean supportsDeferredQueries()

Return true if deferred queries are supported. Deferred queries work such that when a filter or element children query is made, a WorkbenchJob is started to perform the query in a background thread. The query can take time to complete, but a negative side-effect of this is that it will always take time to complete. Alternative models can use asynchronous calls to populate their model with data from the remote side, and refresh the views when new data is in the model. Such subsystem configurations should return false here. The default implementation returns true, indicating that deferred queries are supported for filters, and delegates the check for model elements to the ISystemViewElementAdapter.

Returns:

true if deferred queries are supported.

providesCustomDropInFilters

public boolean providesCustomDropInFilters()

Return true if filters of this subsystem factory provide a custom implementation of drop support. By default, the filter reference adapter treats a drop on a filter as an update to the list of filter strings for a filter. For things like files, it is more desirable to treat the drop as a physical resource copy, so in that case, custom drop makes sense. By default this returns false.

supportsFileTypes

public boolean supportsFileTypes()

Return true if you support user-defined/managed named file types

Returns false in default implementation.

supportsTargets

public boolean supportsTargets()

Tell us if this subsystem factory supports targets, which are destinations for pushes and builds. Normally only true for file system factories.

supportsServerLaunchProperties

public boolean supportsServerLaunchProperties(IHost host)

Tell us if this subsystem factory supports server launch properties, which allow the user to configure how the server-side code for these subsystems are started. There is a Server Launch Setting property page, with a pluggable composite, where users can configure these properties.
By default we return false here. This is overridden in UniversalFileSubSystemConfiguration though.

supportsServerLaunchType

public boolean supportsServerLaunchType(ServerLaunchType serverLaunchType)

If supportsServerLaunchProperties(IHost) returns true, this method may be called by the server launcher to decide if a given remote server launch type is supported or not.
We return true by default.

See Also:

ServerLaunchType

isCaseSensitive

public boolean isCaseSensitive()

Tell us if filter strings are case sensitive.

Returns false in default implementation.

showFilterPools

public boolean showFilterPools()

If we support filters, should we show filter pools in the remote system explorer? Typically retrieved from user preferences.

setShowFilterPools

public void setShowFilterPools(boolean show)

If we support filters, should we show filter pools in the remote system explorer? This is to set it after the user changes it in the user preferences. It may require refreshing the current view.

setSubSystemConfigurationProxy

public void setSubSystemConfigurationProxy(ISubSystemConfigurationProxy proxy)

Private method called by RSEUIPlugin

getSubSystemConfigurationProxy

public ISubSystemConfigurationProxy getSubSystemConfigurationProxy()

Private method

getVendor

public String getVendor()

Return vendor of this factory. This comes from the xml "vendor" attribute of the extension point.

getName

public String getName()

Return name of this factory. Matches value in name attribute in extension point xml

getDescription

public String getDescription()

Return description of this factory. Comes from translated description string in extension point xml

getId

public String getId()

Return unique id of this factory. Matches value in id attribute in extension point xml

Specified by:

getId in interface ISystemFilterPoolManagerProvider

Returns:

the id

getCategory

public String getCategory()

Return the category this subsystem factory subscribes to.

See Also:

ISubSystemConfigurationCategories

getSystemTypes

public IRSESystemType[] getSystemTypes()

Return the system types this subsystem factory supports.

deletingSystemProfile

public void deletingSystemProfile(ISystemProfile profile)

Called by SystemRegistry when we are about to delete a profile.

Our only mission is to delete the filter pool associated with it, because the registry has already called deleteSubSystemsByConnection for every subsystem of every connection owned by this profile.

changingSystemProfileActiveStatus

public void changingSystemProfileActiveStatus(ISystemProfile profile,
                                              boolean newStatus)

Called by SystemRegistry when we have toggled the active-status of a profile

getSystemProfile

public ISystemProfile getSystemProfile(ISystemFilterPool pool)

Get owning profile object given a filter pool object

renameSubSystemProfile

public void renameSubSystemProfile(String oldProfileName,
                                   String newProfileName)

Callback method called after renaming a subsystem profile.

This is called by SystemRegistry's renameSystemProfile method after it is complete, , in order to allow the subsystem configuration perform any required cleanup. For instance, subsystem configurations must ensure that they update their filter pool manager names (and their folders).

Must be called AFTER changing the profile's name!!

Parameters:

oldProfileName - the old profile name.

newProfileName - the new profile name.

renameSubSystemProfile

public void renameSubSystemProfile(ISubSystem subsystem,
                                   String oldProfileName,
                                   String newProfileName)

Called by SystemRegistry's renameSystemProfile method to ensure we update our subsystem names within each subsystem. This should be invoked after changing the profile's name.

Parameters:

subsystem - the subsystem to be updated

oldProfileName - the old profile name

newProfileName - the new profile name

preTestRenameSubSystemProfile

public void preTestRenameSubSystemProfile(String oldProfileName)
                                   throws Exception

Called by SystemRegistry's renameSystemProfile method to pre-test if we are going to run into errors on a profile rename, due to file or folder in use.

Throws:

Exception

renameSubSystemsByConnection

public void renameSubSystemsByConnection(IHost conn,
                                         String newConnectionName)

Called by SystemRegistry's renameConnection method to ensure we update our connection names within each subsystem.

Must be called prior to changing the connection's name!!

deleteSubSystemsByConnection

public void deleteSubSystemsByConnection(IHost conn)

Called by SystemRegistry's deleteConnection method to ensure we delete all our subsystems for a given connection.

createSubSystem

public ISubSystem createSubSystem(IHost conn,
                                  boolean creatingConnection,
                                  ISubSystemConfigurator[] configurators)

Creates a new subsystem instance that is associated with the given connection object. SystemRegistryImpl calls this when a new connection is created, and appliesToSystemType returns true.

Parameters:

conn - The connection to create a subsystem for

creatingConnection - true if we are creating a connection, false if just creating another subsystem for an existing connection.

configurators - The configurators that will be applied to a new subsystem or null if there are none.

Since:

3.0

createSubSystemAfterTheFact

public ISubSystem createSubSystemAfterTheFact(IHost conn)

createSubSystemInternal

public ISubSystem createSubSystemInternal(IHost conn)

getConnectorService

public IConnectorService getConnectorService(IHost host)

Get the connector service for a particular host. This may create the connector service if necessary. If the configuration is a service subsystem configuration, this should return the connector service specified in setConnectorService(IHost, IConnectorService).

Parameters:

host - the host for which to create or retrieve the connector service

Returns:

the connector service associated with this host. This can return null if there is no connector service associated with this configuration. It is recommended that there be a connector service if supportsSubSystemConnect() is true.

setConnectorService

public void setConnectorService(IHost host,
                                IConnectorService connectorService)

Set the connector service for a particular host. This is usually managed by a connector service manager known to this configuration. This must be implemented by service subsystem configurations. Service subsystems allow a connector service to be changed.

Parameters:

host - the host for which to set this connector service.

connectorService - the connector service associated with this host.

Since:

org.eclipse.rse.core 3.0

getServiceType

public Class getServiceType()

Get the service type associated with this subsystem configuration. If the configuration is not a service subsystem configuration it must return null, otherwise it must return the interface class that the underlying service layer implements.

Returns:

an interface class that is implemented by the service layer used by subsystems that have this configuration, or null if this is not a service subsystem configuration.

Since:

org.eclipse.rse.core 3.0

getServiceImplType

public Class getServiceImplType()

Get the implementation type of the service associated with this subsystem configuration. If the configuration is not a service subsystem configuration then this must return null, otherwise it must return the class that implements the interface specified in getServiceType().

Returns:

an implementation class that implements the interface specified in getServiceType(), or null if this is not a service subsystem configuration.

Since:

org.eclipse.rse.core 3.0

getService

public IService getService(IHost host)

Get the actual service associated with a particular host. If the configuration is not a service subsystem this must return null. Otherwise this must return the particular instance of the class returned by getServiceImplType() that is associated with this host instance.

Parameters:

host - The host for which to retrieve the service.

Returns:

The instance of IService which is associated with this host, or null if this is not a service subsystem configuration.

Since:

org.eclipse.rse.core 3.0

createServerLauncher

public IServerLauncherProperties createServerLauncher(IConnectorService connectorService)

Overridable entry for child classes to contribute a server launcher instance for a given subsystem.

Create an instance of ServerLauncher, and add it to the given subsystem. When a subsystem is created, and supportsServerLaunchProperties(IHost) returns true, this method is called to create the server launcher instance associated with the subsystem. The default implementation is to create an instance of IRemoteServerLauncher, but override to create your own ServerLauncher instance if you have your own class.

updateSubSystem

public void updateSubSystem(ISubSystem subsystem,
                            boolean updateUserId,
                            String userId,
                            boolean updatePort,
                            int port)

Updates user-editable attributes of an existing subsystem instance. These attributes typically affect the live connection, so the subsystem will be forced to disconnect.

The subsystem will be saved to disk.

Parameters:

subsystem - target of the update action

updateUserId - true if we are updating the userId, else false to ignore userId

userId - new local user Id. Ignored if updateUserId is false

updatePort - true if we are updating the port, else false to ignore port

port - new local port value. Ignored if updatePort is false

setSubSystemPort

public void setSubSystemPort(ISubSystem subsystem,
                             int port)

Update the port for the given subsystem instance.

setSubSystemUserId

public void setSubSystemUserId(ISubSystem subsystem,
                               String userId)

Update the user ID for the given subsystem instance.

isSubSystemsDeletable

public boolean isSubSystemsDeletable()

Returns true if this factory allows users to delete instances of subsystem objects. Would only be true if users are allowed to create multiple instances of subsystem objects per connection.

deleteSubSystem

public boolean deleteSubSystem(ISubSystem subsystem)

Deletes a given subsystem instance from the list maintained by this factory. SystemRegistryImpl calls this when the user selects to delete a subsystem object, or delete the parent connection this subsystem is associated with. In former case, this is only called if the factory supports user-deletable subsystems.

cloneSubSystem

public ISubSystem cloneSubSystem(ISubSystem oldSubsystem,
                                 IHost newConnection,
                                 boolean copyProfileOperation)
                          throws Exception

Clone a given subsystem into the given connection. Called when user does a copy-connection action.

Parameters:

oldSubsystem - The subsystem to be cloned

newConnection - The connection into which to create and clone the old subsystem

copyProfileOperation - Pass true if this is an profile-copy operation versus a connection-copy operation

Returns:

New subsystem within the new connection

Throws:

Exception

getSubSystems

public ISubSystem[] getSubSystems(IHost conn,
                                  boolean force)

Returns a list of subsystem objects existing for the given connection.

Parameters:

conn - System connection to retrieve subsystems for

force - true if we should force all the subsystems to be restored from disk if not already

getSubSystems

public ISubSystem[] getSubSystems(boolean force)

Returns a list of all subsystem objects for all connections.

renameSubSystem

public void renameSubSystem(ISubSystem subsystem,
                            String newName)

Renames a subsystem. This is better than ss.setName(String newName) as it saves the subsystem to disk.

disconnectAllSubSystems

public void disconnectAllSubSystems()
                             throws Exception

Disconnect all subsystems currently connected. Called by shutdown() of RSEUIPlugin.

Throws:

Exception

getFilterPoolManager

public ISystemFilterPoolManager getFilterPoolManager(ISystemProfile profile,
                                                     boolean force)

Get the filter pool manager for the given profile. A subsystem configuration has a filter pool manager for each profile.

Parameters:

profile - The system profile for which to get the manager.

force - if true then create the default filters for this subsystem configuration in this profile. This should only be done during initial subsystem creation, not during subsystem restore.

Returns:

a filter pool manager

Since:

org.eclipse.rse.core 3.0

getFilterPoolManager

public ISystemFilterPoolManager getFilterPoolManager(ISystemProfile profile)

Get the filter pool manager for the given profile. A subsystem configuration has a filter pool manager for each profile. Do not force the creation of default filter pools. Fully equivalent to getFilterPoolManager(profile, false).

Parameters:

profile - The system profile for which to get the manager.

Returns:

a filter pool manager

copyFilterPoolManager

public ISystemFilterPoolManager copyFilterPoolManager(ISystemProfile oldProfile,
                                                      ISystemProfile newProfile)
                                               throws Exception

Copy the filter pool manager and return a new one. Called during profile-copy operations. Will also copy all of the filter pools and their respective data.

Throws:

Exception

getDefaultSystemFilterPool

public ISystemFilterPool getDefaultSystemFilterPool(ISubSystem subsys)

Given a subsystem, return the first (hopefully only) default pool for this subsystem's profile.

testForActiveReferences

public ISubSystem[] testForActiveReferences(ISystemProfile profile)

Test if any filter pools in the given profile are referenced by other profiles, which are active.

Called when user tries to make a profile inactive. We prevent this if there exists active references.

Parameters:

profile - The profile being tested

Returns:

An array of the active subsystems which reference filter pools in this profile, or null if none are found.

getTranslatedFilterTypeProperty

public String getTranslatedFilterTypeProperty(ISystemFilter selectedFilter)

Return the translated string to show in the property sheet for the type property when a filter is selected.

showRefreshOnFilter

public boolean showRefreshOnFilter()

Return true if we should show the refresh action in the popup for the given element.

showGenericShowInTableOnFilter

public boolean showGenericShowInTableOnFilter()

Return true if we should show the show in table action in the popup for the given element.

showChangeFilterStringsPropertyPage

public boolean showChangeFilterStringsPropertyPage(ISystemFilter filter)

Given a filter, decide whether to show the Filter Strings property page for this filter. Default is true.

isFactoryFor

public boolean isFactoryFor(Class subSystemType)

Determines whether this factory is responsible for the creation of subsytems of the specified type Subsystem factories should override this to indicate which subsystems they support.

Parameters:

subSystemType - type of subsystem

Returns:

whether this factory is for the specified subsystemtype

setConnection

public void setConnection(IHost connection)

Called by adapters prior to asking for actions, in case the connection of the currently selected object is required by the action.

setCurrentSelection

public void setCurrentSelection(Object[] selection)

Called by adapters prior to asking for actions. For cases when current selection is needed.

commit

public boolean commit()

Saves absolutely everything to disk. This is called as a safety measure when the workbench shuts down.

Totally handled for you!

Calls saveSubSystems() and saveFilterPools()

Exceptions are swallowed since we cannot deal with them on shutdown anyway!

Specified by:

commit in interface IRSEPersistableContainer

Returns:

true if the object was persisted.

saveSubSystem

public void saveSubSystem(ISubSystem subsys)
                   throws Exception

Save one subsystem to disk. Called by each subsystem when their data changes.

Throws:

Exception

getSubSystemList

public List getSubSystemList()

Private. Do not call or use.

Returns:

The list of SubSystemList references

getFilterPoolManagerList

public List getFilterPoolManagerList()

Private. Do not call or use.

Returns:

The list of FilterPoolManagerList references

getDefaultFilterPool

public ISystemFilterPool getDefaultFilterPool(ISystemProfile profile,
                                              String oldProfileName)

getSystemProfile

public ISystemProfile getSystemProfile(String name)

renameFilterPoolManager

public void renameFilterPoolManager(ISystemProfile profile)