/*

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

 *

 */

#ifndef CACLIENTNOTIFIERPROXY_H

#define CACLIENTNOTIFIERPROXY_H

#include <QObject>

#include <QMutex>

#include "caclient_global.h"

#include "cadefs.h"

#include "canotifier_p.h"

class CaEntry;

class CaNotifierFilter;

/**

 *  IDataObserver

 *

 */

class IDataObserver

{

public:

    /**

     * Method invoked when entry is changed.

     * @param entryId entry id.

     * @param changeType change type.

     */

    virtual void entryChanged(int entryId,

                              ChangeType changeType) const = 0;

    /**

     * Method invoked when entry is changed.

     * @param entry entry.

     * @param changeType change type.

     */

    virtual void entryChanged(const CaEntry &entry,

                              ChangeType changeType) const = 0;

    /**

     * Method invoked when entry was changed.

     * @param entryId entry id.

     */

    virtual void entryTouched(int id) const = 0;

    /**

     * Method invoked when entry was changed.

     * @param groupId group id.

     */

    virtual void groupContentChanged(int groupId) const = 0;

};

class CACLIENT_EXPORT CaClientNotifierProxy: public QObject

{

    Q_OBJECT

public:

    /**

     * Constructor.

     * @param parent pointer to parent. Defaults to NULL.

     */

    explicit CaClientNotifierProxy(QObject *parent = 0);

    /**

     * Destructor.

     */

    ~CaClientNotifierProxy();

    /**

     * Method invoked when entry is changed.

     * @param entryId entry id.

     * @param changeType change type.

     */

    virtual void entryChanged(int entryId, ChangeType changeType) const;

    /**

     * Method invoked when entry is changed.

     * @param entry entry.

     * @param changeType change type.

     */

    virtual void entryChanged(const CaEntry &entry,

                              ChangeType changeType) const;

    /**

     * Method invoked when entry was changed.

     * @param entryId entry id.

     */

    virtual void entryTouched(int id) const;

    /**

     * Method invoked when entry was changed.

     * @param groupId group id.

     */

    virtual void groupContentChanged(int groupId) const;

    /**

     * Method for registering notifier

     *

     * @param notifierFilter notifierFilter used to register notifier.

     * @param notifierType type of notifier

     * @return error code

     */

    int registerNotifier(

        const CaNotifierFilter *notifierFilter,

        CaNotifierPrivate::NotifierType notifierType,

        const CaClientNotifierProxy *notifierProxy);

    /**

     * Method for unregistering notifier.

     *

     * @param notifierFilter notifierFilter used to unregister notifier.

     * @param notifierType type of notifier

     */

    void unregisterNotifier(

        const CaNotifierFilter &notifierFilter,

        CaNotifierPrivate::NotifierType notifierType);

signals:

    void signalEntryChanged(int entryId, ChangeType changeType) const;

    void signalEntryChanged(const CaEntry &entry,

                            ChangeType changeType) const;

    void signalEntryTouched(int id) const;

    void signalGroupContentChanged(int groupId) const;

private:

    // Mutex to serialize registering/unregistering for notifications.

    QMutex mMutex;

    Q_DISABLE_COPY(CaClientNotifierProxy)

};

#endif //_CACLIENTNOTIFIERPROXY_H