summaryrefslogtreecommitdiff
path: root/src/download.h
blob: 83a01b5945806a32e85d28934dcec77ab485c418 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
/* ============================================================
*
* This file is a part of the rekonq project
*
* Copyright (C) 2007 Lukas Appelhans <l.appelhans@gmx.de>
* Copyright (C) 2008-2009 by Andrea Diamantini <adjam7 at gmail dot com>
* Copyright (C) 2009 by Paweł Prażak <pawelprazak at gmail dot com>
* Copyright (C) 2009 by Domrachev Alexandr <alexandr.domrachev@gmail.com>
*
*
* This program is free software; you can redistribute it
* and/or modify it under the terms of the GNU General
* Public License as published by the Free Software Foundation;
* either version 2, or (at your option) any later version.
*
* 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 General Public License for more details.
*
* ============================================================ */


#ifndef DOWNLOAD_H
#define DOWNLOAD_H

// Auto Includes
#include "rekonq.h"

// KDE Includes
#include <KIO/FileCopyJob>

// Qt Includes
#include <QObject>

// Forward Declarations
class KJob;

namespace KIO
{
    class Job;
}


/**
 * This class lets rekonq to download an object from the network.
 * Creating a new object, you can continue downloading a file also
 * when rekonq is closed.
 *
 */
class Download : public QObject
{
    Q_OBJECT
    
public:
    enum DownloadType { Save, Open };
    
    /**
     * Class constructor. This is the unique method we need to
     * use this class. In fact Download class needs to know just
     * "where" catch the file to download and where it has to put it
     *
     * @param srcUrl the source url
     * @param destUrl the destination url
     *
     */
    Download(const KUrl &srcUrl, const KUrl &destUrl, DownloadType type);

    /**
     * class destructor
     */
    ~Download();

    KUrl srcUrl() const { return m_srcUrl; }
    KUrl destUrl() const { return m_destUrl; }
    DownloadType type() const { return m_type; }
    void cancel();

signals:
    void downloadFinished(int errorCode);

private slots:
    void slotResult(KJob *job);

private:
    KIO::FileCopyJob *m_copyJob;
    KUrl m_srcUrl;
    KUrl m_destUrl;
    KUrl m_destFile;
    QByteArray m_data;
    DownloadType m_type;
};


// ----------------------


class DownloadManager : public QObject
{
    Q_OBJECT
    
public:
    DownloadManager();
    ~DownloadManager();
    
    /**
    * @short Creates new download job.
    * This method lets you to download a file from a remote source url
    * to a local destination url.
    *
    * @param srcUrl the source url
    * @param destUrl the destination url (default value is your default download destination setting)
    *
    */
    void newDownload(const KUrl &srcUrl, const KUrl &destUrl = KUrl());

    const QList<Download *> &downloads() const;
    
public slots:
    void slotDownloadFinished(int errorCode);

private:
    KUrl downloadDestination(const QString &filename);
    
    QList<Download *> m_downloads;
};


//--


#endif