/*

* 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 <e32base.h>

#include <ccherror.h>

#include <cchtypes.h>

#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<TServiceStatus> iServiceStatus;

    // Observers

    RPointerArray<MCchServiceStatusObserver> iObservers;

#ifdef CCHUNITTEST

    friend class UT_CCchService;

#endif

    };

#endif // C_CCHCLIENTOBSERVER_H