diff -r f742655b05bf -r d38647835c2e convergedconnectionhandler/cchclientapi/inc/cchclientobserver.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/convergedconnectionhandler/cchclientapi/inc/cchclientobserver.h Wed Sep 01 12:29:57 2010 +0100 @@ -0,0 +1,154 @@ +/* +* Copyright (c) 2007 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: cch client api implementation class +* +*/ + + + +#ifndef C_CCHCLIENTOBSERVER_H +#define C_CCHCLIENTOBSERVER_H + +#include +#include +#include + +#include "cch.h" + + +/** + * Class for basic cch functionality, getting services + * + * @code + * ?good_class_usage_example(s) + * @endcode + * + * @lib cch + */ +class CCchClientObserver : public CActive + { + +public: + + /** + * Two-phased constructor. + * + * @param aCchService Cch service factory + */ + static CCchClientObserver* NewL( CCchServiceImpl& aCchService ) ; + + /** + * Two-phased constructor. + * + * @param aCchService Cch service factory + */ + static CCchClientObserver* NewLC( CCchServiceImpl& aCchService ); + + /** + * Destructor. + */ + ~CCchClientObserver(); + + /** + * @deprecated Do not use this anymore, change to AddObserver! + * + * Adds observer for listening service events + * + * @param aObserver Event observing class + */ + void SetObserver( MCchServiceStatusObserver& aObserver ); + + /** + * @deprecated Do not use this anymore, change to + * RemoveObserver method with paramater + * + * Removes the observer of service events + */ + void RemoveObserver( ); + + /** + * Adds observer for listening service events + * + * @param aObserver Event observing class + * @return KErrAlreadyExist Observer already added + * KErrNone Observer was added + */ + TInt AddObserver( MCchServiceStatusObserver& aObserver ); + + /** + * Removes the observer of service events + * + * @param aObserver Event observing class + * @return KErrNotFound Observer was not found + * KErrNone Observer was removed + */ + TInt RemoveObserver( MCchServiceStatusObserver& aObserver ); + +private: + + /** + * The constructor + * + * @param aCchService Cch service factory + */ + CCchClientObserver( CCchServiceImpl& aCchService ); + + /** + * By default Symbian 2nd phase constructor is private. + */ + void ConstructL(); + +private: //from CActive + + /** + * @see CActive. + */ + void RunL(); + + /** + * @see CActive. + */ + void DoCancel(); + + /** + * @see CActive. + */ + TInt RunError( TInt aError ); + +private: // data + + /** + * cch service factory, not own + */ + CCchServiceImpl& iCchService; + + /** + * Service observer, not own + */ + MCchServiceStatusObserver* iBackwardSupportObserver; + + /** + * Stores service status information + */ + TPckgBuf iServiceStatus; + + // Observers + RPointerArray iObservers; + +#ifdef CCHUNITTEST + friend class UT_CCchService; +#endif + }; + +#endif // C_CCHCLIENTOBSERVER_H