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