* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).

import org.eclipse.core.runtime.CoreException;

import com.nokia.carbide.remoteconnections.internal.api.IConnection2;

 * @noimplement

	/**

	 * Listener interface for connection manager events

	 * (These tend to be used internally by remote connections UI)

	 * @deprecated

	 */

	/**

	 * Internal method for loading connections from persisted state

	 * @deprecated

	 */

	/**

	 * Internal method for persisting connections

	 * @deprecated

	 */

	/**

	 * Listener interface for connections which are added, removed and set as current

	 * @since 3.0

	 */

	public interface IConnectionListener {

		void connectionAdded(IConnection connection);

		void connectionRemoved(IConnection connection);

		void currentConnectionSet(IConnection connection);

	}

	/**

	 * Add a listener for internal connection manager events

	 * @param listener IConnectionsManagerListener

	 * @deprecated

	 */

	/**

	 * Remove a listener for internal connection manager events

	 * @param listener IConnectionsManagerListener

	 * @deprecated

	 */

	/**

	 * Add a connection to the system

	 * @param connection IConnection

	 */

	/**

	 * Remove a connection from the system

	 * @param connection IConnection

	 */

	/**

	 * Return all connections in the system

	 * @return Collection<IConnection>

	 */

	/**

	 * Return all the connected services for a connection

	 * @param connection IConnection

	 * @return Collection<IConnectedService>

	 */

	/**

	 * Returns a unique id to be used for a new connection

	 * @return String

	 */

	/**

	 * Returns whether some display name is in use for any existing connections

	 * @param name String

	 * @return boolean

	 */

	/**

	 * Fires internal display changed event

	 * @deprecated

	 */

	/**

	 * Returns the IClientServiceSiteUI for a service. Filters connection types to those that

	 * are supported by the service. Connection list UI as well as new and edit wizards are filtered.

	 * @param service IService

	 * @return IClientServiceSiteUI

	 * @deprecated use {@link #getClientSiteUI2(IService)}

	 */

	/**

	 * Internal method to create the connected service over a connection (for service testing)

	 * @param service IService

	 * @param connection IConnection

	 * @return IConnectedService

	 * @deprecated

	 */

	/**

	 * Add new IConnectionListener

	 * @param listener IConnectionListener

	 * @since 3.0

	 */

	void addConnectionListener(IConnectionListener listener);

	/**

	 * Remove IConnectionListener

	 * @param listener IConnectionListener

	 * @since 3.0

	 */

	void removeConnectionListener(IConnectionListener listener);

	/**

	 * Sets the current connection.

	 * @param connection IConnection

	 * @since 3.0

	 */

	void setCurrentConnection(IConnection connection);

	/**

	 * Returns the current connection.

	 * @return IConnection

	 * @since 3.0

	 */

	IConnection getCurrentConnection();

	/**

	 * Returns the IClientServiceSiteUI2 for a service. Filters connection types to those that

	 * are supported by the service. Connection list UI as well as new and edit wizards are filtered.

	 * Allows selecting a "current" connection which maps to #getCurrentConnection()

	 * when you use #ensureConenction().

	 * @param service IService

	 * @return IClientServiceSiteUI2

	 * @since 3.0

	 */

	IClientServiceSiteUI2 getClientSiteUI2(IService service);

	/**

	 * Can be called by specific service implementors (e.g., debugger) to ensure some connection

	 * exists and supports this service. If the connection does not exist or does not support

	 * the service, a CoreException may be thrown after the framework attempts to allow the user

	 * to correct the situation. If an IConnection is returned, it is assumed to be 

	 * a valid connection in the system that supports the service.

	 * @param connectionId String

	 * @param service IService

	 * @return IConnection

	 * @throws CoreException

	 * @since 3.0

	 */

	IConnection ensureConnection(String connectionId, IService service) throws CoreException;

	/**

	 * Returns a connection from an id (including the current connection id) or null if none found.

	 * @param connectionId String

	 * @param service IService

	 * @return IConnection

	 * @throws CoreException

	 * @since 3.0

	 */

	IConnection findConnection(String connectionId);

	/**

	 * Sets a dynamic connection as disconnected. Is no-op on user generated connections.

	 * If a dynamic connection is disconnected, it is transitioned to a disconnected state while it

	 * is in use by some client service, and is eventually removed from the system once it is 

	 * no longer in use. 

	 * @param connection IConnection2

	 * @since 3.0

	 */

	void disconnect(IConnection2 connection);

	/**

	 * Attempts to set a disconnected dynamic connection back to its in-use state. 

	 * If the connection has not been removed from the system, and is still in-use, 

	 * it will be restored. Returns true if successful in restoring the connection.

	 * @param connection IConnection2

	 * @since 3.0

	 */

	boolean reconnect(IConnection2 connection);