chrome/browser/browser_process.h

   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 // This interface is for managing the global services of the application. Each
   6 // service is lazily created when requested the first time. The service getters
   7 // will return NULL if the service is not available, so callers must check for
   8 // this condition.
   9
  10 #ifndef CHROME_BROWSER_BROWSER_PROCESS_H_
  11 #define CHROME_BROWSER_BROWSER_PROCESS_H_
  12
  13 #include <string>
  14
  15 #include "base/basictypes.h"
  16 #include "base/memory/scoped_ptr.h"
  17 #include "chrome/browser/browser_process_platform_part.h"
  18 #include "chrome/browser/shell_integration.h"
  19 #include "chrome/browser/ui/host_desktop.h"
  20
  21 class BackgroundModeManager;
  22 class ChromeNetLog;
  23 class CRLSetFetcher;
  24 class DownloadRequestLimiter;
  25 class DownloadStatusUpdater;
  26 class GLStringManager;
  27 class GpuModeManager;
  28 class IconManager;
  29 class IntranetRedirectDetector;
  30 class IOThread;
  31 class MediaFileSystemRegistry;
  32 class MetricsServicesManager;
  33 class NotificationUIManager;
  34 class PrefRegistrySimple;
  35 class PrefService;
  36 class Profile;
  37 class ProfileManager;
  38 class SafeBrowsingService;
  39 class StatusTray;
  40 class WatchDogThread;
  41 #if defined(ENABLE_WEBRTC)
  42 class WebRtcLogUploader;
  43 #endif
  44
  45 namespace variations {
  46 class VariationsService;
  47 }
  48
  49 namespace component_updater {
  50 class ComponentUpdateService;
  51 class PnaclComponentInstaller;
  52 class SupervisedUserWhitelistInstaller;
  53 }
  54
  55 namespace extensions {
  56 class EventRouterForwarder;
  57 }
  58
  59 namespace gcm {
  60 class GCMDriver;
  61 }
  62
  63 namespace memory {
  64 class OomPriorityManager;
  65 }
  66
  67 namespace message_center {
  68 class MessageCenter;
  69 }
  70
  71 namespace metrics {
  72 class MetricsService;
  73 }
  74
  75 namespace net {
  76 class URLRequestContextGetter;
  77 }
  78
  79 namespace network_time {
  80 class NetworkTimeTracker;
  81 }
  82
  83 namespace policy {
  84 class BrowserPolicyConnector;
  85 class PolicyService;
  86 }
  87
  88 namespace printing {
  89 class BackgroundPrintingManager;
  90 class PrintJobManager;
  91 class PrintPreviewDialogController;
  92 }
  93
  94 namespace rappor {
  95 class RapporService;
  96 }
  97
  98 namespace safe_browsing {
  99 class ClientSideDetectionService;
 100 }
 101
 102 namespace web_resource {
 103 class PromoResourceService;
 104 }
 105
 106 // NOT THREAD SAFE, call only from the main thread.
 107 // These functions shouldn't return NULL unless otherwise noted.
 108 class BrowserProcess {
 109  public:
 110   BrowserProcess();
 111   virtual ~BrowserProcess();
 112
 113   // Called when the ResourceDispatcherHost object is created by content.
 114   virtual void ResourceDispatcherHostCreated() = 0;
 115
 116   // Invoked when the user is logging out/shutting down. When logging off we may
 117   // not have enough time to do a normal shutdown. This method is invoked prior
 118   // to normal shutdown and saves any state that must be saved before we are
 119   // continue shutdown.
 120   virtual void EndSession() = 0;
 121
 122   // Gets the manager for the various metrics-related services, constructing it
 123   // if necessary.
 124   virtual MetricsServicesManager* GetMetricsServicesManager() = 0;
 125
 126   // Services: any of these getters may return NULL
 127   virtual metrics::MetricsService* metrics_service() = 0;
 128   virtual rappor::RapporService* rappor_service() = 0;
 129   virtual ProfileManager* profile_manager() = 0;
 130   virtual PrefService* local_state() = 0;
 131   virtual net::URLRequestContextGetter* system_request_context() = 0;
 132   virtual variations::VariationsService* variations_service() = 0;
 133   virtual web_resource::PromoResourceService* promo_resource_service() = 0;
 134
 135   virtual BrowserProcessPlatformPart* platform_part() = 0;
 136
 137   virtual extensions::EventRouterForwarder*
 138       extension_event_router_forwarder() = 0;
 139
 140   // Returns the manager for desktop notifications.
 141   virtual NotificationUIManager* notification_ui_manager() = 0;
 142
 143   // MessageCenter is a global list of currently displayed notifications.
 144   virtual message_center::MessageCenter* message_center() = 0;
 145
 146   // Returns the state object for the thread that we perform I/O
 147   // coordination on (network requests, communication with renderers,
 148   // etc.
 149   //
 150   // Can be NULL close to startup and shutdown.
 151   //
 152   // NOTE: If you want to post a task to the IO thread, use
 153   // BrowserThread::PostTask (or other variants).
 154   virtual IOThread* io_thread() = 0;
 155
 156   // Returns the thread that is used for health check of all browser threads.
 157   virtual WatchDogThread* watchdog_thread() = 0;
 158
 159   // Starts and manages the policy system.
 160   virtual policy::BrowserPolicyConnector* browser_policy_connector() = 0;
 161
 162   // This is the main interface for chromium components to retrieve policy
 163   // information from the policy system.
 164   virtual policy::PolicyService* policy_service() = 0;
 165
 166   virtual IconManager* icon_manager() = 0;
 167
 168   virtual GLStringManager* gl_string_manager() = 0;
 169
 170   virtual GpuModeManager* gpu_mode_manager() = 0;
 171
 172   virtual void CreateDevToolsHttpProtocolHandler(
 173       chrome::HostDesktopType host_desktop_type,
 174       const std::string& ip,
 175       uint16 port) = 0;
 176
 177   virtual unsigned int AddRefModule() = 0;
 178   virtual unsigned int ReleaseModule() = 0;
 179
 180   virtual bool IsShuttingDown() = 0;
 181
 182   virtual printing::PrintJobManager* print_job_manager() = 0;
 183   virtual printing::PrintPreviewDialogController*
 184       print_preview_dialog_controller() = 0;
 185   virtual printing::BackgroundPrintingManager*
 186       background_printing_manager() = 0;
 187
 188   virtual IntranetRedirectDetector* intranet_redirect_detector() = 0;
 189
 190   // Returns the locale used by the application.
 191   virtual const std::string& GetApplicationLocale() = 0;
 192   virtual void SetApplicationLocale(const std::string& locale) = 0;
 193
 194   virtual DownloadStatusUpdater* download_status_updater() = 0;
 195   virtual DownloadRequestLimiter* download_request_limiter() = 0;
 196
 197   // Returns the object that manages background applications.
 198   virtual BackgroundModeManager* background_mode_manager() = 0;
 199   virtual void set_background_mode_manager_for_test(
 200       scoped_ptr<BackgroundModeManager> manager) = 0;
 201
 202   // Returns the StatusTray, which provides an API for displaying status icons
 203   // in the system status tray. Returns NULL if status icons are not supported
 204   // on this platform (or this is a unit test).
 205   virtual StatusTray* status_tray() = 0;
 206
 207   // Returns the SafeBrowsing service.
 208   virtual SafeBrowsingService* safe_browsing_service() = 0;
 209
 210   // Returns an object which handles communication with the SafeBrowsing
 211   // client-side detection servers.
 212   virtual safe_browsing::ClientSideDetectionService*
 213       safe_browsing_detection_service() = 0;
 214
 215 #if (defined(OS_WIN) || defined(OS_LINUX)) && !defined(OS_CHROMEOS)
 216   // This will start a timer that, if Chrome is in persistent mode, will check
 217   // whether an update is available, and if that's the case, restart the
 218   // browser. Note that restart code will strip some of the command line keys
 219   // and all loose values from the cl this instance of Chrome was launched with,
 220   // and add the command line key that will force Chrome to start in the
 221   // background mode. For the full list of "blacklisted" keys, refer to
 222   // |kSwitchesToRemoveOnAutorestart| array in browser_process_impl.cc.
 223   virtual void StartAutoupdateTimer() = 0;
 224 #endif
 225
 226   virtual ChromeNetLog* net_log() = 0;
 227
 228   virtual component_updater::ComponentUpdateService* component_updater() = 0;
 229
 230   virtual CRLSetFetcher* crl_set_fetcher() = 0;
 231
 232   virtual component_updater::PnaclComponentInstaller*
 233   pnacl_component_installer() = 0;
 234
 235   virtual component_updater::SupervisedUserWhitelistInstaller*
 236   supervised_user_whitelist_installer() = 0;
 237
 238   virtual MediaFileSystemRegistry* media_file_system_registry() = 0;
 239
 240   virtual bool created_local_state() const = 0;
 241
 242 #if defined(ENABLE_WEBRTC)
 243   virtual WebRtcLogUploader* webrtc_log_uploader() = 0;
 244 #endif
 245
 246   virtual network_time::NetworkTimeTracker* network_time_tracker() = 0;
 247
 248   virtual gcm::GCMDriver* gcm_driver() = 0;
 249
 250   // Returns the out-of-memory priority manager if it exists, null otherwise.
 251   virtual memory::OomPriorityManager* GetOomPriorityManager() = 0;
 252
 253   // Returns the default web client state of Chrome (i.e., was it the user's
 254   // default browser) at the time a previous check was made sometime between
 255   // process startup and now.
 256   virtual ShellIntegration::DefaultWebClientState
 257   CachedDefaultWebClientState() = 0;
 258
 259  private:
 260   DISALLOW_COPY_AND_ASSIGN(BrowserProcess);
 261 };
 262
 263 extern BrowserProcess* g_browser_process;
 264
 265 #endif  // CHROME_BROWSER_BROWSER_PROCESS_H_