/**************************************************************************** ** ** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). ** Contact: http://www.qt-project.org/legal ** ** This file is part of the Qt Mobility Components. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and Digia. For licensing terms and ** conditions see http://qt.digia.com/licensing. For further information ** use the contact form at http://qt.digia.com/contact-us. ** ** 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, Digia gives you certain additional ** rights. These rights are described in the Digia Qt LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 3.0 as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL included in the ** packaging of this file. Please review the following information to ** ensure the GNU General Public License version 3.0 requirements will be ** met: http://www.gnu.org/copyleft/gpl.html. ** ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #include "qcontactmaemo5backend_p.h" #include #include #include "qcontactmaemo5debug_p.h" DEFINE_GLOBAL_DEBUG_VAR QContactManagerEngine* ContactMaemo5Factory::engine(const QMap& parameters, QContactManager::Error* error) { Q_UNUSED(parameters); Q_UNUSED(error); initDebugLogger(); return new QContactMaemo5Engine(); //FIXME Wonderfull memory leak :D } QString ContactMaemo5Factory::managerName() const { return QString("maemo5"); } Q_EXPORT_PLUGIN2(qtcontacts_maemo5, ContactMaemo5Factory); /*! \class QContactMaemo5Engine \brief The QContactMaemo5Engine class provides an implementation of QContactManagerEngine whose functions always return an error. The Maemo5 engine. */ /*! Constructs a new invalid contacts backend. */ QContactMaemo5Engine::QContactMaemo5Engine() : d(new QContactMaemo5EngineData) { QContactABook *abook = d->m_abook; connect(abook, SIGNAL(contactsAdded(const QList&)), SIGNAL(contactsAdded(const QList&))); connect(abook, SIGNAL(contactsChanged(const QList&)), SIGNAL(contactsChanged(const QList&))); connect(abook, SIGNAL(contactsRemoved(const QList&)), SIGNAL(contactsRemoved(const QList&))); } /*! \reimp */ QContactMaemo5Engine& QContactMaemo5Engine::operator=(const QContactMaemo5Engine& other) { d = other.d; return *this; } /*! \reimp */ QString QContactMaemo5Engine::managerName() const { return QString(QLatin1String("maemo5")); } /* Synthesise the display label of a contact */ QString QContactMaemo5Engine::synthesizedDisplayLabel(const QContact& contact, QContactManager::Error* error) const { QString label; // Try to get the display name from the OSSO-ABook Contact label = d->m_abook->getDisplayName(contact); // Synthesise the display label for not saved contacts // A. FirstName + LastName if (label.isEmpty()){ QContactName name = contact.detail(QContactName::DefinitionName); QStringList nameList; nameList << name.firstName(); if (name.lastName().count()){ nameList << name.lastName(); } label = nameList.join(QString(' ')); } // B. Email if (label.isEmpty()){ QContactEmailAddress email = contact.detail(QContactEmailAddress::DefinitionName); label = email.emailAddress(); } // if (label.isEmpty()){ *error = QContactManager::UnspecifiedError; return QString("No name"); } *error = QContactManager::NoError; return label; } bool QContactMaemo5Engine::validateContact(const QContact& contact, QContactManager::Error* error) const { return QContactManagerEngine::validateContact(contact, error); } bool QContactMaemo5Engine::validateDefinition(const QContactDetailDefinition& definition, QContactManager::Error* error) const { QContactDetailDefinition existing = detailDefinition(definition.name(), QContactType::TypeContact, error); if (existing == definition) { *error = QContactManager::NoError; return true; } *error = QContactManager::NotSupportedError; // XXX TODO: mutable definitions? return false; } QContact QContactMaemo5Engine::compatibleContact(const QContact& contact, QContactManager::Error* error) const { return QContactManagerEngine::compatibleContact(contact, error); } QContactLocalId QContactMaemo5Engine::selfContactId(QContactManager::Error* error) const { Q_CHECK_PTR(d->m_abook); return d->m_abook->selfContactId(error); } QList QContactMaemo5Engine::contactIds(const QContactFilter& filter, const QList& sortOrders, QContactManager::Error* error) const { Q_CHECK_PTR(d->m_abook); QList rtn; // do this naively for now... QContactManager::Error tempError = QContactManager::NoError; QList allIds = d->m_abook->contactIds(filter, sortOrders, error); QList sortedAndFiltered; foreach (const QContactLocalId& currId, allIds) { QContact curr = contact(currId, QContactFetchHint(), &tempError); if (tempError != QContactManager::NoError) *error = tempError; if (QContactManagerEngine::testFilter(filter, curr)) { QContactManagerEngine::addSorted(&sortedAndFiltered, curr, sortOrders); } } foreach (const QContact& contact, sortedAndFiltered) { rtn.append(contact.localId()); } return rtn; } QList QContactMaemo5Engine::contacts(const QContactFilter & filter, const QList & sortOrders, const QContactFetchHint & fetchHint, QContactManager::Error* error ) const { Q_UNUSED(fetchHint); // no optimizations currently, ignore the fetchhint. Q_CHECK_PTR(d->m_abook); QList rtn; QList ids = contactIds(filter, sortOrders,error); foreach (QContactLocalId id, ids) rtn << contact(id, QContactFetchHint(), error); return rtn; } QContact QContactMaemo5Engine::contact(const QContactLocalId& contactId, const QContactFetchHint& fetchHint, QContactManager::Error* error) const { Q_UNUSED(fetchHint); //TODO Q_CHECK_PTR(d->m_abook); //NOTE getQContact can't set the displayLabel QContact *contact = d->m_abook->getQContact(contactId, error); QContact rtn(*contact); delete contact; if (*error == QContactManager::NoError) { setContactDisplayLabel(&rtn, synthesizedDisplayLabel(rtn, error)); QContactId cid; cid.setLocalId(contactId); cid.setManagerUri(managerUri()); rtn.setId(cid); } return rtn; } bool QContactMaemo5Engine::saveContacts(QList* contacts, QMap* errorMap, QContactManager::Error* error) { *error = QContactManager::NoError; QContactManager::Error tempError = QContactManager::NoError; QContact curr; for (int i = 0; i < contacts->size(); i++) { curr = contacts->at(i); if (!saveContact(&curr, &tempError)) { if (errorMap) errorMap->insert(i, tempError); *error = tempError; } else { contacts->replace(i, curr); } } return (*error == QContactManager::NoError); } bool QContactMaemo5Engine::removeContacts(const QList& ids, QMap* errorMap, QContactManager::Error* error) { *error = QContactManager::NoError; QContactManager::Error tempError = QContactManager::NoError; QContact curr; for (int i = 0; i < ids.size(); i++) { if (!removeContact(ids.at(i), &tempError)) { if (errorMap) errorMap->insert(i, tempError); *error = tempError; } } return (*error == QContactManager::NoError); } bool QContactMaemo5Engine::saveContact(QContact* contact, QContactManager::Error* error) { Q_CHECK_PTR(d->m_abook); if (!contact) { *error = QContactManager::BadArgumentError; return false; } // synthesize the display label for the contact setContactDisplayLabel(contact, synthesizedDisplayLabel(*contact, error)); // ensure that the contact's details conform to their definitions if (!validateContact(*contact, error)) { QCM5_DEBUG << "Validate Contact failed"; return false; } bool retn = d->m_abook->saveContact(contact, error); QContactId cId = contact->id(); cId.setManagerUri(managerUri()); contact->setId(cId); return retn; } bool QContactMaemo5Engine::removeContact(const QContactLocalId& contactId, QContactManager::Error* error) { Q_CHECK_PTR(d->m_abook); return d->m_abook->removeContact(contactId, error); } QMap QContactMaemo5Engine::detailDefinitions(const QString& contactType, QContactManager::Error* error) const { QMap > defns = QContactManagerEngine::schemaDefinitions(); QMap fields; QContactDetailFieldDefinition gsfd; //Generic string field definition gsfd.setDataType(QVariant::String); // QContactAddress fields = defns[contactType][QContactAddress::DefinitionName].fields(); fields.remove(QContactAddress::FieldSubTypes); fields.insert(AddressFieldExtension, gsfd); fields.insert(QContactDetail::FieldDetailUri, gsfd); defns[contactType][QContactAddress::DefinitionName].setFields(fields); defns[contactType][QContactAddress::DefinitionName].setUnique(false); // No QContactAnniversary defns[contactType].remove(QContactAnniversary::DefinitionName); // No QContactAvatar defns[contactType].remove(QContactAvatar::DefinitionName); // QContactBirthday fields = defns[contactType][QContactBirthday::DefinitionName].fields(); fields.remove(QContactDetail::FieldContext); defns[contactType][QContactBirthday::DefinitionName].setFields(fields); defns[contactType][QContactBirthday::DefinitionName].setUnique(true); // QContactDisplayLabel fields = defns[contactType][QContactDisplayLabel::DefinitionName].fields(); defns[contactType][QContactDisplayLabel::DefinitionName].setFields(fields); defns[contactType][QContactDisplayLabel::DefinitionName].setUnique(true); // QContactEmailAddress fields = defns[contactType][QContactEmailAddress::DefinitionName].fields(); fields.insert(QContactDetail::FieldDetailUri, gsfd); defns[contactType][QContactEmailAddress::DefinitionName].setFields(fields); defns[contactType][QContactEmailAddress::DefinitionName].setUnique(false); // QContactFamily fields = defns[contactType][QContactFamily::DefinitionName].fields(); fields.remove(QContactDetail::FieldContext); defns[contactType][QContactFamily::DefinitionName].setFields(fields); defns[contactType][QContactFamily::DefinitionName].setUnique(true); // QContactGender fields = defns[contactType][QContactGender::DefinitionName].fields(); fields.remove(QContactDetail::FieldContext); defns[contactType][QContactGender::DefinitionName].setFields(fields); defns[contactType][QContactGender::DefinitionName].setUnique(true); // No QContactGeoLocation defns[contactType].remove(QContactGeoLocation::DefinitionName); // QContactGuid fields = defns[contactType][QContactGuid::DefinitionName].fields(); fields.remove(QContactDetail::FieldContext); defns[contactType][QContactGuid::DefinitionName].setFields(fields); defns[contactType][QContactGuid::DefinitionName].setUnique(true); // No QContactGlobalPresence defns[contactType].remove(QContactGlobalPresence::DefinitionName); // QContactName fields = defns[contactType][QContactName::DefinitionName].fields(); fields.remove(QContactDetail::FieldContext); fields.remove(QContactName::FieldCustomLabel); fields.remove(QContactName::FieldMiddleName); fields.remove(QContactName::FieldPrefix); fields.remove(QContactName::FieldSuffix); defns[contactType][QContactName::DefinitionName].setFields(fields); defns[contactType][QContactName::DefinitionName].setUnique(true); // QContactNickname fields = defns[contactType][QContactNickname::DefinitionName].fields(); fields.remove(QContactDetail::FieldContext); defns[contactType][QContactNickname::DefinitionName].setFields(fields); defns[contactType][QContactNickname::DefinitionName].setUnique(true); // QContactNote fields = defns[contactType][QContactNote::DefinitionName].fields(); fields.remove(QContactDetail::FieldContext); defns[contactType][QContactNote::DefinitionName].setFields(fields); defns[contactType][QContactNote::DefinitionName].setUnique(true); // QContactOnlineAccount fields = defns[contactType][QContactOnlineAccount::DefinitionName].fields(); fields.remove(QContactDetail::FieldContext); fields.remove(QContactOnlineAccount::FieldAccountUri); fields.remove(QContactOnlineAccount::FieldSubTypes); fields.insert("AccountPath", gsfd); defns[contactType][QContactOnlineAccount::DefinitionName].setFields(fields); defns[contactType][QContactOnlineAccount::DefinitionName].setUnique(false); // QContactOrganization fields = defns[contactType][QContactOrganization::DefinitionName].fields(); fields.remove(QContactDetail::FieldContext); fields.remove(QContactOrganization::FieldAssistantName); fields.remove(QContactOrganization::FieldDepartment); fields.remove(QContactOrganization::FieldLocation); fields.remove(QContactOrganization::FieldLogoUrl); fields.remove(QContactOrganization::FieldTitle); fields.remove(QContactOrganization::FieldRole); defns[contactType][QContactOrganization::DefinitionName].setFields(fields); defns[contactType][QContactOrganization::DefinitionName].setUnique(true); // QContactPhoneNumber fields = defns[contactType][QContactPhoneNumber::DefinitionName].fields(); fields.insert(QContactDetail::FieldDetailUri, gsfd); QContactDetailFieldDefinition phoneSubtype = fields.value(QContactPhoneNumber::FieldSubTypes); QVariantList allowableValues; allowableValues << QContactPhoneNumber::SubTypeMobile; allowableValues << QContactPhoneNumber::SubTypeVoice; allowableValues << QContactPhoneNumber::SubTypeFax; phoneSubtype.setAllowableValues(allowableValues); fields.insert(QContactPhoneNumber::FieldSubTypes, phoneSubtype); defns[contactType][QContactPhoneNumber::DefinitionName].setFields(fields); defns[contactType][QContactPhoneNumber::DefinitionName].setUnique(false); // QContactPresence fields = defns[contactType][QContactPresence::DefinitionName].fields(); fields.remove(QContactPresence::FieldTimestamp); fields.remove(QContactPresence::FieldPresenceState); defns[contactType][QContactPresence::DefinitionName].setFields(fields); defns[contactType][QContactPresence::DefinitionName].setUnique(false); // No QContactRingtone defns[contactType].remove(QContactRingtone::DefinitionName); // No QContactSyncTarget defns[contactType].remove(QContactSyncTarget::DefinitionName); // No QContactTag defns[contactType].remove(QContactTag::DefinitionName); // QContactTimestamp fields = defns[contactType][QContactTimestamp::DefinitionName].fields(); fields.remove(QContactDetail::FieldContext); defns[contactType][QContactTimestamp::DefinitionName].setFields(fields); // QContactType fields = defns[contactType][QContactType::DefinitionName].fields(); fields.remove(QContactDetail::FieldContext); defns[contactType][QContactType::DefinitionName].setFields(fields); // QContactUrl fields = defns[contactType][QContactUrl::DefinitionName].fields(); fields.remove(QContactUrl::FieldSubType); defns[contactType][QContactUrl::DefinitionName].setFields(fields); defns[contactType][QContactUrl::DefinitionName].setUnique(false); QCM5_DEBUG << "Contact type" << contactType << "Keys" << defns.keys(); *error = QContactManager::NoError; return defns[contactType]; } QContactDetailDefinition QContactMaemo5Engine::detailDefinition(const QString& definitionName, const QString& contactType, QContactManager::Error* error) const { return QContactManagerEngine::detailDefinition(definitionName, contactType, error); } bool QContactMaemo5Engine::hasFeature(QContactManager::ManagerFeature feature, const QString& contactType) const { Q_UNUSED(contactType); if (feature == QContactManager::Anonymous) return true; return false; } bool QContactMaemo5Engine::isFilterSupported(const QContactFilter& filter) const { switch (filter.type()) { case QContactFilter::InvalidFilter: case QContactFilter::DefaultFilter: case QContactFilter::LocalIdFilter: case QContactFilter::ContactDetailFilter: case QContactFilter::ActionFilter: case QContactFilter::IntersectionFilter: case QContactFilter::UnionFilter: return true; default: return false; } } QList QContactMaemo5Engine::supportedDataTypes() const { QList st; st.append(QVariant::String); st.append(QVariant::Int); st.append(QVariant::UInt); st.append(QVariant::Double); st.append(QVariant::Date); st.append(QVariant::DateTime); return st; } void QContactMaemo5Engine::requestDestroyed(QContactAbstractRequest* req){ m_asynchronousOperations.removeOne(req); } bool QContactMaemo5Engine::startRequest(QContactAbstractRequest* req){ if (!m_asynchronousOperations.contains(req)) m_asynchronousOperations.enqueue(req); updateRequestState(req, QContactAbstractRequest::ActiveState); QTimer::singleShot(0, this, SLOT(performAsynchronousOperation())); return true; } bool QContactMaemo5Engine::cancelRequest(QContactAbstractRequest* req){ updateRequestState(req, QContactAbstractRequest::CanceledState); return true; } bool QContactMaemo5Engine::waitForRequestProgress(QContactAbstractRequest* req, int msecs){ Q_UNUSED(msecs); if (!m_asynchronousOperations.removeOne(req)) return false; // didn't exist. // replace at head of queue m_asynchronousOperations.insert(0, req); // and perform the operation. performAsynchronousOperation(); return true; } bool QContactMaemo5Engine::waitForRequestFinished(QContactAbstractRequest* req, int msecs){ // in our implementation, we always complete any operation we start. // so, waitForRequestFinished is equivalent to waitForRequestProgress. return waitForRequestProgress(req, msecs); } void QContactMaemo5Engine::performAsynchronousOperation(){ QContactAbstractRequest *currentRequest; // take the first pending request and finish it if (m_asynchronousOperations.isEmpty()) return; currentRequest = m_asynchronousOperations.dequeue(); // check to see if it is cancelling; if so, remove it from the queue and return. if (currentRequest->state() == QContactAbstractRequest::CanceledState) return; // Now perform the active request and emit required signals. Q_ASSERT(currentRequest->state() == QContactAbstractRequest::ActiveState); switch (currentRequest->type()) { case QContactAbstractRequest::ContactFetchRequest: { QContactFetchRequest* r = static_cast(currentRequest); QContactFilter filter = r->filter(); QList sorting = r->sorting(); QContactFetchHint fh = r->fetchHint(); QContactManager::Error operationError; QList requestedContacts = contacts(filter, sorting, fh, &operationError); // update the request with the results. updateContactFetchRequest(r, requestedContacts, operationError, QContactAbstractRequest::FinishedState); // emit resultsAvailable() } break; case QContactAbstractRequest::ContactLocalIdFetchRequest: { QContactLocalIdFetchRequest* r = static_cast(currentRequest); QContactFilter filter = r->filter(); QList sorting = r->sorting(); QContactManager::Error operationError = QContactManager::NoError; QList requestedContactIds = contactIds(filter, sorting, &operationError); updateContactLocalIdFetchRequest(r, requestedContactIds, operationError, QContactAbstractRequest::FinishedState); } break; case QContactAbstractRequest::ContactSaveRequest: { QContactSaveRequest* r = static_cast(currentRequest); QList contacts = r->contacts(); QContactManager::Error operationError = QContactManager::NoError; QMap errorMap; saveContacts(&contacts, &errorMap, &operationError); updateContactSaveRequest(r, contacts, operationError, errorMap, QContactAbstractRequest::FinishedState); // there will always be results of some form. emit resultsAvailable(). } break; case QContactAbstractRequest::ContactRemoveRequest: { // this implementation provides scant information to the user // the operation either succeeds (all contacts matching the filter were removed) // or it fails (one or more contacts matching the filter could not be removed) // if a failure occurred, the request error will be set to the most recent // error that occurred during the remove operation. QContactRemoveRequest* r = static_cast(currentRequest); QContactManager::Error operationError = QContactManager::NoError; QList contactsToRemove = r->contactIds(); QMap errorMap; for (int i = 0; i < contactsToRemove.size(); i++) { QContactManager::Error tempError; removeContact(contactsToRemove.at(i), /*changeSet,*/ &tempError); errorMap.insert(i, tempError); if (tempError != QContactManager::NoError) { operationError = tempError; } } updateContactRemoveRequest(r, operationError, errorMap, QContactAbstractRequest::FinishedState); } break; case QContactAbstractRequest::DetailDefinitionFetchRequest: { QContactDetailDefinitionFetchRequest* r = static_cast(currentRequest); QContactManager::Error operationError = QContactManager::NoError; QMap errorMap; QMap requestedDefinitions; QStringList names = r->definitionNames(); if (names.isEmpty()) names = detailDefinitions(r->contactType(), &operationError).keys(); // all definitions. QContactManager::Error tempError; for (int i = 0; i < names.size(); i++) { QContactDetailDefinition current = detailDefinition(names.at(i), r->contactType(), &tempError); requestedDefinitions.insert(names.at(i), current); errorMap.insert(i, tempError); if (tempError != QContactManager::NoError) { operationError = tempError; } } updateDefinitionFetchRequest(r, requestedDefinitions, operationError, errorMap, QContactAbstractRequest::FinishedState); } break; default: { // this engine currently does not support mutable definitions. } break; } }