blob: 70a27e74ef095fdc3a6caf0a9b39c960caba571c [file] [log] [blame]
// Copyright 2016 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.
#include "base/macros.h"
#include "base/time/time.h"
namespace ntp_snippets {
// Interface to schedule persistent periodic fetches for remote suggestions, OS-
// dependent. These persistent fetches must get triggered according to their
// schedule independent of whether Chrome is running at that moment.
// Once per period, the concrete implementation should call
// RemoteSuggestionsScheduler::OnFetchDue() where the scheduler object is
// obtained from ContentSuggestionsService.
// The implementation may also call
// RemoteSuggestionsScheduler::RescheduleFetching() when its own current
// schedule got corrupted for whatever reason and needs to be applied again
// (in turn, this will result in calling Schedule() on the implementation).
class PersistentScheduler {
// Schedule periodic fetching of remote suggestions, with different periods
// depending on network state. Any of the periods can be zero to indicate that
// the corresponding task should not be scheduled. Returns whether the
// scheduling was successful.
virtual bool Schedule(base::TimeDelta period_wifi,
base::TimeDelta period_fallback) = 0;
// Cancel any scheduled tasks. Equivalent to Schedule(0, 0). Returns whether
// the scheduling was successful.
virtual bool Unschedule() = 0;
PersistentScheduler() = default;
} // namespace ntp_snippets