libdcp
pkl.h
Go to the documentation of this file.
1 /*
2  Copyright (C) 2018-2021 Carl Hetherington <cth@carlh.net>
3 
4  This file is part of libdcp.
5 
6  libdcp is free software; you can redistribute it and/or modify
7  it under the terms of the GNU General Public License as published by
8  the Free Software Foundation; either version 2 of the License, or
9  (at your option) any later version.
10 
11  libdcp is distributed in the hope that it will be useful,
12  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14  GNU General Public License for more details.
15 
16  You should have received a copy of the GNU General Public License
17  along with libdcp. If not, see <http://www.gnu.org/licenses/>.
18 
19  In addition, as a special exception, the copyright holders give
20  permission to link the code of portions of this program with the
21  OpenSSL library under certain conditions as described in each
22  individual source file, and distribute linked combinations
23  including the two.
24 
25  You must obey the GNU General Public License in all respects
26  for all of the code used other than OpenSSL. If you modify
27  file(s) with this exception, you may extend this exception to your
28  version of the file(s), but you are not obligated to do so. If you
29  do not wish to do so, delete this exception statement from your
30  version. If you delete this exception statement from all source
31  files in the program, then also delete it here.
32 */
33 
34 
40 #ifndef LIBDCP_PKL_H
41 #define LIBDCP_PKL_H
42 
43 
44 #include "asset_list.h"
45 #include "object.h"
46 #include "util.h"
47 #include "certificate_chain.h"
48 #include <libcxml/cxml.h>
49 #include <boost/filesystem.hpp>
50 
51 
52 namespace dcp {
53 
54 
55 class VerificationNote;
56 
57 
58 class PKL : public Object, public AssetList
59 {
60 public:
61  PKL (Standard standard, boost::optional<std::string> annotation_text, std::string issue_date, std::string issuer, std::string creator)
62  : AssetList(standard, annotation_text, issue_date, issuer, creator)
63  {}
64 
65  explicit PKL(boost::filesystem::path file, std::vector<dcp::VerificationNote>* notes = nullptr);
66 
67  boost::optional<std::string> hash (std::string id) const;
68  boost::optional<std::string> type (std::string id) const;
69 
70  void clear_assets();
71  void add_asset(std::string id, boost::optional<std::string> annotation_text, std::string hash, int64_t size, std::string type, std::string original_filename);
72  void write_xml (boost::filesystem::path file, std::shared_ptr<const CertificateChain> signer) const;
73 
75  boost::optional<boost::filesystem::path> file () const {
76  return _file;
77  }
78 
79  class Asset : public Object
80  {
81  public:
82  Asset (cxml::ConstNodePtr node)
83  : Object (remove_urn_uuid(node->string_child("Id")))
84  , _annotation_text (node->optional_string_child("AnnotationText"))
85  , _hash (node->string_child("Hash"))
86  , _size (node->number_child<int64_t>("Size"))
87  , _type (node->string_child("Type"))
88  , _original_filename(node->optional_string_child("OriginalFileName"))
89  {}
90 
91  Asset(std::string id, boost::optional<std::string> annotation_text, std::string hash, int64_t size, std::string type, std::string original_filename)
92  : Object (id)
93  , _annotation_text (annotation_text)
94  , _hash (hash)
95  , _size (size)
96  , _type (type)
97  , _original_filename(original_filename)
98  {}
99 
100  boost::optional<std::string> annotation_text () const {
101  return _annotation_text;
102  }
103 
104  std::string hash () const {
105  return _hash;
106  }
107 
108  int64_t size () const {
109  return _size;
110  }
111 
112  std::string type () const {
113  return _type;
114  }
115 
116  boost::optional<std::string> original_filename() const {
117  return _original_filename;
118  }
119 
120  private:
121  boost::optional<std::string> _annotation_text;
122  std::string _hash;
123  int64_t _size = 0;
124  std::string _type;
125  boost::optional<std::string> _original_filename;
126  };
127 
128  std::vector<std::shared_ptr<Asset>> assets() const {
129  return _assets;
130  }
131 
132 private:
133  std::vector<std::shared_ptr<Asset>> _assets;
135  mutable boost::optional<boost::filesystem::path> _file;
136 };
137 
138 
139 }
140 
141 
142 #endif
CertificateChain class.
Some part of a DCP that has a UUID.
Definition: object.h:63
Definition: pkl.h:59
boost::optional< boost::filesystem::path > file() const
Definition: pkl.h:75
boost::optional< boost::filesystem::path > _file
Definition: pkl.h:135
Namespace for everything in libdcp.
Definition: array_data.h:50
Object class.
Utility methods and classes.