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
/* ***
*
* Harmos
*
* SPDX-License-Identifier: Apache-2.0
*
* ***
*/
// Capture A File Range Into Independent Immutable Durable Storage.
/* === Modules === */
/* === Re-Exports === */
/* === Imports === */
// Standard Library Imports
// Third Party Imports
// Local Imports
use crate::FileRead;
use crate::{FileReference, Result, StorageManager};
use harmos_domain::model::storage::files::CaptureConsistency;
/* === Constants === */
/* === Macros === */
/* === Type Aliases === */
/* === Structs === */
#[derive(Clone, Debug)]
pub struct FileCapture {
pub source: crate::FileSource,
pub range: crate::ByteRange,
pub metadata: crate::FileMetadata,
pub consistency: CaptureConsistency,
}
/* === Enums === */
/* === Traits === */
/* === Implementations === */
impl<C> StorageManager<C> {
pub async fn capture_file(&self, request: FileCapture) -> Result<FileReference> {
let context = crate::execution::Context::current();
let span = context.sync(|| tracing::debug_span!("storage.file.capture_file", outcome = "cancelled"));
context
.result(span, async {
let mut reader = self
.read_file(FileRead {
source: request.source,
range: request.range,
})
.await?;
let mut target = self.create_file(request.metadata).await?;
while let Some(batch) = reader.next_raw(false).await? {
let chunk = crate::FileChunk::new(batch.bytes);
let offset = target.length();
target.write_retained_at(offset, chunk).await?;
}
reader.completion()?;
if request.consistency == CaptureConsistency::Stable {
reader.check_unchanged().await?;
}
let reference = target.finish().await?;
self.flush_until(&reference.position).await?;
Ok(reference)
})
.await
}
}
/* === Public Functions === */
/* === Private Functions === */
/* === Tests === */