/*
 * 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