blob: 0831b93fc4f93912bf434ff08e698babba512e4d (
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
|
// Copyright 2017 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef COMPONENTS_DOWNLOAD_PUBLIC_COMMON_DOWNLOAD_JOB_H_
#define COMPONENTS_DOWNLOAD_PUBLIC_COMMON_DOWNLOAD_JOB_H_
#include "base/macros.h"
#include "base/memory/weak_ptr.h"
#include "base/time/time.h"
#include "components/download/public/common/download_export.h"
#include "components/download/public/common/download_file.h"
#include "components/download/public/common/download_interrupt_reasons.h"
#include "components/download/public/common/download_request_handle_interface.h"
namespace download {
class DownloadItem;
// DownloadJob lives on UI thread and subclasses implement actual download logic
// and interact with DownloadItem.
// The base class is a friend class of DownloadItem.
class COMPONENTS_DOWNLOAD_EXPORT DownloadJob {
public:
DownloadJob(DownloadItem* download_item,
std::unique_ptr<DownloadRequestHandleInterface> request_handle);
virtual ~DownloadJob();
// Download operations.
// TODO(qinmin): Remove the |callback| and |download_file_| parameter if
// DownloadJob owns download file.
void Start(DownloadFile* download_file_,
DownloadFile::InitializeCallback callback,
const DownloadItem::ReceivedSlices& received_slices);
virtual void Cancel(bool user_cancel);
virtual void Pause();
virtual void Resume(bool resume_request);
bool is_paused() const { return is_paused_; }
// Returns whether the download is parallelizable. The download may not send
// parallel requests as it can be disabled through flags.
virtual bool IsParallelizable() const;
// Cancel a particular request starts from |offset|, while the download is not
// canceled. Used in parallel download.
// TODO(xingliu): Remove this function if download job owns download file.
virtual void CancelRequestWithOffset(int64_t offset);
// Whether the download is save package.
virtual bool IsSavePackageDownload() const;
protected:
// Callback from file thread when we initialize the DownloadFile.
virtual void OnDownloadFileInitialized(
DownloadFile::InitializeCallback callback,
DownloadInterruptReason result,
int64_t bytes_wasted);
// Add an input stream to the download sink. Return false if we start to
// destroy download file.
bool AddInputStream(std::unique_ptr<InputStream> stream,
int64_t offset,
int64_t length);
DownloadItem* download_item_;
// Used to perform operations on network request.
// Can be null on interrupted download.
std::unique_ptr<DownloadRequestHandleInterface> request_handle_;
private:
// If the download progress is paused by the user.
bool is_paused_;
base::WeakPtrFactory<DownloadJob> weak_ptr_factory_{this};
DISALLOW_COPY_AND_ASSIGN(DownloadJob);
};
} // namespace download
#endif // COMPONENTS_DOWNLOAD_PUBLIC_COMMON_DOWNLOAD_JOB_H_
|