RSE Properties API

You can supply your own property pages to any node in the Remote Systems tree or table views. As you author your property page classes, you may find the RSE-supplied base class for property pages of value.

RSE-Supplied Base Class for Property Pages

The RSE supplies a base class for property pages, org.eclipse.rse.ui.propertypages.SystemBasePropertyPage, that extends the base eclipse property page org.eclipse.ui.dialogs.PropertyPage. The advantages of using this RSE-supplied class are:

Supports SystemMessage error messages, allowing the user to click on a message to see its details.
Supports automatic assignment of mnemonics for input-capable fields.
Supports automatic management of the "isValid" property based on current error message status in the message line. This property is important to set correct, so eclipse knows when to prevent the user from switching focus to other property pages.

Property Pages for RSE Non-Remote Resources

You can simply use the eclipse-supplied extension point org.eclipse.ui.propertyPages to contribute property pages to any of the non-remote artifacts from the RSE model. To use this extension point, you need to know the class or, preferably, interface that the objects implement, which we describe here:

RSE Resource	Implements Interface
Profile	`org.eclipse.rse.core.model.ISystemProfile`
Host	`org.eclipse.rse.core.model.IHost`
Subsystem	`org.eclipse.rse.core.subsystems.ISubSystem`
Filter pool reference	`org.eclipse.rse.core.filters.ISystemFilterPoolReference`
Filter reference	`org.eclipse.rse.core.filters.ISystemFilterReference`

Property Pages for RSE Remote Resources

See Plugging In Property Pages for information on how to contribute property pages for remote resources. Because remote resources have no underlying eclipse resource, and typically all are instances of the same class, Eclipse Filtering capabilities are used to allow very explicit scoping of the property page to very specific types of remote resources.