OLD | NEW |
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 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 | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 // | 4 // |
5 // This file contains the keyword autocomplete provider. The keyword provider | 5 // This file contains the keyword autocomplete provider. The keyword provider |
6 // is responsible for remembering/suggesting user "search keyword queries" | 6 // is responsible for remembering/suggesting user "search keyword queries" |
7 // (e.g. "imdb Godzilla") and then fixing them up into valid URLs. An | 7 // (e.g. "imdb Godzilla") and then fixing them up into valid URLs. An |
8 // instance of it gets created and managed by the autocomplete controller. | 8 // instance of it gets created and managed by the autocomplete controller. |
9 // KeywordProvider uses a TemplateURLService to find the set of keywords. | 9 // KeywordProvider uses a TemplateURLService to find the set of keywords. |
10 | 10 |
11 #ifndef CHROME_BROWSER_AUTOCOMPLETE_KEYWORD_PROVIDER_H_ | 11 #ifndef CHROME_BROWSER_AUTOCOMPLETE_KEYWORD_PROVIDER_H_ |
12 #define CHROME_BROWSER_AUTOCOMPLETE_KEYWORD_PROVIDER_H_ | 12 #define CHROME_BROWSER_AUTOCOMPLETE_KEYWORD_PROVIDER_H_ |
13 | 13 |
14 #include <string> | 14 #include <string> |
15 | 15 |
16 #include "base/basictypes.h" | 16 #include "base/basictypes.h" |
17 #include "base/compiler_specific.h" | 17 #include "base/compiler_specific.h" |
18 #include "base/memory/scoped_ptr.h" | 18 #include "base/memory/scoped_ptr.h" |
| 19 #include "chrome/browser/autocomplete/keyword_extensions_delegate.h" |
19 #include "components/metrics/proto/omnibox_input_type.pb.h" | 20 #include "components/metrics/proto/omnibox_input_type.pb.h" |
20 #include "components/omnibox/autocomplete_input.h" | 21 #include "components/omnibox/autocomplete_input.h" |
21 #include "components/omnibox/autocomplete_provider.h" | 22 #include "components/omnibox/autocomplete_provider.h" |
22 | 23 |
23 class AutocompleteProviderListener; | 24 class AutocompleteProviderListener; |
24 class KeywordExtensionsDelegate; | 25 class KeywordExtensionsDelegate; |
25 class Profile; | |
26 class TemplateURL; | 26 class TemplateURL; |
27 class TemplateURLService; | 27 class TemplateURLService; |
28 | 28 |
29 // Autocomplete provider for keyword input. | 29 // Autocomplete provider for keyword input. |
30 // | 30 // |
31 // After construction, the autocomplete controller repeatedly calls Start() | 31 // After construction, the autocomplete controller repeatedly calls Start() |
32 // with some user input, each time expecting to receive a small set of the best | 32 // with some user input, each time expecting to receive a small set of the best |
33 // matches (either synchronously or asynchronously). | 33 // matches (either synchronously or asynchronously). |
34 // | 34 // |
35 // To construct these matches, the provider treats user input as a series of | 35 // To construct these matches, the provider treats user input as a series of |
36 // whitespace-delimited tokens and tries to match the first token as the prefix | 36 // whitespace-delimited tokens and tries to match the first token as the prefix |
37 // of a known "keyword". A keyword is some string that maps to a search query | 37 // of a known "keyword". A keyword is some string that maps to a search query |
38 // URL; the rest of the user's input is taken as the input to the query. For | 38 // URL; the rest of the user's input is taken as the input to the query. For |
39 // example, the keyword "bug" might map to the URL "http://b/issue?id=%s", so | 39 // example, the keyword "bug" might map to the URL "http://b/issue?id=%s", so |
40 // input like "bug 123" would become "http://b/issue?id=123". | 40 // input like "bug 123" would become "http://b/issue?id=123". |
41 // | 41 // |
42 // Because we do prefix matching, user input could match more than one keyword | 42 // Because we do prefix matching, user input could match more than one keyword |
43 // at once. (Example: the input "f jazz" matches all keywords starting with | 43 // at once. (Example: the input "f jazz" matches all keywords starting with |
44 // "f".) We return the best matches, up to three. | 44 // "f".) We return the best matches, up to three. |
45 // | 45 // |
46 // The resulting matches are shown with content specified by the keyword | 46 // The resulting matches are shown with content specified by the keyword |
47 // (usually "Search [name] for %s"), description "(Keyword: [keyword])", and | 47 // (usually "Search [name] for %s"), description "(Keyword: [keyword])", and |
48 // action "[keyword] %s". If the user has typed a (possibly partial) keyword | 48 // action "[keyword] %s". If the user has typed a (possibly partial) keyword |
49 // but no search terms, the suggested result is shown greyed out, with | 49 // but no search terms, the suggested result is shown greyed out, with |
50 // "<enter term(s)>" as the substituted input, and does nothing when selected. | 50 // "<enter term(s)>" as the substituted input, and does nothing when selected. |
51 class KeywordProvider : public AutocompleteProvider { | 51 class KeywordProvider : public AutocompleteProvider { |
52 public: | 52 public: |
53 KeywordProvider(AutocompleteProviderListener* listener, Profile* profile); | |
54 // For testing. | |
55 KeywordProvider(AutocompleteProviderListener* listener, | 53 KeywordProvider(AutocompleteProviderListener* listener, |
56 TemplateURLService* model); | 54 TemplateURLService* model); |
57 | 55 |
| 56 void set_extensions_delegate( |
| 57 scoped_ptr<KeywordExtensionsDelegate> extensions_delegate) { |
| 58 extensions_delegate_ = extensions_delegate.Pass(); |
| 59 } |
| 60 |
58 // Extracts the next whitespace-delimited token from input and returns it. | 61 // Extracts the next whitespace-delimited token from input and returns it. |
59 // Sets |remaining_input| to everything after the first token (skipping over | 62 // Sets |remaining_input| to everything after the first token (skipping over |
60 // the first intervening whitespace). | 63 // the first intervening whitespace). |
61 // If |trim_leading_whitespace| is true then leading whitespace in | 64 // If |trim_leading_whitespace| is true then leading whitespace in |
62 // |*remaining_input| will be trimmed. | 65 // |*remaining_input| will be trimmed. |
63 static base::string16 SplitKeywordFromInput(const base::string16& input, | 66 static base::string16 SplitKeywordFromInput(const base::string16& input, |
64 bool trim_leading_whitespace, | 67 bool trim_leading_whitespace, |
65 base::string16* remaining_input); | 68 base::string16* remaining_input); |
66 | 69 |
67 // Returns the replacement string from the user input. The replacement | 70 // Returns the replacement string from the user input. The replacement |
(...skipping 66 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
134 | 137 |
135 // Fills in the "destination_url" and "contents" fields of |match| with the | 138 // Fills in the "destination_url" and "contents" fields of |match| with the |
136 // provided user input and keyword data. | 139 // provided user input and keyword data. |
137 void FillInURLAndContents(const base::string16& remaining_input, | 140 void FillInURLAndContents(const base::string16& remaining_input, |
138 const TemplateURL* element, | 141 const TemplateURL* element, |
139 AutocompleteMatch* match) const; | 142 AutocompleteMatch* match) const; |
140 | 143 |
141 TemplateURLService* GetTemplateURLService() const; | 144 TemplateURLService* GetTemplateURLService() const; |
142 | 145 |
143 AutocompleteProviderListener* listener_; | 146 AutocompleteProviderListener* listener_; |
144 Profile* profile_; | |
145 | 147 |
146 // Model for the keywords. This is only non-null when testing, otherwise the | 148 // Model for the keywords. |
147 // TemplateURLService from the Profile is used. | |
148 TemplateURLService* model_; | 149 TemplateURLService* model_; |
149 | 150 |
150 // Delegate to handle the extensions-only logic for KeywordProvider. | 151 // Delegate to handle the extensions-only logic for KeywordProvider. |
151 // NULL when extensions are not enabled. May be NULL for tests. | 152 // NULL when extensions are not enabled. May be NULL for tests. |
152 scoped_ptr<KeywordExtensionsDelegate> extensions_delegate_; | 153 scoped_ptr<KeywordExtensionsDelegate> extensions_delegate_; |
153 | 154 |
154 DISALLOW_COPY_AND_ASSIGN(KeywordProvider); | 155 DISALLOW_COPY_AND_ASSIGN(KeywordProvider); |
155 }; | 156 }; |
156 | 157 |
157 #endif // CHROME_BROWSER_AUTOCOMPLETE_KEYWORD_PROVIDER_H_ | 158 #endif // CHROME_BROWSER_AUTOCOMPLETE_KEYWORD_PROVIDER_H_ |
OLD | NEW |