Add an API to component_updater that asks to do an update check "now".

chrome/browser/component_updater/component_updater_service.h

 // 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_COMPONENT_UPDATER_COMPONENT_UPDATER_SERVICE_H_
 #define CHROME_BROWSER_COMPONENT_UPDATER_COMPONENT_UPDATER_SERVICE_H_
 
 #include <string>
 #include <vector>
 
@@ skipping 69 matching lines @@
 // During the normal operation of the component updater some specific
 // notifications are fired, like COMPONENT_UPDATER_STARTED and
 // COMPONENT_UPDATE_FOUND. See notification_type.h for more details.
 //
 // All methods are safe to call ONLY from chrome's UI thread.
 class ComponentUpdateService {
  public:
   enum Status {
     kOk,
     kReplaced,
+    kInProgress,
     kError
   };
   // Controls the component updater behavior.
   class Configurator {
    public:
     enum Events {
       kManifestCheck,
       kComponentUpdated,
       kManifestError,
       kNetworkError,
       kUnpackError,
       kInstallerError
     };
 
     virtual ~Configurator() {}
     // Delay in seconds from calling Start() to the first update check.
     virtual int InitialDelay() = 0;
     // Delay in seconds to every subsequent update check. 0 means don't check.
     virtual int NextCheckDelay() = 0;
     // Delay in seconds from each task step. Used to smooth out CPU/IO usage.
     virtual int StepDelay() = 0;
-    // Minimun delta time in seconds before checking again the same component.
+    // Minimum delta time in seconds before checking again the same component.
     virtual int MinimumReCheckWait() = 0;
+    // Minimum delta time in seconds before an on-demand check is allowed
+    // for the same component.
+    virtual int OnDemandDelay() = 0;
     // The url that is going to be used update checks over Omaha protocol.
     virtual GURL UpdateUrl(CrxComponent::UrlSource source) = 0;
     // Parameters added to each url request. It can be null if none are needed.
     virtual const char* ExtraRequestParams() = 0;
     // How big each update request can be. Don't go above 2000.
     virtual size_t UrlSizeLimit() = 0;
     // The source of contexts for all the url requests.
     virtual net::URLRequestContextGetter* RequestContext() = 0;
     // True means that all ops are performed in this process.
     virtual bool InProcess() = 0;
     // The component updater will call this function when an interesting event
     // happens. It should be used mostly as a place to add application specific
     // logging or telemetry. |extra| is |event| dependent.
     virtual void OnEvent(Events event, int extra) = 0;
   };
 
   // Start doing update checks and installing new versions of registered
   // components after Configurator::InitialDelay() seconds.
   virtual Status Start() = 0;
 
   // Stop doing update checks. In-flight requests and pending installations
   // will not be canceled.
   virtual Status Stop() = 0;
 
   // Add component to be checked for updates. You can call this method
   // before calling Start().
   virtual Status RegisterComponent(const CrxComponent& component) = 0;
 
+  // Ask the component updater to do an update check for a previously
+  // registered component, soon. If an update or check is already in progress,
+  // returns |kInProgress|. The same component cannot be checked repeatedly
+  // in a short interval either (returns |kError| if so).
+  // There is no guarantee that the item will actually be updated,
+  // since another item may be chosen to be updated. Since there is
+  // no time guarantee, there is no notification if the item is not updated.
+  // However, the ComponentInstaller should know if an update succeeded
+  // via the Install() hook.
+  virtual Status CheckForUpdateSoon(const CrxComponent& component) = 0;
+
   virtual ~ComponentUpdateService() {}
 };
 
 // Creates the component updater. You must pass a valid |config| allocated on
 // the heap which the component updater will own.
 ComponentUpdateService* ComponentUpdateServiceFactory(
     ComponentUpdateService::Configurator* config);
 
 #endif  // CHROME_BROWSER_COMPONENT_UPDATER_COMPONENT_UPDATER_SERVICE_H_
-