messagingapp/msgappfw/server/inc/ccscontactsmanager.h
changeset 23 238255e8b033
child 37 518b245aa84c
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/messagingapp/msgappfw/server/inc/ccscontactsmanager.h	Fri Apr 16 14:56:15 2010 +0300
@@ -0,0 +1,128 @@
+/*
+ * 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:QT contact manager interface
+ *
+ */
+#ifndef CONTACTS_MANAGER_H
+#define CONTACTS_MANAGER_H
+
+// SYSTEM INCLUDES
+#include <QObject>
+#include "qtcontactsglobal.h"
+// USER INCLUDES
+#include "mcscontactsmanagerobserver.h"
+
+QTM_BEGIN_NAMESPACE
+// FORWARD DECLARATIONS
+class QContactManager;
+QTM_END_NAMESPACE
+
+QTM_USE_NAMESPACE
+
+class CCsContactsResolver;
+
+// CLASS DECLARATION
+/**
+ * QT contact manager interface. Creates an instance of virtual
+ * phonebook contact manager. Using the QT contacts manager
+ * creates resolver objects for use by cache to resolve addresses 
+ */
+class CCsContactsManager : public QObject
+{
+Q_OBJECT
+
+public:
+
+    /**
+     * Constructor
+     */
+    explicit CCsContactsManager(QObject* parent = 0);
+
+    /**
+     * Destructor
+     */
+    virtual ~CCsContactsManager();
+
+public:
+
+    /**
+     * resolver
+     * Provides a reference to the resolver object.
+     * 
+     * @return The contact resolver interface.
+     */
+    CCsContactsResolver* resolver() const;
+
+    /**
+     * addObserver
+     * add observer into the list
+     * @param aObserver instance of MCsContactsManagerObserver
+     */
+    void addObserver(MCsContactsManagerObserver* aObserver);
+
+    /**
+     * removeObserver
+     * delete observer from the observer list
+     * @param aObserver instance of MCsContactsManagerObserver
+     */
+    void removeObserver(MCsContactsManagerObserver* aObserver);
+
+public slots:
+
+    /**
+     * Handle contactsAdded signal from QContactManager
+     * Emits phonebookNotification signal
+     * @param contactIds unique contact id list
+     */
+    void handleContactsAdded(const QList<QContactLocalId>& contactIds);
+
+    /**
+     * Handle contactsChanged signal from QContactManager
+     * Emits phonebookNotification signal
+     * @param contactIds unique contact id list
+     */
+    void handleContactsChanged(const QList<QContactLocalId>& contactIds);
+
+    /**
+     * Handle contactsRemoved signal from QContactManager
+     * Emits phonebookNotification signal
+     * @param id deleted contact id list
+     */
+    void handleContactsRemoved(const QList<QContactLocalId> &contactIds);
+
+private:
+
+    /**
+     * mContactsResolver
+     * An instance of the contacts database resolver
+     * Own.
+     */
+    CCsContactsResolver* mContactsResolver;
+
+    /**
+     * mPhonebookManager
+     * An instance of the QContactManager
+     * Own.
+     */
+    QContactManager* mPhonebookManager;
+
+    /**
+     * mObserverList
+     * List of Observers
+     * Own.
+     */
+    QList<MCsContactsManagerObserver*> mObserverList;
+};
+
+#endif // CONTACTS_MANAGER_H