RSE
Release 3.3

Deprecated API


Contents
Deprecated Classes
org.eclipse.rse.ui.widgets.InheritControl
            
org.eclipse.rse.files.ui.resources.SystemTempFileListener.RefreshResourcesUIJob
          don't use this class, it's only here because to remove it would be an API change, and we can't do that until 3.0. Instead of using this, SynchResourcesJob should be used. 
 

Deprecated Exceptions
org.eclipse.rse.services.clientserver.messages.IndicatorException
          This exception is no longer used and client code should not try catching it unless it wants to be compatible with earlier RSE versions. 
org.eclipse.rse.services.files.RemoteFileCancelledException
          use SystemOperationCancelledException 
org.eclipse.rse.services.files.RemoteFileSecurityException
          Use SystemRemoteSecurityException 
 

Deprecated Fields
org.eclipse.rse.ui.view.AbstractSystemViewAdapter.cancelledObject
          Use AbstractSystemViewAdapter.getCancelledMessageObject() instead. 
org.eclipse.rse.ui.view.SystemAbstractAPIProvider.cancelledObject
          don't use this field 
org.eclipse.rse.ui.view.AbstractSystemViewAdapter.emptyList
          Do not use directly. Use AbstractSystemViewAdapter.checkForEmptyList(Object[], Object, boolean) when needed. 
org.eclipse.rse.ui.view.SystemAbstractAPIProvider.emptyList
          don't use this field 
org.eclipse.rse.ui.view.AbstractSystemViewAdapter.errorObject
          Use AbstractSystemViewAdapter.getFailedMessageObject() instead. 
org.eclipse.rse.ui.view.SystemAbstractAPIProvider.errorObject
          don't use this field 
org.eclipse.rse.core.events.ISystemResourceChangeEvents.EVENT_COMMAND_FINISHED
          use EVENT_COMMAND_SHELL_FINISHED 
org.eclipse.rse.core.events.ISystemResourceChangeEvents.EVENT_COMPILE_COMMAND_RUN
            
org.eclipse.rse.core.events.ISystemResourceChangeEvents.EVENT_REFRESH_SELECTED
          obtain the selection yourself and do EVENT_REFRESH or EVENT_REFRESH_REMOTE 
org.eclipse.rse.core.events.ISystemResourceChangeEvents.EVENT_REFRESH_SELECTED_FILTER
          Refreshing a particular context(filter) only can lead to inconsistencies, so better obtain the selection yourself and do EVENT_REFRESH or EVENT_REFRESH_REMOTE 
org.eclipse.rse.core.events.ISystemResourceChangeEvents.EVENT_REFRESH_SELECTED_PARENT
          obtain the selection yourself and do EVENT_REFRESH or EVENT_REFRESH_REMOTE 
org.eclipse.rse.ui.ISystemIconConstants.ICON_IDE_COLLAPSEALL_ID
          use ISharedImages via PlatformUI.getWorkbench().getSharedImages() 
org.eclipse.rse.ui.SystemBasePlugin.log
          do not use use this directly, use SystemBasePlugin.getLogger() instead for lazy loading of the Logger. We do not guarantee that this variable is ever initialized. 
org.eclipse.rse.ui.view.AbstractSystemViewAdapter.MSG_SUB_PREFIX
          use Eclipse NLS or Java Messageformat for String substitution. 
org.eclipse.rse.ui.view.AbstractSystemViewAdapter.MSG_SUB1
          use Eclipse NLS or Java Messageformat for String substitution. 
org.eclipse.rse.ui.view.AbstractSystemViewAdapter.MSG_SUB2
          use Eclipse NLS or Java Messageformat for String substitution. 
org.eclipse.rse.ui.view.AbstractSystemViewAdapter.msgList
          Do not use directly. Use AbstractSystemViewAdapter.getCancelledMessageObject() or AbstractSystemViewAdapter.getFailedMessageObject() or AbstractSystemViewAdapter.checkForEmptyList(Object[], Object, boolean) when needed. 
org.eclipse.rse.ui.view.SystemAbstractAPIProvider.msgList
          don't use this field 
org.eclipse.rse.ui.view.AbstractSystemViewAdapter.nullObject
          Use AbstractSystemViewAdapter.checkForEmptyList(Object[], Object, boolean) instead. 
