File: text_log_upload_list.h

package info (click to toggle)
chromium 139.0.7258.127-1
  • links: PTS, VCS
  • area: main
  • in suites:
  • size: 6,122,068 kB
  • sloc: cpp: 35,100,771; ansic: 7,163,530; javascript: 4,103,002; python: 1,436,920; asm: 946,517; xml: 746,709; pascal: 187,653; perl: 88,691; sh: 88,436; objc: 79,953; sql: 51,488; cs: 44,583; fortran: 24,137; makefile: 22,147; tcl: 15,277; php: 13,980; yacc: 8,984; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (75 lines) | stat: -rw-r--r-- 3,179 bytes parent folder | download | duplicates (11)
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
// Copyright 2017 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef COMPONENTS_UPLOAD_LIST_TEXT_LOG_UPLOAD_LIST_H_
#define COMPONENTS_UPLOAD_LIST_TEXT_LOG_UPLOAD_LIST_H_

#include <string>
#include <vector>

#include "base/files/file_path.h"
#include "base/values.h"
#include "components/upload_list/upload_list.h"

// Loads and parses an upload list text file of the line-based JSON format:
// {"upload_time":<value>[,"upload_id":<value>[,"local_id":<value>
// [,"capture_time":<value>[,"state":<value>[,"source":<value>
// [,"path_hash":<value>]]]]]]}
// {"upload_time":<value>[,"upload_id":<value>[,"local_id":<value>
// [,"capture_time":<value>[,"state":<value>[,"source":<value>
// [,"path_hash":<value>]]]]]]}
// ...
// or the CSV format:
// upload_time,upload_id[,local_id[,capture_time[,state]]]
// upload_time,upload_id[,local_id[,capture_time[,state]]]
// ...
// where each line represents an upload. |upload_time| and |capture_time| are in
// Unix time. |state| is an int in the range of UploadInfo::State. A line may
// or may not contain |local_id|, |capture_time|, |state| and |source|.
class TextLogUploadList : public UploadList {
 public:
  // Creates a new upload list that parses the log at |upload_log_path|.
  explicit TextLogUploadList(const base::FilePath& upload_log_path);

  TextLogUploadList(const TextLogUploadList&) = delete;
  TextLogUploadList& operator=(const TextLogUploadList&) = delete;

  const base::FilePath& upload_log_path() const { return upload_log_path_; }

 protected:
  ~TextLogUploadList() override;

  // Splits a string into a vector of lines based on EOLs.
  static std::vector<std::string> SplitIntoLines(
      const std::string& file_contents);

  // UploadList:
  std::vector<std::unique_ptr<UploadList::UploadInfo>> LoadUploadList()
      override;
  void ClearUploadList(const base::Time& begin, const base::Time& end) override;
  void RequestSingleUpload(const std::string& local_id) override;

  // Tries to parse one upload log line based on CSV format, then converts it
  // to a UploadInfo entry. If the conversion succeeds, it returns a valid
  // UploadInfo instance. Otherwise, it returns nullptr.
  virtual std::unique_ptr<UploadList::UploadInfo> TryParseCsvLogEntry(
      const std::string& log_line);

  // Tries to parse one upload log dictionary based on line-based JSON format
  // (no internal additional newline is permitted), then converts it to a
  // UploadInfo entry. If the conversion succeeds, it returns a valid
  // UploadInfo instance. Otherwise, it returns nullptr.
  virtual std::unique_ptr<UploadList::UploadInfo> TryParseJsonLogEntry(
      const base::Value::Dict& dict);

  // Parses upload log lines, converting them to UploadInfo entries.
  // The method also reverse the order of the entries (the first entry in
  // |uploads| is the last in |log_entries|).
  void ParseLogEntries(const std::vector<std::string>& log_entries,
                       std::vector<std::unique_ptr<UploadInfo>>* uploads);

  const base::FilePath upload_log_path_;
};

#endif  // COMPONENTS_UPLOAD_LIST_TEXT_LOG_UPLOAD_LIST_H_