/*

* 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 "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:

*

*/

#ifndef WLANQTUTILSCONMONWRAPPER_H

#define WLANQTUTILSCONMONWRAPPER_H

// INCLUDES

#include <QObject>

#include <QList>

#include <QStringList>

QT_BEGIN_HEADER

QT_BEGIN_NAMESPACE

#include "wlanqtutilscommon.h"

// FORWARD DECLARATIONS

class WlanQtUtilsWlanAp;

class WlanQtUtilsActiveConn;

class ConnMonScanWlanAps;

class ConnMonConnInfo;

class ConnMonConnDisconnect;

// CLASS DECLARATION

/**

* ConMonWrapper class.

*/

class ConMonWrapper : public QObject

{

    Q_OBJECT

public:

    /**

     * Constructor.

     */

    ConMonWrapper(QObject *parent = 0);

    /**

    * Destructor.

    */

    ~ConMonWrapper();

    /**

     * Requests wlan scanning

     *

     * @return ???.

     */

    int scanAvailableWlanAPs();

    /**

     * Emits available WLANs to engine.

     * 

     * @param[in] availableWlanAPs Available WLAN access points found in scan.

     */

    void emitAvailableWlans(QList<WlanQtUtilsWlanAp *> &availableWlanAPs);

    /**

     * Emits signal indicating that a new connection has been created.

     * 

     * @param[in] connectionId Connection ID.

     */

    void emitConnCreatedEvent(uint connectionId);

    /**

     * Emits signal indicating that a connection has been deleted.

     * 

     * @param[in] connectionId Connection ID.

     */

    void emitConnDeletedEvent(uint connectionId);

    /**

     * Emits signal indicating that status of a connection has changed.

     * 

     * @param[in] connectionId Connection ID.

     * @param[in] connectionStatus Connection status.

     */

    void emitConnStatusEvent(uint connectionId, WlanQtUtilsConnectionStatus connectionStatus);

    /**

     * Return active connection information.

     * 

     * @return Information of active connection, if one exists.

     */ 

    WlanQtUtilsActiveConn *activeConnection();

    /**

     * Returns information of a connection with the given connection ID.

     * 

     * @param[in] connectionId Connection ID.

     * @return Information of the given connection, if one exists.

     */ 

    WlanQtUtilsActiveConn *connectionInfo(uint connectionId);

    /**

     * Stops given connection regardless of how many applications are using it.

     * 

     * @param[in] iapId IAP ID to disconnect.

     */ 

    void disconnectIap(int iapId);

signals:

    /**

     * Signal indicating available WLAN access points.

     * 

     * @param[in] availableWlans Available WLAN access points found in scan.

     */

    void availableWlanApsFromWrapper(QList<WlanQtUtilsWlanAp *> &availableWlans);

    /**

     * Signal indicating that a new connection has been created.

     * 

     * @param[in] connectionId Connection ID.

     */

    void connCreatedEventFromWrapper(uint connectionId);

    /**

     * Signal indicating that a connection has been deleted.

     * 

     * @param[in] connectionId Connection ID.

     */

    void connDeletedEventFromWrapper(uint connectionId);

    /**

     * Signal indicating that status of a connection has changed.

     * 

     * @param[in] connectionId Connection ID.

     * @param[in] connectionStatus Connection status.

     */

    void connStatusEventFromWrapper(uint connectionId, WlanQtUtilsConnectionStatus connectionStatus);

private: // Data

    /**

    * d_ptrScanWlans pointer to ConMonWrapperPrivate

    * Owned by ConMonWrapper object, instantiated in

    * constructor.

    */

    ConnMonScanWlanAps *d_ptrScanWlans;

    /**

    * d_ptrConnInfo pointer to ConMonWrapperPrivate

    * Owned by ConMonWrapper object, instantiated in

    * constructor.

    */

    ConnMonConnInfo *d_ptrConnInfo;

    /**

    * d_ptrConnDisconnect pointer to ConMonWrapperPrivate

    * Owned by ConMonWrapper object, instantiated in

    * constructor.

    */

    ConnMonConnDisconnect *d_ptrConnDisconnect;

private: // Friend classes

    // TestWlanQtUtils is defined as a friend class in order to be able to

    // call event handlers of wrappers.

    friend class TestWlanQtUtils;

};

QT_END_HEADER

QT_END_NAMESPACE

#endif /* WLANQTUTILSCONMONWRAPPER_H */

// End of file