File: start_suggest_service.h

package info (click to toggle)
chromium 138.0.7204.157-1
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 6,071,864 kB
  • sloc: cpp: 34,936,859; ansic: 7,176,967; javascript: 4,110,704; python: 1,419,953; asm: 946,768; xml: 739,967; pascal: 187,324; sh: 89,623; perl: 88,663; objc: 79,944; sql: 50,304; cs: 41,786; fortran: 24,137; makefile: 21,806; php: 13,980; tcl: 13,166; yacc: 8,925; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (118 lines) | stat: -rw-r--r-- 4,346 bytes parent folder | download | duplicates (3)
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
// Copyright 2022 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_SEARCH_START_SUGGEST_SERVICE_H_
#define COMPONENTS_SEARCH_START_SUGGEST_SERVICE_H_

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

#include "base/functional/callback.h"
#include "base/functional/callback_forward.h"
#include "base/memory/raw_ptr.h"
#include "base/memory/weak_ptr.h"
#include "base/observer_list.h"
#include "components/keyed_service/core/keyed_service.h"
#include "components/search_engines/template_url.h"
#include "services/data_decoder/public/cpp/data_decoder.h"
#include "url/gurl.h"

class AutocompleteSchemeClassifier;

class SearchProviderObserver;

class TemplateURLService;

namespace network {
class SimpleURLLoader;
class SharedURLLoaderFactory;
}  // namespace network

class QuerySuggestion {
 public:
  friend bool operator==(const QuerySuggestion&,
                         const QuerySuggestion&) = default;

  // Query suggestion.
  std::u16string query;
  // Destination url of query.
  GURL destination_url;
};

using QuerySuggestions = std::vector<QuerySuggestion>;

// Service that retrieves query suggestions for the Start/NTP surface when
// Google is the default search provider.
class StartSuggestService : public KeyedService {
 public:
  StartSuggestService(
      TemplateURLService* template_url_service,
      scoped_refptr<network::SharedURLLoaderFactory> url_loader_factory,
      std::unique_ptr<AutocompleteSchemeClassifier> scheme_classifier,
      const std::string& application_country,
      const std::string& application_locale,
      const GURL& request_initiator_url);
  ~StartSuggestService() override;
  StartSuggestService(const StartSuggestService&) = delete;
  StartSuggestService& operator=(const StartSuggestService&) = delete;

  using SuggestResultCallback = base::OnceCallback<void(QuerySuggestions)>;
  // If Google is the default search provider, asynchronously requests
  // query suggestions from the server and returns them to the caller in
  // `callback`. If `fetch_from_server` is true, any saved suggestions from a
  // previous fetch are bypassed and a new request will be sent.
  void FetchSuggestions(const TemplateURLRef::SearchTermsArgs& args,
                        SuggestResultCallback callback,
                        bool fetch_from_server = false);

 protected:
  // Called when the default search provider changes.
  void SearchProviderChanged();

  // Returns the server request URL.
  GURL GetRequestURL(const TemplateURLRef::SearchTermsArgs& search_terms_args);
  // Returns the destination url for `query` for `search_provider`.
  GURL GetQueryDestinationURL(const std::u16string& query,
                              const TemplateURL* search_provider);

  virtual SearchProviderObserver* search_provider_observer();

 private:
  // Handles request response from the server.
  void SuggestResponseLoaded(network::SimpleURLLoader* loader,
                             SuggestResultCallback callback,
                             std::unique_ptr<std::string> response);
  void SuggestionsParsed(SuggestResultCallback callback,
                         data_decoder::DataDecoder::ValueOrError result);

  // Cannot be null. Must outlive `this`.
  raw_ptr<TemplateURLService> template_url_service_;
  scoped_refptr<network::SharedURLLoaderFactory> url_loader_factory_;
  std::unique_ptr<AutocompleteSchemeClassifier> scheme_classifier_;

  // The country locale used by this client.
  const std::string application_country_;

  // The language locale used by this client.
  const std::string application_locale_;

  // Indicates what page is initiating the requests by this service.
  const GURL request_initiator_url_;

  // Used to ensure requests are only made if Google is the default search
  // engine.
  std::unique_ptr<SearchProviderObserver> search_provider_observer_;

  // Holds all SimpleURLLoader instances started by this service that have not
  // received responses yet.
  std::vector<std::unique_ptr<network::SimpleURLLoader>> loaders_;

  // Stores last fetched suggestions.
  std::map<std::string, QuerySuggestions> suggestions_cache_;

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

#endif  // COMPONENTS_SEARCH_START_SUGGEST_SERVICE_H_