org.eclipse.rse.ui.actions
Class SystemAbstractPopupMenuExtensionAction

java.lang.Object
  org.eclipse.rse.ui.actions.SystemAbstractPopupMenuExtensionAction

All Implemented Interfaces:

IActionDelegate, IObjectActionDelegate

Direct Known Subclasses:

SystemAbstractRemoteFilePopupMenuExtensionAction, TestPopupMenuAction1

public abstract class SystemAbstractPopupMenuExtensionAction

extends Object

implements IObjectActionDelegate

This is a base class to simplify the creation of actions supplied via the org.eclipse.rse.core.popupMenus extension point.

The only method you must implement is run(). You may optionally override getEnabled(Object[])

Convenience methods are:

• getShell()
• getProxyAction()
• getSelection()
• getSelectionCount()
• getSelectedRemoteObjects()
• getFirstSelectedRemoteObject()
• getRemoteAdapter(Object)
• getSubSystem()
• getSubSystemConfiguration()
• getSystemConnection()
• getRemoteObjectName(Object obj, ISystemRemoteElementAdapter adapter)
• getRemoteObjectSubSystemConfigurationId(Object obj, ISystemRemoteElementAdapter adapter)
• getRemoteObjectTypeCategory(Object obj, ISystemRemoteElementAdapter adapter)
• getRemoteObjectType(Object obj, ISystemRemoteElementAdapter adapter)
• getRemoteObjectSubType(Object obj, ISystemRemoteElementAdapter adapter)
• getRemoteObjectSubSubType(Object obj, ISystemRemoteElementAdapter adapter)

See Also:

ISystemRemoteElementAdapter, SystemPromptDialog

Field Summary

protected static Object[]	EMPTY_ARRAY
protected IAction	proxyAction
protected IStructuredSelection	sel
protected Shell	shell
protected IWorkbenchPart	viewPart

Constructor Summary

SystemAbstractPopupMenuExtensionAction()
Constructor

Method Summary

IWorkbenchPart	getActivePart() Get the current view part.
boolean	getEnabled(Object[] currentlySelected) The user has selected one or more objects.
Object	getFirstSelectedRemoteObject() Retrieve the first selected object, for convenience.
ISystemRemoteElementAdapter	getFirstSelectedRemoteObjectAdapter() Retrieve the adapter of the first selected object as an ISystemRemoteElementAdapter object, for convenience.
IAction	getProxyAction() Return the proxy action for this action delegate
ISystemRemoteElementAdapter	getRemoteAdapter(Object o) Returns the implementation of ISystemRemoteElementAdapter for the given object.
String	getRemoteObjectName(Object obj, ISystemRemoteElementAdapter adapter) Returns the name of the given remote object, given its remote object adapter.
String	getRemoteObjectSubSubType(Object obj, ISystemRemoteElementAdapter adapter) Returns the sub-subtype of the given remote object, given its remote object adapter.
String	getRemoteObjectSubSystemConfigurationId(Object obj, ISystemRemoteElementAdapter adapter) Returns the id of the subsystem factory of the given remote object, given its remote object adapter.
String	getRemoteObjectSubType(Object obj, ISystemRemoteElementAdapter adapter) Returns the subtype of the given remote object, given its remote object adapter.
String	getRemoteObjectType(Object obj, ISystemRemoteElementAdapter adapter) Returns the type of the given remote object, given its remote object adapter.
String	getRemoteObjectTypeCategory(Object obj, ISystemRemoteElementAdapter adapter) Returns the type category of the given remote object, given its remote object adapter.
ISystemRemoteElementAdapter[]	getSelectedRemoteObjectAdapters() Retrieve the adapters of the currently selected objects as an array of ISystemRemoteElementAdapter objects.
Object[]	getSelectedRemoteObjects() Retrieve the currently selected objects as an array of Object objects.
IStructuredSelection	getSelection() Retrieve the current selected objects as a structured selection
int	getSelectionCount() Retrieve the number of items currently selected
Shell	getShell() Return the shell hosting this action
ISubSystem	getSubSystem() Returns the subsystem from which the selected remote objects were resolved.
ISubSystemConfiguration	getSubSystemConfiguration() Returns the subsystem factory which owns the subsystem from which the selected remote objects were resolved
IHost	getSystemConnection() Return the SystemConnection from which the selected remote objects were resolved
void	printTest() Debug method to print out details of given selected object...
abstract void	run() The user has selected this action.
void	run(IAction action) The Eclipse-supplied proxy action has been selected to run.
void	selectionChanged(IAction action, ISelection sel) Called by Eclipse when the user selects something.
void	setActivePart(IAction action, IWorkbenchPart part)
void	setChecked(boolean checked) For toggle actions (attribute state specified in action tag), set the toggle state
void	setEnabled(boolean enabled) Change the enabled state of the action

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

viewPart

protected IWorkbenchPart viewPart

sel

protected IStructuredSelection sel

proxyAction

protected IAction proxyAction

shell

protected Shell shell

EMPTY_ARRAY

protected static final Object[] EMPTY_ARRAY

Constructor Detail

SystemAbstractPopupMenuExtensionAction

public SystemAbstractPopupMenuExtensionAction()