org.eclipse.rse.ui.view.SystemAbstractAPIProvider.nullObject
          Use SystemAbstractAPIProvider.checkForEmptyList(Object[], Object, boolean) instead. 
org.eclipse.rse.ui.view.AbstractSystemViewAdapter.shell
          Use AbstractSystemViewAdapter.getShell() and AbstractSystemViewAdapter.setShell(Shell) 
org.eclipse.rse.ui.view.SystemAbstractAPIProvider.sr
          don't use this field 
org.eclipse.rse.core.IRSESystemType.SYSTEMTYPE_AIX
          Use IRSESystemType.SYSTEMTYPE_AIX_ID. 
org.eclipse.rse.core.IRSESystemType.SYSTEMTYPE_ISERIES
          Use IRSESystemType.SYSTEMTYPE_ISERIES_ID. 
org.eclipse.rse.core.IRSESystemType.SYSTEMTYPE_LINUX
          Use IRSESystemType.SYSTEMTYPE_LINUX_ID. 
org.eclipse.rse.core.IRSESystemType.SYSTEMTYPE_LOCAL
          Use IRSESystemType.SYSTEMTYPE_LOCAL_ID. 
org.eclipse.rse.core.IRSESystemType.SYSTEMTYPE_PASE
          Use IRSESystemType.SYSTEMTYPE_PASE_ID. 
org.eclipse.rse.core.IRSESystemType.SYSTEMTYPE_POWER_LINUX
          Use IRSESystemType.SYSTEMTYPE_POWER_LINUX_ID. 
org.eclipse.rse.core.IRSESystemType.SYSTEMTYPE_UNIX
          Use IRSESystemType.SYSTEMTYPE_UNIX_ID. 
org.eclipse.rse.core.IRSESystemType.SYSTEMTYPE_WINDOWS
          Use IRSESystemType.SYSTEMTYPE_WINDOWS_ID. 
org.eclipse.rse.core.IRSESystemType.SYSTEMTYPE_ZSERIES
          Use IRSESystemType.SYSTEMTYPE_ZSERIES_ID. 
org.eclipse.rse.core.IRSESystemType.SYSTEMTYPE_ZSERIES_LINUX
          Use IRSESystemType.SYSTEMTYPE_ZSERIES_LINUX_ID. 
org.eclipse.rse.services.clientserver.IClassifierConstants.TYPE_LINK
          should use TYPE_SYMBOLIC_LINK 
org.eclipse.rse.ui.view.AbstractSystemViewAdapter.viewer
          use AbstractSystemViewAdapter.getViewer() and AbstractSystemViewAdapter.setViewer(Viewer) 
 

Deprecated Methods
org.eclipse.rse.subsystems.files.core.subsystems.RemoteFileSubSystem.cancelSearch(IHostSearchResultConfiguration)
          Do not call this method directly since it is not implemented. 
org.eclipse.rse.ui.view.AbstractSystemViewAdapter.checkForNull(Object[], boolean)
          Use AbstractSystemViewAdapter.checkForEmptyList(Object[], Object, boolean) instead. 
org.eclipse.rse.ui.view.SystemAbstractAPIProvider.checkForNull(Object[], boolean)
          Use SystemAbstractAPIProvider.checkForEmptyList(Object[], Object, boolean) instead. 
org.eclipse.rse.files.ui.resources.UniversalFileTransferUtility.compressedCopyRemoteResourceToWorkspace(IRemoteFile, IProgressMonitor)
          use compressedDownloadToWorkspace 
org.eclipse.rse.files.ui.resources.UniversalFileTransferUtility.compressedCopyWorkspaceResourceToRemote(IContainer, IRemoteFile, IProgressMonitor)
          use compressedUploadFromWorkspace 
org.eclipse.rse.files.ui.resources.UniversalFileTransferUtility.copyRemoteFileToWorkspace(File, IProgressMonitor)
          use downloadFileToWorkspace 
org.eclipse.rse.files.ui.resources.UniversalFileTransferUtility.copyRemoteFileToWorkspace(IRemoteFile, IProgressMonitor)
          use downloadFileToWorkspace 
org.eclipse.rse.files.ui.resources.UniversalFileTransferUtility.copyRemoteResourcesToWorkspace(SystemRemoteResourceSet, IProgressMonitor)
          use downloadResourcesToWorkspace 
org.eclipse.rse.files.ui.resources.UniversalFileTransferUtility.copyRemoteResourcesToWorkspaceMultiple(SystemRemoteResourceSet, IProgressMonitor)
          use downloadResourcesToWorkspaceMultiple 
