blob: d6648437cab04693c4f676cd67c5a7eb995b8fe2 [file] [log] [blame]
// Copyright 2021 The Chromium OS 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 <utility>
#include <base/callback.h>
#include <base/memory/ref_counted.h>
#include <base/memory/scoped_refptr.h>
#include "missive/proto/record.pb.h"
#include "missive/proto/record_constants.pb.h"
#include "missive/util/status.h"
namespace reporting {
class StorageModuleInterface
: public base::RefCountedThreadSafe<StorageModuleInterface> {
StorageModuleInterface(const StorageModuleInterface& other) = delete;
StorageModuleInterface& operator=(const StorageModuleInterface& other) =
// AddRecord will add |record| (taking ownership) to the
// |StorageModuleInterface| according to the provided |priority|. On
// completion, |callback| is called.
virtual void AddRecord(Priority priority,
Record record,
base::OnceCallback<void(Status)> callback) = 0;
// Initiates upload of collected records according to the priority.
// Called usually for a queue with an infinite or very large upload period.
// Multiple |Flush| calls can safely run in parallel.
// Returns error if cannot start upload.
virtual void Flush(Priority priority,
base::OnceCallback<void(Status)> callback) = 0;
// Once a record has been successfully uploaded, the sequencing information
// can be passed back to the StorageModuleInterface here for record deletion.
// If |force| is false (which is used in most cases), |sequencing_information|
// only affects Storage if no higher sequeincing was confirmed before;
// otherwise it is accepted unconditionally.
virtual void ReportSuccess(SequencingInformation sequencing_information,
bool force) = 0;
// If the server attached signed encryption key to the response, it needs to
// be paased here.
virtual void UpdateEncryptionKey(
SignedEncryptionInfo signed_encryption_key) = 0;
// Constructor can only be called by |Create| factory method.
// Refcounted object must have destructor declared protected or private.
virtual ~StorageModuleInterface();
friend base::RefCountedThreadSafe<StorageModuleInterface>;
} // namespace reporting