--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/homescreensrv_plat/contentstorage_api/inc/caservice.h Wed Oct 06 16:00:22 2010 +0300
@@ -0,0 +1,133 @@
+/*
+ * 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: caservice.h
+ *
+ */
+
+#ifndef CASERVICE_H
+#define CASERVICE_H
+
+#include <QObject>
+#include <QSharedPointer>
+
+#include <cadefs.h>
+
+#include "caclient_global.h"
+#include "canotifierfilter.h"
+
+class CaQuery;
+class CaEntry;
+class CaServicePrivate;
+class CaNotifier;
+
+class CACLIENT_EXPORT CaService: public QObject
+{
+
+Q_OBJECT
+
+ explicit CaService(QObject *parent = 0);
+
+ ~CaService();
+
+public:
+
+ static QSharedPointer<CaService> instance();
+
+ QSharedPointer<CaEntry> getEntry(int entryId) const;
+ QList< QSharedPointer<CaEntry> > getEntries(const QList<int> &entryIdList) const;
+ QList< QSharedPointer<CaEntry> > getEntries(const CaQuery &query) const;
+ QList<int> getEntryIds(const CaQuery &query) const;
+
+ QSharedPointer<CaEntry> createEntry(const CaEntry &entry) const;
+
+ bool removeEntry(int entryId) const;
+ bool removeEntry(const CaEntry &entry) const;
+ bool removeEntries(const QList<int> &entryIdList) const;
+ bool removeEntries(const QList< QSharedPointer<CaEntry> > &entryList) const;
+
+ bool updateEntry(const CaEntry &entry) const;
+ bool touch(const CaEntry &entry) const;
+
+ bool insertEntryIntoGroup(int groupId, int entryId,
+ int beforeEntryId) const;
+ bool insertEntryIntoGroup(const CaEntry &group, const CaEntry &entry,
+ int beforeEntryId) const;
+ bool insertEntriesIntoGroup(int groupId, const QList<int> &entryIdList,
+ int beforeEntryId) const;
+ bool insertEntriesIntoGroup(const CaEntry &group,
+ const QList< QSharedPointer<CaEntry> > &entryList, int beforeEntryId) const;
+
+ bool removeEntryFromGroup(int groupId, int entryId) const;
+ bool removeEntryFromGroup(const CaEntry &group,
+ const CaEntry &entry) const;
+ bool removeEntriesFromGroup(int groupId,
+ const QList<int> &entryIdList) const;
+ bool removeEntriesFromGroup(const CaEntry &group,
+ const QList< QSharedPointer<CaEntry> > &entryList) const;
+
+ bool appendEntryToGroup(int groupId, int entryId) const;
+ bool appendEntryToGroup(const CaEntry &group,
+ const CaEntry &entry) const;
+ bool appendEntriesToGroup(int groupId,
+ const QList<int> &entryIdList) const;
+ bool appendEntriesToGroup(const CaEntry &group,
+ const QList< QSharedPointer<CaEntry> > &entryList) const;
+
+ bool prependEntryToGroup(int groupId, int entryId) const;
+ bool prependEntryToGroup(const CaEntry &group,
+ const CaEntry &entry) const;
+ bool prependEntriesToGroup(int groupId,
+ const QList<int> &entryIdList) const;
+ bool prependEntriesToGroup(const CaEntry &group,
+ const QList< QSharedPointer<CaEntry> > &entryList) const;
+
+ int executeCommand(int entryId, const QString &command =
+ caCmdOpen, QObject* receiver = NULL, const char* member = NULL) const;
+ int executeCommand(const CaEntry &entry, const QString &command =
+ caCmdOpen, QObject* receiver = NULL, const char* member = NULL) const;
+
+ CaNotifier * createNotifier(const CaNotifierFilter &filter) const;
+
+ bool customSort(int groupId, QList<int> &entryIdList) const;
+
+ ErrorCode lastError() const;
+
+signals:
+
+ void entryChanged(int entryId, ChangeType changeType);
+ void entryChanged(const CaEntry &entry, ChangeType changeType);
+ void entryTouched(int id);
+ void groupContentChanged(int groupId);
+
+private:
+
+ /**
+ * Pointer to a private implementation.
+ */
+ CaServicePrivate * const m_d;
+
+ /**
+ * The static pointer to the instance of CaService.
+ */
+ static QWeakPointer<CaService> m_instance;
+
+ friend class CaServicePrivate;
+ friend class QtSharedPointer::ExternalRefCount<CaService>;
+
+ Q_DISABLE_COPY(CaService)
+
+};
+
+
+#endif // CASERVICE_H