Update installed ServiceWorkers.

content/browser/service_worker/service_worker_registration.h

 // Copyright 2013 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 CONTENT_BROWSER_SERVICE_WORKER_SERVICE_WORKER_REGISTRATION_H_
 #define CONTENT_BROWSER_SERVICE_WORKER_SERVICE_WORKER_REGISTRATION_H_
 
 #include "base/basictypes.h"
 #include "base/gtest_prod_util.h"
 #include "base/logging.h"
 #include "base/memory/ref_counted.h"
 #include "base/memory/scoped_ptr.h"
 #include "content/browser/service_worker/service_worker_version.h"
 #include "content/common/content_export.h"
 #include "content/common/service_worker/service_worker_types.h"
 #include "url/gurl.h"
 
 namespace content {
 
 class ServiceWorkerRegistrationInfo;
 class ServiceWorkerVersion;
 
-// This class manages all persistence of service workers:
-//  - Registrations
-//  - Mapping of caches to registrations / versions
-//
-// This is the place where we manage simultaneous
-// requests for the same registrations and caches, making sure that
-// two pages that are registering the same pattern at the same time
-// have their registrations coalesced rather than overwriting each
-// other.
-//
-// This class also manages the state of the upgrade process, which
-// includes managing which ServiceWorkerVersion is "active" vs "in
-// waiting".
+// This class represents a service worker regiratration. The

[falken, 2014/07/17 06:33:42]

nit: registration

+// scope and script url are constant for the life of the persistent
+// registration. It's refcounted to facillitate multiple controllees

[falken, 2014/07/17 06:33:41]

nit: facilitate

+// being associated with the same registration. The class roughly
+// corresponds to navigator.serviceWorker.registgration.

[falken, 2014/07/17 06:33:41]

nit: registration

 class CONTENT_EXPORT ServiceWorkerRegistration
     : NON_EXPORTED_BASE(public base::RefCounted<ServiceWorkerRegistration>) {
  public:
+  typedef base::Callback<void(ServiceWorkerStatusCode status)> StatusCallback;
 
   class Listener {
    public:
     virtual void OnVersionAttributesChanged(
         ServiceWorkerRegistration* registration,
         ChangedVersionAttributesMask changed_mask,
         const ServiceWorkerRegistrationInfo& info)  = 0;
   };
 
   ServiceWorkerRegistration(const GURL& pattern,
@@ skipping 15 matching lines @@
 
   ServiceWorkerVersion* installing_version() const {
     return installing_version_.get();
   }
 
   void AddListener(Listener* listener);
   void RemoveListener(Listener* listener);
 
   ServiceWorkerRegistrationInfo GetInfo();
 
-  // Sets the corresposding version attribute and resets the position (if any)
-  // left vacant (ie. by a waiting version being promoted).
+  // Sets the corresposding version attribute and resets the position

[falken, 2014/07/17 06:33:41]

nit: corresponding

+  // (if any) left vacant (ie. by a waiting version being promoted).
   // Also notifies listeners via OnVersionAttributesChanged.
   void SetActiveVersion(ServiceWorkerVersion* version);
   void SetWaitingVersion(ServiceWorkerVersion* version);
   void SetInstallingVersion(ServiceWorkerVersion* version);
 
   // If version is the installing, waiting, active version of this
   // registation, the method will reset that field to NULL, and notify
   // listeners via OnVersionAttributesChanged.
   void UnsetVersion(ServiceWorkerVersion* version);
 
+  // This method corresponds to the [[Activate]] algorithm described in
+  // the service worker specification. It's only valid to call this method
+  // when the registration's active version has no controllees.
+  void ActivateWaitingVersion(const StatusCallback& completion_callback);
+
  private:
   ~ServiceWorkerRegistration();
   friend class base::RefCounted<ServiceWorkerRegistration>;
 
   void SetVersionInternal(
       ServiceWorkerVersion* version,
       scoped_refptr<ServiceWorkerVersion>* data_member,
       int change_flag);
   void UnsetVersionInternal(
       ServiceWorkerVersion* version,
       ChangedVersionAttributesMask* mask);
+  void OnActivateEventFinished(
+      ServiceWorkerVersion* activating_version,
+      const StatusCallback& completion_callback,
+      ServiceWorkerStatusCode status);
 
   const GURL pattern_;
   const GURL script_url_;
   const int64 registration_id_;
   scoped_refptr<ServiceWorkerVersion> active_version_;
   scoped_refptr<ServiceWorkerVersion> waiting_version_;
   scoped_refptr<ServiceWorkerVersion> installing_version_;
   ObserverList<Listener> listeners_;
   base::WeakPtr<ServiceWorkerContextCore> context_;
 
   DISALLOW_COPY_AND_ASSIGN(ServiceWorkerRegistration);
 };
 }  // namespace content
 #endif  // CONTENT_BROWSER_SERVICE_WORKER_SERVICE_WORKER_REGISTRATION_H_