transfermethodinfo.cpp 6.4 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
/****************************************************************************************
**
** Copyright (C) 2013 Jolla Ltd.
** Contact: Marko Mattila <marko.mattila@jollamobile.com>
** All rights reserved.
**
** This file is part of Nemo Transfer Engine package.
**
** You may use this file 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.
**
** This library is free software; you can redistribute it and/or
** modify it 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.
**
** This library is distributed in the hope that it will be useful,
** but WITHOUT ANY WARRANTY; without even the implied warranty of
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
** Lesser General Public License for more details.
**
****************************************************************************************/

#include "transfermethodinfo.h"
#include "metatypedeclarations.h"

/*!
    \class TransferMethodInfo
    \brief The TransferMethodInfo class encapsulate information of a single transfer method.

    \ingroup transfer-engine-lib

    Share plugin must create a list of instances of TransferMethodInfo class to encapsulate
    information about the plugin for example filling information for the Bluetooth sharing plugin:

    \code
        QList<TransferMethodInfo> infoList;
        TransferMethodInfo info;

        QStringList capabilities;
        capabilities << QLatin1String("*");

        info.displayName     = QLatin1String("Bluetooth");
        info.userName        = "";
        info.accountId       = "";
49
        info.accountIcon     = QLatin1String("image://theme/icon-m-bluetooth");
50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65
        info.methodId        = QLatin1String("bluetooth");
        info.shareUIPath     = SHARE_UI_PATH + QLatin1String("/BluetoothShareUI.qml");
        info.capabilitities  = capabilities;
        infoList << info;
    \endcode
*/

/*!
    \enum TransferMethodInfo::TransferMethodInfoField

    This enum can be used for accessing different values using value() method

    \value DisplayName The name that will be visible e.g. Facebook or Bluetooth
    \value UserName User name e.g. mike.myers@gmail.com
    \value MethodId The plugin Id of the share plugin e.g. "bluetooth"
    \value AccountId The Id the account, needed in a case of multiple accounts
66
    \value AccountIcon The url of the icon representing the account
67 68 69 70 71 72 73
    \value ShareUIPath The path to the share ui QML plugin. This QML file will be loaded by the share UI
    \value Capabilities A list of supported mimetypes
*/

/*!
    Creates an instance of TransferMethodInfo.
 */
74
TransferMethodInfo::TransferMethodInfo()
75 76 77 78 79 80 81 82 83 84 85 86 87 88
{
}

/*!
    Assigns \a other object to this.
*/
TransferMethodInfo &TransferMethodInfo::operator=(const TransferMethodInfo &other)
{
    displayName     = other.displayName;
    userName        = other.userName;
    methodId        = other.methodId;
    shareUIPath     = other.shareUIPath;
    capabilitities  = other.capabilitities;
    accountId       = other.accountId;
89 90
    accountIcon     = other.accountIcon;
    hints           = other.hints;
91 92 93 94 95 96 97 98 99 100 101 102
    return *this;
}

/*!
    Copies \a other to this instance.
*/
TransferMethodInfo::TransferMethodInfo(const TransferMethodInfo &other):
    displayName(other.displayName),
    userName(other.userName),
    methodId(other.methodId),
    shareUIPath(other.shareUIPath),
    capabilitities(other.capabilitities),
103 104 105
    accountId(other.accountId),
    accountIcon(other.accountIcon),
    hints(other.hints)
106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128
{

}

/*!
    Destroys TransferMethodInfo instance.
*/
TransferMethodInfo::~TransferMethodInfo()
{

}

/*!
    Writes data from \a info to \a argument.
*/
QDBusArgument &operator<<(QDBusArgument &argument, const TransferMethodInfo &info)
{
    argument.beginStructure();
    argument << info.displayName
             << info.userName
             << info.methodId
             << info.shareUIPath
             << info.capabilitities
129 130 131
             << info.accountId
             << info.accountIcon
             << info.hints;
132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147

    argument.endStructure();
    return argument;
}

/*!
    Reads data from \a argument to \a info.
*/
const QDBusArgument &operator>>(const QDBusArgument &argument, TransferMethodInfo &info)
{
    argument.beginStructure();
    argument >> info.displayName
             >> info.userName
             >> info.methodId
             >> info.shareUIPath
             >> info.capabilitities
148 149 150
             >> info.accountId
             >> info.accountIcon
             >> info.hints;
151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182

    argument.endStructure();
    return argument;
}

/*!
    Registers TransferMethodInfo and QList<TransferMethodInfo> as DBus types.
*/
void TransferMethodInfo::registerType()
{
    qDBusRegisterMetaType<TransferMethodInfo>();
    qDBusRegisterMetaType<QList<TransferMethodInfo> >();
}

/*!
 Returns the value using the \a index. Actually the index is enum TransferMethodInfoField.
 */
QVariant TransferMethodInfo::value(int index) const
{
    switch(index) {
    case DisplayName:
        return displayName;
    case UserName:
        return userName;
    case MethodId:
        return methodId;
    case ShareUIPath:
        return shareUIPath;
    case Capabilities:
        return capabilitities;
    case AccountId:
        return accountId;
183 184
    case AccountIcon:
        return accountIcon;
185
    default:
186 187 188
        return QVariant();
    }
}
189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220

QDBusArgument &operator<<(QDBusArgument &argument, const TransferMethodInfoDeprecated &info)
{
    argument.beginStructure();
    argument << info.displayName
             << info.userName
             << info.methodId
             << info.shareUIPath
             << info.capabilitities
             << info.accountId;
    argument.endStructure();
    return argument;
}
const QDBusArgument &operator>>(const QDBusArgument &argument, TransferMethodInfoDeprecated &info)
{
    argument.beginStructure();
    argument >> info.displayName
             >> info.userName
             >> info.methodId
             >> info.shareUIPath
             >> info.capabilitities
             >> info.accountId;

    argument.endStructure();
    return argument;
}

void TransferMethodInfoDeprecated::registerType()
{
    qDBusRegisterMetaType<TransferMethodInfoDeprecated>();
    qDBusRegisterMetaType<QList<TransferMethodInfoDeprecated> >();
}