Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Mail Systems
Eclipse Documentation

How To Guides
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Problem Solutions
Privacy Policy




RSE Preferences API

RSE Preference Pages Category

All Remote System Explorer preference pages are rooted within the preferences category org.eclipse.rse.ui.preferences.RemoteSystemsPreferencePage, as shown here:

RSE Preference Pages Classes

There is no RSE-supplied base class for preference pages, but we recommend you extend FieldEditorPreferencePage in package org.eclipse.jface.preference. This JFace class allows you to create a preferences page as a sequence of "field editors" which know how to initialize, load and store their values from their preferences store.

We also suggest the following when designing your preference pages:

  1. A interface for your preferences constants. It should store two constants per preference: the preference store key, and its default value.
  2. Static getter and setter methods in your preference page classes, one per preference, to query or update the preference value in the preferences store.
  3. An initDefaults(IPreferenceStore store) method per preferences class, that initializes the preference store value of each preference on that page.
  4. In your plugin class, an override of the initializeDefaultPreferences(IPreferenceStore store) method, so it calls your initDefaults(store) method for each preference page class.

Should you need to query, or update, any RSE preferences you can do so via the getters and setters in org.eclipse.rse.core.SystemPreferencesManager.

The RSE supplies a few field editors, complementing what JFace supplies in org.eclipse.jface.preference. The RSE-supplied field editors, and the RSE-supplied preferences pages, are all found in package org.eclipse.rse.ui.propertypages :

  • SystemBooleanFieldEditor . Extends BooleanFieldEditor to add support for tooltip text.

  • SystemComboBoxFieldEditor . Shows a combo box allowing the user to choose from a finite list of discrete possibilities.

  • SystemKeyValueFieldEditor . Shows a list of hard-coded keys, each of which supports a user-specifiable value.

  • SystemStringFieldEditor . For simple string preferences. Unlike the JFace string editor, this supports tooltip text and RSE validators and massagers on the typed text.

  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire