chromeos/components/local_search_service/index_sync.h

// Copyright 2019 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 CHROMEOS_COMPONENTS_LOCAL_SEARCH_SERVICE_INDEX_SYNC_H_
#define CHROMEOS_COMPONENTS_LOCAL_SEARCH_SERVICE_INDEX_SYNC_H_

#include <map>
#include <memory>
#include <string>
#include <vector>

#include "base/macros.h"
#include "base/memory/weak_ptr.h"
#include "base/optional.h"
#include "base/strings/string16.h"
#include "base/time/time.h"
#include "chromeos/components/local_search_service/search_metrics_reporter_sync.h"
#include "chromeos/components/local_search_service/shared_structs.h"

class PrefService;

namespace chromeos {
namespace local_search_service {

// A local search service IndexSync.
// It is the client-facing API for search and indexing. It can be implemented
// with different backends that provide actual data storage/indexing/search
// functions.
class IndexSync {
 public:
  IndexSync(IndexId index_id, Backend backend, PrefService* local_state);
  virtual ~IndexSync();

  IndexSync(const IndexSync&) = delete;
  IndexSync& operator=(const IndexSync&) = delete;

  // Returns number of data items.
  virtual uint64_t GetSizeSync() = 0;

  // Adds or updates data.
  // IDs of data should not be empty.
  virtual void AddOrUpdateSync(const std::vector<Data>& data) = 0;

  // Deletes data with |ids| and returns number of items deleted.
  // If an id doesn't exist in the Index, no operation will be done.
  // IDs should not be empty.
  virtual uint32_t DeleteSync(const std::vector<std::string>& ids) = 0;

  // Clears all data in the index.
  virtual void ClearIndexSync() = 0;

  // Returns matching results for a given query.
  // Zero |max_results| means no max.
  // Search behaviour depends on the implementation.
  virtual ResponseStatus FindSync(const base::string16& query,
                                  uint32_t max_results,
                                  std::vector<Result>* results) = 0;

  // Logs daily search metrics if |reporter_| is non-null. Also logs other
  // UMA metrics (number results and search latency).
  // Each implementation of this class should call this method at the end of
  // Find.
  void MaybeLogSearchResultsStatsSync(ResponseStatus status,
                                      size_t num_results,
                                      base::TimeDelta latency);

  // Logs number of documents in the index if the index is not empty.
  // Each implementation of this class should call this method at the end of
  // Find.
  void MaybeLogIndexSizeSync();

  void SetSearchParams(const SearchParams& search_params);
  SearchParams GetSearchParamsForTesting();

 protected:
  SearchParams search_params_;

 private:
  std::string histogram_prefix_;
  std::unique_ptr<SearchMetricsReporterSync> reporter_;
  base::WeakPtrFactory<IndexSync> weak_ptr_factory_{this};
};

}  // namespace local_search_service
}  // namespace chromeos

#endif  // CHROMEOS_COMPONENTS_LOCAL_SEARCH_SERVICE_INDEX_SYNC_H_