Constructor

Method Detail

run

public abstract void run()

The user has selected this action. This is where the actual code for the action goes.

getEnabled

public boolean getEnabled(Object[] currentlySelected)

The user has selected one or more objects. This is an opportunity to enable/disable this action based on the current selection. By default, it is always enabled. Return false to disable it.

setActivePart

public void setActivePart(IAction action,
                          IWorkbenchPart part)

Specified by:

setActivePart in interface IObjectActionDelegate

See Also:

IObjectActionDelegate.setActivePart(IAction, IWorkbenchPart)

getActivePart

public IWorkbenchPart getActivePart()

Get the current view part. Handy for things like getting the shell.

run

public void run(IAction action)

The Eclipse-supplied proxy action has been selected to run. This is the foreward to us, the actual action. This method's default implementation is to simply call run().

Specified by:

run in interface IActionDelegate

See Also:

IActionDelegate.run(org.eclipse.jface.action.IAction)

selectionChanged

public void selectionChanged(IAction action,
                             ISelection sel)

Called by Eclipse when the user selects something. Our opportunity to enable or disable this menu item. The default implementation of this method calls getEnabled to determine if the proxy action should be enabled or not, then calls setEnabled on that proxy action with the result.

Specified by:

selectionChanged in interface IActionDelegate

See Also:

IActionDelegate.selectionChanged(IAction, ISelection)

setChecked

public void setChecked(boolean checked)

For toggle actions (attribute state specified in action tag), set the toggle state

setEnabled

public void setEnabled(boolean enabled)

Change the enabled state of the action

getProxyAction

public IAction getProxyAction()

Return the proxy action for this action delegate

getShell

public Shell getShell()

Return the shell hosting this action

getSelection

public IStructuredSelection getSelection()

Retrieve the current selected objects as a structured selection

getSelectionCount

public int getSelectionCount()

Retrieve the number of items currently selected

getSelectedRemoteObjects

public Object[] getSelectedRemoteObjects()

Retrieve the currently selected objects as an array of Object objects. Array may be length 0, but will never be null, for convenience. To do anything interesting with the object, you will also need to retrieve its adapter

See Also:

getRemoteAdapter(Object)

getFirstSelectedRemoteObject

public Object getFirstSelectedRemoteObject()

Retrieve the first selected object, for convenience. Will be null if there is nothing selected To do anything interesting with the object, you will also need to retrieve its adapter

See Also:

getRemoteAdapter(Object)

getSelectedRemoteObjectAdapters

public ISystemRemoteElementAdapter[] getSelectedRemoteObjectAdapters()

Retrieve the adapters of the currently selected objects as an array of ISystemRemoteElementAdapter objects. Array may be length 0, but will never be null, for convenience.

getFirstSelectedRemoteObjectAdapter

public ISystemRemoteElementAdapter getFirstSelectedRemoteObjectAdapter()

Retrieve the adapter of the first selected object as an ISystemRemoteElementAdapter object, for convenience. Will be null if there is nothing selected

getRemoteAdapter

public ISystemRemoteElementAdapter getRemoteAdapter(Object o)

Returns the implementation of ISystemRemoteElementAdapter for the given object. Returns null if this object does not adaptable to this.

getRemoteObjectName

public String getRemoteObjectName(Object obj,
                                  ISystemRemoteElementAdapter adapter)

Returns the name of the given remote object, given its remote object adapter. Same as adapter.getName(obj);

getRemoteObjectSubSystemConfigurationId

public String getRemoteObjectSubSystemConfigurationId(Object obj,
                                                      ISystemRemoteElementAdapter adapter)

Returns the id of the subsystem factory of the given remote object, given its remote object adapter. Same as adapter.getSubSystemConfigurationId(obj);

getRemoteObjectTypeCategory

public String getRemoteObjectTypeCategory(Object obj,
                                          ISystemRemoteElementAdapter adapter)

Returns the type category of the given remote object, given its remote object adapter. Same as adapter.getRemoteTypeCategory(obj);

getRemoteObjectType

public String getRemoteObjectType(Object obj,
                                  ISystemRemoteElementAdapter adapter)

Returns the type of the given remote object, given its remote object adapter. Same as adapter.getRemoteType(obj);

getRemoteObjectSubType

public String getRemoteObjectSubType(Object obj,
                                     ISystemRemoteElementAdapter adapter)

Returns the subtype of the given remote object, given its remote object adapter. Same as adapter.getRemoteSubType(obj);

getRemoteObjectSubSubType

public String getRemoteObjectSubSubType(Object obj,
                                        ISystemRemoteElementAdapter adapter)

Returns the sub-subtype of the given remote object, given its remote object adapter. Same as adapter.getRemoteSubSubType(obj);

getSubSystem

public ISubSystem getSubSystem()

Returns the subsystem from which the selected remote objects were resolved.

getSubSystemConfiguration

public ISubSystemConfiguration getSubSystemConfiguration()

Returns the subsystem factory which owns the subsystem from which the selected remote objects were resolved

getSystemConnection

public IHost getSystemConnection()

Return the SystemConnection from which the selected remote objects were resolved

printTest

public void printTest()

Debug method to print out details of given selected object...