org.eclipse.rse.files.ui.resources.UniversalFileTransferUtility.copyRemoteResourceToWorkspace(File, IProgressMonitor)
          use downloadResourceToWorkspace 
org.eclipse.rse.files.ui.resources.UniversalFileTransferUtility.copyRemoteResourceToWorkspace(IRemoteFile, IProgressMonitor)
          use downloadResourceToWorkspace 
org.eclipse.rse.files.ui.resources.UniversalFileTransferUtility.copyWorkspaceResourcesToRemote(SystemWorkspaceResourceSet, IRemoteFile, IProgressMonitor, boolean)
          use uploadResourcesFromWorkspace 
org.eclipse.rse.files.ui.resources.UniversalFileTransferUtility.copyWorkspaceResourceToRemote(IResource, IRemoteFile, IProgressMonitor)
          use uploadResourceFromWorkspace 
org.eclipse.rse.files.ui.resources.UniversalFileTransferUtility.copyWorkspaceResourceToRemote(IResource, IRemoteFile, IProgressMonitor, boolean)
          use uploadResourceFromWorkspace 
org.eclipse.rse.ui.SystemWidgetHelpers.createBrowseButton(Composite, Listener, String)
            
org.eclipse.rse.ui.view.AbstractSystemViewAdapter.doDrop(Object, Object, boolean, boolean, IProgressMonitor)
          use doDrop(Object from, Object to, boolean sameSystemType, boolean sameSystem, int srcType, IProgressMonitor monitor) instead 
org.eclipse.rse.ui.view.AbstractSystemViewAdapter.getEmptyMessageObject()
          Use AbstractSystemViewAdapter.checkForEmptyList(Object[], Object, boolean) instead. 
org.eclipse.rse.services.clientserver.archiveutils.ArchiveHandlerManager.getExtension(File)
          Use ArchiveHandlerManager.getRegisteredExtension(File) instead 
org.eclipse.rse.ui.SystemBasePlugin.getImageDescriptorFromIDE(String)
          use ISharedImages via PlatformUI.getWorkbench().getSharedImages() 
org.eclipse.rse.services.processes.AbstractProcessService.getMessage(String)
          This method was removed from IProcessService in RSE 3.0, and implementers are not expected to return anything useful. Use SimpleSystemMessage to create system messages instead. 
org.eclipse.rse.core.IRSESystemType.getName()
          Use IRSESystemType.getId() for accessing the unique id or IRSESystemType.getLabel() for the UI label. 
org.eclipse.rse.connectorservice.dstore.DStoreConnectorService.getNoLaunchEnabled(SubSystem)
          Use instead AbstractConnectorService.isServerLaunchTypeEnabled(ISubSystem, ServerLaunchType) or SubSystemConfiguration.supportsServerLaunchType(ServerLaunchType) 
org.eclipse.rse.core.subsystems.SubSystem.getObjectWithAbsoluteName(String)
          use getObjectWithAbsoluteName(String key, IProgressMonitor monitor) 
org.eclipse.rse.core.subsystems.IRemoteObjectResolver.getObjectWithAbsoluteName(String)
          - use getObjectwithAbsoluteName(String key, IProgressMonitor monitor) 
org.eclipse.rse.services.files.IFileService.getOutputStream(String, String, boolean, IProgressMonitor)
          Use IFileService.getOutputStream(String, String, int, IProgressMonitor) instead 
org.eclipse.rse.services.files.AbstractFileService.getOutputStream(String, String, boolean, IProgressMonitor)
          use AbstractFileService.getOutputStream(String, String, int, IProgressMonitor) instead 
org.eclipse.rse.subsystems.files.core.servicesubsystem.FileServiceSubSystem.getOutputStream(String, String, boolean, IProgressMonitor)
          Use FileServiceSubSystem.getOutputStream(String, String, int, IProgressMonitor) instead 
org.eclipse.rse.subsystems.files.core.subsystems.IRemoteFileSubSystem.getOutputStream(String, String, boolean, IProgressMonitor)
          Use IRemoteFileSubSystem.getOutputStream(String, String, int, IProgressMonitor) instead 
org.eclipse.rse.subsystems.files.core.servicesubsystem.AbstractRemoteFile.getParentNoRoot()
          - shouldn't need apis like this 
