|
|
|
|
org.eclipse.rse.core.subsystems
Interface ISubSystem
-
All Superinterfaces:
-
IPropertySetContainer,
IRemoteObjectResolver,
IRSEModelObject,
IRSEPersistableContainer,
ISchedulingRule,
ISystemFilterPoolReferenceManagerProvider
-
All Known Subinterfaces:
-
IFileServiceSubSystem,
IProcessServiceSubSystem,
IRemoteCmdSubSystem,
IRemoteFileSubSystem,
IRemoteProcessSubSystem,
IShellServiceSubSystem,
ITerminalServiceSubSystem
-
All Known Implementing Classes:
-
FileServiceSubSystem,
ProcessServiceSubSystem,
RemoteCmdSubSystem,
RemoteFileSubSystem,
RemoteProcessSubSystemImpl,
ShellServiceSubSystem,
SubSystem,
TerminalServiceSubSystem
-
public interface ISubSystem
- extends
ISystemFilterPoolReferenceManagerProvider,
IRemoteObjectResolver,
ISchedulingRule,
IRSEModelObject
Interface implemented by SubSystem objects.
While connections contain information to identify a particular remote system,
it is the subsystem objects within a connection that contain information
unique to a particular tool for that remote system, such as the port the tool
uses and the user ID for making the connection. There are a set of default
properties, but these can be extended by subsystem providers, by extending
SubSystem.
Method Summary
|
boolean
|
canSwitchTo
(
ISubSystemConfiguration configuration)
Determine is this subsystem is compatible with this specified
configuration. |
void
|
checkIsConnected
(
IProgressMonitor monitor)
Check if the subsystem is connected, and connect if it's not. |
void
|
clearLocalUserId
()
Called to clear the local user Id such that subsequent requests to getUserId() will
return the parent connection's default user Id. |
void
|
connect
(boolean forcePrompt,
IRSECallback callback)
Asynchronously connect to the remote system, optionally forcing a signon prompt
even if the password is cached in memory or on disk. |
void
|
connect
(
IProgressMonitor monitor,
boolean forcePrompt)
Synchronously connect to the remote system. |
void
|
deletingConnection
()
Private method called when the parent connection is being deleted, so
the subsystem can do any pre-death cleanup it needs to. |
void
|
disconnect
()
Disconnect from the remote system. |
void
|
disconnect
(boolean collapseTree)
Disconnect from the remote system. |
boolean
|
doesFilterListContentsOf
(
ISystemFilter filter,
String remoteObjectAbsoluteName)
Return true if the given filter lists the contents of the given remote object. |
boolean
|
doesFilterMatch
(
ISystemFilter filter,
String remoteObjectAbsoluteName)
Return true if the given remote object name will pass the filtering criteria for any of
the filter strings in this filter. |
boolean
|
doesFilterStringListContentsOf
(
ISystemFilterString filterString,
String remoteObjectAbsoluteName)
Return true if the given filter string lists the contents of the given remote object. |
boolean
|
doesFilterStringMatch
(
String filterString,
String remoteObjectAbsoluteName,
boolean caseSensitive)
Return true if the given remote object name will pass the filtering criteria for the
given filter string in this filter. |
boolean
|
forceUserIdToUpperCase
()
Return true if userId and password should be forced to uppercase. |
ICacheManager
|
getCacheManager
()
Return the CacheManager for this subsystem. |
Object[]
|
getChildren
()
Return the children for this subsystem. |
String
|
getConfigurationId
()
|
IConnectorService
|
getConnectorService
()
Return the IConnectorService object that represents the live connection for this system. |
ISystemFilterPoolReferenceManager
|
getFilterPoolReferenceManager
()
Generated persistent property method
Return the object that manages the list of
filter pools referenced by this subsystem. |
IHost
|
getHost
()
Return the connection object this subsystem is associated with. |
String
|
getHostAliasName
()
|
String
|
getLocalUserId
()
Alternative to getUserId when we don't want to resolve it from parent connection. |
String
|
getName
()
|
ISubSystem
|
getPrimarySubSystem
()
Return the primary subsystem associated with this subsystem's IConnectorService |
String[]
|
getProperties
(
Object subject,
String[] keys)
Deprecated. this shouldn't be used
|
String
|
getProperty
(
Object subject,
String key)
Deprecated. this shouldn't be used
|
Class
|
getServiceType
()
Returns the interface type (i.e. a Class object that is an Interface) of
a service subsystem. |
ISubSystemConfiguration
|
getSubSystemConfiguration
()
Return the parent subsystem factory that owns this subsystem. |
ISystemFilterPoolReferenceManager
|
getSystemFilterPoolReferenceManager
()
Return the system filter pool reference manager, as per the
interface SystemFilterPoolReferenceManagerProvider |
ISystemProfile
|
getSystemProfile
()
Return the system profile object this subsystem is associated with. |
String
|
getSystemProfileName
()
|
Object
|
getTargetForFilter
(
ISystemFilterReference filterRef)
Returns the parent object associated with a filter reference. |
String
|
getUserId
()
Returns the value of this subsystem's user id if it is not null. |
String
|
getVendorAttribute
(
String vendorName,
String attributeName)
Deprecated. Subsystems can now take named property sets. These should be used instead.
See
IPropertySet
|
boolean
|
hasChildren
()
Return true if this subsystem has children objects to
be displayed in the Remote System View explorer. |
void
|
initializeSubSystem
(
IProgressMonitor monitor)
Called on each subsystem associated with a particular
IConnectorService after it connects successfully. |
boolean
|
isConnected
()
Return true if this subsystem is currently connected to its remote system. |
boolean
|
isConnectionError
()
Return true if the last attempt to connect this subsystem to its remote system failed. |
boolean
|
isHidden
()
Generated persistent property method
Return true if this subsystem is to be hidden so it doesn't show in the Remote Systems
view when a connection is expanded. |
boolean
|
isOffline
()
Return true if this subsystem is currently being used in "offline" mode. |
boolean
|
isPrimarySubSystem
()
|
void
|
renamingConnection
(
String newName)
Private method called when the parent connection is being renamed, so
the subsystem can do any cleanup it needs to. |
void
|
renamingProfile
(
String oldName,
String newName)
Private method called when the parent profile is being renamed, so
the subsystem can do any cleanup it needs to. |
Object[]
|
resolveFilterString
(
Object parent,
String filterString,
IProgressMonitor monitor)
Resolve a relative filter string. |
Object[]
|
resolveFilterString
(
String filterString,
IProgressMonitor monitor)
Resolve an absolute filter string. |
Object[]
|
resolveFilterStrings
(
String[] filterStrings,
IProgressMonitor monitor)
Resolve multiple absolute filter strings. |
void
|
setConfigurationId
(
String value)
|
void
|
setConnectionError
(boolean error)
Sets whether the last attempt to connect this subsystem to its remote system failed. |
void
|
setConnectorService
(
IConnectorService connectorService)
Set the connector service for this subsystem |
void
|
setFilterPoolReferenceManager
(
ISystemFilterPoolReferenceManager value)
Generated persistent property method
Set the object that manages the list of
filter pools referenced by this subsystem. |
void
|
setHidden
(boolean value)
Generated persistent property method
Specify true if this subsystem is to be hidden so it doesn't show in the Remote Systems
view when a connection is expanded. |
void
|
setHost
(
IHost conn)
Set the parent connection that owns this subsystem. |
void
|
setName
(
String value)
|
Object
|
setProperties
(
Object subject,
String[] keys,
String[] values)
Deprecated. this shouldn't be used
|
Object
|
setProperty
(
Object subject,
String key,
String value)
Deprecated. this shouldn't be used
|
void
|
setSubSystemConfiguration
(
ISubSystemConfiguration ssf)
Set the parent subsystem factory that owns this subsystem. |
void
|
setVendorAttribute
(
String vendorName,
String attributeName,
String attributeValue)
Deprecated. Subsystems can now take named property sets. These should be used instead.
See
IPropertySet
|
boolean
|
supportsCaching
()
Check if the SubSystem supports caching. |
void
|
switchServiceFactory
(
ISubSystemConfiguration configuration)
Requests a service subsystem to switch to a new configuration. |
void
|
uninitializeSubSystem
(
IProgressMonitor monitor)
Called on each subsystem associated with a particular
IConnectorService after it disconnects |
getSubSystemConfiguration
ISubSystemConfiguration getSubSystemConfiguration()
- Return the parent subsystem factory that owns this subsystem.
-
-
setSubSystemConfiguration
void setSubSystemConfiguration(
ISubSystemConfiguration ssf)
- Set the parent subsystem factory that owns this subsystem.
-
-
setHost
void setHost(
IHost conn)
- Set the parent connection that owns this subsystem.
-
-
setConnectorService
void setConnectorService(
IConnectorService connectorService)
- Set the connector service for this subsystem
-
-
-
Parameters:
-
connectorService - connector service object to set
getSystemProfile
ISystemProfile getSystemProfile()
- Return the system profile object this subsystem is associated with.
-
-
-
See Also:
-
getName()
getHost
IHost getHost()
- Return the connection object this subsystem is associated with.
-
-
initializeSubSystem
void initializeSubSystem(
IProgressMonitor monitor)
throws
SystemMessageException
- Called on each subsystem associated with a particular
IConnectorService after it connects successfully. This call is
always made on a background Thread, so it's allowed to be long-running.
-
-
-
Parameters:
-
monitor - a progress monitor that can be used to show progress
during long-running operation. Cancellation is typically not
supported since it might leave the system in an inconsistent
state.
-
Throws:
-
SystemMessageException
- if an error occurs during initialization.
uninitializeSubSystem
void uninitializeSubSystem(
IProgressMonitor monitor)
- Called on each subsystem associated with a particular
IConnectorService after it disconnects
-
-
-
Parameters:
-
monitor - a progress monitor that can be used to show progress
during long-running operation. Cancellation is typically not
supported since it might leave the system in an inconsistent
state.
isPrimarySubSystem
boolean isPrimarySubSystem()
-
-
-
Returns:
- true if this subsystem's properties should take precedence over other
subsystems that share the same
IConnectorService
getPrimarySubSystem
ISubSystem getPrimarySubSystem()
- Return the primary subsystem associated with this subsystem's IConnectorService
-
-
getHostAliasName
String getHostAliasName()
-
-
-
Returns:
- The name of the connection that owns this. Same as getSystemConnection().getAliasName()
getSystemProfileName
String getSystemProfileName()
-
-
-
Returns:
- The value of the profile that owns the connection that owns this subsystem. Fastpath.
renamingProfile
void renamingProfile(
String oldName,
String newName)
- Private method called when the parent profile is being renamed, so
the subsystem can do any cleanup it needs to. Called after the profile is actually renamed.
-
-
renamingConnection
void renamingConnection(
String newName)
- Private method called when the parent connection is being renamed, so
the subsystem can do any cleanup it needs to.
-
-
deletingConnection
void deletingConnection()
- Private method called when the parent connection is being deleted, so
the subsystem can do any pre-death cleanup it needs to.
-
-
checkIsConnected
void checkIsConnected(
IProgressMonitor monitor)
throws
SystemMessageException
- Check if the subsystem is connected, and connect if it's not.
This is a convenience method which first checks whether the subsystem is
already connected. If not, it automatically checks if it's running on the
dispatch thread or not, and calls the right
connect() method
as appropriate. It also performs some exception parsing, converting
Exceptions from connect() into SystemMessageException that can be
displayed to the user by using a method in it.
If the subsystem is marked offline, or supports caching and is currently
restoring from its memento, no connect will be performed.
-
-
-
Throws:
-
SystemMessageException
- in case of an error connecting -
Since:
- org.eclipse.rse.core 3.0
setVendorAttribute
void setVendorAttribute(
String vendorName,
String attributeName,
String attributeValue)
-
Deprecated. Subsystems can now take named property sets. These should be used instead.
See
IPropertySet
- For business partners defining their own subsystems.
This method allows an attribute to be persisted in this
subsystem, given the following information:
- Vendor name. This name should uniquely differentiate one
vendor's attributes from anothers.
- Attribute name. The name of the attribute to set.
- attribute value. The value to give the named attribute. It must
be resolved into a string to use this. Eg, for boolean use
something like "true" or "false". To clear the attribute
value pass null for the value.
Warning do not use any of the following characters in any of
given parameters, or it will cause problems with parsing:
- Pound sign ('#')
- Three underscores ("___")
- Three equals signs ("===")
- Three semicolons (";;;")
-
-
getVendorAttribute
String getVendorAttribute(
String vendorName,
String attributeName)
-
Deprecated. Subsystems can now take named property sets. These should be used instead.
See
IPropertySet
- For business partners defining their own subsystems.
This method allows retrieval of a persisted attribute in this
subsystem, given the following information:
- Vendor name. This name should uniquely differentiate one
vendor's attributes from anothers.
- Attribute name. The name of the attribute whose value is being queried.
-
-
-
Returns:
- value of the attribute being queried, or null if not found
forceUserIdToUpperCase
boolean forceUserIdToUpperCase()
- Return true if userId and password should be forced to uppercase.
Shortcut to calling same method in parent SubSystemConfiguration.
-
-
getLocalUserId
String getLocalUserId()
- Alternative to getUserId when we don't want to resolve it from parent connection.
This is used when showing the properties.
Unlike getUserId() this one does not defer to the connection's default user Id if
the subsystem's userId attribute is null.
To set the local user Id, simply call setUserId(String id). To clear it, call
clearLocalUserId() .
-
-
-
See Also:
-
IHost.getDefaultUserId() ,
clearLocalUserId() ,
getUserId()
clearLocalUserId
void clearLocalUserId()
- Called to clear the local user Id such that subsequent requests to getUserId() will
return the parent connection's default user Id. Sets the user Id attribute for this
subsystem to null.
-
-
-
See Also:
-
IHost.getDefaultUserId() ,
getUserId() ,
getLocalUserId()
getChildren
Object[] getChildren()
- Return the children for this subsystem.
This is used to populate the Remote System View explorer.
By default, if the parent subsystem factory supports filters, then
we return getSystemFilterPoolReferencesArray. If filters are not
supported (supportsFilters() returns false from factory) then we
return null. In this case you should override this.
-
-
hasChildren
boolean hasChildren()
- Return true if this subsystem has children objects to
be displayed in the Remote System View explorer.
-
-
doesFilterListContentsOf
boolean doesFilterListContentsOf(
ISystemFilter filter,
String remoteObjectAbsoluteName)
- Return true if the given filter lists the contents of the given remote object.
For example, if given a folder, return true if any of the filter strings in this filter
lists the contents of that folder. Used in impact analysis when a remote object is
created, deleted, renamed, copied or moved, so as to establish which filters need to be
refreshed or collapsed (if the folder is deleted, say).
The default algorithm calls doesFilterStringListContentsOf for each filter string.
-
-
doesFilterStringListContentsOf
boolean doesFilterStringListContentsOf(
ISystemFilterString filterString,
String remoteObjectAbsoluteName)
- Return true if the given filter string lists the contents of the given remote object.
For example, if given a folder, return true if the given filter string
lists the contents of that folder. Used in impact analysis when a remote object is
created, deleted, renamed, copied or moved, so as to establish which filters need to be
refreshed or collapsed (if the folder is deleted, say).
-
-
doesFilterMatch
boolean doesFilterMatch(
ISystemFilter filter,
String remoteObjectAbsoluteName)
- Return true if the given remote object name will pass the filtering criteria for any of
the filter strings in this filter.
-
-
doesFilterStringMatch
boolean doesFilterStringMatch(
String filterString,
String remoteObjectAbsoluteName,
boolean caseSensitive)
- Return true if the given remote object name will pass the filtering criteria for the
given filter string in this filter.
-
-
getSystemFilterPoolReferenceManager
ISystemFilterPoolReferenceManager getSystemFilterPoolReferenceManager()
- Return the system filter pool reference manager, as per the
interface SystemFilterPoolReferenceManagerProvider
-
-
Specified by:
-
getSystemFilterPoolReferenceManager
in interface
ISystemFilterPoolReferenceManagerProvider
-
getName
String getName()
-
-
Specified by:
-
getName
in interface
IRSEModelObject
-
-
Returns:
- The value of the Name attribute
setName
void setName(
String value)
-
-
-
Parameters:
-
value - The new value of the Name attribute
getUserId
String getUserId()
- Returns the value of this subsystem's user id if it is not null. If it
is null, it returns the parent connection object's default user Id.
In fact, we now don't store the user Id in the subsystem object itself, but rather store it in the
user preferences, so that such things are not shared among the team on a synchronize operation.
This is transparent to callers of this method however, as this method resolves from the preferences.
-
-
-
Returns:
- The value of the UserId attribute
-
See Also:
-
IHost.getDefaultUserId() ,
getLocalUserId() ,
clearLocalUserId()
getConfigurationId
String getConfigurationId()
-
-
-
Returns:
- The value of the ConfigurationId attribute
Ties this subsystem to its owning subsystem configuration, via the
id key string of the configuration.
setConfigurationId
void setConfigurationId(
String value)
-
-
-
Parameters:
-
value - The new value of the ConfigurationId attribute
getConnectorService
IConnectorService getConnectorService()
- Return the IConnectorService object that represents the live connection for this system.
-
-
supportsCaching
boolean supportsCaching()
- Check if the SubSystem supports caching.
-
-
getCacheManager
ICacheManager getCacheManager()
- Return the CacheManager for this subsystem. If the SubSystem returns true for
supportsCaching() then it must return a valid CacheManager, otherwise it is free
to return null.
-
-
-
See Also:
-
supportsCaching()
isConnected
boolean isConnected()
- Return true if this subsystem is currently connected to its remote system.
-
-
isConnectionError
boolean isConnectionError()
- Return true if the last attempt to connect this subsystem to its remote system failed.
-
-
setConnectionError
void setConnectionError(boolean error)
- Sets whether the last attempt to connect this subsystem to its remote system failed.
-
-
isOffline
boolean isOffline()
- Return true if this subsystem is currently being used in "offline" mode. Not necessarily supported
by all subsystems in which case this will always return false.
-
-
connect
void connect(
IProgressMonitor monitor,
boolean forcePrompt)
throws
Exception
- Synchronously connect to the remote system.
Clients are expected to call this method on a background
thread with an existing progress monitor. A signon prompt
may optionally be forced even if the password is cached
in memory or on disk.
The framework will take care of switching to the UI thread
for requesting a password from the user if necessary.
-
-
-
Parameters:
-
monitor - the progress monitor. Must not be null . -
forcePrompt - forces the prompt dialog to be displayed
even if the password is currently in memory.
-
Throws:
-
Exception
- an exception if there is a failure to connect.
Typically, this will be a
SystemMessageException .
An
OperationCanceledException will be thrown if the user cancels the connect.
connect
void connect(boolean forcePrompt,
IRSECallback callback)
throws
Exception
- Asynchronously connect to the remote system, optionally forcing a signon prompt
even if the password is cached in memory or on disk.
This method must be called on the UI Thread! An Eclipse background job with a
progress monitor will be created automatically. If the optional callback is
given, it will be called when the connect is complete.
You do not need to override this, as it does the progress monitor reporting
for you.
Override internalConnect if you want, but by default it calls
getConnectorService().connect(IProgressMonitor) .
-
-
-
Parameters:
-
forcePrompt - forces the prompt dialog even if the password is in mem -
callback - to call after connect is complete.
May be null .
-
Throws:
-
Exception
- an exception if there is a failure to connect.
Typically, this will be a
SystemMessageException .
An
OperationCanceledException will be thrown if the user cancels the connect.
disconnect
void disconnect()
throws
Exception
- Disconnect from the remote system.
In addition to calling getSystem().disconnect(),this must fire an
event to collapse the expanded nodes in the tree under this node.
-
-
-
Throws:
-
Exception
disconnect
void disconnect(boolean collapseTree)
throws
Exception
- Disconnect from the remote system.
In addition to calling getSystem().disconnect(),this may fire an
event to collapse the expanded nodes in the tree under this node
depending on the value of collapseTree.
-
-
-
Throws:
-
Exception
resolveFilterString
Object[] resolveFilterString(
String filterString,
IProgressMonitor monitor)
throws
Exception
- Resolve an absolute filter string. This is only applicable if the subsystem
factory reports true for supportsFilters().
When a user expands a filter containing filter strings, this method is
invoked for each filter string.
The resulting objects are displayed in the remote system view tree. They
can be anything, but at a minimum must support IAdaptable in order to
drive the property sheet. You can just defer the getAdapter request to
the platform's Adapter manager if desired.
You should supply an adapter class for the returned object's class,
to render objects in the Remote System Explorer view. It will uses a
label and content provider that defers all requests to the adapter,
which it gets by querying the platform's adapter manager for the object
type. Be sure to register your adapter factory.
-
-
-
Parameters:
-
filterString - filter pattern for objects to return. -
monitor - the process monitor associated with this operation
-
Returns:
- Array of objects that are the result of this filter string
-
Throws:
-
Exception
resolveFilterStrings
Object[] resolveFilterStrings(
String[] filterStrings,
IProgressMonitor monitor)
throws
Exception
- Resolve multiple absolute filter strings. This is only applicable if the subsystem
factory reports true for supportsFilters().
This is the same as
resolveFilterString(String, IProgressMonitor) but takes an array of
filter strings versus a single filter string.
-
-
-
Parameters:
-
filterStrings - array of filter patterns for objects to return. -
monitor - the process monitor associated with this operation
-
Returns:
- Array of objects that are the result of this filter string
-
Throws:
-
Exception
resolveFilterString
Object[] resolveFilterString(
Object parent,
String filterString,
IProgressMonitor monitor)
throws
Exception
- Resolve a relative filter string. This is only applicable if the subsystem
factory reports true for supportsFilters().
When a user expands an object that came from a previous filter string expansion,
(such as expanding a folder), this method is invoked to get the children of
that object. The user can choose to expand all, or choose a pre-defined
relative filter string to subset/filter the children. In either case, the
relative filter string is passed in as well as the to-be-expanded parent object.
The resulting objects are displayed in the remote system view tree. They
can be anything, but at a minimum must support IAdaptable in order to
drive the property sheet. You can just defer the getAdapter request to
the platform's Adapter manager if desired.
You should supply an adapter class for the returned object's class,
to render objects in the Remote System Explorer view. It will uses a
label and content provider that defers all requests to the adapter,
which it gets by querying the platform's adapter manager for the object
type. Be sure to register your adapter factory.
-
-
-
Parameters:
-
parent - Object that is being expanded. -
filterString - filter pattern for children of parent. -
monitor - the process monitor associated with this operation
-
Returns:
- Array of objects that are the result of this filter string
-
Throws:
-
Exception
setProperty
Object setProperty(
Object subject,
String key,
String value)
throws
Exception
-
Deprecated. this shouldn't be used
- Set a remote property. Subsystems interpret as they wish. Eg, this might be to set
a remote environment variable. This is only applicable if the subsystem factory reports
true for supportsProperties().
-
-
-
Parameters:
-
subject - Identifies which object to get the properties of -
key - Identifies property to set -
value - Value to set property to
-
Returns:
- Object interpretable by subsystem. Might be a Boolean, or the might be new value for confirmation.
-
Throws:
-
Exception
getProperty
String getProperty(
Object subject,
String key)
throws
Exception
-
Deprecated. this shouldn't be used
- Get a remote property. Subsystems interpret as they wish. Eg, this might be to get
a remote environment variable. This is only applicable if the subsystem factory reports
true for supportsProperties().
-
-
-
Parameters:
-
subject - Identifies which object to get the properties of -
key - Identifies property to get value of
-
Returns:
- String The value of the requested key.
-
Throws:
-
Exception
setProperties
Object setProperties(
Object subject,
String[] keys,
String[] values)
throws
Exception
-
Deprecated. this shouldn't be used
- Set multiple remote properties. Subsystems interpret as they wish. Eg, this might be to set
a number of remote environment variables. This is only applicable if the subsystem factory reports
true for supportsProperties().
-
-
-
Parameters:
-
subject - Identifies which object to get the properties of -
keys - Identifies the properties to set -
values - Values to set properties to. One to one mapping to keys by index number
-
Returns:
- Object interpretable by subsystem. Might be a Boolean, or the might be new values for confirmation.
-
Throws:
-
Exception
getProperties
String[] getProperties(
Object subject,
String[] keys)
throws
Exception
-
Deprecated. this shouldn't be used
- Get a remote property. Subsystems interpret as they wish. Eg, this might be to get
a remote environment variable. This is only applicable if the subsystem factory reports
true for supportsProperties().
-
-
-
Parameters:
-
subject - Identifies which object to get the properties of -
keys - Identifies properties to get value of
-
Returns:
- The values of the requested keys.
-
Throws:
-
Exception
isHidden
boolean isHidden()
-
Generated persistent property method
Return true if this subsystem is to be hidden so it doesn't show in the Remote Systems
view when a connection is expanded. If so, this subsystem is for programmatic use only,
or is exposed in alternative view. Such is the case for command subsystems, for example.
-
-
-
Returns:
- The value of the Hidden attribute
setHidden
void setHidden(boolean value)
-
Generated persistent property method
Specify true if this subsystem is to be hidden so it doesn't show in the Remote Systems
view when a connection is expanded. If so, this subsystem is for programmatic use only,
or is exposed in alternative view. Such is the case for command subsystems, for example.
-
-
-
Parameters:
-
value - The new value of the Hidden attribute
getFilterPoolReferenceManager
ISystemFilterPoolReferenceManager getFilterPoolReferenceManager()
-
Generated persistent property method
Return the object that manages the list of
filter pools referenced by this subsystem.
-
-
-
Returns:
- The FilterPoolReferenceManager reference
setFilterPoolReferenceManager
void setFilterPoolReferenceManager(
ISystemFilterPoolReferenceManager value)
-
Generated persistent property method
Set the object that manages the list of
filter pools referenced by this subsystem. This is called by the subsystem factory
when creating or restoring subsystems.
-
-
-
Parameters:
-
l - The new value of the FilterPoolReferenceManager reference
getTargetForFilter
Object getTargetForFilter(
ISystemFilterReference filterRef)
- Returns the parent object associated with a filter reference. It's up to the
subsystem implementation to decide what "parent object" means for a filter reference.
-
-
-
Parameters:
-
filterRef - the filter reference to determine a target object from.
-
Returns:
- An object representing the parent
getServiceType
Class getServiceType()
- Returns the interface type (i.e. a Class object that is an Interface) of
a service subsystem.
-
-
-
Returns:
- the service interface on which this service subsystem is
implemented. If this subsystem is not a service subsystem it must
return
null . -
Since:
- org.eclipse.rse.core 3.0
switchServiceFactory
void switchServiceFactory(
ISubSystemConfiguration configuration)
- Requests a service subsystem to switch to a new configuration. If the
configuration is compatible with this subsystem then it must disconnect,
possibly reset its filter pool references, and request new services and
parameters from its new configuration. It must also answer true to
canSwitchTo(ISubSystemConfiguration) . If the configuration is
not compatible with this subsystem then this must do nothing and must
answer false to
canSwitchTo(ISubSystemConfiguration) .
-
-
-
Parameters:
-
configuration - the configuration to which to switch. -
Since:
- org.eclipse.rse.core 3.0
canSwitchTo
boolean canSwitchTo(
ISubSystemConfiguration configuration)
- Determine is this subsystem is compatible with this specified
configuration.
-
-
-
Parameters:
-
configuration - the configuration which may be switched to
-
Returns:
- true if the subsystem can switch to this configuration, false
otherwise. Subsystems which are not service subsystems must
return false.
-
Since:
- org.eclipse.rse.core 3.0
Copyright (c) IBM Corporation and others 2000, 2008. All Rights Reserved.
|
|
|