FCL/sf/app/homescreen: homescreenapp/hsdomainmodel/src/hscontentservice.cpp@341166945d65 (annotated)

35 f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	1	/*
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	2	* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	3	* All rights reserved.
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	4	* This component and the accompanying materials are made available
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	5	* under the terms of "Eclipse Public License v1.0"
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	6	* which accompanies this distribution, and is available
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	7	* at the URL "http://www.eclipse.org/legal/epl-v10.html".
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	8	*
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	9	* Initial Contributors:
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	10	* Nokia Corporation - initial contribution.
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	11	*
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	12	* Contributors:
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	13	*
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	14	* Description: Homescreen runtime content service.
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	15	*
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	16	*/
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	17
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	18	#include "hscontentservice.h"
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	19	#include "hsdatabase.h"
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	20	#include "hsscene.h"
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	21	#include "hspage.h"
36 cdae8c6c3876 Revision: 201011 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 35 diff changeset	22	#include "hsdomainmodeldatastructures.h"
35 f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	23	#include "hswidgethost.h"
62 341166945d65 201025 hgs parents: 55 diff changeset	24	#include "hsapp_defs.h"
35 f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	25
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	26
62 341166945d65 201025 hgs parents: 55 diff changeset	27	/*!
341166945d65 201025 hgs parents: 55 diff changeset	28	\class HsContentService
341166945d65 201025 hgs parents: 55 diff changeset	29	\ingroup group_hsdomainmodel
341166945d65 201025 hgs parents: 55 diff changeset	30	\brief Service for creating widget to Home Screen and make query for widget instances.
341166945d65 201025 hgs parents: 55 diff changeset	31
341166945d65 201025 hgs parents: 55 diff changeset	32	*/
341166945d65 201025 hgs parents: 55 diff changeset	33
341166945d65 201025 hgs parents: 55 diff changeset	34	/*!
341166945d65 201025 hgs parents: 55 diff changeset	35	Constructor.
341166945d65 201025 hgs parents: 55 diff changeset	36
341166945d65 201025 hgs parents: 55 diff changeset	37	\a parent Owner.
341166945d65 201025 hgs parents: 55 diff changeset	38	*/
35 f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	39	HsContentService::HsContentService(QObject *parent)
62 341166945d65 201025 hgs parents: 55 diff changeset	40	: QObject(parent), mWidgetStartFaulted(false)
35 f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	41	{
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	42
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	43	}
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	44
62 341166945d65 201025 hgs parents: 55 diff changeset	45	/*!
341166945d65 201025 hgs parents: 55 diff changeset	46	Destructor.
341166945d65 201025 hgs parents: 55 diff changeset	47	*/
35 f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	48	HsContentService::~HsContentService()
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	49	{
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	50	}
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	51
62 341166945d65 201025 hgs parents: 55 diff changeset	52	/*!
341166945d65 201025 hgs parents: 55 diff changeset	53	Creates widget. \a params must include 'uri' for the desired widget type.
341166945d65 201025 hgs parents: 55 diff changeset	54	'preferences' is optional.
341166945d65 201025 hgs parents: 55 diff changeset	55	*/
36 cdae8c6c3876 Revision: 201011 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 35 diff changeset	56	bool HsContentService::createWidget(const QVariantHash &params)
35 f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	57	{
62 341166945d65 201025 hgs parents: 55 diff changeset	58	return addWidget(params.value(URI).toString(),
341166945d65 201025 hgs parents: 55 diff changeset	59	params.value(PREFERENCES).toHash(),
341166945d65 201025 hgs parents: 55 diff changeset	60	params.value(HOMESCREENDATA));
35 f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	61	}
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	62
62 341166945d65 201025 hgs parents: 55 diff changeset	63	// This method will be removed.
341166945d65 201025 hgs parents: 55 diff changeset	64	#ifdef COVERAGE_MEASUREMENT
341166945d65 201025 hgs parents: 55 diff changeset	65	#pragma CTC SKIP
341166945d65 201025 hgs parents: 55 diff changeset	66	#endif //COVERAGE_MEASUREMENT
36 cdae8c6c3876 Revision: 201011 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 35 diff changeset	67	HsWidgetHost *HsContentService::createWidgetForPreview(const QVariantHash &params)
35 f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	68	{
f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	69	HsWidgetData widgetData;
62 341166945d65 201025 hgs parents: 55 diff changeset	70	widgetData.uri = params.value(URI).toString();
35 f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	71
55 03646e8da489 Revision: 201021 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 39 diff changeset	72	return HsWidgetHost::createInstance(
62 341166945d65 201025 hgs parents: 55 diff changeset	73	widgetData, params.value(PREFERENCES).toHash());
35 f9ce957a272c Revision: 201007 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	74	}
62 341166945d65 201025 hgs parents: 55 diff changeset	75	#ifdef COVERAGE_MEASUREMENT
341166945d65 201025 hgs parents: 55 diff changeset	76	#pragma CTC ENDSKIP
341166945d65 201025 hgs parents: 55 diff changeset	77	#endif //COVERAGE_MEASUREMENT
39 4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	78
4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	79	/*!
4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	80
4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	81	*/
62 341166945d65 201025 hgs parents: 55 diff changeset	82	bool HsContentService::addWidget(const QString &uri, const QVariantHash &preferences,
341166945d65 201025 hgs parents: 55 diff changeset	83	const QVariant &homescreenData)
39 4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	84	{
55 03646e8da489 Revision: 201021 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 39 diff changeset	85	HsWidgetData data;
03646e8da489 Revision: 201021 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 39 diff changeset	86	data.uri = uri;
39 4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	87
55 03646e8da489 Revision: 201021 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 39 diff changeset	88	HsWidgetHost *widget = HsWidgetHost::createInstance(data, preferences);
03646e8da489 Revision: 201021 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 39 diff changeset	89	if (!widget) {
39 4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	90	return false;
4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	91	}
4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	92
55 03646e8da489 Revision: 201021 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 39 diff changeset	93	HsPage *page = HsScene::instance()->activePage();
62 341166945d65 201025 hgs parents: 55 diff changeset	94	QPointF touchPoint = homescreenData.toPointF();
341166945d65 201025 hgs parents: 55 diff changeset	95	if (!page->addNewWidget(widget, touchPoint)) {
55 03646e8da489 Revision: 201021 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 39 diff changeset	96	widget->remove();
39 4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	97	return false;
4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	98	}
62 341166945d65 201025 hgs parents: 55 diff changeset	99	connect(widget,SIGNAL(event_faulted()),SLOT(widgetStartFaulted()));
341166945d65 201025 hgs parents: 55 diff changeset	100	mWidgetStartFaulted = false;
341166945d65 201025 hgs parents: 55 diff changeset	101	widget->startWidget(); // synchronous operation
341166945d65 201025 hgs parents: 55 diff changeset	102	if (mWidgetStartFaulted) {
341166945d65 201025 hgs parents: 55 diff changeset	103	// page will destroy widget instance
341166945d65 201025 hgs parents: 55 diff changeset	104	return false;
341166945d65 201025 hgs parents: 55 diff changeset	105	}
341166945d65 201025 hgs parents: 55 diff changeset	106	widget->disconnect(this);
341166945d65 201025 hgs parents: 55 diff changeset	107	emit widgetAdded(uri, preferences);
39 4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	108	return true;
4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	109	}
4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	110
4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	111	/*!
62 341166945d65 201025 hgs parents: 55 diff changeset	112	Returns false if database query fails. If returns true then
341166945d65 201025 hgs parents: 55 diff changeset	113	number of widget instances of the given \a uri and \a preferences is stored to \a count.
341166945d65 201025 hgs parents: 55 diff changeset	114	If \a preferences is empty then returns number of widget instances with given uri.
341166945d65 201025 hgs parents: 55 diff changeset	115	*/
341166945d65 201025 hgs parents: 55 diff changeset	116	bool HsContentService::widgets(const QString &uri, const QVariantHash &preferences, int &count)
341166945d65 201025 hgs parents: 55 diff changeset	117	{
341166945d65 201025 hgs parents: 55 diff changeset	118	return HsDatabase::instance()->widgets(uri, preferences, count);
341166945d65 201025 hgs parents: 55 diff changeset	119	}
39 4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	120
62 341166945d65 201025 hgs parents: 55 diff changeset	121	/*!
39 4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	122	*/
4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	123	HsContentService *HsContentService::instance()
4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	124	{
4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	125	if (!mInstance) {
55 03646e8da489 Revision: 201021 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 39 diff changeset	126	mInstance = new HsContentService();
39 4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	127	}
55 03646e8da489 Revision: 201021 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 39 diff changeset	128	return mInstance;
39 4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	129	}
4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	130
4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	131	/*!
62 341166945d65 201025 hgs parents: 55 diff changeset	132
341166945d65 201025 hgs parents: 55 diff changeset	133	*/
341166945d65 201025 hgs parents: 55 diff changeset	134	void HsContentService::emitWidgetRemoved(const QString &uri, const QVariantHash &preferences)
341166945d65 201025 hgs parents: 55 diff changeset	135	{
341166945d65 201025 hgs parents: 55 diff changeset	136	emit widgetRemoved(uri, preferences);
341166945d65 201025 hgs parents: 55 diff changeset	137	}
341166945d65 201025 hgs parents: 55 diff changeset	138
341166945d65 201025 hgs parents: 55 diff changeset	139	/*!
341166945d65 201025 hgs parents: 55 diff changeset	140
341166945d65 201025 hgs parents: 55 diff changeset	141	*/
341166945d65 201025 hgs parents: 55 diff changeset	142	void HsContentService::widgetStartFaulted()
341166945d65 201025 hgs parents: 55 diff changeset	143	{
341166945d65 201025 hgs parents: 55 diff changeset	144	mWidgetStartFaulted = true;
341166945d65 201025 hgs parents: 55 diff changeset	145	}
341166945d65 201025 hgs parents: 55 diff changeset	146
341166945d65 201025 hgs parents: 55 diff changeset	147	/*!
39 4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	148	Points to the content service instance.
4e8ebe173323 Revision: 201015 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 36 diff changeset	149	*/
55 03646e8da489 Revision: 201021 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 39 diff changeset	150	HsContentService *HsContentService::mInstance(0);
62 341166945d65 201025 hgs parents: 55 diff changeset	151
341166945d65 201025 hgs parents: 55 diff changeset	152	/*!
341166945d65 201025 hgs parents: 55 diff changeset	153	\fn HsContentService::widgetAdded(const QString &uri, const QVariantHash &preferences);
341166945d65 201025 hgs parents: 55 diff changeset	154
341166945d65 201025 hgs parents: 55 diff changeset	155	Emited when widget is added.
341166945d65 201025 hgs parents: 55 diff changeset	156
341166945d65 201025 hgs parents: 55 diff changeset	157	*/
341166945d65 201025 hgs parents: 55 diff changeset	158	/*!
341166945d65 201025 hgs parents: 55 diff changeset	159	\fn HsContentService::widgetRemoved(const QString &uri, const QVariantHash &preferences);
341166945d65 201025 hgs parents: 55 diff changeset	160
341166945d65 201025 hgs parents: 55 diff changeset	161	Emited when widget is removed.
341166945d65 201025 hgs parents: 55 diff changeset	162
341166945d65 201025 hgs parents: 55 diff changeset	163	*/
341166945d65 201025 hgs parents: 55 diff changeset	164

author	hgs
	Fri, 25 Jun 2010 19:19:22 +0300
changeset 62	341166945d65
parent 55	03646e8da489
child 81	7dd137878ff8
permissions	-rw-r--r--