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

**

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

** All rights reserved.

** Contact: Nokia Corporation (qt-info@nokia.com)

**

** This file is part of the Qt Mobility Components.

**

** $QT_BEGIN_LICENSE:LGPL$

** No Commercial Usage

** This file contains pre-release code and may not be distributed.

** You may use this file in accordance with the terms and conditions

** contained in the Technology Preview License Agreement accompanying

** this package.

**

** GNU Lesser General Public License Usage

** Alternatively, 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 qt-info@nokia.com.

**

**

**

**

**

**

**

**

** $QT_END_LICENSE$

**

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

#include "qversitcontactexporter.h"

#include "qversitcontactexporter_p.h"

#include "versitutils_p.h"

#include "qmobilityglobal.h"

#include <qcontact.h>

#include <qcontactdetail.h>

#include <qcontactname.h>

#include <qcontactemailaddress.h>

#include <qcontactphonenumber.h>

#include <qcontactaddress.h>

#include <qcontacturl.h>

#include <qcontactguid.h>

#include <qcontactorganization.h>

#include <qcontacttimestamp.h>

#include <qcontactbirthday.h>

#include <qcontactnote.h>

#include <qcontactgeolocation.h>

#include <qcontactavatar.h>

#include <qcontactgender.h>

#include <qcontactnickname.h>

#include <qcontactanniversary.h>

#include <qcontactonlineaccount.h>

#include <qcontactfamily.h>

#include <qcontactdisplaylabel.h>

#include <qcontactthumbnail.h>

#include <QUrl>

#include <QBuffer>

QTM_USE_NAMESPACE

/*!

 * Constructor.

 */

    mDetailHandler(NULL),

    mDetailHandler2(NULL),

    mDetailHandlerVersion(0),

    mDefaultResourceHandler(new QVersitDefaultResourceHandler),

{

    // Detail mappings

    int versitPropertyCount =

    for (int i=0; i < versitPropertyCount; i++) {

        mPropertyMappings.insert(

                QLatin1String(versitContactDetailMappings[i].versitPropertyName));

    }

    // Contexts mappings

    int contextCount = sizeof(versitContextMappings)/sizeof(VersitMapping);

    for (int i=0; i < contextCount; i++) {

        mParameterMappings.insert(

                QLatin1String(versitContextMappings[i].contactString),

                QLatin1String(versitContextMappings[i].versitString));

    }

    // Subtypes mappings

    int subTypeCount = sizeof(versitSubTypeMappings)/sizeof(VersitMapping);

    for (int i=0; i < subTypeCount; i++) {

        mParameterMappings.insert(

                QLatin1String(versitSubTypeMappings[i].contactString),

                QLatin1String(versitSubTypeMappings[i].versitString));

    }

}

/*!

 * Destructor.

 */

QVersitContactExporterPrivate::~QVersitContactExporterPrivate()

{

    delete mDefaultResourceHandler;

}

/*!

 * Export QT Contact into Versit Document.

 */

bool QVersitContactExporterPrivate::exportContact(

    const QContact& contact,

    QVersitDocument& document,

    QVersitContactExporter::Error* error)

