org.eclipse.remote.internal.core

Class RemoteConnection

java.lang.Object

org.eclipse.remote.internal.core.RemoteConnection

All Implemented Interfaces:

IRemoteConnection

public class RemoteConnection
extends java.lang.Object
implements IRemoteConnection

The standard root class for remote connections. Implements common hook up with the remote services and the remote services manager as well as handling for services.

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.remote.core.IRemoteConnection

IRemoteConnection.Service

Field Summary

Fields inherited from interface org.eclipse.remote.core.IRemoteConnection

FILE_SEPARATOR_PROPERTY, LINE_SEPARATOR_PROPERTY, LOCALE_CHARMAP_PROPERTY, OS_ARCH_PROPERTY, OS_NAME_PROPERTY, OS_VERSION_PROPERTY, PATH_SEPARATOR_PROPERTY, USER_HOME_PROPERTY

Constructor Summary

Constructors

Constructor and Description
RemoteConnection(RemoteConnectionType connectionType, java.lang.String name)

Method Summary

Methods

Modifier and Type	Method and Description
void	addConnectionChangeListener(IRemoteConnectionChangeListener listener) Register a listener that will be notified when this connection's status changes.
void	close() Close the connection.
void	fireConnectionChangeEvent(int type) Notify all listeners when this connection's status changes.
java.lang.String	getAttribute(java.lang.String key) Get an attribute for a connection.
IRemoteConnectionType	getConnectionType() Get the connection type of this connection
java.lang.String	getName() Get unique name for this connection.
java.lang.String	getProperty(java.lang.String key) Gets the remote system property indicated by the specified key.
java.lang.String	getSecureAttribute(java.lang.String key) Get an attribute that is stored in secure storage, such as passwords.
<T extends IRemoteConnection.Service> T	getService(java.lang.Class<T> service) Get the service for this remote connection that implements the given interface.
IRemoteConnectionWorkingCopy	getWorkingCopy() Return a working copy to allow setting and changing of attributes.
<T extends IRemoteConnection.Service> boolean	hasService(java.lang.Class<T> service) Does this connection support the given service.
boolean	isOpen() Test if the connection is open.
void	open(org.eclipse.core.runtime.IProgressMonitor monitor) Open the connection.
void	removeConnectionChangeListener(IRemoteConnectionChangeListener listener) Remove a listener that will be notified when this connection's status changes.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

RemoteConnection

public RemoteConnection(RemoteConnectionType connectionType,
                java.lang.String name)

Method Detail

getConnectionType

public IRemoteConnectionType getConnectionType()

Description copied from interface: IRemoteConnection

Get the connection type of this connection

Specified by:

getConnectionType in interface IRemoteConnection

Returns:

connection type

getService

public <T extends IRemoteConnection.Service> T getService(java.lang.Class<T> service)

Description copied from interface: IRemoteConnection

Get the service for this remote connection that implements the given interface.

Specified by:

getService in interface IRemoteConnection

Parameters:

service - the interface the required service must implements

Returns:

the desired service or null if there is no such service available

hasService

public <T extends IRemoteConnection.Service> boolean hasService(java.lang.Class<T> service)

Description copied from interface: IRemoteConnection

Does this connection support the given service.

Specified by:

hasService in interface IRemoteConnection

Parameters:

service - The service to be tested

Returns:

true if this connection supports the service

getName

public java.lang.String getName()

Description copied from interface: IRemoteConnection

Get unique name for this connection.

Specified by:

getName in interface IRemoteConnection

Returns:

connection name

getAttribute

public java.lang.String getAttribute(java.lang.String key)

Description copied from interface: IRemoteConnection

Get an attribute for a connection. NOTE: the attributes do not include any security related information (e.g. passwords, keys, etc.)

Specified by:

getAttribute in interface IRemoteConnection

Returns:

the attribute value, or empty string if not defined.

getSecureAttribute

public java.lang.String getSecureAttribute(java.lang.String key)

Description copied from interface: IRemoteConnection

Get an attribute that is stored in secure storage, such as passwords.

Specified by:

getSecureAttribute in interface IRemoteConnection

Returns:

the attribute value, or empty string if not defined.

getWorkingCopy

public IRemoteConnectionWorkingCopy getWorkingCopy()

Description copied from interface: IRemoteConnection

Return a working copy to allow setting and changing of attributes.

Specified by:

getWorkingCopy in interface IRemoteConnection

Returns:

working copy of remote

getProperty

public java.lang.String getProperty(java.lang.String key)

Description copied from interface: IRemoteConnection

Gets the remote system property indicated by the specified key. The connection must be open prior to calling this method.

Specified by:

getProperty in interface IRemoteConnection

Parameters:

key - the name of the property

Returns:

the string value of the property, or null if no property has that key

open

public void open(org.eclipse.core.runtime.IProgressMonitor monitor)
          throws RemoteConnectionException

Description copied from interface: IRemoteConnection

Open the connection. Must be called before the connection can be used.

Specified by:

open in interface IRemoteConnection

Parameters:

monitor - the progress monitor to use for reporting progress to the user. It is the caller's responsibility to call done() on the given monitor. Accepts null, indicating that no progress should be reported and that the operation cannot be cancelled.

Throws:

RemoteConnectionException

close

public void close()

Description copied from interface: IRemoteConnection

Close the connection. Must be called to terminate the connection.

Specified by:

close in interface IRemoteConnection

isOpen

public boolean isOpen()

Description copied from interface: IRemoteConnection

Test if the connection is open.

Specified by:

isOpen in interface IRemoteConnection

Returns:

true if connection is open.

addConnectionChangeListener

public void addConnectionChangeListener(IRemoteConnectionChangeListener listener)

Description copied from interface: IRemoteConnection

Register a listener that will be notified when this connection's status changes.

Specified by:

addConnectionChangeListener in interface IRemoteConnection

removeConnectionChangeListener

public void removeConnectionChangeListener(IRemoteConnectionChangeListener listener)

Description copied from interface: IRemoteConnection

Remove a listener that will be notified when this connection's status changes.

Specified by:

removeConnectionChangeListener in interface IRemoteConnection

fireConnectionChangeEvent

public void fireConnectionChangeEvent(int type)

Description copied from interface: IRemoteConnection

Notify all listeners when this connection's status changes. See {RemoteConnectionChangeEvent for a list of event types.

Specified by:

fireConnectionChangeEvent in interface IRemoteConnection

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object