1 /*

     2 * Copyright (c) 2009 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:  Network info listener

    15 *

    16 */

    17 

    18 #ifndef C_NETWORKLISTENER_H

    19 #define C_NETWORKLISTENER_H

    20 

    21 #include <e32base.h>

    22 #include <NWHandlingEngine.h>

    23 #include "ainetworkobserver.h"

    24 

    25 class MAiNetworkObserver;

    26 class CNWSession;

    27 

    28 /**

    29  *  @ingroup group_xmluicontroller

    30  *

    31  *  Network info listener.

    32  *

    33  *  Client can use this object to listen network state changes. Client must implement

    34  *  MAiNetworkObserver interface to retrieve network state changes

    35  *

    36  *  @since S60 5.0

    37  */

    38 NONSHARABLE_CLASS(CAiNetworkListener) : public CBase, 

    39                            public MNWMessageObserver

    40     {

    41 public:

    42 

    43     static CAiNetworkListener* CAiNetworkListener::NewL(MAiNetworkObserver& aNetworkObserver);

    44  

    45     virtual ~CAiNetworkListener();

    46     

    47     /**

    48      * Get current network status

    49      * @return TNetworkState

    50      */

    51     MAiNetworkObserver::TNetworkState NetworkState();

    52 

    53 // from base class MNWMessageObserver

    54 

    55     /**

    56      * From MNWMessageObserver.

    57      * Called by network handling engine when network info changes.

    58      *

    59      * @since S60 5.0

    60      * @param aMessage is type of the change.

    61      */

    62     void HandleNetworkMessage( const TNWMessages aMessage );

    63 

    64     /**

    65      * From MNWMessageObserver.

    66      * Called if network handling engine fails.

    67      *

    68      * @since S60 5.0

    69      * @param aOperation is failed operation.

    70      * @param aErrorCode is fail reason.

    71      */

    72     void HandleNetworkError( const TNWOperation aOperation, TInt aErrorCode );

    73 

    74 private:

    75     TBool HasNetworkInfoChanged( const TNWMessages aMessage );

    76 

    77     MAiNetworkObserver::TNetworkState InterpretNWMessage(const TNWMessages aMessage, const TNWInfo);

    78 

    79     CAiNetworkListener(MAiNetworkObserver& aNetworkObserver);

    80 

    81     void ConstructL();

    82 

    83  

    84 private: // data

    85 

    86      /**

    87      * Session to network handling engine.

    88      * Own.

    89      */

    90     CNWSession* iSession;

    91 

    92     /**

    93      * Cached network info structure.

    94      */

    95     TNWInfo iInfo;

    96     

    97     /**

    98      * Previous network information.

    99      */

   100     TNWInfo iOldInfo;

   101 

   102     /**

   103       * Reference to client observing

   104       */

   105       MAiNetworkObserver& iObserver;

   106 

   107 

   108     /**

   109      * Network related message flags

   110      */

   111      

   112     enum TNetInfoFlags 

   113         {

   114         ENetworkProviderNameReceived      = 0x00000001,

   115         ENetworkProviderNameOk            = 0x00000002,

   116         EServiceProviderNameReceived      = 0x00000004,

   117         EServiceProviderNameOk            = 0x00000008,

   118         ERegistrationStatusReceived       = 0x00000010,

   119         ENetworkInfoChangeReceived        = 0x00000020,

   120         EProgrammableOperatorInfoReceived = 0x00000040,

   121         EProgrammableOperatorInfoReceivedOk = 0x00000080

   122         };

   123         

   124     /**

   125      * Subset of sum of TNetInfoFlags.

   126      */    

   127     TUint iReceivedMessageFlags;

   128     

   129     /**

   130      * Subset of sum of old TNetInfoFlags.

   131      */    

   132     TUint iOldReceivedMessageFlags;

   133     

   134     /**

   135      * current state of network

   136      */    

   137     MAiNetworkObserver::TNetworkState iCurrentNwState;

   138      };

   139 //}    

   140 

   141 #endif // C_AINETWORKINFOLISTENER_H