components/persistent_cache/sqlite/sqlite_entry_impl.h

// Copyright 2025 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_PERSISTENT_CACHE_SQLITE_SQLITE_ENTRY_IMPL_H_
#define COMPONENTS_PERSISTENT_CACHE_SQLITE_SQLITE_ENTRY_IMPL_H_

#include <cstdint>

#include "base/component_export.h"
#include "base/gtest_prod_util.h"
#include "components/persistent_cache/entry.h"

namespace persistent_cache {

class COMPONENT_EXPORT(PERSISTENT_CACHE) SqliteEntryImpl : public Entry {
 public:
  ~SqliteEntryImpl() override;

  // Entry:
  [[nodiscard]] base::span<const uint8_t> GetContentSpan() const override;

 private:
  FRIEND_TEST_ALL_PREFIXES(SqliteEntryTest, ConstructionTakesOwnershipOfValue);
  FRIEND_TEST_ALL_PREFIXES(SqliteEntryTest,
                           ConstructionFromEmptyValueLeadsToEmptyEntry);

  // Private constructor and destructor because entry creation should be left
  // to the associated backend.
  //
  // Takes ownership of `content`. Only this constructor is defined to avoid
  // unwanted copies as much as possible. There is precedent for copies coming
  // from disk caches leading to OOMs and this class tries to avoid the
  // situation.
  explicit SqliteEntryImpl(std::string&& content);

  std::string content_;
};

}  // namespace persistent_cache

#endif  // COMPONENTS_PERSISTENT_CACHE_SQLITE_SQLITE_ENTRY_IMPL_H_