1 /*

     2  * Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies). 

     3  * All rights reserved.

     4  * This component and the accompanying materials are made available

     5  * under the terms of "Eclipse Public License v1.0"

     6  * which accompanies this distribution, and is available

     7  * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8  *

     9  * Initial Contributors:

    10  * Nokia Corporation - initial contribution.

    11  *

    12  * Contributors:

    13  *

    14  * Description:  Implementation of CWsfActiveWrappers.

    15  *

    16  */

    17 

    18 

    19 

    20 #ifndef WSFACTIVEWRAPPERS_H

    21 #define WSFACTIVEWRAPPERS_H

    22 

    23 //  EXTERNAL INCLUDES

    24 #include <e32std.h>

    25 #include <e32base.h>

    26 

    27 //  INTERNAL INCLUDES

    28 #include "wsfcommon.h"

    29 #include "wsfaicontroller.h"

    30 #include "wsfmodel.h"

    31 

    32 //  FORWARD DECLARATIONS

    33 class CWsfWLANListActiveWrapper;

    34 class CWsfRefreshScanActiveWrapper;

    35 class CWsfDisconnectActiveWrapper;

    36 class CWsfConnectActiveWrapper;

    37 class CWsfLaunchAiHelperActiveWrapper;

    38 

    39 // CLASS DECLARATION

    40 

    41 /**

    42  *  Active object helper class that capsulates active wrapper classes

    43  *

    44  *  @lib wsfaiplugin.lib

    45  *  @since S60 v5.2

    46  * 

    47  */

    48 class CWsfActiveWrappers : public CBase

    49     {

    50 public:

    51     // Constructors and destructor

    52 

    53     /**

    54      * Destructor.

    55      * @since S60 5.2 

    56      */

    57     ~CWsfActiveWrappers();

    58 

    59     /**

    60      * Two-phased constructor.

    61      * @since S60 5.2  

    62      */

    63     static CWsfActiveWrappers* NewL( CWsfModel* aModel,

    64             TWsfAiController &aController );

    65 

    66     /**

    67      * Two-phased constructor.

    68      * @since S60 5.2 

    69      */

    70     static CWsfActiveWrappers* NewLC(CWsfModel* aModel,

    71             TWsfAiController &aController );

    72 

    73 public:

    74 

    75     /**

    76      * Starts disconnecting 

    77      * @since S60 5.2     

    78      */

    79     void Disconnect();

    80 

    81     /**

    82      * Starts connecting

    83      * @since S60 5.2     

    84      * @param aIapId WLAN IAP id to connect to.

    85      * @param aConnectOnly ETrue if Connect selected

    86      * @param aPersistence Persistence property of the IAP

    87      */

    88     void Connect( TUint aIapID, TBool aConnectOnly, 

    89                   TWsfIapPersistence aPersistence );

    90 

    91     /**

    92      * Starts refresh scan

    93      * @since S60 5.2     

    94      */

    95     void RefreshScan();

    96 

    97     /**

    98      * Starts wlan list refreshing

    99      * @since S60 5.2   

   100      * @param aStarUp is this called called from plugin start up   

   101      */

   102     void RefreshWLANList( TBool aStarUp );

   103     

   104     /**

   105      * Starts launching of ai helper 

   106      * @since S60 5.2   

   107      * @param aWlanInfo The WlanInfo object to be passed to the helper app

   108      * @param aConnectOnly ETrue if we are only connecting, 

   109      *                     EFalse if we should also launch the browser  

   110      * @param aTestAccessPoint ETrue if ICT is executed, 

   111      *                         EFalse if ICT is not executed 

   112      */

   113     void LaunchHelperApplicationL( TWsfWlanInfo& aInfo, TBool aConnectOnly, 

   114                                    TBool aTestAccessPoint );

   115 

   116     /**

   117      * Returns the list of found WLANs. 

   118      * Ownership not passed.

   119      * @since S60 5.2

   120      * @return Array of WLANs

   121      */

   122     CWsfWlanInfoArray* GetWLANList();

   123 

   124     /**

   125      * Returns the connected wlan network 

   126      * @since S60 5.2

   127      * @return TWsfWlanInfo

   128      */

   129     TWsfWlanInfo GetConnectedWLANNetwork();

   130 

   131 private:

   132 

   133     /**

   134      * Constructor for performing 1st stage construction

   135      */

   136     CWsfActiveWrappers();

   137 

   138     /**

   139      * Constructor for performing 2nd stage construction

   140      */

   141     void ConstructL( CWsfModel* aModel, TWsfAiController &aController );

   142 

   143 private:

   144     // Data

   145 

   146     /**

   147      * Pointer to CWsfWLANListActiveWrapper

   148      * Own.

   149      */

   150     CWsfWLANListActiveWrapper* iWLANListActiveWrapper;

   151 

   152     /**

   153      * Pointer to CWsfRefreshScanActiveWrapper

   154      * Own.

   155      */

   156     CWsfRefreshScanActiveWrapper* iRefreshScanActiveWrapper;

   157 

   158     /**

   159      * Pointer to CWsfDisconnectActiveWrapper

   160      * Own.

   161      */

   162     CWsfDisconnectActiveWrapper* iDisconnectActiveWrapper;

   163 

   164     /**

   165      * Pointer to CWsfConnectActiveWrapper

   166      * Own.

   167      */

   168     CWsfConnectActiveWrapper* iConnectActiveWrapper;

   169 

   170     /**

   171      * Pointer to CWsfLaunchAiHelperActiveWrapper

   172      * Own.

   173      */

   174     CWsfLaunchAiHelperActiveWrapper* iLaunchAiHelperActiveWrapper;

   175 

   176     };

   177 

   178 #endif // WSFACTIVEWRAPPERS_H