OLD | NEW |
| (Empty) |
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | |
2 // Use of this source code is governed by a BSD-style license that can be | |
3 // found in the LICENSE file. | |
4 | |
5 #include "chrome/browser/autocomplete/autocomplete_result.h" | |
6 | |
7 #include <algorithm> | |
8 #include <iterator> | |
9 | |
10 #include "base/logging.h" | |
11 #include "base/metrics/histogram.h" | |
12 #include "base/strings/utf_string_conversions.h" | |
13 #include "components/metrics/proto/omnibox_event.pb.h" | |
14 #include "components/metrics/proto/omnibox_input_type.pb.h" | |
15 #include "components/omnibox/autocomplete_input.h" | |
16 #include "components/omnibox/autocomplete_match.h" | |
17 #include "components/omnibox/autocomplete_provider.h" | |
18 #include "components/omnibox/omnibox_field_trial.h" | |
19 #include "components/search/search.h" | |
20 #include "components/url_fixer/url_fixer.h" | |
21 | |
22 using metrics::OmniboxEventProto; | |
23 | |
24 namespace { | |
25 | |
26 // This class implements a special version of AutocompleteMatch::MoreRelevant | |
27 // that allows matches of particular types to be demoted in AutocompleteResult. | |
28 class CompareWithDemoteByType { | |
29 public: | |
30 CompareWithDemoteByType( | |
31 OmniboxEventProto::PageClassification current_page_classification); | |
32 | |
33 // Returns the relevance score of |match| demoted appropriately by | |
34 // |demotions_by_type_|. | |
35 int GetDemotedRelevance(const AutocompleteMatch& match); | |
36 | |
37 // Comparison function. | |
38 bool operator()(const AutocompleteMatch& elem1, | |
39 const AutocompleteMatch& elem2); | |
40 | |
41 private: | |
42 OmniboxFieldTrial::DemotionMultipliers demotions_; | |
43 }; | |
44 | |
45 CompareWithDemoteByType::CompareWithDemoteByType( | |
46 OmniboxEventProto::PageClassification current_page_classification) { | |
47 OmniboxFieldTrial::GetDemotionsByType(current_page_classification, | |
48 &demotions_); | |
49 } | |
50 | |
51 int CompareWithDemoteByType::GetDemotedRelevance( | |
52 const AutocompleteMatch& match) { | |
53 OmniboxFieldTrial::DemotionMultipliers::const_iterator demotion_it = | |
54 demotions_.find(match.type); | |
55 return (demotion_it == demotions_.end()) ? | |
56 match.relevance : (match.relevance * demotion_it->second); | |
57 } | |
58 | |
59 bool CompareWithDemoteByType::operator()(const AutocompleteMatch& elem1, | |
60 const AutocompleteMatch& elem2) { | |
61 // Compute demoted relevance scores for each match. | |
62 const int demoted_relevance1 = GetDemotedRelevance(elem1); | |
63 const int demoted_relevance2 = GetDemotedRelevance(elem2); | |
64 // For equal-relevance matches, we sort alphabetically, so that providers | |
65 // who return multiple elements at the same priority get a "stable" sort | |
66 // across multiple updates. | |
67 return (demoted_relevance1 == demoted_relevance2) ? | |
68 (elem1.contents < elem2.contents) : | |
69 (demoted_relevance1 > demoted_relevance2); | |
70 } | |
71 | |
72 class DestinationSort { | |
73 public: | |
74 DestinationSort( | |
75 OmniboxEventProto::PageClassification current_page_classification); | |
76 bool operator()(const AutocompleteMatch& elem1, | |
77 const AutocompleteMatch& elem2); | |
78 | |
79 private: | |
80 CompareWithDemoteByType demote_by_type_; | |
81 }; | |
82 | |
83 DestinationSort::DestinationSort( | |
84 OmniboxEventProto::PageClassification current_page_classification) : | |
85 demote_by_type_(current_page_classification) {} | |
86 | |
87 bool DestinationSort::operator()(const AutocompleteMatch& elem1, | |
88 const AutocompleteMatch& elem2) { | |
89 // Sort identical destination_urls together. Place the most relevant matches | |
90 // first, so that when we call std::unique(), these are the ones that get | |
91 // preserved. | |
92 if (AutocompleteMatch::DestinationsEqual(elem1, elem2) || | |
93 (elem1.stripped_destination_url.is_empty() && | |
94 elem2.stripped_destination_url.is_empty())) { | |
95 return demote_by_type_(elem1, elem2); | |
96 } | |
97 return elem1.stripped_destination_url < elem2.stripped_destination_url; | |
98 } | |
99 | |
100 // Returns true if |match| is allowed to the default match taking into account | |
101 // whether we're supposed to (and able to) demote all matches with inline | |
102 // autocompletions. | |
103 bool AllowedToBeDefaultMatchAccountingForDisableInliningExperiment( | |
104 const AutocompleteMatch& match, | |
105 const bool has_legal_default_match_without_completion) { | |
106 return match.allowed_to_be_default_match && | |
107 (!OmniboxFieldTrial::DisableInlining() || | |
108 !has_legal_default_match_without_completion || | |
109 match.inline_autocompletion.empty()); | |
110 } | |
111 | |
112 }; // namespace | |
113 | |
114 // static | |
115 const size_t AutocompleteResult::kMaxMatches = 6; | |
116 | |
117 void AutocompleteResult::Selection::Clear() { | |
118 destination_url = GURL(); | |
119 provider_affinity = NULL; | |
120 is_history_what_you_typed_match = false; | |
121 } | |
122 | |
123 AutocompleteResult::AutocompleteResult() { | |
124 // Reserve space for the max number of matches we'll show. | |
125 matches_.reserve(kMaxMatches); | |
126 | |
127 // It's probably safe to do this in the initializer list, but there's little | |
128 // penalty to doing it here and it ensures our object is fully constructed | |
129 // before calling member functions. | |
130 default_match_ = end(); | |
131 } | |
132 | |
133 AutocompleteResult::~AutocompleteResult() {} | |
134 | |
135 void AutocompleteResult::CopyOldMatches( | |
136 const AutocompleteInput& input, | |
137 const AutocompleteResult& old_matches, | |
138 TemplateURLService* template_url_service) { | |
139 if (old_matches.empty()) | |
140 return; | |
141 | |
142 if (empty()) { | |
143 // If we've got no matches we can copy everything from the last result. | |
144 CopyFrom(old_matches); | |
145 for (ACMatches::iterator i(begin()); i != end(); ++i) | |
146 i->from_previous = true; | |
147 return; | |
148 } | |
149 | |
150 // In hopes of providing a stable popup we try to keep the number of matches | |
151 // per provider consistent. Other schemes (such as blindly copying the most | |
152 // relevant matches) typically result in many successive 'What You Typed' | |
153 // results filling all the matches, which looks awful. | |
154 // | |
155 // Instead of starting with the current matches and then adding old matches | |
156 // until we hit our overall limit, we copy enough old matches so that each | |
157 // provider has at least as many as before, and then use SortAndCull() to | |
158 // clamp globally. This way, old high-relevance matches will starve new | |
159 // low-relevance matches, under the assumption that the new matches will | |
160 // ultimately be similar. If the assumption holds, this prevents seeing the | |
161 // new low-relevance match appear and then quickly get pushed off the bottom; | |
162 // if it doesn't, then once the providers are done and we expire the old | |
163 // matches, the new ones will all become visible, so we won't have lost | |
164 // anything permanently. | |
165 ProviderToMatches matches_per_provider, old_matches_per_provider; | |
166 BuildProviderToMatches(&matches_per_provider); | |
167 old_matches.BuildProviderToMatches(&old_matches_per_provider); | |
168 for (ProviderToMatches::const_iterator i(old_matches_per_provider.begin()); | |
169 i != old_matches_per_provider.end(); ++i) { | |
170 MergeMatchesByProvider(input.current_page_classification(), | |
171 i->second, matches_per_provider[i->first]); | |
172 } | |
173 | |
174 SortAndCull(input, template_url_service); | |
175 } | |
176 | |
177 void AutocompleteResult::AppendMatches(const ACMatches& matches) { | |
178 #ifndef NDEBUG | |
179 for (ACMatches::const_iterator i(matches.begin()); i != matches.end(); ++i) { | |
180 DCHECK_EQ(AutocompleteMatch::SanitizeString(i->contents), i->contents); | |
181 DCHECK_EQ(AutocompleteMatch::SanitizeString(i->description), | |
182 i->description); | |
183 } | |
184 #endif | |
185 std::copy(matches.begin(), matches.end(), std::back_inserter(matches_)); | |
186 default_match_ = end(); | |
187 alternate_nav_url_ = GURL(); | |
188 } | |
189 | |
190 void AutocompleteResult::SortAndCull( | |
191 const AutocompleteInput& input, | |
192 TemplateURLService* template_url_service) { | |
193 for (ACMatches::iterator i(matches_.begin()); i != matches_.end(); ++i) | |
194 i->ComputeStrippedDestinationURL(template_url_service); | |
195 | |
196 DedupMatchesByDestination(input.current_page_classification(), true, | |
197 &matches_); | |
198 | |
199 // If the result set has at least one legal default match without an inline | |
200 // autocompletion, then in the disable inlining experiment it will be okay | |
201 // to demote all matches with inline autocompletions. On the other hand, if | |
202 // the experiment is active but there is no legal match without an inline | |
203 // autocompletion, then we'll pretend the experiment is not active and not | |
204 // demote the matches with an inline autocompletion. In other words, an | |
205 // alternate name for this variable is | |
206 // allowed_to_demote_matches_with_inline_autocompletion. | |
207 bool has_legal_default_match_without_completion = false; | |
208 for (AutocompleteResult::iterator it = matches_.begin(); | |
209 (it != matches_.end()) && !has_legal_default_match_without_completion; | |
210 ++it) { | |
211 if (it->allowed_to_be_default_match && it->inline_autocompletion.empty()) | |
212 has_legal_default_match_without_completion = true; | |
213 } | |
214 UMA_HISTOGRAM_BOOLEAN("Omnibox.HasLegalDefaultMatchWithoutCompletion", | |
215 has_legal_default_match_without_completion); | |
216 | |
217 // Sort and trim to the most relevant kMaxMatches matches. | |
218 size_t max_num_matches = std::min(kMaxMatches, matches_.size()); | |
219 CompareWithDemoteByType comparing_object(input.current_page_classification()); | |
220 std::sort(matches_.begin(), matches_.end(), comparing_object); | |
221 if (!matches_.empty() && | |
222 !AllowedToBeDefaultMatchAccountingForDisableInliningExperiment( | |
223 *matches_.begin(), has_legal_default_match_without_completion)) { | |
224 // Top match is not allowed to be the default match. Find the most | |
225 // relevant legal match and shift it to the front. | |
226 for (AutocompleteResult::iterator it = matches_.begin() + 1; | |
227 it != matches_.end(); ++it) { | |
228 if (AllowedToBeDefaultMatchAccountingForDisableInliningExperiment( | |
229 *it, has_legal_default_match_without_completion)) { | |
230 std::rotate(matches_.begin(), it, it + 1); | |
231 break; | |
232 } | |
233 } | |
234 } | |
235 // In the process of trimming, drop all matches with a demoted relevance | |
236 // score of 0. | |
237 size_t num_matches; | |
238 for (num_matches = 0u; (num_matches < max_num_matches) && | |
239 (comparing_object.GetDemotedRelevance(*match_at(num_matches)) > 0); | |
240 ++num_matches) {} | |
241 matches_.resize(num_matches); | |
242 | |
243 default_match_ = matches_.begin(); | |
244 | |
245 if (default_match_ != matches_.end()) { | |
246 const base::string16 debug_info = | |
247 base::ASCIIToUTF16("fill_into_edit=") + | |
248 default_match_->fill_into_edit + | |
249 base::ASCIIToUTF16(", provider=") + | |
250 ((default_match_->provider != NULL) | |
251 ? base::ASCIIToUTF16(default_match_->provider->GetName()) | |
252 : base::string16()) + | |
253 base::ASCIIToUTF16(", input=") + | |
254 input.text(); | |
255 DCHECK(default_match_->allowed_to_be_default_match) << debug_info; | |
256 // If the default match is valid (i.e., not a prompt/placeholder), make | |
257 // sure the type of destination is what the user would expect given the | |
258 // input. | |
259 if (default_match_->destination_url.is_valid()) { | |
260 // We shouldn't get query matches for URL inputs, or non-query matches | |
261 // for query inputs. | |
262 if (AutocompleteMatch::IsSearchType(default_match_->type)) { | |
263 DCHECK_NE(metrics::OmniboxInputType::URL, input.type()) << debug_info; | |
264 } else { | |
265 DCHECK_NE(metrics::OmniboxInputType::FORCED_QUERY, input.type()) | |
266 << debug_info; | |
267 // If the user explicitly typed a scheme, the default match should | |
268 // have the same scheme. | |
269 if ((input.type() == metrics::OmniboxInputType::URL) && | |
270 input.parts().scheme.is_nonempty()) { | |
271 const std::string& in_scheme = base::UTF16ToUTF8(input.scheme()); | |
272 const std::string& dest_scheme = | |
273 default_match_->destination_url.scheme(); | |
274 DCHECK(url_fixer::IsEquivalentScheme(in_scheme, dest_scheme)) | |
275 << debug_info; | |
276 } | |
277 } | |
278 } | |
279 } | |
280 | |
281 // Set the alternate nav URL. | |
282 alternate_nav_url_ = (default_match_ == matches_.end()) ? | |
283 GURL() : ComputeAlternateNavUrl(input, *default_match_); | |
284 } | |
285 | |
286 bool AutocompleteResult::HasCopiedMatches() const { | |
287 for (ACMatches::const_iterator i(begin()); i != end(); ++i) { | |
288 if (i->from_previous) | |
289 return true; | |
290 } | |
291 return false; | |
292 } | |
293 | |
294 size_t AutocompleteResult::size() const { | |
295 return matches_.size(); | |
296 } | |
297 | |
298 bool AutocompleteResult::empty() const { | |
299 return matches_.empty(); | |
300 } | |
301 | |
302 AutocompleteResult::const_iterator AutocompleteResult::begin() const { | |
303 return matches_.begin(); | |
304 } | |
305 | |
306 AutocompleteResult::iterator AutocompleteResult::begin() { | |
307 return matches_.begin(); | |
308 } | |
309 | |
310 AutocompleteResult::const_iterator AutocompleteResult::end() const { | |
311 return matches_.end(); | |
312 } | |
313 | |
314 AutocompleteResult::iterator AutocompleteResult::end() { | |
315 return matches_.end(); | |
316 } | |
317 | |
318 // Returns the match at the given index. | |
319 const AutocompleteMatch& AutocompleteResult::match_at(size_t index) const { | |
320 DCHECK_LT(index, matches_.size()); | |
321 return matches_[index]; | |
322 } | |
323 | |
324 AutocompleteMatch* AutocompleteResult::match_at(size_t index) { | |
325 DCHECK_LT(index, matches_.size()); | |
326 return &matches_[index]; | |
327 } | |
328 | |
329 bool AutocompleteResult::ShouldHideTopMatch() const { | |
330 return chrome::ShouldHideTopVerbatimMatch() && | |
331 TopMatchIsStandaloneVerbatimMatch(); | |
332 } | |
333 | |
334 bool AutocompleteResult::TopMatchIsStandaloneVerbatimMatch() const { | |
335 if (empty() || !match_at(0).IsVerbatimType()) | |
336 return false; | |
337 | |
338 // Skip any copied matches, under the assumption that they'll be expired and | |
339 // disappear. We don't want this disappearance to cause the visibility of the | |
340 // top match to change. | |
341 for (const_iterator i(begin() + 1); i != end(); ++i) { | |
342 if (!i->from_previous) | |
343 return !i->IsVerbatimType(); | |
344 } | |
345 return true; | |
346 } | |
347 | |
348 void AutocompleteResult::Reset() { | |
349 matches_.clear(); | |
350 default_match_ = end(); | |
351 } | |
352 | |
353 void AutocompleteResult::Swap(AutocompleteResult* other) { | |
354 const size_t default_match_offset = default_match_ - begin(); | |
355 const size_t other_default_match_offset = | |
356 other->default_match_ - other->begin(); | |
357 matches_.swap(other->matches_); | |
358 default_match_ = begin() + other_default_match_offset; | |
359 other->default_match_ = other->begin() + default_match_offset; | |
360 alternate_nav_url_.Swap(&(other->alternate_nav_url_)); | |
361 } | |
362 | |
363 #ifndef NDEBUG | |
364 void AutocompleteResult::Validate() const { | |
365 for (const_iterator i(begin()); i != end(); ++i) | |
366 i->Validate(); | |
367 } | |
368 #endif | |
369 | |
370 // static | |
371 GURL AutocompleteResult::ComputeAlternateNavUrl( | |
372 const AutocompleteInput& input, | |
373 const AutocompleteMatch& match) { | |
374 return ((input.type() == metrics::OmniboxInputType::UNKNOWN) && | |
375 (AutocompleteMatch::IsSearchType(match.type)) && | |
376 (match.transition != content::PAGE_TRANSITION_KEYWORD) && | |
377 (input.canonicalized_url() != match.destination_url)) ? | |
378 input.canonicalized_url() : GURL(); | |
379 } | |
380 | |
381 void AutocompleteResult::DedupMatchesByDestination( | |
382 OmniboxEventProto::PageClassification page_classification, | |
383 bool set_duplicate_matches, | |
384 ACMatches* matches) { | |
385 DestinationSort destination_sort(page_classification); | |
386 // Sort matches such that duplicate matches are consecutive. | |
387 std::sort(matches->begin(), matches->end(), destination_sort); | |
388 | |
389 if (set_duplicate_matches) { | |
390 // Set duplicate_matches for the first match before erasing duplicate | |
391 // matches. | |
392 for (ACMatches::iterator i(matches->begin()); i != matches->end(); ++i) { | |
393 for (int j = 1; (i + j != matches->end()) && | |
394 AutocompleteMatch::DestinationsEqual(*i, *(i + j)); ++j) { | |
395 AutocompleteMatch& dup_match(*(i + j)); | |
396 i->duplicate_matches.insert(i->duplicate_matches.end(), | |
397 dup_match.duplicate_matches.begin(), | |
398 dup_match.duplicate_matches.end()); | |
399 dup_match.duplicate_matches.clear(); | |
400 i->duplicate_matches.push_back(dup_match); | |
401 } | |
402 } | |
403 } | |
404 | |
405 // Erase duplicate matches. | |
406 matches->erase(std::unique(matches->begin(), matches->end(), | |
407 &AutocompleteMatch::DestinationsEqual), | |
408 matches->end()); | |
409 } | |
410 | |
411 void AutocompleteResult::CopyFrom(const AutocompleteResult& rhs) { | |
412 if (this == &rhs) | |
413 return; | |
414 | |
415 matches_ = rhs.matches_; | |
416 // Careful! You can't just copy iterators from another container, you have to | |
417 // reconstruct them. | |
418 default_match_ = (rhs.default_match_ == rhs.end()) ? | |
419 end() : (begin() + (rhs.default_match_ - rhs.begin())); | |
420 | |
421 alternate_nav_url_ = rhs.alternate_nav_url_; | |
422 } | |
423 | |
424 void AutocompleteResult::BuildProviderToMatches( | |
425 ProviderToMatches* provider_to_matches) const { | |
426 for (ACMatches::const_iterator i(begin()); i != end(); ++i) | |
427 (*provider_to_matches)[i->provider].push_back(*i); | |
428 } | |
429 | |
430 // static | |
431 bool AutocompleteResult::HasMatchByDestination(const AutocompleteMatch& match, | |
432 const ACMatches& matches) { | |
433 for (ACMatches::const_iterator i(matches.begin()); i != matches.end(); ++i) { | |
434 if (i->destination_url == match.destination_url) | |
435 return true; | |
436 } | |
437 return false; | |
438 } | |
439 | |
440 void AutocompleteResult::MergeMatchesByProvider( | |
441 OmniboxEventProto::PageClassification page_classification, | |
442 const ACMatches& old_matches, | |
443 const ACMatches& new_matches) { | |
444 if (new_matches.size() >= old_matches.size()) | |
445 return; | |
446 | |
447 size_t delta = old_matches.size() - new_matches.size(); | |
448 const int max_relevance = (new_matches.empty() ? | |
449 matches_.front().relevance : new_matches[0].relevance) - 1; | |
450 // Because the goal is a visibly-stable popup, rather than one that preserves | |
451 // the highest-relevance matches, we copy in the lowest-relevance matches | |
452 // first. This means that within each provider's "group" of matches, any | |
453 // synchronous matches (which tend to have the highest scores) will | |
454 // "overwrite" the initial matches from that provider's previous results, | |
455 // minimally disturbing the rest of the matches. | |
456 for (ACMatches::const_reverse_iterator i(old_matches.rbegin()); | |
457 i != old_matches.rend() && delta > 0; ++i) { | |
458 if (!HasMatchByDestination(*i, new_matches)) { | |
459 AutocompleteMatch match = *i; | |
460 match.relevance = std::min(max_relevance, match.relevance); | |
461 match.from_previous = true; | |
462 matches_.push_back(match); | |
463 delta--; | |
464 } | |
465 } | |
466 } | |
OLD | NEW |