/*

* Copyright (c) 2006-2010 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:   Contains CNcdProviderUtils implementation

*

*/

#ifndef NCD_PROVIDER_UTILS_H

#define NCD_PROVIDER_UTILS_H

#include <e32base.h>

#include <f32file.h>

#include "ncdinstallationservice.h"

class MNcdEngineConfiguration;

class CNcdEngineConfiguration;

class MNcdDeviceService;

class MNcdProtocol;

class CNcdHttpUtils;

/**

 *

 *  

 *

 *  @lib ?library

 *  @since S60 ?S60_version *** for example, S60 v3.0

 */

class CNcdProviderUtils : public CBase

    {

public: // 

    /**

     * Creates new provider utils

     *

     * @param aConfigFile Configuration file. Just filename, no path

     */

    static CNcdProviderUtils* NewL( 

        const TDesC& aConfigFile );

    virtual ~CNcdProviderUtils();

    /**

     * File session getter

     */

    static RFs& FileSession();

    /**

     * Installation service getter

     *

     * @note Creates the service if it doesn't exist yet.

     */

    static MNcdInstallationService& InstallationServiceL();

    /**

     * Engine configuration getter

     */

    static MNcdEngineConfiguration& EngineConfig();

    /**

     * Device service getter

     *

     * @return Device service

     */

    static MNcdDeviceService& DeviceService();

    /**

     * Provider temp path getter

     *

     * @return Temp path     

     */

    static HBufC* TempPathLC( const TDesC& aClientId );

    static void ReadDatabaseVersionsL( 

        const TDesC& aRootPath,

        TUint32& aGeneralVersion, 

        TUint32& aPurchaseHistoryVersion );

    static void WriteDatabaseVersionsL(

        const TDesC& aRootPath,

        TUint32 aGeneralVersion,

        TUint32 aPurchaseHistoryVersion );

    static TInt UpdateShutdownFileL( const TDesC& aRootPath );

    static void RemoveShutdownFileL( const TDesC& aRootPath );

    /**    

     */

    static TNcdApplicationStatus IsApplicationInstalledL(

        const TUid& aUid, const TDesC& aVersion );

    // check if a widget with given identifier is installed already    

    static TNcdApplicationStatus IsWidgetInstalledL(

        const TDesC& aIdentifier, const TDesC& aVersion );

    //  Calling widget registry API to return the Uid of the widget with given identifier

    static TUid WidgetUidL( const TDesC& aIdentifier);

    /**

     * Compares version number strings

     *

     * They are converted as TCatalogsVersion before conversion

     * @return 0 if versions match, negative value if left < right and

     * positive value if left > right

     * @see TCatalogsVersion::ConvertL for possible leave codes

     */

    static TInt CompareVersionsL( const TDesC& aLeft, const TDesC& aRight );

private:

    CNcdProviderUtils();

    void ConstructL( const TDesC& aConfigFile );

protected:

    static RFs iFs;

    static CNcdEngineConfiguration* iConfig;

    static MNcdDeviceService* iDeviceService;

    static MNcdInstallationService* iInstallationService;

    };

#endif // NCD_PROVIDER_UTILS_H