Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(521)

Side by Side Diff: ios/chrome/browser/reading_list/reading_list_entry.h

Issue 2514333003: Componentize Reading List (Closed)
Patch Set: rebase Created 4 years ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
OLDNEW
1 // Copyright 2016 The Chromium Authors. All rights reserved. 1 // Copyright 2016 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be 2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file. 3 // found in the LICENSE file.
4 4
5 #ifndef IOS_CHROME_BROWSER_READING_LIST_READING_LIST_ENTRY_H_ 5 #ifndef IOS_CHROME_BROWSER_READING_LIST_READING_LIST_ENTRY_H_
6 #define IOS_CHROME_BROWSER_READING_LIST_READING_LIST_ENTRY_H_ 6 #define IOS_CHROME_BROWSER_READING_LIST_READING_LIST_ENTRY_H_
7 7
8 #include <string> 8 // This is a temporary convenience file.
9 9 #include "components/reading_list/reading_list_entry.h"
10 #include "base/files/file_path.h"
11 #include "base/macros.h"
12 #include "base/time/time.h"
13 #include "net/base/backoff_entry.h"
14 #include "url/gurl.h"
15
16 namespace reading_list {
17 class ReadingListLocal;
18 }
19
20 namespace sync_pb {
21 class ReadingListSpecifics;
22 }
23
24 class ReadingListEntry;
25 using ReadingListEntries = std::vector<ReadingListEntry>;
26
27 // An entry in the reading list. The URL is a unique identifier for an entry, as
28 // such it should not be empty and is the only thing considered when comparing
29 // entries.
30 class ReadingListEntry {
31 public:
32 ReadingListEntry(const GURL& url, const std::string& title);
33 ReadingListEntry(const GURL& url,
34 const std::string& title,
35 std::unique_ptr<net::BackoffEntry> backoff);
36 ReadingListEntry(ReadingListEntry&& entry);
37 ~ReadingListEntry();
38
39 // Entries are created in WAITING state. At some point they will be PROCESSING
40 // into one of the three state: PROCESSED, the only state a distilled URL
41 // would be set, WILL_RETRY, similar to wait, but with exponential delays or
42 // ERROR where the system will not retry at all.
43 enum DistillationState { WAITING, PROCESSING, PROCESSED, WILL_RETRY, ERROR };
44
45 static const net::BackoffEntry::Policy kBackoffPolicy;
46
47 // The URL of the page the user would like to read later.
48 const GURL& URL() const;
49 // The title of the entry. Might be empty.
50 const std::string& Title() const;
51 // What state this entry is in.
52 DistillationState DistilledState() const;
53 // The local file path for the distilled version of the page. This should only
54 // be called if the state is "PROCESSED".
55 const base::FilePath& DistilledPath() const;
56 // The URL to the distilled file.
57 const GURL DistilledURL() const;
58 // The time before the next try. This is automatically increased when the
59 // state is set to WILL_RETRY or ERROR from a non-error state.
60 base::TimeDelta TimeUntilNextTry() const;
61 // The number of time chrome failed to download this entry. This is
62 // automatically increased when the state is set to WILL_RETRY or ERROR from a
63 // non-error state.
64 int FailedDownloadCounter() const;
65
66 // The last update time of the entry. This value may be used to sort the
67 // entries. The value is in microseconds since Jan 1st 1970.
68 int64_t UpdateTime() const;
69
70 // The creation update time of the entry. The value is in microseconds since
71 // Jan 1st 1970.
72 int64_t CreationTime() const;
73
74 // Set the update time to now.
75 void MarkEntryUpdated();
76
77 // Returns a protobuf encoding the content of this ReadingListEntry for local
78 // storage.
79 std::unique_ptr<reading_list::ReadingListLocal> AsReadingListLocal(
80 bool read) const;
81
82 // Returns a protobuf encoding the content of this ReadingListEntry for sync.
83 std::unique_ptr<sync_pb::ReadingListSpecifics> AsReadingListSpecifics(
84 bool read) const;
85
86 // Created a ReadingListEntry from the protobuf format.
87 static std::unique_ptr<ReadingListEntry> FromReadingListLocal(
88 const reading_list::ReadingListLocal& pb_entry);
89
90 // Created a ReadingListEntry from the protobuf format.
91 static std::unique_ptr<ReadingListEntry> FromReadingListSpecifics(
92 const sync_pb::ReadingListSpecifics& pb_entry);
93
94 // Merge the local data from |other| to this.
95 // The local fields (distilled_state_, distilled_url_, backoff_,
96 // failed_download_counter_) of |other| are moved to |this| and must not be
97 // used after this call.
98 void MergeLocalStateFrom(ReadingListEntry& other);
99
100 ReadingListEntry& operator=(ReadingListEntry&& other);
101
102 bool operator==(const ReadingListEntry& other) const;
103
104 // Returns whether |lhs| is more recent than |rhs|.
105 static bool CompareEntryUpdateTime(const ReadingListEntry& lhs,
106 const ReadingListEntry& rhs);
107
108 // Sets the title.
109 void SetTitle(const std::string& title);
110 // Sets the distilled URL and switch the state to PROCESSED and reset the time
111 // until the next try.
112 void SetDistilledPath(const base::FilePath& path);
113 // Sets the state to one of PROCESSING, WILL_RETRY or ERROR.
114 void SetDistilledState(DistillationState distilled_state);
115
116 private:
117 ReadingListEntry(const GURL& url,
118 const std::string& title,
119 int64_t creation_time,
120 int64_t update_time,
121 ReadingListEntry::DistillationState distilled_state,
122 const base::FilePath& distilled_path,
123 int failed_download_counter,
124 std::unique_ptr<net::BackoffEntry> backoff);
125 GURL url_;
126 std::string title_;
127 base::FilePath distilled_path_;
128 DistillationState distilled_state_;
129
130 std::unique_ptr<net::BackoffEntry> backoff_;
131 int failed_download_counter_;
132
133 // These value are in microseconds since Jan 1st 1970. They are used for
134 // sorting the entries from the database. They are kept in int64_t to avoid
135 // conversion on each save/read event.
136 int64_t creation_time_us_;
137 int64_t update_time_us_;
138
139 DISALLOW_COPY_AND_ASSIGN(ReadingListEntry);
140 };
141 10
142 #endif // IOS_CHROME_BROWSER_READING_LIST_READING_LIST_ENTRY_H_ 11 #endif // IOS_CHROME_BROWSER_READING_LIST_READING_LIST_ENTRY_H_
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698