File: background_task_impl.h

package info (click to toggle)
chromium 139.0.7258.127-1
  • links: PTS, VCS
  • area: main
  • in suites:
  • size: 6,122,068 kB
  • sloc: cpp: 35,100,771; ansic: 7,163,530; javascript: 4,103,002; python: 1,436,920; asm: 946,517; xml: 746,709; pascal: 187,653; perl: 88,691; sh: 88,436; objc: 79,953; sql: 51,488; cs: 44,583; fortran: 24,137; makefile: 22,147; tcl: 15,277; php: 13,980; yacc: 8,984; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (143 lines) | stat: -rw-r--r-- 4,787 bytes parent folder | download | duplicates (5)
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
133
134
135
136
137
138
139
140
141
142
143
// Copyright 2023 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef COMPONENTS_UNEXPORTABLE_KEYS_BACKGROUND_TASK_IMPL_H_
#define COMPONENTS_UNEXPORTABLE_KEYS_BACKGROUND_TASK_IMPL_H_

#include <optional>

#include "base/functional/callback.h"
#include "base/location.h"
#include "base/memory/scoped_refptr.h"
#include "base/memory/weak_ptr.h"
#include "base/task/sequenced_task_runner.h"
#include "base/time/time.h"
#include "base/timer/elapsed_timer.h"
#include "components/unexportable_keys/background_task.h"
#include "components/unexportable_keys/background_task_priority.h"
#include "components/unexportable_keys/background_task_type.h"

namespace unexportable_keys::internal {

// A template class implementing `BackgroundTask`. Background task is
// represented by a `task_` callback with a specific `ReturnType` that is passed
// from the background thread to a `reply_` callback.
template <typename T>
class BackgroundTaskImpl : public BackgroundTask {
 public:
  using ReturnType = T;

  // `task` is a callback that runs on the background thread and returns a
  // value.
  // `reply` is invoked on the posting thread with the return result of
  // `task` and the number or retries it took to compute this result.
  BackgroundTaskImpl(base::RepeatingCallback<ReturnType()> task,
                     base::OnceCallback<void(ReturnType, size_t)> reply,
                     BackgroundTaskPriority priority,
                     BackgroundTaskType type,
                     size_t max_retries)
      : task_(std::move(task)),
        reply_(std::move(reply)),
        priority_(priority),
        type_(type),
        max_retries_(max_retries) {
    DCHECK(task_);
    DCHECK(reply_);
    scheduled_timer_ = base::ElapsedTimer();
  }
  ~BackgroundTaskImpl() override = default;

  // BackgroundTask:
  void Run(scoped_refptr<base::SequencedTaskRunner> background_task_runner,
           base::OnceCallback<void(BackgroundTask* task)> on_complete_callback)
      override {
    CHECK(!result_.has_value());
    run_timer_ = base::ElapsedTimer();
    background_task_runner->PostTaskAndReplyWithResult(
        FROM_HERE, task_,
        base::BindOnce(&BackgroundTaskImpl::OnTaskComplete,
                       weak_ptr_factory_.GetWeakPtr(),
                       std::move(on_complete_callback)));
  }

  void ReplyWithResult() override {
    CHECK(result_.has_value());
    std::move(reply_).Run(std::move(result_).value(), retries_);
  }

  void ResetStateBeforeRetry() override {
    result_.reset();
    run_timer_.reset();
    scheduled_timer_ = base::ElapsedTimer();
    ++retries_;
  }

  BackgroundTask::Status GetStatus() const override {
    if (run_timer_.has_value()) {
      // `run_timer_` is started just before posting the task.
      return BackgroundTask::Status::kPosted;
    }

    return reply_.IsCancelled() ? BackgroundTask::Status::kCanceled
                                : BackgroundTask::Status::kPending;
  }

  BackgroundTaskPriority GetPriority() const override { return priority_; }

  BackgroundTaskType GetType() const override { return type_; }

  base::TimeDelta GetElapsedTimeSinceScheduled() const override {
    CHECK(scheduled_timer_.has_value());
    return scheduled_timer_->Elapsed();
  }

  std::optional<base::TimeDelta> GetElapsedTimeSinceRun() const override {
    if (run_timer_.has_value()) {
      return run_timer_->Elapsed();
    }
    return std::nullopt;
  }

  size_t GetRetryCount() const override { return retries_; }

  bool ShouldRetry() const override {
    CHECK(result_.has_value());
    return !reply_.IsCancelled() && retries_ < max_retries_ &&
           ShouldRetryBasedOnResult(*result_);
  }

 protected:
  // Allows subclasses to specify whether the task should be retried based on
  // `result`.
  virtual bool ShouldRetryBasedOnResult(const ReturnType& result) const {
    return false;
  }

 private:
  void OnTaskComplete(
      base::OnceCallback<void(BackgroundTask*)> on_complete_callback,
      ReturnType result) {
    result_ = std::move(result);
    std::move(on_complete_callback).Run(this);
    // `this` might be destroyed after running the callback.
  }

  base::RepeatingCallback<ReturnType()> task_;
  base::OnceCallback<void(ReturnType, size_t)> reply_;

  size_t retries_ = 0;
  std::optional<ReturnType> result_;

  const BackgroundTaskPriority priority_;
  const BackgroundTaskType type_;
  const size_t max_retries_;
  std::optional<base::ElapsedTimer> scheduled_timer_;
  std::optional<base::ElapsedTimer> run_timer_;

  base::WeakPtrFactory<BackgroundTaskImpl> weak_ptr_factory_{this};
};

}  // namespace unexportable_keys::internal

#endif  // COMPONENTS_UNEXPORTABLE_KEYS_BACKGROUND_TASK_IMPL_H_