/*

* Copyright (c) 2002-2004 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:  factory settings for active space

*

*/

#ifndef HNREPOSITORYOBSERVER_H_

#define HNREPOSITORYOBSERVER_H_

#include <liwcommon.h>

#include <e32base.h>

#include <centralrepository.h>

#include <cenrepnotifyhandler.h>

#include "hnmdmodel.h"

#include "hnservicehandler.h"

#include "hnsuiteobserver.h"

/**

 * Repository Observer base class.

 *

 * It is used to be derived by repository observers.

 *

 * @lib hnmetadatamodel

 * @since S60 5.0

 * @ingroup group_hnmetadatamodel

 */

NONSHARABLE_CLASS( CHnRepositoryObserver ):

    public CBase,

    public MCenRepNotifyHandlerCallback

	{

public:

    /**

     * Default C++ Destructor.

     *

     * @since S60 v5.0

     */

    virtual ~CHnRepositoryObserver();

protected:

    /**

     * Defautlt C++ Constructor.

     *

     * @param aCmnPtrs Common pointers.

     * @since S60 v5.0

     */

    CHnRepositoryObserver( THnMdCommonPointers* aCmnPtrs );

    /**

     * Defautlt C++ Constructor.

     *

     * @param aCmnPtrs Common pointers.

     * @since S60 v5.0

     */

    CHnRepositoryObserver( THnMdCommonPointers* aCmnPtrs, TUint32 iId );

    /**

     * Second stage constructor.

     *

     * @since S60 v5.0

     */

    void ConstructL( const TUid aRepositoryUid );

protected:

    /**

     * Own - Central Repository access class.

     */

    CRepository *iRepository;

    /**

     * Id of the CR entry to be watched.

     */

    TUint32 iId;

    /**

     * Common pointers.

     */

    THnMdCommonPointers* iCmnPtrs;

    /**

     * Own - Central repository notification handler.

     */

    CCenRepNotifyHandler* iNotifyHandler;

	};

/**

 * Widget Type Repository Observer.

 *

 * It is used to inform hierarchy navigator of changes in the suites repository.

 *

 * @lib hnmetadatamodel

 * @since S60 5.0

 * @ingroup group_hnmetadatamodel

 */

NONSHARABLE_CLASS( CHnRepositoryWidgetTypeObserver ): public CHnRepositoryObserver

	{

public:

    /**

     * Default C++ Destructor.

     *

     * @since S60 v5.0

     */

    virtual ~CHnRepositoryWidgetTypeObserver();

    /**

     * Factory function.

     *

     * @param aCmnPtrs Common pointers.

     * @return Repository Observer.

     * @since S60 v5.0

     */

    static CHnRepositoryWidgetTypeObserver* NewL( THnMdCommonPointers* aCmnPtrs, const TUid aRepositoryUid  );

    /**

     * Factory function.

     *

     * @param aCmnPtrs Common pointers.

     * @return Repository Observer.

     * @since S60 v5.0

     */

    static CHnRepositoryWidgetTypeObserver* NewLC( THnMdCommonPointers* aCmnPtrs, const TUid aRepositoryUid  );

    /**

     * Change handler method.

     * It is invoked whenever notifier detects a change in the CR.

     *

     * @param aId Id of the entry in CR.

     * @since S60 v5.0

     */

    void HandleNotifyGeneric(TUint32 aId);

    /**

     * Change handler method.

     * It is invoked whenever notifier detects a change in the CR.

     *

     * @param aId Id of the entry in CR.

     * @since S60 v5.0

     */

    void HandleNotifyGenericL(TUint32 aId);

private:

    /**

     * Defautlt C++ Constructor.

     *

     * @param aCmnPtrs Common pointers.

     * @since S60 v5.0

     */

	CHnRepositoryWidgetTypeObserver( THnMdCommonPointers* aCmnPtrs );

private:

    /**

     * Second stage constructor.

     *

     * @since S60 v5.0

     */

	void ConstructL( const TUid aRepositoryUid );

private:

	/**

	 * Array holding ids of widgets being switched.

	 * It is used to eliminate double refresh for such suites.

	 */

	RArray<TUint32> iWidgetSwitches;

	};

