/*
* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:
*
*/
/*
* Symbian specific settings handling
*/
#include <QVariant>
#include <QList>
#include <QMultiMap>
#include <QMetaType>
#include <QString>
#include <QStringList>
#include <QVariant>
#include "xqsettingsmanager.h" // Settings Manager API
#include "xqsettingskey.h"
#include "cxesettingscenrepstore.h"
#include "cxenamespace.h"
#include "cxutils.h"
#include "cxenamespace.h"
#include "cxeerror.h"
#include "cxecenrepkeys.h"
using namespace CxeSettingIds;
/*
* CxeSettingsCenRepStore::CxeSettingsCenRepStore
*/
CxeSettingsCenRepStore::CxeSettingsCenRepStore()
{
CX_DEBUG_ENTER_FUNCTION();
// map keys of type "string" to cenrep ids
mapKeys();
// we create settings handle, scope user::scope
mSettingsManager = new XQSettingsManager(this);
bool ok = false;
ok = connect(mSettingsManager, SIGNAL(valueChanged(XQSettingsKey, QVariant)),
this, SLOT(handleValueChanged(XQSettingsKey, QVariant)));
CX_DEBUG_ASSERT(ok);
CX_DEBUG(("CxeSettingsCenRepStore - mSettingsManager ptr = %d", mSettingsManager));
CX_DEBUG_EXIT_FUNCTION();
}
/*
* CxeSettingsCenRepStore::~CxeSettingsCenRepStore()
*/
CxeSettingsCenRepStore::~CxeSettingsCenRepStore()
{
CX_DEBUG_ENTER_FUNCTION();
delete mSettingsManager;
CX_DEBUG_EXIT_FUNCTION();
}
/*
* Generates XQSettingsKey from given setting/runtime key
*/
XQSettingsKey
CxeSettingsCenRepStore::generateXQSettingsKey(const QString& key, CxeError::Id& error)
{
CX_DEBUG_ENTER_FUNCTION();
error = CxeError::None;
long int uid = 0;
unsigned long int keyId = 0;
if(mKeyMapping.contains(key)) {
uid = mKeyMapping[key].mRepositoryUid;
keyId = mKeyMapping[key].mKeyId;
} else {
error = CxeError::NotFound;
}
CX_DEBUG(( "CxeSettingsCenRepStore::generateXQSettingsKey uid = %x keyId = %d", uid, keyId ));
XQSettingsKey newKey(XQSettingsKey::TargetCentralRepository, uid, keyId);
CX_DEBUG_EXIT_FUNCTION();
return newKey;
}
/*
* Reads/loads all run-time settings values from cenrep
* @param QList<QString> contains list of all runtime key ids which we use to load values from cenrep.
* returns: QHash container, "contains" values associated with each key that are read from cenrep
* NOTE: loading runtime settings should be done only ONCE at start-up.
*/
QHash<QString, QVariantList> CxeSettingsCenRepStore::loadRuntimeSettings(QList<QString>& runtimeKeys)
{
CX_DEBUG_ENTER_FUNCTION();
QHash<QString, QVariantList> settings;
CxeError::Id err = CxeError::None;
QVariantList list;
QVariant data;
// parsing through the list of run-time keys and reading values from cenrep.
foreach (QString key, runtimeKeys) {
// read the data from cenrep
err = get(key, data);
// clear the list
list.clear();
if (CxeError::None == err) {
if (data.type() == QMetaType::QString ) {
QString str = data.toString();
QVariant strListVariant = qVariantFromValue(str.split(","));
//generate qvariantlist from strListVariant
list = strListVariant.toList();
} else {
// if its of any other type, then just append to the list
list.append(data);
}
}
// append the values associated with the key to the list.
settings.insert(key, list);
} // end for
CX_DEBUG_EXIT_FUNCTION();
return settings;
}
/*
* Reads a value from cenrep
* @param key - setting key
* @param value - setting value read from cenrep
*/
CxeError::Id CxeSettingsCenRepStore::get(const QString& key, QVariant &value)
{
CX_DEBUG_ENTER_FUNCTION();
CX_DEBUG_ASSERT(mSettingsManager);
CX_DEBUG(("CxeSettingsCenRepStore::get - key: %s", key.toAscii().constData()));
CxeError::Id err = CxeError::None;
XQSettingsKey mappedSettingKey = generateXQSettingsKey(key, err);
if (CxeError::None == err) {
CX_DEBUG(("reading values from XQSettingsManager.."));
value = mSettingsManager->readItemValue(mappedSettingKey, mKeyMapping[key].mDataType);
// checking if reading data from cenrep was successful
if (mSettingsManager->error() != XQSettingsManager::NoError) {
CX_DEBUG(("Error reading value from XQSettingsManager.."));
err = CxeError::General;
}
}
CX_DEBUG_EXIT_FUNCTION();
return err;
}
/*
* Reads a value from cenrep
* @param key - setting key
* @param uid - setting UID of the component that owns the setting key
* @param type - the type of key cr key or P&S key (constantly monitoring value)
* @param value - setting value read from cenrep
*/
void CxeSettingsCenRepStore::get(long int uid,
unsigned long int key,
Cxe::SettingKeyType type,
QVariant &value)
{
CX_DEBUG_ENTER_FUNCTION();
CX_DEBUG_ASSERT(mSettingsManager);
XQSettingsKey::Target keyType;
if (type == Cxe::PublishAndSubscribe) {
keyType = XQSettingsKey::TargetPublishAndSubscribe;
} else {
keyType = XQSettingsKey::TargetCentralRepository;
}
XQSettingsKey settingsKey(keyType, uid, key);
CX_DEBUG(("reading values from XQSettingsManager.."));
value = mSettingsManager->readItemValue(settingsKey);
if (keyType == XQSettingsKey::TargetPublishAndSubscribe) {
bool ok = false;
ok = mSettingsManager->startMonitoring(settingsKey);
CX_DEBUG_ASSERT(ok);
}
CX_DEBUG_EXIT_FUNCTION();
}
/*
* Sets a new value to cenrep
* @param key - setting key
* @param newValue - new value set to the key in cenrep
*/
CxeError::Id CxeSettingsCenRepStore::set(const QString& key, const QVariant newValue)
{
CX_DEBUG_ENTER_FUNCTION();
CX_DEBUG_ASSERT(mSettingsManager);
CxeError::Id err = CxeError::None;
// generating key for xqsettingsmanager
XQSettingsKey mappedSettingKey = generateXQSettingsKey(key, err);
if (CxeError::None == err) {
// key found
// check if the key can be set any value or read-only
if(mKeyMapping[key].mReadOnly) {
err = CxeError::NotFound;
} else {
mSettingsManager->writeItemValue(mappedSettingKey, newValue);
// check from xqsettingsmanager if "Set" operation was successful
if (mSettingsManager->error() != XQSettingsManager::NoError) {
CX_DEBUG(("Error writing value to XQSettingsManager.."));
err = CxeError::General;
}
}
}
CX_DEBUG_EXIT_FUNCTION();
return err;
}
/*
* resets the cenrep store
*/
void CxeSettingsCenRepStore::reset()
{
CX_DEBUG_ENTER_FUNCTION();
CX_DEBUG_ASSERT(mSettingsManager);
//!@Todo: How to reset the repository.
CX_DEBUG_EXIT_FUNCTION();
}
/*
* adds key mapping to all settings
*/
void CxeSettingsCenRepStore::mapKeys()
{
CX_DEBUG_ENTER_FUNCTION();
mKeyMapping.clear();
// mapping setting keys
addKeyMapping(CxeSettingIds::FNAME_FOLDER_SUFFIX,
FileNameSuffixCr,
XQSettingsManager::TypeString);
addKeyMapping(CxeSettingIds::FNAME_MONTH_FOLDER,
FolderNameCr,
XQSettingsManager::TypeString);
addKeyMapping(CxeSettingIds::FNAME_IMAGE_COUNTER,
FileNameImageCounterCr,
XQSettingsManager::TypeInt);
addKeyMapping(CxeSettingIds::FNAME_VIDEO_COUNTER,
FileNameVideoCounterCr,
XQSettingsManager::TypeInt);
addKeyMapping(CxeSettingIds::STILL_SHOWCAPTURED,
StillShowCapturedCr,
XQSettingsManager::TypeInt);
addKeyMapping(CxeSettingIds::VIDEO_SHOWCAPTURED,
VideoShowCapturedCr,
XQSettingsManager::TypeInt);
addKeyMapping(CxeSettingIds::IMAGE_QUALITY,
ImageQualityCr,
XQSettingsManager::TypeInt);
addKeyMapping(CxeSettingIds::VIDEO_QUALITY,
VideoQualityCr,
XQSettingsManager::TypeInt);
addKeyMapping(CxeSettingIds::VIDEO_MUTE_SETTING,
AudioMuteCr,
XQSettingsManager::TypeInt);
// mapping run-time keys
addKeyMapping(CxeRuntimeKeys::PRIMARY_CAMERA_CAPTURE_KEYS,
PrimaryCameraCaptureKeysCr,
XQSettingsManager::TypeString,
true);
addKeyMapping(CxeRuntimeKeys::PRIMARY_CAMERA_AUTOFOCUS_KEYS,
PrimaryCameraAutofocusKeysCr,
XQSettingsManager::TypeString,
true);
addKeyMapping(CxeRuntimeKeys::SECONDARY_CAMERA_CAPTURE_KEYS,
SecondaryCameraCaptureKeysCr,
XQSettingsManager::TypeString,
true);
addKeyMapping(CxeRuntimeKeys::FREE_MEMORY_LEVELS,
FreeMemoryLevelsCr,
XQSettingsManager::TypeString,
true);
addKeyMapping(CxeRuntimeKeys::STILL_MAX_ZOOM_LIMITS,
StillMaxZoomLimitsCr,
XQSettingsManager::TypeString,
true);
addKeyMapping(CxeRuntimeKeys::VIDEO_MAX_ZOOM_LIMITS,
VideoMaxZoomLimitsCr,
XQSettingsManager::TypeString,
true);
CX_DEBUG_EXIT_FUNCTION();
}
/*
* helper class to construct key mappings for each setting key
*/
void CxeSettingsCenRepStore::addKeyMapping(QString key,
unsigned long int keyid,
XQSettingsManager::Type type,
bool readOnly)
{
CX_DEBUG_ENTER_FUNCTION();
CxeCenRepDefinition cenrepDef;
long int uid;
if (readOnly) {
uid = CxRuntimeFeaturesCrUid;
} else {
uid = CxSettingsCrUid;
}
cenrepDef.mRepositoryUid = uid;
cenrepDef.mKeyId = keyid;
cenrepDef.mReadOnly = readOnly;
cenrepDef.mDataType = type;
// insert the key specific mapping to the hash
mKeyMapping.insert(key, cenrepDef);
CX_DEBUG_EXIT_FUNCTION();
}
/*!
* Slot that handles value changed signal for Publish & Subscribe key.
*/
void CxeSettingsCenRepStore::handleValueChanged(XQSettingsKey key, QVariant value)
{
CX_DEBUG_ENTER_FUNCTION();
emit settingValueChanged(key.uid(), key.key(), value);
CX_DEBUG_EXIT_FUNCTION();
}
const QHash<QString, CxeSettingsCenRepStore::CxeCenRepDefinition>& CxeSettingsCenRepStore::keyMapping() const
{
return mKeyMapping;
}
CxeSettingsLocalStore::CxeSettingsLocalStore()
{
CX_DEBUG_ENTER_FUNCTION();
// load values from cenrep
CX_DEBUG(("Loading keys from cenrep..."));
foreach(QString key, keyMapping().keys()) {
QVariant value;
CxeError::Id err = CxeSettingsCenRepStore::get(key, value);
if (!err) {
CX_DEBUG(("Adding key %s", key.toAscii().constData()));
mSettings[key] = value;
} else {
CX_DEBUG(("Key %s not found in cenrep", key.toAscii().constData()));
}
}
CX_DEBUG(("Done"));
CX_DEBUG_EXIT_FUNCTION();
}
CxeSettingsLocalStore::~CxeSettingsLocalStore()
{
CX_DEBUG_ENTER_FUNCTION();
CX_DEBUG_EXIT_FUNCTION();
}
CxeError::Id CxeSettingsLocalStore::get(const QString& key, QVariant &value)
{
CX_DEBUG_ENTER_FUNCTION();
if (useValueFromCenrep(key)) {
CX_DEBUG(("Reading key %s directly from cenrep", key.toAscii().constData()));
return CxeSettingsCenRepStore::get(key, value);
}
value = mSettings.value(key);
if (value.isNull()) {
CX_DEBUG(("Key %s not found", key.toAscii().constData()));
return CxeError::NotFound;
}
CX_DEBUG(("Key %s, value %s", key.toAscii().constData(), value.toString().toAscii().constData()));
CX_DEBUG_EXIT_FUNCTION();
return CxeError::None;
}
CxeError::Id CxeSettingsLocalStore::set(const QString& key, const QVariant newValue)
{
CX_DEBUG_ENTER_FUNCTION();
if (useValueFromCenrep(key)) {
CX_DEBUG(("Writing key %s directly to cenrep", key.toAscii().constData()));
return CxeSettingsCenRepStore::set(key, newValue);
}
if (mSettings.value(key).isNull()) {
// only allow to set keys that are mapped in CxeSettingsCenRepStore
CX_DEBUG(("Key %s not found", key.toAscii().constData()));
return CxeError::NotFound;
}
mSettings[key] = newValue;
CX_DEBUG_EXIT_FUNCTION();
return CxeError::None;
}
/*!
* Returns true for keys that should be read/written from cenrep instead
* of using cached copies. This is for some settings that need to be shared
* between all instances of camera.
*
* @param key name
* @return boolean to indicate wheter to load use cenrep value or not
*/
bool CxeSettingsLocalStore::useValueFromCenrep(const QString &key) const
{
if (key == CxeSettingIds::FNAME_MONTH_FOLDER ||
key == CxeSettingIds::FNAME_IMAGE_COUNTER ||
key == CxeSettingIds::FNAME_VIDEO_COUNTER) {
return true;
}
return false;
}
// end of file