diff -r cfcbf08528c4 -r 2b40d63a9c3d qtmobility/src/contacts/qcontactchangeset.cpp --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/qtmobility/src/contacts/qcontactchangeset.cpp Fri Apr 16 15:51:22 2010 +0300 @@ -0,0 +1,213 @@ +/**************************************************************************** +** +** Copyright (C) 2009 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 "qcontactchangeset.h" +#include "qcontactchangeset_p.h" +#include "qcontactmanagerengine.h" + +QTM_BEGIN_NAMESPACE + +/*! + \class QContactChangeSet + + \brief The QContactChangeSet class provides a simple API to + simplify the emission of state-change signals from + QContactManagerEngine implementations. + + This class can be utilised by backend implementations to ensure + correct emission of the \l QContactManagerEngine::dataChanged(), \l + QContactManagerEngine::contactsAdded(), \l + QContactManagerEngine::contactsChanged() and \l + QContactManagerEngine::contactsRemoved(). + + \sa QContactManagerEngine + */ + +/*! + Constructs a new change set + */ +QContactChangeSet::QContactChangeSet() + : d(new QContactChangeSetData) +{ +} + +/*! + Constructs a copy of the \a other change set + */ +QContactChangeSet::QContactChangeSet(const QContactChangeSet& other) + : d(other.d) +{ +} + +/*! + Frees the memory used by this change set + */ +QContactChangeSet::~QContactChangeSet() +{ +} + +/*! + Assigns this change set to be equal to \a other + */ +QContactChangeSet& QContactChangeSet::operator=(const QContactChangeSet& other) +{ + d = other.d; + return *this; +} + +/*! + Sets the data changed flag to \a dataChanged. If this is set to true prior to calling \l emitSignals(), + only the \l QContactManagerEngine::dataChanged() signal will be emitted; otherwise, the appropriate + finer-grained signals will be emitted. + */ +void QContactChangeSet::setDataChanged(bool dataChanged) +{ + d->m_dataChanged = dataChanged; +} + +/*! + Returns the value of the data changed flag + */ +bool QContactChangeSet::dataChanged() +{ + return d->m_dataChanged; +} + +/*! + Returns a reference to the set of ids of contacts which have been added to + the database. + */ +QSet& QContactChangeSet::addedContacts() +{ + return d->m_addedContacts; +} + +/*! + Returns a reference to the set of ids of contacts which have been changed in + the database. + */ +QSet& QContactChangeSet::changedContacts() +{ + return d->m_changedContacts; +} + +/*! + Returns a reference to the set of ids of contacts which have been removed from + the database. + */ +QSet& QContactChangeSet::removedContacts() +{ + return d->m_removedContacts; +} + +/*! + Returns a reference to the set of ids of contacts which have been affected + by the addition of relationships to the database. + */ +QSet& QContactChangeSet::addedRelationshipsContacts() +{ + return d->m_addedRelationships; +} + +/*! + Returns a reference to the set of ids of contacts which have been affected + by the removal of relationships from the database. + */ +QSet& QContactChangeSet::removedRelationshipsContacts() +{ + return d->m_removedRelationships; +} + +/*! + Returns a reference to the pair of ids which represents the + old and new self contact ids. The first id in the pair is the + old self contact id, while the second id in the pair is the + new self contact id. If the new id is different to the old id + at the point in time when emitSignals() is called, + the QContactManagerEngine::selfContactIdChanged() signal will be emitted. + */ +QPair& QContactChangeSet::oldAndNewSelfContactId() +{ + return d->m_oldAndNewSelfContactId; +} + +/*! + Clears all flags and sets of ids in this change set + */ +void QContactChangeSet::clear() +{ + d->m_dataChanged = false; + d->m_addedContacts.clear(); + d->m_changedContacts.clear(); + d->m_removedContacts.clear(); + d->m_addedRelationships.clear(); + d->m_removedRelationships.clear(); + d->m_oldAndNewSelfContactId = QPair(); +} + +/*! + Emits the appropriate signals from the given \a engine given the state of the change set + */ +void QContactChangeSet::emitSignals(QContactManagerEngine *engine) +{ + if (!engine) + return; + + if (d->m_dataChanged) { + emit engine->dataChanged(); + } else { + if (!d->m_addedContacts.isEmpty()) + emit engine->contactsAdded(d->m_addedContacts.toList()); + if (!d->m_changedContacts.isEmpty()) + emit engine->contactsChanged(d->m_changedContacts.toList()); + if (!d->m_removedContacts.isEmpty()) + emit engine->contactsRemoved(d->m_removedContacts.toList()); + if (!d->m_addedRelationships.isEmpty()) + emit engine->relationshipsAdded(d->m_addedRelationships.toList()); + if (!d->m_removedRelationships.isEmpty()) + emit engine->relationshipsRemoved(d->m_removedRelationships.toList()); + if (d->m_oldAndNewSelfContactId.first != d->m_oldAndNewSelfContactId.second) + emit engine->selfContactIdChanged(d->m_oldAndNewSelfContactId.first, d->m_oldAndNewSelfContactId.second); + } +} + +QTM_END_NAMESPACE