/**

   This file is part of CWRT package **

   Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies). **

   This program is free software: you can redistribute it and/or modify

   it under the terms of the GNU (Lesser) General Public License as 

   published by the Free Software Foundation, version 2.1 of the License. 

   This program is distributed in the hope that it will be useful, but

   WITHOUT ANY WARRANTY; without even the implied warranty of 

   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 

   (Lesser) General Public License for more details. You should have 

   received a copy of the GNU (Lesser) General Public License along 

   with this program. If not, see <http://www.gnu.org/licenses/>.

*/

#ifndef DOWNLOADMANAGER_H

#define DOWNLOADMANAGER_H

#include "dmcommon.h"

#include "dmpimpl.h"

#include "downloadevent.h"

#include <QObject>

#ifndef DOWNLOAD_MGR_EXPORT

# ifdef BUILD_DOWNLOAD_MGR_LIB

#  define DOWNLOAD_MGR_EXPORT Q_DECL_EXPORT

# else

#  define DOWNLOAD_MGR_EXPORT Q_DECL_IMPORT

# endif

#endif

// forward declarations

class Download;

class QNetworkReply; 

class QNetworkProxy;

class DownloadInfo;

class DownloadCoreManager;

class BackgroundDownloadManager;

class DownloadManagerPrivate;

class SequentialDownloadManager;

// class declaration

class DownloadManager

{

    DM_DECLARE_PRIVATE(DownloadManager); // private implementation

public:

    DOWNLOAD_MGR_EXPORT DownloadManager(const QString& clientName);

    DOWNLOAD_MGR_EXPORT virtual ~DownloadManager();

    // to initialise all the downloads which belongs to last

    // download manager session

    DOWNLOAD_MGR_EXPORT void init();

    // creates new download by passing url

    DOWNLOAD_MGR_EXPORT Download* createDownload(const QString& url, DownloadType type = Parallel, DownloadScope scope = Normal);

    // creates a download by passing network reply

    DOWNLOAD_MGR_EXPORT Download* createDownload(QNetworkReply *reply);    

    // sets the proxy

    DOWNLOAD_MGR_EXPORT void setProxy(const QString& proxyServer, int port);

    // registers event listener

    DOWNLOAD_MGR_EXPORT void registerEventReceiver(QObject *receiver);

    // unregister event listener

    DOWNLOAD_MGR_EXPORT void unregisterEventReceiver(QObject *receiver);

    // sets download manager attributes

    DOWNLOAD_MGR_EXPORT int setAttribute(DownloadManagerAttribute attr, const QVariant& value);

    // fetches download manager attributes

    DOWNLOAD_MGR_EXPORT QVariant getAttribute(DownloadManagerAttribute attr);

    // returns all the current downloads

    DOWNLOAD_MGR_EXPORT QList<Download *>& currentDownloads();

    // finds a download provided id if exists

    DOWNLOAD_MGR_EXPORT Download* findDownload(int dlId);

    // cancels all the downloads and removes from the list

    DOWNLOAD_MGR_EXPORT void removeAll();

    // cancels and removes the download from list

    DOWNLOAD_MGR_EXPORT void removeOne(Download *dl);

    // pauses all the downloads which are in progress

    DOWNLOAD_MGR_EXPORT void pauseAll();

    // resumes all the downloads which are paused

    DOWNLOAD_MGR_EXPORT void resumeAll();

    // returns the network proxy

    DOWNLOAD_MGR_EXPORT QNetworkProxy* proxy();

    // returns downloadinfo object

    DownloadInfo* downloadInfo();

    // returns downloadcoremanager object

    DownloadCoreManager* downloadCoreManager();

    // returns sequentialmanager object

    SequentialDownloadManager* sequentialManager();

    // returns background download manager object

    BackgroundDownloadManager* backgroundManager();

    // post the events

    void postEvent(DEventType type, DlManagerEventAttributeMap* attrMap);

private:

    // creates download by passing id

    // used while loading the saved downloads

    Download* createDownload(int dlId, DownloadScope scope);

    // loads the saved downloads

    void loadAllDownloads();

    // generated unique id for download

    long generateDlId();

};

#endif