org.eclipse.rse.ui.RSEUIPlugin.getPersistenceManager()
          use RSECorePlugin.getThePersistenceManager() 
org.eclipse.rse.core.subsystems.SubSystem.getProperties(Object, String[])
          this shouldn't be used 
org.eclipse.rse.core.subsystems.ISubSystem.getProperties(Object, String[])
          this shouldn't be used 
org.eclipse.rse.core.subsystems.SubSystem.getProperty(Object, String)
          this shouldn't be used 
org.eclipse.rse.core.subsystems.ISubSystem.getProperty(Object, String)
          this shouldn't be used 
org.eclipse.rse.ui.view.AbstractSystemViewAdapter.getRemoteAdapter(Object)
          use SystemAdapterHelpers.getRemoteAdapter(o, getViewer()) instead 
org.eclipse.rse.core.subsystems.SubSystem.getRemoteAttribute(String)
            
org.eclipse.rse.connectorservice.dstore.DStoreConnectorService.getRexecLaunchEnabled(SubSystem)
          Use instead AbstractConnectorService.isServerLaunchTypeEnabled(ISubSystem, ServerLaunchType) or SubSystemConfiguration.supportsServerLaunchType(ServerLaunchType) 
org.eclipse.rse.subsystems.files.core.servicesubsystem.AbstractRemoteFile.getRoot()
          - shouldn't need apis like this 
org.eclipse.rse.core.subsystems.SubSystem.getRunnableContext()
          this is scheduled to be removed since we want to avoid UI components in SubSystem. 
org.eclipse.rse.core.model.ISystemRegistry.getSubSystemConfigurations()
          use ISystemRegistry.getSubSystemConfigurationProxies() and filter the list of needed subsystem configurations in order to activate only those that are really needed. 
org.eclipse.rse.core.model.ISystemRegistry.getSubSystemConfigurationsBySystemType(IRSESystemType, boolean)
          Use ISystemRegistry.getSubSystemConfigurationsBySystemType(IRSESystemType,boolean,boolean) instead in order to avoid instantiating subsystem configurations if possible. 
org.eclipse.rse.core.model.ISystemRegistry.getSubSystems(IHost, boolean)
          Use ISystemRegistry.getSubSystems(IHost) instead, the "force" parameter is now ignored. 
org.eclipse.rse.core.model.ISystemRegistry.getSubSystemsBySubSystemConfigurationCategory(String, IHost)
          use ISystemRegistry.getSubSystemConfigurationProxiesByCategory(String) and instantiate only those subsystem configurations from the proxy that are really needed. Then, use ISubSystemConfiguration.getSubSystems(boolean) with a parameter true. 
org.eclipse.rse.core.IRSECoreRegistry.getSystemType(String)
          Use IRSECoreRegistry.getSystemTypeById(String). 
org.eclipse.rse.ui.view.AbstractSystemViewAdapter.getSystemViewElementAdapter(Object)
          use SystemAdapterHelpers.getViewAdapter(o, getViewer()) instead 
org.eclipse.rse.ui.RSEUIPlugin.getTheSystemProfileManager()
          use RSECorePlugin.getTheSystemProfileManager() 
org.eclipse.rse.core.subsystems.SubSystem.getVendorAttribute(String, String)
          use property sets directly now 
org.eclipse.rse.core.subsystems.ISubSystem.getVendorAttribute(String, String)
          Subsystems can now take named property sets. These should be used instead. See IPropertySet 
org.eclipse.rse.core.model.ISystemViewInputProvider.getViewer()
          use other methods for getting the active viewer. 
org.eclipse.rse.ui.view.AbstractSystemViewAdapter.initMsgObjects()
          Internal use. Do not call this method. 
org.eclipse.rse.ui.RSESystemTypeAdapter.isEnabled(Object)
          Clients should use IRSESystemType.isEnabled(), which is available without UI dependencies, in order to guarantee consistent availability of system types. Providers of custom RSESystemTypeAdapter implementations, which override this method, should move their code to their IRSESystemType implementations. See https://bugs.eclipse.org/bugs/show_bug.cgi?id=218655#c1 for details. 
org.eclipse.rse.ui.SystemBasePlugin.isHeadless()
          this method is useless right now because SystemBasePlugin is part of the rse.ui plugin which depends on workbench and therefore we can never load this class while actually being in headless mode. Normally this should return false however, because the javadoc says we "equate this to mean that the workbench is not running", it's possible early on that the method may return true if the workbench has not yet been instantiated - although it will later return false. 
