src/hbcore/activity/hbactivitymanager.cpp
author hgs
Mon, 18 Oct 2010 18:23:13 +0300
changeset 34 ed14f46c0e55
parent 5 627c4a0fd0e7
permissions -rw-r--r--
201041

/****************************************************************************
**
** 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"
#include "hbactivityplugininterface_r.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) {
        foreach(const QString & path, QCoreApplication::libraryPaths()) {
            QString pluginPath;
            QString libPath = QDir(path).filePath(QLatin1String("hbactivityplugin"));
#ifdef Q_OS_SYMBIAN
            libPath += QLatin1String(".qtplugin");
            QLibrary library(libPath);
            if (QFile::exists(libPath) && library.load()) {
                library.unload();
                pluginPath = libPath;
            }
#else
            QLibrary library(libPath);
            if (library.load()) {
                library.unload();
                pluginPath = library.fileName();
            }
#endif
            QPluginLoader loader(pluginPath);
            QObject *pluginInstance = loader.instance();
            if (pluginInstance) {
                mActivityPlugin = qobject_cast<HbActivityPluginInterface *>(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 data. Activity data that should be stored. It will allow application to restore its state later
    \a parameters. Activity properties: screenshot, localized name, hidden flag, etc.
    Returns true if activity was successfully saved, otherwise returns false.
 */
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
    Returns true if activity was successfully deleted, otherwise returns false.
 */
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 data. Activity data that should be stored. It will allow application to restore its state later
    \a parameters. Activity properties: screenshot, localized name, hidden flag, etc.
    Returns true if activity was successfully updated, otherwise returns false.
 */
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
 */
bool HbActivityManager::waitActivity()
{
    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);
}