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
|
//
// This file is part of the Marble Virtual Globe.
//
// This program is free software licensed under the GNU LGPL. You can
// find a copy of this license in LICENSE.txt in the top directory of
// the source code.
//
// Copyright 2007 Torsten Rahn <tackat@kde.org>
// Copyright 2007 Inge Wallin <ingwa@kde.org>
// Copyright 2009 Jens-Michael Hoffmann <jensmh@gmx.de>
//
//
// The HttpDownloadManager manages http downloads.
//
#ifndef MARBLE_HTTPDOWNLOADMANAGER_H
#define MARBLE_HTTPDOWNLOADMANAGER_H
#include <QObject>
#include "MarbleGlobal.h"
#include "marble_export.h"
class QUrl;
namespace Marble
{
class DownloadPolicy;
class StoragePolicy;
/**
* @Short This class manages scheduled downloads.
* The downloadmanager offers a maximum number of active jobs and a
* limit for pending jobs. it also takes care that the job queue
* won't be polluted by jobs that timed out already.
*
* @author Torsten Rahn
*/
class MARBLE_EXPORT HttpDownloadManager : public QObject
{
Q_OBJECT
public:
/**
* Creates a new http download manager.
*
* @note HttpDownloadManager doesn't take ownership of @p policy.
*
* @param policy The storage policy for this manager.
*/
explicit HttpDownloadManager( StoragePolicy *policy );
/**
* Destroys the http download manager.
*/
~HttpDownloadManager() override;
/**
* Switches loading on/off, useful for offline mode.
*/
void setDownloadEnabled( const bool enable );
void addDownloadPolicy( const DownloadPolicy& );
static QByteArray userAgent(const QString &platform, const QString &plugin);
public Q_SLOTS:
/**
* Adds a new job with a sourceUrl, destination file name and given id.
*/
void addJob( const QUrl& sourceUrl, const QString& destFilename, const QString &id,
const DownloadUsage usage );
Q_SIGNALS:
void downloadComplete( const QString&, const QString& );
/**
* This signal is emitted if a file is downloaded and the data argument
* contains the files content. The HttpDownloadManager takes care to save
* it using the given storage policy.
*/
void downloadComplete( const QByteArray &data, const QString& initiatorId );
/**
* Signal is emitted when a new job is added to the queue.
*/
void jobAdded();
/**
* Signal is emitted when a job is removed from the queue.
* The job might be completed or blacklisted.
*/
void jobRemoved();
/**
* A job was queued, activated or removed (finished, failed)
*/
void progressChanged( int active, int queued );
private:
Q_DISABLE_COPY( HttpDownloadManager )
class Private;
Private * const d;
Q_PRIVATE_SLOT( d, void finishJob( const QByteArray&, const QString&, const QString& id ) )
Q_PRIVATE_SLOT( d, void requeue() )
Q_PRIVATE_SLOT( d, void startRetryTimer() )
};
}
#endif // MARBLE_HTTPDOWNLOADMANAGER_H
|
