OLD | NEW |
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_ |
OLD | NEW |