diff -r 000000000000 -r 307788aac0a8 sipplugins/sippsystemstatemonitor/inc/sipsnapavailabilitymonitor.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/sipplugins/sippsystemstatemonitor/inc/sipsnapavailabilitymonitor.h Tue Feb 02 01:03:15 2010 +0200 @@ -0,0 +1,135 @@ +/* +* Copyright (c) 2008 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 CSIPSNAPAVAILABILITYMONITOR_H +#define CSIPSNAPAVAILABILITYMONITOR_H + +// INCLUDES +#include "MSystemStateConnUsagePermissionObserver.h" +#include +#include +#include + +// FORWARD DECLARATIONS +class MSipSystemStateObserver; + +// CLASS DEFINITION +/** +* A class for monitoring the availability of a SNAP. +*/ +class CSipSnapAvailabilityMonitor : + public CActive, + public MConnectionMonitorObserver, + public MSystemStateConnUsagePermissionObserver + { + public: // Constructors and destructor + + /** + * Static constructor + * @param aSnapId the ID of the SNAP to be monitored + * @param aPermissionToUseNetwork the current permission to use network + * @param aObserver observer to be notified about SNAP availability + * @return An initialized instance of this class. + */ + static CSipSnapAvailabilityMonitor* NewL( + TUint32 aSnapId, + TBool aPermissionToUseNetwork, + MSipSystemStateObserver& aObserver ); + + /** + * Static constructor + * @param aSnapId the ID of the SNAP to be monitored + * @param aPermissionToUseNetwork the current permission to use network + * @param aObserver observer to be notified about SNAP availability + * @return An initialized instance of this class. + */ + static CSipSnapAvailabilityMonitor* NewLC( + TUint32 aSnapId, + TBool aPermissionToUseNetwork, + MSipSystemStateObserver& aObserver ); + + /// Destructor + ~CSipSnapAvailabilityMonitor(); + + public: // From CActive + + void RunL(); + + void DoCancel(); + + public: // From MConnectionMonitorObserver + + void EventL( const CConnMonEventBase &aConnMonEvent ); + + public: // from MSystemStateConnUsagePermissionObserver + + void UsagePermissionChanged( TBool aPermissionToUse, TInt aError ); + + public: // New functions + + TUint32 SnapId() const; + + CSipSystemStateMonitor::TSnapAvailability SnapAvailability() const; + + void AddObserverL( MSipSystemStateObserver& aObserver ); + + void RemoveObserver( MSipSystemStateObserver& aObserver ); + + TBool HasObservers() const; + + private: // Constructors + + CSipSnapAvailabilityMonitor( + TUint32 aSnapId, + TBool aPermissionToUseNetwork ); + + void ConstructL( MSipSystemStateObserver& aObserver ); + + private: // Private methods + + TBool IsSnapAvailable( + const TConnMonSNAPInfo& aSnapInfo, + TUint32 aSnapId ) const; + + void NotifyObservers() const; + + TBool SetCurrentState( + TBool aPermissionToUseNetwork, + TBool aSnapAvailable ); + + TBool CanSnapBeUsed() const; + + private: // Data + + TUint32 iSnapId; + TBool iPermissionToUseNetwork; + TBool iSnapAvailable; + // Observers not owned + RPointerArray iObservers; + /// Connection monitor session. Owned. + RConnectionMonitor iConnMon; + TConnMonSNAPInfoBuf iSnapInfoBuf; + // ETrue if successfully connected to Connection Monitor Server + // (iConnMon). + TBool iIsConnected; + + private: // For unit testing purposes + + friend class CSipSnapAvailabilityMonitorTest; + }; + +#endif // CSIPSNAPAVAILABILITYMONITOR_H