Marble::DownloadQueueSet Class Reference

#include <DownloadQueueSet.h>

Inheritance diagram for Marble::DownloadQueueSet:

Signals
void	jobAdded ()
void	jobFinished (const QByteArray &data, const QString &destinationFileName, const QString &id)
void	jobRedirected (const QUrl &newSourceUrl, const QString &destinationFileName, const QString &id, DownloadUsage)
void	jobRemoved ()
void	jobRetry ()
void	progressChanged (int active, int queued)

Public Member Functions
	DownloadQueueSet (QObject *const parent=0)
	DownloadQueueSet (const DownloadPolicy &policy, QObject *const parent=0)
	~DownloadQueueSet ()
void	activateJobs ()
void	addJob (HttpJob *const job)
bool	canAcceptJob (const QUrl &sourceUrl, const QString &destinationFileName) const
DownloadPolicy	downloadPolicy () const
void	purgeJobs ()
void	retryJobs ()
void	setDownloadPolicy (const DownloadPolicy &)

Detailed Description

Life of a HttpJob

• Job is added to the QueueSet (by calling addJob() ) the HttpJob is put into the m_jobQueue where it waits for "activation" signal jobAdded is emitted
• Job is activated Job is moved from m_jobQueue to m_activeJobs and signals of the job are connected to slots (local or HttpDownloadManager) Job is executed by calling the jobs execute() method

now there are different possibilities: 1) Job emits jobDone (some error occurred, or canceled (kio)) Job is disconnected signal jobRemoved is emitted Job is either moved from m_activeJobs to m_retryQueue or destroyed and blacklisted

2) Job emits redirected Job is removed from m_activeJobs, disconnected and destroyed signal jobRemoved is emitted (HttpDownloadManager creates new Job with new source url)

3) Job emits dataReceived Job is removed from m_activeJobs, disconnected and destroyed signal jobRemoved is emitted

so we can conclude following rules:

• Job is only connected to signals when in "active" state

questions:

• update of initiatorId needed? "We update the initiatorId as the previous initiator likely doesn't exist anymore"
• blacklist or black list?

Definition at line 72 of file DownloadQueueSet.h.

Constructor & Destructor Documentation

Marble::DownloadQueueSet::DownloadQueueSet ( QObject *const  parent = 0 )

explicit

Definition at line 25 of file DownloadQueueSet.cpp.

Marble::DownloadQueueSet::DownloadQueueSet ( const DownloadPolicy &  policy, QObject *const  parent = 0  )

explicit

Definition at line 30 of file DownloadQueueSet.cpp.

Marble::DownloadQueueSet::~DownloadQueueSet

(

)

Definition at line 36 of file DownloadQueueSet.cpp.

Member Function Documentation

void Marble::DownloadQueueSet::activateJobs

(

)

Definition at line 85 of file DownloadQueueSet.cpp.

void Marble::DownloadQueueSet::addJob

(

HttpJob *const

job

)

Definition at line 76 of file DownloadQueueSet.cpp.

bool Marble::DownloadQueueSet::canAcceptJob	(	const QUrl &	sourceUrl,
		const QString &	destinationFileName
	)		const

Definition at line 51 of file DownloadQueueSet.cpp.

DownloadPolicy Marble::DownloadQueueSet::downloadPolicy

(

)

const

Definition at line 41 of file DownloadQueueSet.cpp.

void Marble::DownloadQueueSet::jobAdded ( )

signal

void Marble::DownloadQueueSet::jobFinished ( const QByteArray &  data, const QString &  destinationFileName, const QString &  id  )

signal

void Marble::DownloadQueueSet::jobRedirected ( const QUrl &  newSourceUrl, const QString &  destinationFileName, const QString &  id, DownloadUsage    )

signal

void Marble::DownloadQueueSet::jobRemoved ( )

signal

void Marble::DownloadQueueSet::jobRetry ( )

signal

void Marble::DownloadQueueSet::progressChanged ( int  active, int  queued  )

signal

void Marble::DownloadQueueSet::purgeJobs

(

)

Definition at line 105 of file DownloadQueueSet.cpp.

void Marble::DownloadQueueSet::retryJobs

(

)

Definition at line 95 of file DownloadQueueSet.cpp.

void Marble::DownloadQueueSet::setDownloadPolicy

(

const DownloadPolicy &

policy

)

Definition at line 46 of file DownloadQueueSet.cpp.

---

The documentation for this class was generated from the following files:

• DownloadQueueSet.h
• DownloadQueueSet.cpp