/*
* 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:  Java MIDlet runtime type for AppMngr2
*
*/


#ifndef APPMNGR2MIDLETRUNTIME_H
#define APPMNGR2MIDLETRUNTIME_H

#include <appmngr2runtime.h>            // CAppMngr2Runtime
#include <javaregistryincludes.h>

class MAppMngr2RuntimeObserver;
class CAppMngr2MidletPckgInfoFactory;
class CAppMngr2RecognizedFile;
class CAppMngr2PackageInfo;
class CAknIconArray;
class CAppMngr2MidletResourceHandler;

/**
 *  ECom interface UID for AppMngr2 MIDlet Runtime Plugin
 */
const TInt KAppMngr2MidletUidValue = 0x20016BF8;
const TUid KAppMngr2MidletUid = { KAppMngr2MidletUidValue };

/**
 * MIDlet Runtime Plug-in
 *
 * The MIDlet Runtime Plug-in provides to AppMngr:
 * - Array of MIDlet suite Installation Packages Info objects
 *   based on provided file name list.
 * - Array of installed MIDlets Application Info objects.
 * - MIDlet default icons
 * - Data types supported for creating installation
 * - Additional directories for installation file scanning.
 *
 * @lib appmngr2midletplugin.dll
 * @since S60 v9.1
 */
class CAppMngr2MidletRuntime : public CAppMngr2Runtime
{
public:     // constructor and destructor

    /**
     * Two phase constructor
     * @param aObserver Observer implementing MAppMngr2RuntimeObserver functions
     *
     * @since S60 9.1
     * @return instance
     */
    static CAppMngr2MidletRuntime* NewL(MAppMngr2RuntimeObserver& aObserver);

    /**
     * Destructor
     *
     * @since S60 9.1
     */
    ~CAppMngr2MidletRuntime();

public:     // from CAppMngr2Runtime

    /**
     * Load plug-in specific icons. Functions CAppMngr2InfoBase::IconIndex()
     * and CAppMngr2InfoBase::IndicatorIconIndex() must return indexes to the
     * plug-in specific icons appended to aIconArray.
     * @param aIconArray  Array where to append the loaded icons
     */
    void LoadIconsL(CAknIconArray& aIconArray);

    /**
     * Get data types that this Runtime plug-in supports for creating installation
     * file (CAppMngr2PackageInfo) objects. When installation files are scanned,
     * recognized files are provided to the plug-in via GetPackageInfosL() function.
     * @param aDataTypeArray  Array where to append supported data types
     */
    void GetSupportedDataTypesL(CDataTypeArray& aDataTypeArray);

    /**
     * Create package info objects to represent installation files in "Installation
     * Files" view. Each package info object is displayed as a separate item in the
     * "Installation Files" view. Package info objects should be based on recognized
     * installation files, provided in aFileList array. All data types match to the
     * ones defined in function CAppMngr2Runtime::GetSupportedDataTypesL().
     * @param aPackageInfos  Array where to append package info objects
     * @param aFileList  List of recognized files
     * @param aFsSession  File server session
     * @param aStatus  The request status. KErrNone on completion,
     *                otherwise another of the system-wide error codes.
     */
    void GetInstallationFilesL(RPointerArray<CAppMngr2PackageInfo>& aPackageInfos,
                               const RPointerArray<CAppMngr2RecognizedFile>& aFileList,
                               RFs& aFsSession,
                               TRequestStatus& aStatus);

    /**
     * Cancel pending asynchronous GetInstallationFilesL() request.
     */
    void CancelGetInstallationFiles();

    /**
     * Create application info objects to represent installed applications in
     * "Installed" view. Each application info object is displayed as separate
     * item in "Installed" view.
     * @param aApps  Array where to add application info objects
     * @param aFsSession  File server session
     * @param aStatus  Request status for the asynchronous request
     */
    void GetInstalledAppsL(RPointerArray<CAppMngr2AppInfo>& aApps,
                           RFs& aFsSession, TRequestStatus& aStatus);

    /**
     * Cancel pending asynchronous GetInstalledAppsL() request.
     */
    void CancelGetInstalledApps();


private:    // new functions

    /**
     * Constructor
     * @param aObserver Observer implementing MAppMngr2RuntimeObserver functions
     *
     * @since S60 9.1
     */
    CAppMngr2MidletRuntime(MAppMngr2RuntimeObserver &aObserver);

    /**
     * Second phase constructor
     *
     * @since S60 9.1
     */
    void ConstructL();

    /**
     * Create Installed MIDlet suite application info object.
     * @param aApps  Array where to add application info object
     * @param aFsSession  File server session
     * @param aEntry  Java registry MIDlet suite entry
     */
    void GetInstalledAppL(RPointerArray<CAppMngr2AppInfo>& aApps,
                          RFs& aFsSession,
                          Java::CJavaRegistryPackageEntry* aEntry);

private:    // data

    /**
     * Java Registry for getting installed Java applications
     * Owned
     */
    Java::CJavaRegistry* iJavaRegistry;

    /**
     * Package Info factory for getting installation packages
     * Owned
     */
    CAppMngr2MidletPckgInfoFactory* iPckgFactory;

    /**
     * Resource handler
     * Owned
     */
    CAppMngr2MidletResourceHandler* iResourceHandler;
};

#endif // APPMNGR2MIDLETRUNTIME_H