RSE API Discussion

As we are working towards an RSE 1.0 release, which should contain stable, accepted APIs, we want to expose the RSE APIs to discussion in a broader public.

This page serves as the entry point into those discussions. It will point to overview articles and serve as the starting point to convey the overall picture of RSE APIs.

Individual API discussions will be held on Bugzilla. Please file your requests for API changes as enhancement requests with the String [api] in the subject. At regular intervals, we will search bugzilla for such requests and sort them into this overview page as appropriate.

Core and System Registry API

• org.eclipse.rse.core: IRSECoreRegistry, IRSESystemType
  • systemTypes.exsd -- missing documentation

Services API

• org.eclipse.rse.services: IService

Files API

• Eclipse File Service APIs Compared
• org.eclipse.rse.services.files: IHostFile, IFileService
• Check IClassifierConstants (from clientserver)

Shellls API

• org.eclipse.rse.services.shells: IShellService, IHostSHell, AbstractHostShell, IHostShellChangeEvent, IHostShellOutput*

Processes API

• org.eclipse.rse.services.processes: IProcessService, IHostProcess, IHostProcessFilter
• API should be moved to single package (currently also ...clientserver)

Persistence Manager

• org.eclipse.rse.ui/persistence: IRSEPersistenceProvider, IRSEPersistenceManager, IRSEPersistableContainer
  • persistenceProviders.exsd
  • Currently in rse.ui, should go to non-UI (core) plugin?

Remote Search API

• org.eclipse.rse.services.search: ISearchService, IHostSearchResultConfiguration, IHostSearchResultSet, IHostSearchResult, ISearchHandler, IHostSearchResultConfigurationFactory
• Check SystemSearchString (from clientserver)

UI-Related APIs

To be discussed:

• org.eclipse.rse.ui
  • archivehandlers.exsd -- go to services.files?
  • compile.exsd -- go to services.files or services.shells?
  • dynamicPopupMenuExtensions.exsd -- replace by Platform popupMenus?
  • keystoreProviders.exsd
  • mountPathMappers.exsd
  • passwordPersistence.exsd
  • popupMenus.exsd -- replace by Platform popupMenus?
  • propertyPages.exsd -- replace by Platform propertyPages?
  • remoteSystemsViewPreferencesAction.exsd -- ??
  • systemtype.exsd -- obsoleted by systemType ??

UI Model

• org.eclipse.rse.ui/org.eclipse.rse.model
  • IHost, IProperty, IPropertySet, IPropertySetContainer, IRSEModelObject
  • ISystemModelChangeEvent, ISystemModelChangeListener
  • ISystemPreferenceChange* -- Replace by Platform equivalent?
  • ISystemRegistry -- go to rse.core?

Subsystem Configuration

• org.eclipse.rse.ui
  • subsystemConfiguration.exsd -- Still has some com.ibm.etools...
  • ISubSystemConfiguration, SubSystemConfiguration, ServiceSubSystemConfiguration -- can this large class/interface be splitted?
  • ISubSystemConfigurationProxy -- can this be made internal?
  • ISystemValidator
  • IHost
  • ISubSystem
  • IConnectorService, IServerLauncherProperties

Filtering

• org.eclipse.rse.ui/org.eclipse.rse.filters
  • ISystemFilterPoolManagerProvider, ISystemFilter, ISystemFilterConstants, ...
  • ISystemFilterNamingPolicy, ISystemFilterPool

Profiles and Team Management

• org.eclipse.rse.ui/
  • ISystemFilterPool, ISystemProfile

Files Subsystem

• org.eclipse.rse.subsystems.files.core/model
  • IRemotePath, ISystemFileAPIProvider, ISystemFileRemoteTypes, ISystemFileTransferModeMapping, ISystemFileTransferModeRegistry, ISystemRemoteCommand, ISystemRemoteCommandMessage
  • IRemoteFile, IRemoteFileContext, IVirtualRemoteFile,...
  • IHostFileToRemoteFileAdapter

Processes Subsystem

• org.eclipse.rse.subsystems.processes.core/subsystem
  • IHostProcessToRemoteProcessAdapter, IRemoteProcess, IRemoteProcessContext
  • IRemoteProcessSubSystemConfiguration

Shells Subsystem

• org.eclipse.rse.subsystems.shells.core/model
  • ISystemOutputRemoteTypes
  • ICandidateCommand, IRemoteCmdSubSystem, IRemoteError, IRemoteOutput
• Duplication?
• Push the dstore remote command matchers into core?