/*

* Copyright (c) 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:

*

*/

package com.nokia.mj.impl.installer.applicationregistrator;

import com.nokia.mj.impl.installer.utils.InstallerException;

import com.nokia.mj.impl.installer.utils.Log;

/**

 * Sends installation and uninstallation progress notifications

 * to platform's software installation framework.

 */

public final class SifNotifier

{

    /** Install operation. */

    /** Uninstall operation. */

    /** Update operation. */

        specific suboperation. */

    /** OCSP phase during installation. */

    /** Download phase during installation. */

    /** Operation being notified. */

    private int iOperation = 0;

    /** Global component id for the application. */

    private String iGlobalComponentId = null;

    /** Component name (i.e. suite name). */

    private String iComponentName = null;

    /** Application names. */

    private String[] iApplicationNames = null;

    /** Applications icons. */

    private String[] iApplicationIcons = null;

    /** Component initial size. */

    private int iComponentSize = 0;

    /** Icon dir. */

    private String iIconDir = null;

    /** Component icon. */

    private String iComponentIcon = null;

    /** Sending progress notifications is only allowed between start

     *  and end notifications. */

    private boolean iNotifyProgressAllowed = false;

    private int iHandle = 0;

    /*** ----------------------------- PUBLIC ------------------------------ */

    /**

     * Constructor.

     */

    public SifNotifier()

    {

        init();

    }

    /**

     * Returns true if SIF progress notifications are enabled, false otherwise.

     */

    public static boolean enabled()

    {

        return _sifNotifierEnabled();

    }

    /*

     * Notifies SIF that installation or uninstallation has started.

     *

     * @throws InstallerException in case an error occurs

     */

    public void notifyStart(

        int aOperation, String aGlobalComponentId, String aComponentName,

        String[] aApplicationNames, String[] aApplicationIcons,

        int aComponentSize, String aIconDir, String aComponentIcon)

    {

        iOperation = aOperation;

        iGlobalComponentId = aGlobalComponentId;

        iComponentName = aComponentName;

        iApplicationNames = aApplicationNames;

        iApplicationIcons = aApplicationIcons;

        iComponentSize = aComponentSize;

        iIconDir = aIconDir;

        iComponentIcon = aComponentIcon;

        int ret = _notifyStart(

                      aApplicationNames, aApplicationIcons,

                      aComponentSize, aIconDir, aComponentIcon);

        if (ret < 0)

        {

            InstallerException.internalError(

                "Notifying SIF start failed with code " + ret);

        }

        iNotifyProgressAllowed = true;

    }

    /**

     * Notifies SIF that installation or uinstallation has ended.

     *

     * @throws InstallerException in case an error occurs

     */

    public void notifyEnd(

        int aErrCategory, int aErrCode, String aErrMsg, String aErrMsgDetails)

    {

        {

        }

        iNotifyProgressAllowed = false;

        int ret = _notifyEnd(

                      iHandle, iGlobalComponentId, aErrCategory, aErrCode,

                      aErrMsg, aErrMsgDetails);

        if (ret < 0)

        {

            InstallerException.internalError(

                "Notifying SIF end failed with code " + ret);

        }

    }

    /**

     * Notifies SIF about installation or uninstallation progress.

     *

     * @throws InstallerException in case an error occurs

     */

    public void notifyProgress(int aSubOperation, int aCurrent, int aTotal)

    {

        if (!iNotifyProgressAllowed)

        {

            return;

        }

        {

        }

        int ret = _notifyProgress(

                      iHandle, iGlobalComponentId, iOperation, aSubOperation,

                      aCurrent, aTotal);

        if (ret < 0)

        {

            InstallerException.internalError(

                "Notifying SIF progress failed with code " + ret);

        }

    }

    /**

     * Destroys SifNotifier. This method releawse native resources and

     * must be called after SifNotifier is no longer used.

     *

     * @throws InstallerException in case an error occurs

     */

    public void destroy()

    {

        int ret = _destroy(iHandle);

        if (ret < 0)

        {

            InstallerException.internalError(

                "Destroying SIF notifier failed with code " + ret);

        }

        iHandle = 0;

    }

    /*** ----------------------------- PACKAGE ---------------------------- */

    /**

     * Initializes SifNotifier. This method must be called before any

     * other methods are called.

     *

     * @throws InstallerException if the notifier cannot be initialized

     */

    void init()

    {

        int ret = _init();

        if (ret < 0)

        {

            InstallerException.internalError(

                "Initializing SifNotifier failed with code " + ret);

        }

        iHandle = ret;

    }

    /*** ----------------------------- PRIVATE ---------------------------- */

    /**

     * Returns notification info string used in logging.

     */

    private String getInfoString()

    {

        StringBuffer buf = new StringBuffer();

        buf.append("Operation: ").append(iOperation);

        buf.append(", GlobalComponentId: ").append(iGlobalComponentId);

        buf.append(", ComponentName: ").append(iComponentName);

        {

        }

        buf.append(", ComponentSize: ").append(iComponentSize);

        return buf.toString();

    }

    /*** ----------------------------- NATIVE ----------------------------- */

    /**

     * Returns true if SIF progress notifications are enabled, false otherwise.

     */

    private static native boolean _sifNotifierEnabled();

    /**

     * Notifies SIF about installation/uinstallation start.

     *

     * @param aHandle

     * @param aGlobalComponentId

     * @param aComponentName

     * @param aApplicationNames

     * @param aApplicationIcons

     * @param aComponentSize

     * @param aIconDir

     * @param aComponentIcon

     * @return Symbian error code (negative number) if operation fails,

     * otherwise 0

     */

    private static native int _notifyStart(

    /**

     * Notifies SIF about installation/uinstallation completion.

     *

     * @param aHandle

     * @param aGlobalComponentId

     * @param aErrCategory

     * @param aErrCode

     * @param aErrMsg

     * @param aErrMsgDetails

     * @return Symbian error code (negative number) if operation fails,

     * otherwise 0

     */

    private static native int _notifyEnd(

        int aHandle, String aGlobalComponentId,

        int aErrCategory, int aErrCode,

        String aErrMsg, String aErrMsgDetails);

    /**

     * Notifies SIF about installation/uinstallation progress.

     *

     * @param aHandle

     * @param aGlobalComponentId

     * @param aOperation

     * @param aSubOperation

     * @param aCurrent

     * @param aTotal

     * @return Symbian error code (negative number) if operation fails,

     * otherwise 0

     */

    private static native int _notifyProgress(

        int aHandle, String aGlobalComponentId, int aOperation,

        int aSubOperation, int aCurrent, int aTotal);

    /**

     * Initializes SifNotifier. This method must be called before any

     * other methods are called.

     *

     * @return Symbian error code (negative number) if operation fails,

     */

    private static native int _init();

    /**

     * Cleans up SifNotifier. This method must be called after SifNotifier

     * is no longer used.

     *

     * @param aHandle

     * @return Symbian error code (negative number) if operation fails,

     * otherwise 0

     */

    private static native int _destroy(int aHandle);

}