org.eclipse.rse.model
Interface ISystemRegistryUI

All Superinterfaces:

ISchedulingRule, ISystemRegistry

All Known Implementing Classes:

SystemRegistry

public interface ISystemRegistryUI

extends ISystemRegistry

Registry or front door for all remote system connections.

Method Summary

Clipboard	getSystemClipboard() Returns the clipboard used for copy actions
void	updateHost(Shell shell, IHost conn, String systemType, String connectionName, String hostName, String description, String defaultUserId, int defaultUserIdLocation) Update an existing connection given the new information.

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

areAllSubSystemsConnected, connectedStatusChange, connectedStatusChange, copyHost, copySystemProfile, createHost, createHost, createHost, createLocalHost, createSystemProfile, deleteHost, deleteSubSystem, deleteSystemProfile, disconnectAllSubSystems, expandHost, expandSubSystem, findFilterReferencesFor, getAbsoluteNameForConnection, getAbsoluteNameForSubSystem, getActiveSystemProfileNames, getActiveSystemProfiles, getAllSystemProfileNames, getAllSystemProfileNamesVector, getAllSystemProfiles, getConnectorServices, getHost, getHostAliasNames, getHostAliasNames, getHostAliasNamesForAllActiveProfiles, getHostCount, getHostCount, getHostCountWithinProfile, getHostNames, getHostNames, getHostPosition, getHosts, getHostsByProfile, getHostsByProfile, getHostsBySubSystemConfiguration, getHostsBySubSystemConfigurationCategory, getHostsBySubSystemConfigurationId, getHostsBySystemType, getHostsBySystemTypes, getLastException, getLocalHost, getQualifiedHostNames, getServiceSubSystems, getSubSystem, getSubSystem, getSubSystemConfiguration, getSubSystemConfiguration, getSubSystemConfigurationProxies, getSubSystemConfigurationProxiesByCategory, getSubSystemConfigurations, getSubSystemConfigurationsByCategory, getSubSystemConfigurationsBySystemType, getSubSystemConfigurationsBySystemType, getSubSystems, getSubSystems, getSubSystems, getSubSystems, getSubSystemsBySubSystemConfigurationCategory, getSystemClipboardObjects, getSystemFilterPool, getSystemFilterStartHere, getSystemProfile, getSystemProfileManager, invalidateFiltersFor, invalidateFiltersFor, isAnySubSystemConnected, isAnySubSystemSupportsConnect, moveHost, moveHosts, renameHost, renameSystemProfile, restore, save, saveHost, saveHostPool, setHostOffline, setQualifiedHostNames, setShowFilterPools, setShowNewHostPrompt, setSubSystemConfigurationProxies, setSystemProfileActive, showRSEPerspective

Methods inherited from interface org.eclipse.core.runtime.jobs.ISchedulingRule

contains, isConflicting

Method Detail

updateHost

public void updateHost(Shell shell,
                       IHost conn,
                       String systemType,
                       String connectionName,
                       String hostName,
                       String description,
                       String defaultUserId,
                       int defaultUserIdLocation)

Update an existing connection given the new information. This method:

• calls the setXXX methods on the given connection object, updating the information in it.
• save the connection's connection pool to disk
• fires an ISystemResourceChangeEvent event of type EVENT_CHANGE to all registered listeners
• if the systemtype or hostname is changed, calls disconnect on each associated subsystem. We must do this because a hostname changes fundamentally affects the connection, rendering any information currently displayed under that connection obsolete. That is, the user will have to reconnect.

Parameters:

conn - SystemConnection to be updated

systemType - system type matching one of the system type names defined via the systemTypes extension point.

connectionName - unique connection name.

hostName - ip name of host.

description - optional description of the connection. Can be null.

defaultUserIdLocation - one of the constants in ISystemUserIdConstants that tells us where to set the user Id

defaultUserId - userId to use as the default for the subsystems.

getSystemClipboard

public Clipboard getSystemClipboard()

Returns the clipboard used for copy actions