If you only have a single subsystem class, you may override this method to return the - * IConnectorService object that manages the connect/disconnect actions. If, on the other hand, - * you have multiple subsystem classes that desire to share a single IConnectorService connection, - * (ie, share the same communications pipe) then do not override this. By default, this - * calls getSystemManager() which returns an {@link AbstractConnectorServiceManager} object that manages maintaining a singleton - * IConnectorService object per system connection. You should subclass AbstractSystemManager, - * and override getSystemManager() to return a singleton instance of that subclass. - *
Default implementation:
- *
- * return getSystemManager().getSystemObject(this);
- * We recommending using a subclass of {@link AbstractConnectorServiceManager} even for single - * subsystems, because it doesn't hurt and allows easy growth if new subsystems - * are added in the future. + * + * The connector service gets passed in to the constructor for the subsystem so there's normally no reason + * to override this method. + * */ public IConnectorService getConnectorService() { return _connectorService; } + /** + * Sets the {@link org.eclipse.rse.core.subsystems.IConnectorService IConnectorService} object that represents the live connection for this system. + * + * @param connectorService the connector service + */ public void setConnectorService(IConnectorService connectorService) { if (_connectorService != connectorService) @@ -2464,7 +2456,9 @@ public abstract class SubSystem extends RSEModelObject } } - + // ---------------------------------- + // METHODS THAT MUST BE OVERRIDDEN... + // ---------------------------------- /** @@ -2488,10 +2482,8 @@ public abstract class SubSystem extends RSEModelObject } /** - * Connect to the remote host. This is called by the run(IProgressMonitor monitor) method. - *
- * DO NOT OVERRIDE THIS. Rather, this calls connect(IProgressMonitor) in the - * IConnectorService class that is returned from getConnectorService(). + * Connect to the remote host. This is called by the implicitConnect(boolean, IProgressMonitor, String, int) method. + * Rather, this calls connect(IProgressMonitor) in the IConnectorService class that is returned from getConnectorService(). *
* Your connect method in your IConnectorService class must follow these IRunnableWithProgress rules: *