NONSHARABLE_CLASS( CHnRepositoryShowFolderObserver ): 	public CHnRepositoryObserver,

														public MLiwNotifyCallback,

														public MHnSuiteObserver

	{

public:

    /**

     * Default C++ Destructor.

     *

     * @since S60 v5.0

     */

    virtual ~CHnRepositoryShowFolderObserver();

    /**

	 * Factory function.

	 *

	 * @param aCmnPtrs Common pointers.

	 * @return Repository Observer.

	 * @since S60 v5.0

	 */

	static CHnRepositoryShowFolderObserver* NewL(

			THnMdCommonPointers* aCmnPtrs, const TUid aRepositoryUid,

			const TUint32 aId);

	/**

	 * Factory function.

	 *

	 * @param aCmnPtrs Common pointers.

	 * @return Repository Observer.

	 * @since S60 v5.0

	 */

	static CHnRepositoryShowFolderObserver* NewLC(

			THnMdCommonPointers* aCmnPtrs, const TUid aRepositoryUid,

			const TUint32 aId);

    /**

     * Change handler method.

     * It is invoked whenever notifier detects a change in the CR.

     *

     * @param aId Id of the entry in CR.

     * @since S60 v5.0

     */

    void HandleNotifyString(TUint32 aId, const TDesC16& aNewValue );

    /**

     * Change handler method.

     * It is invoked whenever notifier detects a change in the CR.

     *

     * @param aId Id of the entry in CR.

     * @since S60 v5.0

     */

    void HandleNotifyStringL(TUint32 aId, const TDesC16& aNewValue );

    /**

     * From MLiwNotifyCallback

     */

    TInt HandleNotifyL(

        TInt aCmdId,

        TInt aEventId,

        CLiwGenericParamList& aEventParamList,

        const CLiwGenericParamList& aInParamList);

    /**

     * From MHnSuiteObserver

     */

    virtual void HandleSuiteEventL ( THnCustomSuiteEvent aCustomSuiteEvent,

            CHnSuiteModel *aModel );

private:

    /**

     * Defautlt C++ Constructor.

     *

     * @param aCmnPtrs Common pointers.

     * @since S60 v5.0

     */

	CHnRepositoryShowFolderObserver( THnMdCommonPointers* aCmnPtrs, TUint32 iId  );

    /**

     * Extracts the folder name from the CR key.

     *

     * @param aNewValue The CR key.

     * @since S60 v5.0

     */

	void ExtractCRKeyShowFolderName( const TDesC& aNewValue );

	/**

	 * Request get list for parent folder of an application.

	 *

	 * @param aFolderId A parent folder id

	 * @since S60 v5.0

	 */

    void GetShowFolderL( TUint32 aFolderId );

    /**

     * Request get list for a folder with given application group name

     * contained in iCRKeyFolderName.

     *

     * @since S60 v5.0

     */

    void GetShowFolderGroupNameL();

private:

    /**

     * Type of a flag describing the type of notification.

     * APP_ID - MCS id is given

     * APP_UID - Application UID is given

     * SECOND_NOTIFY - handled notify caused by the second get list

     */

    enum TNotifyType { EAPP_ID=1, EAPP_UID=2, ESECOND_NOTIFY=4 };

private:

    /**

     * Second stage constructor.

     *

     * @since S60 v5.0

     */

	void ConstructL( const TUid aRepositoryUid );

private:

	/**

     * Folder application group name.

     */

	TBuf8<KApaMaxAppGroupName> iCRKeyFolderName;

    /**

     * Mcs id for an application item in a folder with a given app group name.

     */

	TBuf8<KUidStringLength> iCRKeyFolderItemUid;

	/**

     * Own.

     * Intance of the service handler.

     */

    CHnServiceHandler* iServiceHandler;

    /**

       * Flag describing the type of notification.

     */

    TInt iNotifyType;

	};

#endif /*HNREPOSITORYOBSERVER_H_*/

//End of file