org.eclipse.rse.ui.RSEUIPlugin.isSystemRegistryActive()
          use RSECorePlugin.isTheSystemRegistryActive() 
org.eclipse.rse.ui.RSEUIPlugin.isTheSystemRegistryActive()
          use RSECorePlugin.isTheSystemRegistryActive() 
org.eclipse.rse.ui.validators.ValidatorUniqueString.isValid(String)
          You should be using ValidatorUniqueString.validate(String) and SystemMessage objects 
org.eclipse.rse.services.clientserver.PathUtility.normalizeUnix(String)
          this should not be used since \ is a valid part of UNIX file names. Also, a better normalizer would also consider swquences like a/../b and a/./b -- Try to work without this method. 
org.eclipse.rse.subsystems.shells.core.subsystems.RemoteCmdSubSystem.runCommand(String, Object)
          use RemoteCmdSubSystem.runCommand(String, Object, IProgressMonitor) 
org.eclipse.rse.subsystems.shells.core.subsystems.RemoteCmdSubSystem.runCommand(String, Object, boolean)
          use RemoteCmdSubSystem.runCommand(String, Object, boolean, IProgressMonitor) 
org.eclipse.rse.subsystems.shells.core.subsystems.RemoteCmdSubSystem.runShell(Object)
          use RemoteCmdSubSystem.runShell(Object, IProgressMonitor) 
org.eclipse.rse.ui.RSESystemTypeAdapter.setDefaultUserId(Object, String)
          Use RSEPreferencesManager.setDefaultUserId(IRSESystemType, String) 
org.eclipse.rse.ui.SystemWidgetHelpers.setHelp(Control, IViewPart, Object)
            
org.eclipse.rse.ui.RSESystemTypeAdapter.setIsEnabled(Object, boolean)
          Use RSEPreferencesManager.setIsSystemTypeEnabled(IRSESystemType, boolean) 
org.eclipse.rse.core.subsystems.SubSystem.setProperties(Object, String[], String[])
          this shouldn't be used 
org.eclipse.rse.core.subsystems.ISubSystem.setProperties(Object, String[], String[])
          this shouldn't be used 
org.eclipse.rse.core.subsystems.SubSystem.setProperty(Object, String, String)
          this shouldn't be used 
org.eclipse.rse.core.subsystems.ISubSystem.setProperty(Object, String, String)
          this shouldn't be used 
org.eclipse.rse.core.subsystems.SubSystem.setRemoteAttribute(String, String)
            
org.eclipse.rse.core.subsystems.RemoteServerLauncher.setRestrictedType(String, String)
            
org.eclipse.rse.core.subsystems.SubSystem.setVendorAttribute(String, String, String)
          use property sets directly now 
org.eclipse.rse.core.subsystems.ISubSystem.setVendorAttribute(String, String, String)
          Subsystems can now take named property sets. These should be used instead. See IPropertySet 
org.eclipse.rse.ui.view.AbstractSystemViewAdapter.sub(String, String, String)
          Clients should use Eclipse NLS or Java MessageFormat or String.replaceAll(String, String) to do substring replacement and variable substitution. 
 

Deprecated Constructors
org.eclipse.rse.services.files.RemoteFileException(ResourceBundle, String)
          this constructor violates the contract that all RemoteFileException instances must have an embedded remote exception for SystemRemoteMessageException.getRemoteException() to return 
org.eclipse.rse.services.files.RemoteFileException(String)
          this constructor violates the contract that all RemoteFileException instances must have an embedded remote exception for SystemRemoteMessageException.getRemoteException() to return 
org.eclipse.rse.services.files.RemoteFileException(SystemMessage)
          this constructor violates the contract that all RemoteFileException instances must have an embedded remote exception for SystemRemoteMessageException.getRemoteException() to return 
org.eclipse.rse.ui.SystemBaseForm(ISystemMessageLine)
          You should now use the constructor that takes a shell. 
org.eclipse.rse.ui.actions.SystemBaseSubMenuAction(ResourceBundle, String, String, ImageDescriptor, Shell)
          use fields from resource class directly now instead of via ResourceBundle 
 


RSE
Release 3.3

Copyright (c) IBM Corporation and others 2000, 2011. All Rights Reserved.