diff -r 3a27d56389d5 -r 670ab96c591c connectivity/com.nokia.carbide.remoteConnections/src/com/nokia/carbide/remoteconnections/internal/IDeviceDiscoveryAgent.java --- a/connectivity/com.nokia.carbide.remoteConnections/src/com/nokia/carbide/remoteconnections/internal/IDeviceDiscoveryAgent.java Thu Dec 17 16:05:51 2009 -0600 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,55 +0,0 @@ -/** -* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). -* All rights reserved. -* This component and the accompanying materials are made available -* under the terms of the License "Eclipse Public License v1.0" -* which accompanies this distribution, and is available -* at the URL "http://www.eclipse.org/legal/epl-v10.html". -* -* Initial Contributors: -* Nokia Corporation - initial contribution. -* -* Contributors: -* -* Description: -* -*/ - -package com.nokia.carbide.remoteconnections.internal; - -import java.net.URL; - -import org.eclipse.core.runtime.CoreException; - -/** - * An interface to a device discovery agent - * @since 3.0 - */ -public interface IDeviceDiscoveryAgent { - - /** - * Starts agent. Once started, runs until stopped. - * @throws CoreException - */ - void start() throws CoreException; - - /** - * Stops agent. - * @throws CoreException - */ - void stop() throws CoreException; - - /** - * Returns a URL to specific information about this discovery mechanism, - * troubleshooting, etc. - * @return URL - */ - URL getInformation(); - - // In addition, there may need to be an additional API to do a deeper form of discovery for - // connection mechanisms that require pairing (like BT or Wifi). In these cases, normal discovery - // will probably be for already paired devices, however, the user will want to discover all - // potential devices from some UI in order to set up a paired device. - // A method for doing this will need to be added. - -}