1 /*

     2 * Copyright (c) 2005-2006 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:  This is default implementation class for CMusAvaInterface

    15 *

    16 */

    17 

    18 

    19 #ifndef __MUSAVADEFAULTIMP_H__

    20 #define __MUSAVADEFAULTIMP_H__

    21 

    22 //  USER

    23 #include "musavainterface.h"

    24 #include "musavaavailabilityobserver.h"

    25 #include "musunittesting.h"

    26 

    27 // SYSTEM

    28 #include <e32base.h>

    29 #include <e32std.h>

    30 

    31 class MMusAvaObserver;

    32 class CMusAvaSettingsImp;

    33 class CMusAvaSettings;

    34 class CMusAvaSharedObject;

    35 class CMusAvaAvailability;

    36 class MMusAvaAvailabilityObserver;

    37 class MMusAvaSettingsObserver;

    38 

    39 /**

    40  *  CMusAvaDefaultImp class represent the interface of application.

    41  *

    42  *  It accept request from the API for creating the corresponding

    43  *  availability report.

    44  *

    45  *  @lib musavailabilityplugin.lib

    46  */

    47 class CMusAvaDefaultImp : public CMusAvaInterface, 

    48     private MMusAvaAvailabilityObserver

    49     {

    50     public:  // Constructors and destructor

    51 

    52         /**

    53          * Two-phased constructor

    54          *

    55          * @return Returns pointer to CMusAvaDefaultImp object

    56          */

    57         static CMusAvaDefaultImp* NewL();

    58 

    59         /**

    60          * Destructor

    61          *

    62          */

    63         ~CMusAvaDefaultImp();

    64 

    65    protected:  // Constructors

    66 

    67         /**

    68          * Constructor

    69          *

    70          * @param aObserver Pointer to observer intercase

    71          */

    72         CMusAvaDefaultImp( );

    73 

    74         /**

    75          * Perform the second phase construction of a

    76          *             CMusAvaDefaultImp object

    77          *

    78          */

    79         void ConstructL();

    80 

    81 

    82     protected:

    83 

    84 

    85         /**

    86          * Create availability setting.

    87          *

    88          */

    89         void CreateAvailabilityModulesL();

    90 

    91 

    92         /**

    93          * Create work for executing availability report.

    94          *

    95          */

    96         void ExecuteAvailablitityModules();

    97 

    98 		 /**

    99          * Create handler (Invite/Options) availability module.

   100          *

   101          */

   102 		void ConstuctHandlerAvailabilityModulesL();

   103 		

   104 		 /**

   105          * Create static ( Sipprofile / activation ) availability module.

   106          *

   107          */

   108 		void ConstructStaticAvailabilityModulesL();

   109 

   110         /**

   111          * Create dynamic ( call / network / bearer ) availability module.

   112          *

   113          */

   114 		void ConstructDynamicAvailabilityModulesL();

   115 

   116 

   117     public: // from base class CMusAvaInterface

   118 

   119          /**

   120          * Called by the ECOM framework when MusAvailability Plug-in is request

   121          * retuns setting interface for the client.

   122          *

   123          */

   124         virtual MMusAvaSettings& Settings();

   125 

   126         /**

   127          * Called by the ECOM framework when MusAvailability Plug-in is for

   128          * Observer interface for the client.

   129          *

   130          * @since S60 v3.2

   131          * @param aObserver bserver interface

   132          */

   133         virtual void SetObserver( MMusAvaObserver& aObserver );

   134         

   135         /**

   136          * Called by the ECOM framework when MusAvailability Plug-in is for

   137          * setting Observer interface for the client.

   138          *

   139          * @since S60 v3.2

   140          * @param aObserver MMusAvaSettingsObserver interface

   141          */

   142         virtual void SetSettingsObserver( MMusAvaSettingsObserver& aObserver );

   143 

   144          /**

   145          * Called by the ECOM framework when MusAvailability Plug-in is request

   146          * to investigate availabilites for the client.

   147          *

   148          */

   149         virtual void StartL();

   150 

   151         /**

   152          * Called by the ECOM framework when MusAvailability Plug-in is request

   153          * to stop investigate or monitoring availabilites for the client.

   154          *

   155          */

   156         virtual void Stop();

   157 

   158         void CalculateAvailability();

   159         virtual MMusAvaObserver::TAvailabilityName CurrentAvailability();

   160         virtual MMusAvaObserver::TAvailabilityStatus AvailabilityStatus();

   161         virtual TBool MinimumAvailability();

   162         virtual TBool MandatoryAvailability();

   163         virtual TBool ExtensionAvailability();

   164         virtual MMusAvaObserver::TAvailabilityStatus AvailabilityState( MMusAvaObserver::TAvailabilityName aAvailability );

   165 

   166     public: // from base class MMusAvaAvailabilityObserver

   167 

   168        /**

   169          * Availability report

   170          *

   171          * @param aName Availability name

   172          * @param aStatus Current availability Status

   173          */

   174     virtual void AvailabilityChanged(

   175         MMusAvaObserver::TAvailabilityName aName,

   176         MMusAvaObserver::TAvailabilityStatus aStatus );

   177         

   178 		 /**

   179          * Availability error report

   180          *

   181          * @param aName Availability name

   182          * @param aStatus Current availability Status

   183          */

   184     virtual void AvailabilityError(

   185         MMusAvaObserver::TAvailabilityName aName,

   186         MMusAvaObserver::TAvailabilityStatus aStatus );

   187         

   188     virtual TBool Available( MMusAvaObserver::TAvailabilityName aAvailability );

   189         

   190     virtual MMusAvaObserver::TAvailabilityStatus AvailabilityPluginState();

   191     

   192 

   193     private: // data

   194 

   195         RPointerArray<CMusAvaAvailability> iAvailabilities;

   196 

   197         /**

   198          * Pointer to Observer interface for the ECOM Client

   199          */

   200         MMusAvaObserver* iObserver;

   201 

   202         /**

   203          * Pointer to CMusAvaSettings object

   204          */

   205         CMusAvaSettingsImp* iSettings;

   206 

   207         MMusAvaObserver::TAvailabilityName iCurrentAvailability;

   208         MMusAvaObserver::TAvailabilityStatus iAvailabilityStatus;

   209 

   210         TBool iStopping;

   211         TBool iExecuteStarted;

   212         

   213         TInt iForbidden;

   214 

   215         MUS_UNITTEST( UT_CMusAvaDefaultImp )

   216 

   217         };

   218 

   219 

   220 #endif // __MUSAVADEFAULTIMP_H__

   221