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
|
// Copyright (c) 2012 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 CHROME_BROWSER_SEARCH_ENGINES_TEMPLATE_URL_FETCHER_H_
#define CHROME_BROWSER_SEARCH_ENGINES_TEMPLATE_URL_FETCHER_H_
#include "base/memory/scoped_vector.h"
#include "base/string16.h"
#include "components/browser_context_keyed_service/browser_context_keyed_service.h"
#include "ui/gfx/native_widget_types.h"
class GURL;
class Profile;
class TemplateURL;
class TemplateURLFetcherCallbacks;
namespace content {
class WebContents;
}
// TemplateURLFetcher is responsible for downloading OpenSearch description
// documents, creating a TemplateURL from the OSDD, and adding the TemplateURL
// to the TemplateURLService. Downloading is done in the background.
//
class TemplateURLFetcher : public BrowserContextKeyedService {
public:
enum ProviderType {
AUTODETECTED_PROVIDER,
EXPLICIT_PROVIDER // Supplied by Javascript.
};
// Creates a TemplateURLFetcher with the specified Profile.
explicit TemplateURLFetcher(Profile* profile);
virtual ~TemplateURLFetcher();
// If TemplateURLFetcher is not already downloading the OSDD for osdd_url,
// it is downloaded. If successful and the result can be parsed, a TemplateURL
// is added to the TemplateURLService. Takes ownership of |callbacks|.
//
// If |provider_type| is AUTODETECTED_PROVIDER, |keyword| must be non-empty,
// and if there's already a non-replaceable TemplateURL in the model for
// |keyword|, or we're already downloading an OSDD for this keyword, no
// download is started. If |provider_type| is EXPLICIT_PROVIDER, |keyword| is
// ignored.
//
// |web_contents| specifies which WebContents displays the page the OSDD is
// downloaded for. |web_contents| must not be NULL, except during tests.
void ScheduleDownload(const string16& keyword,
const GURL& osdd_url,
const GURL& favicon_url,
content::WebContents* web_contents,
TemplateURLFetcherCallbacks* callbacks,
ProviderType provider_type);
// The current number of outstanding requests.
int requests_count() const { return requests_.size(); }
private:
// A RequestDelegate is created to download each OSDD. When done downloading
// RequestCompleted is invoked back on the TemplateURLFetcher.
class RequestDelegate;
friend class RequestDelegate;
typedef ScopedVector<RequestDelegate> Requests;
Profile* profile() const { return profile_; }
// Invoked from the RequestDelegate when done downloading.
void RequestCompleted(RequestDelegate* request);
Profile* profile_;
// In progress requests.
Requests requests_;
DISALLOW_COPY_AND_ASSIGN(TemplateURLFetcher);
};
#endif // CHROME_BROWSER_SEARCH_ENGINES_TEMPLATE_URL_FETCHER_H_
|