diff -r 5d007b20cfd0 -r cd2778e5acfe qtmobileextensions/src/settingsmanager/xqcentralrepositoryutils.cpp --- a/qtmobileextensions/src/settingsmanager/xqcentralrepositoryutils.cpp Tue Aug 31 16:02:37 2010 +0300 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,189 +0,0 @@ -/* -* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). -* All rights reserved. -* -* This program is free software: you can redistribute it and/or modify -* it under the terms of the GNU Lesser General Public License as published by -* the Free Software Foundation, version 2.1 of the License. -* -* This program 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. -* -* You should have received a copy of the GNU Lesser General Public License -* along with this program. If not, -* see "http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html/". -* -* Description: -* -*/ - -#include "xqcentralrepositoryutils.h" -#include "xqcentralrepositoryutils_p.h" - -/*! - \class XQCentralRepositoryUtils - - \brief The XQCentralRepositoryUtils implements Central Repository related special - features in SettingsManager. This class is just a Qt-like wrapper to - Symbian OS' CRepository class. - - See Symbian documentation for more detailed information about e.g. the use of transactions. - - This class co-operates with XQSettingsManager so central repositories accessed via this class - share the same CRepository instances. -*/ - - -/*! - \enum XQCentralRepositoryUtils::TransactionMode - - This enum defines the possible transaction modes. -*/ -/*! \var XQCentralRepositoryUtils::ConcurrentReadWriteTransaction XQCentralRepositoryUtils::ConcurrentReadWriteTransaction - See Symbian documentation for CRepository transactions. -*/ -/*! \var XQCentralRepositoryUtils::ReadTransaction XQCentralRepositoryUtils::ReadTransaction - See Symbian documentation for CRepository transactions. -*/ -/*! \var XQCentralRepositoryUtils::ReadWriteTransaction XQCentralRepositoryUtils::ReadWriteTransaction - See Symbian documentation for CRepository transactions. -*/ - -/*! - \enum XQCentralRepositoryUtils::TransactionState - - This enum defines the possible transaction states. -*/ -/*! \var XQCentralRepositoryUtils::NotInTransaction XQCentralRepositoryUtils::NotInTransaction - See Symbian documentation for CRepository transactions. -*/ -/*! \var XQCentralRepositoryUtils::ActiveTransaction XQCentralRepositoryUtils::ActiveTransaction - See Symbian documentation for CRepository transactions. -*/ -/*! \var XQCentralRepositoryUtils::FailedTransaction XQCentralRepositoryUtils::FailedTransaction - See Symbian documentation for CRepository transactions. -*/ -/*! \var XQCentralRepositoryUtils::UnknownTransaction XQCentralRepositoryUtils::UnknownTransaction - Transaction state is not known. -*/ - - -/*! - Constructs an XQCentralRepositoryUtils object. - \param settingsManager Reference to XQSettingsManager instance -*/ -XQCentralRepositoryUtils::XQCentralRepositoryUtils(XQSettingsManager& settingsManager, QObject* parent) - : QObject(parent), d(new XQCentralRepositoryUtilsPrivate(settingsManager)) -{ -} - -/*! - Destructs an XQCentralRepositoryUtils. -*/ -XQCentralRepositoryUtils::~XQCentralRepositoryUtils() -{ -} - -/*! - Creates a key to central repository. (NOTE: This function is not enabled in public - releases by default.) - \param key XQCentralRepositorySettingsKey which defines the key details - \param value Initial value to be written into central repository. The type is determined with - QVariant.type() and it must be either QVariant::Int, QVariant::Double, QVariant::String or - QVariant::ByteArray. - \return True if the key was succesfully created, otherwise return false. -*/ -bool XQCentralRepositoryUtils::createKey(const XQCentralRepositorySettingsKey& key, const QVariant& value) -{ - return d->createKey(key, value); -} - -/*! - Deletes a key from central repository. (NOTE: This function is not enabled in public - releases by default.) - \param key XQCentralRepositorySettingsKey which defines the key details - \return True if the key was succesfully deleted, otherwise return false. -*/ -bool XQCentralRepositoryUtils::deleteKey(const XQCentralRepositorySettingsKey& key) -{ - return d->deleteKey(key); -} - -/*! - Resets a key in central repository to it's initial value defined in .ini file. - \param key XQCentralRepositorySettingsKey which defines the key details - \return True if the key was succesfully reset, otherwise return false. -*/ -bool XQCentralRepositoryUtils::resetKey(const XQCentralRepositorySettingsKey& key) -{ - return d->resetKey(key); -} - -/*! - Resets the whole central repository file to it's initial state defined in .ini file. - \param repositoryUid Repository UID - \return True if the repository was succesfully reset, otherwise return false. -*/ -bool XQCentralRepositoryUtils::resetRepository(long int repositoryUid) -{ - return d->resetRepository(repositoryUid); -} - -/*! - Finds keys in central repository. - \param criteria Search criteria - \return List of XQCentralRepositorySettingsKey objects that match with criteria -*/ -QList XQCentralRepositoryUtils::findKeys(const XQCentralRepositorySearchCriteria& criteria) -{ - return d->findKeys(criteria); -} - -/*! - Starts transaction. See Symbian documentation for more info. - \param repositoryUid Repository UID - \param transactionMode Transaction mode. - \return True if the transaction was succesfully started, otherwise return false. -*/ -bool XQCentralRepositoryUtils::startTransaction(long int repositoryUid, TransactionMode transactionMode) -{ - return d->startTransaction(repositoryUid, transactionMode); -} - -/*! - Commits transaction. See Symbian documentation for more info. - \param repositoryUid Repository UID - \return True if the transaction was succesfully committed, otherwise return false. -*/ -bool XQCentralRepositoryUtils::commitTransaction(long int repositoryUid) -{ - return d->commitTransaction(repositoryUid); -} - -/*! - Cancels transaction. See Symbian documentation for more info. - \param repositoryUid Repository UID -*/ -void XQCentralRepositoryUtils::cancelTransaction(long int repositoryUid) -{ - d->cancelTransaction(repositoryUid); -} - -/*! - Fails transaction. See Symbian documentation for more info. - \param repositoryUid Repository UID -*/ -void XQCentralRepositoryUtils::failTransaction(long int repositoryUid) -{ - d->failTransaction(repositoryUid); -} - -/*! - \return Current transaction state. -*/ -XQCentralRepositoryUtils::TransactionState XQCentralRepositoryUtils::transactionState(long int repositoryUid) const -{ - return d->transactionState(repositoryUid); -}