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
111
112
113
114
115
116
117
118
119
|
// Copyright (c) 2009 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 WEBKIT_APPCACHE_APPCACHE_GROUP_H_
#define WEBKIT_APPCACHE_APPCACHE_GROUP_H_
#include <vector>
#include "base/observer_list.h"
#include "base/ref_counted.h"
#include "googleurl/src/gurl.h"
#include "testing/gtest/include/gtest/gtest_prod.h"
namespace appcache {
class AppCache;
class AppCacheHost;
class AppCacheService;
class AppCacheUpdateJob;
// Collection of application caches identified by the same manifest URL.
// A group exists as long as it is in use by a host or is being updated.
class AppCacheGroup : public base::RefCounted<AppCacheGroup> {
public:
class UpdateObserver {
public:
// Called just after an appcache update has completed.
virtual void OnUpdateComplete(AppCacheGroup* group) = 0;
virtual ~UpdateObserver() { }
};
enum UpdateStatus {
IDLE,
CHECKING,
DOWNLOADING,
};
AppCacheGroup(AppCacheService* service, const GURL& manifest_url);
// Adds/removes an update observer, the AppCacheGroup does not take
// ownership of the observer.
void AddUpdateObserver(UpdateObserver* observer);
void RemoveUpdateObserver(UpdateObserver* observer);
const GURL& manifest_url() const { return manifest_url_; }
bool is_obsolete() const { return is_obsolete_; }
void set_obsolete(bool value) { is_obsolete_ = value; }
AppCache* newest_complete_cache() const { return newest_complete_cache_; }
void AddCache(AppCache* complete_cache);
void RemoveCache(AppCache* cache);
bool HasCache() const { return newest_complete_cache_ != NULL; }
UpdateStatus update_status() const { return update_status_; }
// Starts an update via update() javascript API.
void StartUpdate() {
StartUpdateWithHost(NULL);
}
// Starts an update for a doc loaded from an application cache.
void StartUpdateWithHost(AppCacheHost* host) {
StartUpdateWithNewMasterEntry(host, GURL::EmptyGURL());
}
// Starts an update for a doc loaded using HTTP GET or equivalent with
// an <html> tag manifest attribute value that matches this group's
// manifest url.
void StartUpdateWithNewMasterEntry(AppCacheHost* host,
const GURL& new_master_resource);
private:
friend class AppCacheUpdateJob;
friend class AppCacheUpdateJobTest;
friend class base::RefCounted<AppCacheGroup>;
friend class MockAppCacheStorage; // for old_caches()
~AppCacheGroup();
typedef std::vector<AppCache*> Caches;
AppCacheUpdateJob* update_job() { return update_job_; }
void SetUpdateStatus(UpdateStatus status);
const Caches& old_caches() const { return old_caches_; }
GURL manifest_url_;
UpdateStatus update_status_;
bool is_obsolete_;
// Old complete app caches.
Caches old_caches_;
// Newest cache in this group to be complete, aka relevant cache.
AppCache* newest_complete_cache_;
// Current update job for this group, if any.
AppCacheUpdateJob* update_job_;
// Central service object.
AppCacheService* service_;
// List of objects observing this group.
ObserverList<UpdateObserver> observers_;
FRIEND_TEST(AppCacheGroupTest, StartUpdate);
FRIEND_TEST(AppCacheGroupTest, CancelUpdate);
FRIEND_TEST(AppCacheUpdateJobTest, AlreadyChecking);
FRIEND_TEST(AppCacheUpdateJobTest, AlreadyDownloading);
DISALLOW_COPY_AND_ASSIGN(AppCacheGroup);
};
} // namespace appcache
#endif // WEBKIT_APPCACHE_APPCACHE_GROUP_H_
|