{

    QList<QContactDetail> allDetails = contact.details();

    if (allDetails.isEmpty()) {

        *error = QVersitContactExporter::EmptyContactError;

        return false;

    }

        // If the custom detail handler handles it, we don't have to.

        if (mDetailHandler

            && mDetailHandler->preProcessDetail(contact, detail, &document))

            continue;

        QList<QVersitProperty> removedProperties;

        QList<QVersitProperty> generatedProperties;

        QSet<QString> processedFields;

        if (detail.definitionName() == QContactName::DefinitionName) {

            encodeName(detail, document, &removedProperties, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactPhoneNumber::DefinitionName) {

            encodePhoneNumber(detail, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactEmailAddress::DefinitionName) {

            encodeEmail(detail, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactAddress::DefinitionName) {

            encodeAddress(detail, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactGuid::DefinitionName) {

            encodeUid(detail, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactUrl::DefinitionName) {

            encodeUrl(detail, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactTimestamp::DefinitionName) {

            encodeRev(detail, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactBirthday::DefinitionName) {

            encodeBirthDay(detail, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactGeoLocation::DefinitionName) {

            encodeGeoLocation(detail, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactNote::DefinitionName) {

            encodeNote(detail, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactOrganization::DefinitionName) {

            encodeOrganization(detail, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactRingtone::DefinitionName) {

            encodeRingtone(detail, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactThumbnail::DefinitionName) {

            encodeThumbnail(detail, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactAvatar::DefinitionName){

            encodeAvatar(detail, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactAnniversary::DefinitionName) {

            encodeAnniversary(detail, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactNickname::DefinitionName) {

            encodeNickname(detail, document, &removedProperties, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactTag::DefinitionName) {

            encodeTag(detail, document, &removedProperties, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactGender::DefinitionName) {

            encodeGender(detail, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactOnlineAccount::DefinitionName) {

            encodeOnlineAccount(detail, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactFamily::DefinitionName) {

            encodeFamily(detail, &generatedProperties, &processedFields);

        } else if (detail.definitionName() == QContactDisplayLabel::DefinitionName) {

            encodeDisplayLabel(detail, document, &removedProperties, &generatedProperties, &processedFields);

        }

        if (mDetailHandler2 && mDetailHandlerVersion > 1) {

        }

        foreach(const QVersitProperty& property, removedProperties) {

            document.removeProperty(property);

        }

        foreach(const QVersitProperty& property, generatedProperties) {

            document.addProperty(property);

        }

        if (mDetailHandler && mDetailHandlerVersion == 1) {

            mDetailHandler->postProcessDetail(contact, detail, !processedFields.isEmpty(), &document);

        }

    }

    if (mDetailHandler2 && mDetailHandlerVersion > 1) {

        mDetailHandler2->contactProcessed(contact, &document);

    }

    // Search through the document for FN or N properties.  This will find it even if it was added

    // by a detail handler.

    if (!documentContainsName(document)) {

        *error = QVersitContactExporter::NoNameError;

        return false;

    }

    return true;

}

/*!

 * Returns true if and only if \a document has a "FN" or "N" property.

 */

bool QVersitContactExporterPrivate::documentContainsName(const QVersitDocument &document)

{

    foreach (const QVersitProperty& property, document.properties()) {

        const QString& name = property.name();

        if (name == QLatin1String("FN") || name == QLatin1String("N"))

            return true;

    }

    return false;

}

/*!

 * Encode Contact Name Field Information into the Versit Document

 */

void QVersitContactExporterPrivate::encodeName(

    const QContactDetail& detail,

    const QVersitDocument& document,

    QList<QVersitProperty>* removedProperties,

    QList<QVersitProperty>* generatedProperties,

    QSet<QString>* processedFields)

{

    QContactName contactName = static_cast<QContactName>(detail);

    if (!contactName.lastName().isEmpty()

        || !contactName.firstName().isEmpty()

        || !contactName.middleName().isEmpty()

        || !contactName.prefix().isEmpty()

        || !contactName.suffix().isEmpty()) {

        QVersitProperty property;

        property.setName(mPropertyMappings.value(detail.definitionName()));

        property.setValue(QStringList()

                          << contactName.lastName()

                          << contactName.firstName()

                          << contactName.middleName()

                          << contactName.prefix()

                          << contactName.suffix());

        property.setValueType(QVersitProperty::CompoundType);

        *generatedProperties << property;

    }

    // Generate an FN field if none is already there

    // Don't override previously exported FN properties (eg. exported by a DisplayLabel detail)

    if (fnProperty.value().isEmpty()) {

        fnProperty.setName(QLatin1String("FN"));

        if (!contactName.customLabel().isEmpty()) {

            fnProperty.setValue(contactName.customLabel());

        } else if (!contactName.firstName().isEmpty()) {

            if (!contactName.lastName().isEmpty()) {

                fnProperty.setValue(QString::fromAscii("%1 %2").arg(contactName.firstName(),

                                                                    contactName.lastName()));

            } else {

                fnProperty.setValue(contactName.firstName());

            }

        } else if (!contactName.lastName().isEmpty()) {

            fnProperty.setValue(contactName.lastName());

        }

    }

    *generatedProperties << fnProperty;

    *processedFields << QContactName::FieldLastName

                     << QContactName::FieldFirstName

                     << QContactName::FieldMiddleName

                     << QContactName::FieldPrefix

                     << QContactName::FieldSuffix

                     << QContactName::FieldCustomLabel;

}

/*!

 * Encode Phone Number Field Information into the Versit Document

 */

void QVersitContactExporterPrivate::encodePhoneNumber(

    const QContactDetail& detail,

    QList<QVersitProperty>* generatedProperties,

    QSet<QString>* processedFields)

{

    QContactPhoneNumber phoneNumber = static_cast<QContactPhoneNumber>(detail);

    QStringList subTypes = phoneNumber.subTypes();

    QVersitProperty property;

    if (subTypes.contains(QContactPhoneNumber::SubTypeAssistant))

        property.setName(QLatin1String("X-ASSISTANT-TEL"));

    else

        property.setName(QLatin1String("TEL"));

    encodeParameters(property, phoneNumber.contexts(), subTypes);

    property.setValue(phoneNumber.number());

    *generatedProperties << property;

    *processedFields << QContactPhoneNumber::FieldContext

                      << QContactPhoneNumber::FieldSubTypes

                      << QContactPhoneNumber::FieldNumber;

}

/*!

 * Encode Email Field Information into the Versit Document

 */

void QVersitContactExporterPrivate::encodeEmail(

    const QContactDetail& detail,

    QList<QVersitProperty>* generatedProperties,

    QSet<QString>* processedFields)

{

    QContactEmailAddress emailAddress = static_cast<QContactEmailAddress>(detail);

    QVersitProperty property;

    property.setName(mPropertyMappings.value(detail.definitionName()));

    encodeParameters(property, emailAddress.contexts());

    property.setValue(emailAddress.emailAddress());

    *generatedProperties << property;

    *processedFields << QContactEmailAddress::FieldContext

                      << QContactEmailAddress::FieldEmailAddress;

}

/*!

 * Encode Address Field Information into the Versit Document

 */

void QVersitContactExporterPrivate::encodeAddress(

    const QContactDetail& detail,

    QList<QVersitProperty>* generatedProperties,

    QSet<QString>* processedFields)

{

    QContactAddress address = static_cast<QContactAddress>(detail);

    QVersitProperty property;

    property.setName(mPropertyMappings.value(detail.definitionName()));

    encodeParameters(property, address.contexts(), address.subTypes());

    property.setValue(QStringList()

                      << address.postOfficeBox()

                      << QString() // Leave out the extended address field

                      << address.street()

                      << address.locality()

                      << address.region()

                      << address.postcode()

                      << address.country());

    property.setValueType(QVersitProperty::CompoundType);

    *generatedProperties << property;

    *processedFields << QContactAddress::FieldContext

                      << QContactAddress::FieldSubTypes

                      << QContactAddress::FieldPostOfficeBox

                      << QContactAddress::FieldStreet

                      << QContactAddress::FieldLocality

                      << QContactAddress::FieldRegion

                      << QContactAddress::FieldPostcode

                      << QContactAddress::FieldCountry;

}

/*!

 * Encode URL Field Information into the Versit Document

 */

void QVersitContactExporterPrivate::encodeUrl(

    const QContactDetail& detail,

    QList<QVersitProperty>* generatedProperties,

    QSet<QString>* processedFields)

{

    QContactUrl contactUrl = static_cast<QContactUrl>(detail);

    QVersitProperty property;

    property.setName(mPropertyMappings.value(detail.definitionName()));

    encodeParameters(property, contactUrl.contexts());

    // The vCard specifications do not define any TYPEs for URL property.

    // No need to try to convert the subtypes to TYPEs.

    property.setValue(contactUrl.url());

    *generatedProperties << property;

    *processedFields << QContactUrl::FieldContext

                      << QContactUrl::FieldUrl;

}

/*!

 * Encode Uid Field Information into the Versit Document

 */

void QVersitContactExporterPrivate::encodeUid(

    const QContactDetail& detail,

    QList<QVersitProperty>* generatedProperties,

    QSet<QString>* processedFields)

{

    QContactGuid uid = static_cast<QContactGuid>(detail);

    QVersitProperty property;

    property.setName(mPropertyMappings.value(detail.definitionName()));

    property.setValue(uid.guid());

    *generatedProperties << property;

    *processedFields << QContactGuid::FieldGuid;

}

/*!

 * Encode REV Field Information into the Versit Document

 */

void QVersitContactExporterPrivate::encodeRev(

    const QContactDetail& detail,

    QList<QVersitProperty>* generatedProperties,

    QSet<QString>* processedFields)

{

    QContactTimestamp  rev = static_cast<QContactTimestamp>(detail);

    QString value;

    QVersitProperty property;

    property.setName(mPropertyMappings.value(detail.definitionName()));

    if ( rev.lastModified().toString(Qt::ISODate).size() ) {

        if ( rev.lastModified().timeSpec() == Qt::UTC ) {

            value = rev.lastModified().toString(Qt::ISODate) + QLatin1Char('Z');

        }

        else {

            value = rev.lastModified().toString(Qt::ISODate);

        }

        property.setValue(value);

        *generatedProperties << property;

        *processedFields << QContactTimestamp::FieldModificationTimestamp;

    } else if ( rev.created().toString(Qt::ISODate).size()) {

        if ( rev.created().timeSpec() == Qt::UTC ) {

            value = rev.created().toString(Qt::ISODate) + QLatin1Char('Z');

        }

        else {

            value = rev.created().toString(Qt::ISODate);

        }

        property.setValue(value);

        *generatedProperties << property;

        *processedFields << QContactTimestamp::FieldCreationTimestamp;

    }

}

/*!

 * Encode BirthDay Field Information into the Versit Document

 */

void QVersitContactExporterPrivate::encodeBirthDay(

    const QContactDetail& detail,

    QList<QVersitProperty>* generatedProperties,

    QSet<QString>* processedFields)

{

    QContactBirthday bday = static_cast<QContactBirthday>(detail);

    QVersitProperty property;

    property.setName(mPropertyMappings.value(detail.definitionName()));

    QString value = bday.date().toString(Qt::ISODate);

    property.setValue(value);

    *generatedProperties << property;

    *processedFields << QContactBirthday::FieldBirthday;

}

/*!

 * Encode Comment i.e. Note Field Information into the Versit Document

 */

void QVersitContactExporterPrivate::encodeNote(

    const QContactDetail& detail,

    QList<QVersitProperty>* generatedProperties,

    QSet<QString>* processedFields)

{

    QContactNote contactNote = static_cast<QContactNote>(detail);

    QVersitProperty property;

    property.setName(mPropertyMappings.value(detail.definitionName()));

    property.setValue(contactNote.note());

    *generatedProperties << property;

    *processedFields << QContactNote::FieldNote;

}

/*!

 * Encode Geo Prpoperties Field Information into the Versit Document

 */

void QVersitContactExporterPrivate::encodeGeoLocation(

    const QContactDetail& detail,

    QList<QVersitProperty>* generatedProperties,

    QSet<QString>* processedFields)

{

    QContactGeoLocation geoLocation = static_cast<QContactGeoLocation>(detail);

    QVersitProperty property;

    property.setName(mPropertyMappings.value(detail.definitionName()));

    property.setValue(QStringList() << QString::number(geoLocation.longitude())

                      << QString::number(geoLocation.latitude()));

    property.setValueType(QVersitProperty::CompoundType);

    *generatedProperties << property;

    *processedFields << QContactGeoLocation::FieldLongitude

                      << QContactGeoLocation::FieldLatitude;

}

/*!

 * Encode organization properties to the versit document

 */

void QVersitContactExporterPrivate::encodeOrganization(

    const QContactDetail& detail,

    QList<QVersitProperty>* generatedProperties,

    QSet<QString>* processedFields)

{

    QContactOrganization organization = static_cast<QContactOrganization>(detail);

    if (organization.title().length() > 0) {

        QVersitProperty property;

        property.setName(QLatin1String("TITLE"));

        property.setValue(organization.title());

        *generatedProperties << property;

        *processedFields << QContactOrganization::FieldTitle;

    }

    if (organization.name().length() > 0 || organization.department().size() > 0) {

        QVersitProperty property;

        property.setName(QLatin1String("ORG"));

        QStringList values(organization.name());

        values.append(organization.department());

        property.setValue(values);

        property.setValueType(QVersitProperty::CompoundType);

        *generatedProperties << property;

        *processedFields << QContactOrganization::FieldName

                          << QContactOrganization::FieldDepartment;

    }