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
|
// Copyright 2014 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 COMPONENTS_TRANSLATE_CORE_BROWSER_TRANSLATE_DOWNLOAD_MANAGER_H_
#define COMPONENTS_TRANSLATE_CORE_BROWSER_TRANSLATE_DOWNLOAD_MANAGER_H_
#include <string>
#include "base/memory/ref_counted.h"
#include "base/memory/scoped_ptr.h"
#include "components/translate/core/browser/translate_language_list.h"
#include "components/translate/core/browser/translate_script.h"
#include "net/url_request/url_request_context_getter.h"
template <typename T> struct DefaultSingletonTraits;
class PrefService;
namespace translate {
// Manages the downloaded resources for Translate, such as the translate script
// and the language list.
class TranslateDownloadManager {
public:
// Returns the singleton instance.
static TranslateDownloadManager* GetInstance();
// The request context used to download the resources.
// Should be set before this class can be used.
net::URLRequestContextGetter* request_context() {
return request_context_.get();
}
void set_request_context(net::URLRequestContextGetter* context) {
request_context_ = context;
}
// The application locale.
// Should be set before this class can be used.
const std::string& application_locale() { return application_locale_; }
void set_application_locale(const std::string& locale) {
application_locale_ = locale;
}
// The language list.
TranslateLanguageList* language_list() { return language_list_.get(); }
// The translate script.
TranslateScript* script() { return script_.get(); }
// Let the caller decide if and when we should fetch the language list from
// the translate server. This is a NOOP if switches::kDisableTranslate is set
// or if prefs::kEnableTranslate is set to false.
static void RequestLanguageList(PrefService* prefs);
// Fetches the language list from the translate server.
static void RequestLanguageList();
// Fills |languages| with the list of languages that the translate server can
// translate to and from.
static void GetSupportedLanguages(std::vector<std::string>* languages);
// Returns the last-updated time when Chrome received a language list from a
// Translate server. Returns null time if Chrome hasn't received any lists.
static base::Time GetSupportedLanguagesLastUpdated();
// Returns the language code that can be used with the Translate method for a
// specified |language|. (ex. GetLanguageCode("en-US") will return "en", and
// GetLanguageCode("zh-CN") returns "zh-CN")
static std::string GetLanguageCode(const std::string& language);
// Returns true if |language| is supported by the translation server.
static bool IsSupportedLanguage(const std::string& language);
// Returns true if |language| is supported by the translation server as an
// alpha language.
static bool IsAlphaLanguage(const std::string& language);
// Must be called to shut Translate down. Cancels any pending fetches.
void Shutdown();
// Clears the translate script, so it will be fetched next time we translate.
void ClearTranslateScriptForTesting();
// Resets to its initial state as if newly created.
void ResetForTesting();
// Used by unit-tests to override some defaults:
// Delay after which the translate script is fetched again from the
// translation server.
void SetTranslateScriptExpirationDelay(int delay_ms);
private:
friend struct DefaultSingletonTraits<TranslateDownloadManager>;
TranslateDownloadManager();
virtual ~TranslateDownloadManager();
scoped_ptr<TranslateLanguageList> language_list_;
// An instance of TranslateScript which manages JavaScript source for
// Translate.
scoped_ptr<TranslateScript> script_;
std::string application_locale_;
scoped_refptr<net::URLRequestContextGetter> request_context_;
};
} // namespace translate
#endif // COMPONENTS_TRANSLATE_CORE_BROWSER_TRANSLATE_DOWNLOAD_MANAGER_H_
|
