/****************************************************************************

**

** Copyright (C) 2008-2010 Nokia Corporation and/or its subsidiary(-ies).

** All rights reserved.

** Contact: Nokia Corporation (developer.feedback@nokia.com)

**

** This file is part of the HbCore module of the UI Extensions for Mobile.

**

** GNU Lesser General Public License Usage

** This file may be used under the terms of the GNU Lesser General Public

** License version 2.1 as published by the Free Software Foundation and

** appearing in the file LICENSE.LGPL included in the packaging of this file.

** Please review the following information to ensure the GNU Lesser General

** Public License version 2.1 requirements will be met:

** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

**

** In addition, as a special exception, Nokia gives you certain additional

** rights.  These rights are described in the Nokia Qt LGPL Exception

** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

**

** If you have questions regarding the use of this file, please contact

** Nokia at developer.feedback@nokia.com.

**

****************************************************************************/

#include "hbactivitymanager.h"

#include "hbactivitymanager_p.h"

#include <QPluginLoader>

#include <QLibrary>

#include <QDir>

#include "hbmainwindow.h"

#include "hbinstance.h"

/*!

    @stable

    @hbcore

    \class HbActivityManager

    \brief HbActivityManager is an access point for Activities features.

    Activities can be described as stored application states (for example bookmarks

    in web browser) or actions that can be performed using application (play next

    song, start new game).

    The HbActivityManager class allows to use Activities features in Hb application.

    It can be used to access, add, remove and modify activities. It also notifies the

    application about activity change requests from other applications.

*/

/*!

\internal

*/

HbActivityManagerPrivate::HbActivityManagerPrivate(HbActivityManager *q) : q(q), mActivityPlugin(0)

{

}

/*!

\internal

*/

HbActivityManagerPrivate::~HbActivityManagerPrivate()

{

}

/*!

\internal

*/

HbActivityPluginInterface *HbActivityManagerPrivate::activityPlugin() const

{

    if (!mActivityPlugin) {

            QString pluginPath;

            QString libPath = QDir(path).filePath(QLatin1String("hbactivityplugin"));

#ifdef Q_OS_SYMBIAN

            libPath += QLatin1String(".qtplugin");

            if (QFile::exists(libPath) && library.load()) {

                library.unload();

                pluginPath = libPath;

            }

#else

            if (library.load()) {

                library.unload();

                pluginPath = library.fileName();

            QPluginLoader loader(pluginPath);

            QObject *pluginInstance = loader.instance();

            if (pluginInstance) {

                if (mActivityPlugin) {

                    q->connect(pluginInstance, SIGNAL(activityRequested(QString)), q, SIGNAL(activityRequested(QString)));

                } else {

#if defined(Q_OS_SYMBIAN)

                    qWarning("Cannot load activity plugin. Features related to activities won't be available.");

#endif

                    loader.unload();

                }

            }

        }

    }

    return mActivityPlugin;

}

/*!

\internal

*/

bool HbActivityManagerPrivate::addActivity(const QString &activityId, const QVariant &data, const QVariantHash &parameters)

{

    bool result(false);

    HbActivityPluginInterface *plugin = activityPlugin();

    if (plugin) {

        result = plugin->addActivity(activityId, data, parameters);

    }

    return result;

}

/*!

\internal

*/

bool HbActivityManagerPrivate::removeActivity(const QString &activityId)

{

    bool result(false);

    HbActivityPluginInterface *plugin = activityPlugin();

    if (plugin) {

        result = plugin->removeActivity(activityId);

    }

    return result;

}

/*!

\internal

*/

QList<QVariantHash> HbActivityManagerPrivate::activities() const

{

    HbActivityPluginInterface *plugin = activityPlugin();

    if (plugin) {

        return plugin->activities();

    } else {

        return QList<QVariantHash>();

    }

}

/*!

\internal

*/

bool HbActivityManagerPrivate::updateActivity(const QString &activityId, const QVariant &data, const QVariantHash &parameters)

{

    bool result(false);

    HbActivityPluginInterface *plugin = activityPlugin();

    if (plugin) {

        result = plugin->updateActivity(activityId, data, parameters);

    }

    return result;

}

/*!

\internal

*/

QVariant HbActivityManagerPrivate::activityData(const QString &activityId) const

{

    QVariant result;

    HbActivityPluginInterface *plugin = activityPlugin();

    if (plugin) {

        result = plugin->activityData(activityId);

    }

    return result;

}

/*!

\internal

*/

bool HbActivityManagerPrivate::waitActivity()

{

    bool result(false);

    HbActivityPluginInterface *plugin = activityPlugin();

    if (plugin) {

        result = plugin->waitActivity();

    }

    return result;

}

/*!

\internal

*/

void HbActivityManagerPrivate::parseCommandLine(const QStringList &commandLineParams, Hb::ActivationReason &reason, QString &id, QVariantHash &params) const

{

    HbActivityPluginInterface *plugin = activityPlugin();

    if (plugin) {

        QVariantHash activityParams = plugin->parseCommandLine(commandLineParams);

        if (!activityParams.isEmpty()) {

            reason = Hb::ActivationReasonActivity;

            id = activityParams.value("activityname").toString();

            params = activityParams;

        }

    }

}

/*!

    Constructor

    \a parent. Parent of this object.

 */

HbActivityManager::HbActivityManager(QObject *parent) : QObject(parent), d_ptr(new HbActivityManagerPrivate(this))

{

}

/*!

    Destructor

 */

HbActivityManager::~HbActivityManager()

{

    delete d_ptr;

}

/*!

    Allows to save activity.

    \a activityId. Activity name used as identifier of activities

    \a parameters. Activity properties: screenshot, localized name, hidden flag, etc.

 */

bool HbActivityManager::addActivity(const QString &activityId, const QVariant &data, const QVariantHash &parameters)

{

    Q_D(HbActivityManager);

    return d->addActivity(activityId, data, parameters);

}

/*!

    Allows to delete activity.

    \a activityId. Activity name used as identifier of activities

 */

bool HbActivityManager::removeActivity(const QString &activityId)

{

    Q_D(HbActivityManager);

    return d->removeActivity(activityId);

}

/*!

    Allows to update saved activity.

    \a activityId. Activity name used as identifier of activities

    \a parameters. Activity properties: screenshot, localized name, hidden flag, etc.

 */

bool HbActivityManager::updateActivity(const QString &activityId, const QVariant &data, const QVariantHash &parameters)

{

    Q_D(HbActivityManager);

    return d->updateActivity(activityId, data, parameters);

}

/*!

    Returns activities list. It returns activities as name and screenshot.

 */

QList<QVariantHash> HbActivityManager::activities() const

{

    Q_D(const HbActivityManager);

    return d->activities();

}

/*!

    Returns data of activity specified by \a activityId

 */

QVariant HbActivityManager::activityData(const QString &activityId) const

{

    Q_D(const HbActivityManager);

    return d->activityData(activityId);

}

/*!

    Subscribes to activity manager

 */

{

    Q_D(HbActivityManager);

    return d->waitActivity();

}

/*!

    Searches \a commandLineArguments for pair of "-activity" marker and

    activity URI, which should have following syntax:

    appto://UID3?activityname=activity-name-value&key1=value

    If both marker and valid URI are found, \a reason is set to

    Hb::ActivationReasonActivity, and \a activityId and \a parameters are

    filled with parsed values.

*/

void HbActivityManager::parseCommandLine(const QStringList &commandLineParams, Hb::ActivationReason &reason, QString &id, QVariantHash &params) const

{

    Q_D(const HbActivityManager);

    d->parseCommandLine(commandLineParams, reason, id, params);

}