1 /*

     2 * Copyright (c) 2005-2007 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:  Provide interface for the client requestin network availability.

    15 *

    16 */

    17 

    18 

    19 

    20 #ifndef __MUSAVACONNECTIONAVAILABILITY_H__

    21 #define __MUSAVACONNECTIONAVAILABILITY_H__

    22 

    23 

    24 #include "musavaavailability.h"

    25 #include "musavatelephonystatusobserver.h"

    26 #include "musavaconnectionmonitorobserver.h"

    27 #include "musunittesting.h"

    28 

    29 #include <e32base.h>

    30 #include <etelmm.h>

    31 

    32 class MMusAvaObserver;

    33 class CMusAvaSharedObject;

    34 class CMusAvaConnectionMonitor;

    35 class CConnMonEventBase;

    36 class CMusAvaNetworkRegistrationStatus;

    37 class CMusAvaNetworkModeStatus;

    38 class TAvailabilityStatus;

    39 class CMusAvaSettingsImp;

    40 class TMobilePhoneRegistrationStatus;

    41 

    42 

    43 /**

    44  *  Implemets register vailability.

    45  *

    46  *  Provide interface for the client to availability class.

    47  *

    48  *  @lib musavailabilityplugin.lib

    49  *  @since S60 v3.2

    50  */

    51 class CMusAvaConnectionAvailability : public CMusAvaAvailability,

    52                                       public MMusAvaTelephonyStatusObserver,

    53                                       public MMusAvaConnectionMonitorObserver

    54     {

    55 public:

    56     

    57     /**

    58      * Two-phased constructor

    59      *

    60      * @since S60 v3.2

    61      * @param aObserver Pointer to observer intercase

    62      * @param aName availability name

    63      * @param aModules is data container

    64      * @return Returns pointer to CMusAvaInterface object

    65      */

    66     static CMusAvaConnectionAvailability* NewL( MMusAvaAvailabilityObserver& aObserver,

    67                                                 CMusAvaSettingsImp& aSettings );

    68 

    69     static CMusAvaConnectionAvailability* NewLC( MMusAvaAvailabilityObserver& aObserver,

    70                                                  CMusAvaSettingsImp& aSettings );

    71 

    72     /**

    73      * Destructor

    74      */

    75     ~CMusAvaConnectionAvailability();

    76 

    77 protected:

    78 

    79     CMusAvaConnectionAvailability( MMusAvaAvailabilityObserver& aObserver,

    80                                    CMusAvaSettingsImp& aSettings );

    81 

    82     void ConstructL();

    83 

    84 

    85 public:// from base class CMusAvaAvailability

    86 

    87 

    88     /**

    89      * Executes for the availability.

    90      *

    91      * @since S60 v3.2

    92      * @return KErrNone if ExecutePatternL operation was

    93      *         successfully executed; system wide error otherwise

    94      */

    95     virtual void DoExecuteL();

    96 

    97      /**

    98      * Stop the execution.

    99      */

   100     virtual void Stop();

   101 

   102     /**

   103      * From CMusAvaAvailability.

   104      * Returns availability name.

   105      *

   106      * @return Name of *this* availability.

   107      */

   108     virtual MMusAvaObserver::TAvailabilityName Name();

   109 

   110 public: // from MMusAvaTelephonyStatusObserver

   111 

   112     /**

   113     * Current Network Mode Status

   114     *

   115     * @since  S60 v3.2

   116     * @return

   117     */

   118     void PhoneNetworkModeStatus(

   119             RMobilePhone::TMobilePhoneNetworkMode aStatus );

   120     

   121     /**

   122      * Current Network Registration Status

   123      *

   124      * @since  S60 v3.2

   125      * @return

   126      */

   127     void NetworkRegistrationStatus(

   128             RMobilePhone::TMobilePhoneRegistrationStatus aRegStatus );

   129 

   130 public: //from MMusAvaConnectionMonitorObserver

   131 

   132     /**

   133     * Event from connection monitor server

   134     *

   135     */

   136     void EventL(const CConnMonEventBase& aConnMonEvent);

   137 

   138 private:

   139 

   140     /**

   141     * Check needs to have manual activation 

   142     *

   143     * @since  S60 v3.2

   144     * @return TAvailabilityStatus is returned

   145     */

   146     MMusAvaObserver::TAvailabilityStatus ManualActivationL();

   147 

   148     /**

   149      * Current test network registration agains the settings

   150      *

   151      * @since  S60 v3.2

   152      * @return TAvailabilityStatus is returned

   153      */

   154     MMusAvaObserver::TAvailabilityStatus NetworkRegistrationAndSettingsL();

   155 

   156     static TBool OperatorVariant();

   157     

   158 private: // data

   159 

   160     /**

   161      * Pointer to CMusAvaNetworkRegistrationStatus object

   162      */

   163     CMusAvaNetworkRegistrationStatus* iNetworkRegistrationStatus;

   164 

   165     /**

   166      * Pointer to CMusAvaNetworkModeStatus object

   167      */

   168     CMusAvaNetworkModeStatus* iNetworkModeStatus;

   169 

   170     /**

   171     * Pointer to CMusAvaConnectionMonitor object

   172     */

   173     CMusAvaConnectionMonitor* iConnectionMonitor;

   174 

   175      /**

   176      * Pointer to CMusAvaSharedObject

   177      */

   178     CMusAvaSharedObject* iSharedObj;

   179 

   180      /**

   181      * Connection ID

   182      */

   183     TUint iConnectionID;

   184     

   185      /**

   186      * Reference to availability settings 

   187      */

   188     CMusAvaSettingsImp& iSettings;

   189 

   190     

   191     MUS_UNITTEST( UT_CMusAvaConnectionAvailability )

   192     };

   193 

   194 

   195 #endif // __MUSAVACONNECTIONAVAILABILITY_H__