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
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
|
/************************************************************************
*
* Copyright (C) 2021-2025 IRCAD France
*
* This file is part of Sight.
*
* Sight is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Sight is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with Sight. If not, see <https://www.gnu.org/licenses/>.
*
***********************************************************************/
#pragma once
#include <core/com/signal.hpp>
#include <core/crypto/password_keeper.hpp>
#include <io/__/service/writer.hpp>
#include <io/zip/archive.hpp>
namespace sight::module::io::session
{
/**
* @brief Session writer.
*
* @details Service to recursively write a data object tree, including all fields, to a session file.
* The session file is indeed a standard "ZIP" archive, while the compression algorithm for files inside
* the session archive is ZSTD. A standard archive reader could open a session file, if it is able to handle
* ZIP archive with ZSTD compression.
*
* The archive can be password protected using AES256 algorithm. Depending of the chosen encryption policy, the files
* can be protected, and thus not be readable from external archive reader, even if no password (encryption=forced) are
* provided.
*
* The compression level is set individually, depending of the type of data to serialize.
*
* @section Signals Signals
* - \b monitor_created(SPTR(core::progress::monitor)): emitted to display a progress bar while the image is written,
* it should be connected to a progress bar
*
* @section XML XML Configuration
* @code{.xml}
<service type="sight::module::io::session::writer">
<in key="data" uid="..." />
<dialog extension=".sample" description="Sample Sight session file" policy="once"/>
<password policy="global", encryption=salted/>
<archive format="optimized"/>
</service>
@endcode
*
* @subsection Input Input
* - \b data [sight::data::object]: object to write.
*
* @subsection Configuration Configuration
* - \b dialog(optional):
* \b extension: defines the file extension that will be used for the session file.
* If the extension is not specified, default ".zip" will be used.
* \b description: allows to display a label in front of extension when the file dialog is shown.
* \b policy:
* - \b "never": never show the open dialog. (DEFAULT)
* - \b "once": show only once, store the location as long as the service is started
* - \b "always": always show the location dialog
*
* - \b password(optional):
* \b policy: defines if we should protect the session file using a password and when to ask for it. It could be:
* - \b "never": a password will never be asked and the session file will never be encrypted. (DEFAULT)
* - \b "global": a password will be asked only if global password is not set, or wrong.
* The session file will be encrypted.
* - \b "always": a password will always be asked.
* The session file will be encrypted.
*
* \b encryption: defines if we should use password as is or salt it a bit to make . It could be:
* - \b "password": uses password as is. (DEFAULT)
* - \b "salted": uses password, but salt it. It means that encrypted file could not be open outside Sight.
* - \b "force": force encryption, even without password. Use a pseudo-random hidden password, if
* no password are provided
*
* - \b archive(optional):
* \b format: defines the archive format.
* - \b "filesystem": Use the filesystem to store files.
* - \b "compatible": Store files in a ZIP archive, with old deflate algorithm
* - \b "optimized": Store files in a ZIP archive, with zstd algorithm
* - \b "default": uses the builtin default behavior which is "optimized"
*
* @see sight::io::service::writer
* @see sight::io::session::session_writer
*/
class writer final : public sight::io::service::writer
{
public:
SIGHT_DECLARE_SERVICE(writer, sight::io::service::writer);
writer() noexcept;
~writer() noexcept final = default;
/// Propose to create a medical data file
void open_location_dialog() final;
protected:
/// Parses the configuration
void configuring() final;
/// Does nothing
void starting() final;
/// Does nothing
void stopping() final;
/// Writes session data to filesystem
void updating() final;
/// Returns managed path type, here service manages only single file
sight::io::service::path_type_t get_path_type() const final
{
return sight::io::service::file;
}
private:
/// Extension name to use for session file
std::string m_extension_name {".zip"};
/// Extension description to use for file save dialog
std::string m_extension_description {"Sight session"};
/// Dialog policy to use for the file location
dialog_policy m_dialog_policy = {dialog_policy::never};
/// Password policy to use
sight::core::crypto::password_keeper::password_policy m_password_policy {
sight::core::crypto::password_keeper::password_policy::never
};
/// Encryption policy to use
sight::core::crypto::password_keeper::encryption_policy m_encryption_policy {
sight::core::crypto::password_keeper::encryption_policy::password
};
/// Archive format to use
sight::io::zip::archive::archive_format m_archive_format {sight::io::zip::archive::archive_format::DEFAULT};
};
} // namespace sight::module::io::session
|
