dicom-toolkit-net 0.5.0

Async DICOM networking: association management, DIMSE services (C-ECHO, C-STORE, C-FIND, C-GET, C-MOVE)
Documentation 
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

//! Association configuration.
//!
//! Mirrors DCMTK's `DcmAssociationConfiguration` / `T_ASC_Parameters`.

// ── AssociationConfig ─────────────────────────────────────────────────────────

/// Configuration for both SCU (outbound) and SCP (inbound) associations.
#[derive(Debug, Clone)]
pub struct AssociationConfig {
    /// AE title advertised as the local application entity.
    pub local_ae_title: String,

    /// Maximum PDU length we are willing to receive (bytes).
    ///
    /// A value of `0` means unlimited.  Defaults to 65 536.
    pub max_pdu_length: u32,

    /// Seconds to wait for a response during association negotiation and
    /// DIMSE operations before returning a timeout error.
    pub dimse_timeout_secs: u64,

    /// If `true`, the SCP accepts any transfer syntax offered by the SCU
    /// without checking against a preferred list.
    pub accept_all_transfer_syntaxes: bool,

    /// Transfer syntax UIDs this SCP is willing to accept explicitly.
    ///
    /// When empty and `accept_all_transfer_syntaxes` is `false`, negotiation
    /// falls back to Explicit VR Little Endian and then Implicit VR Little Endian.
    pub accepted_transfer_syntaxes: Vec<String>,

    /// Transfer syntax UIDs this SCP prefers, in descending priority order.
    ///
    /// When empty, accepted transfer syntaxes are chosen in the order they were
    /// offered by the peer.
    pub preferred_transfer_syntaxes: Vec<String>,

    /// Implementation Class UID advertised in the User Information sub-item.
    pub implementation_class_uid: String,

    /// Implementation Version Name advertised in the User Information sub-item.
    pub implementation_version_name: String,

    /// Abstract Syntax UIDs this SCP is willing to accept.
    ///
    /// An empty list means **accept all** (useful for testing / generic SCPs).
    pub accepted_abstract_syntaxes: Vec<String>,
}

impl Default for AssociationConfig {
    fn default() -> Self {
        Self {
            local_ae_title: "DCMTKRS".to_string(),
            max_pdu_length: 65_536,
            dimse_timeout_secs: 30,
            accept_all_transfer_syntaxes: false,
            accepted_transfer_syntaxes: Vec::new(),
            preferred_transfer_syntaxes: Vec::new(),
            implementation_class_uid: "1.3.6.1.4.1.30071.8.1".to_string(),
            implementation_version_name: "DCMTK_RS_010".to_string(),
            accepted_abstract_syntaxes: Vec::new(),
        }
    }
}

// ── Tests ─────────────────────────────────────────────────────────────────────

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn default_config_sensible() {
        let cfg = AssociationConfig::default();
        assert_eq!(cfg.max_pdu_length, 65_536);
        assert_eq!(cfg.dimse_timeout_secs, 30);
        assert!(!cfg.accept_all_transfer_syntaxes);
        assert!(cfg.accepted_transfer_syntaxes.is_empty());
        assert!(cfg.preferred_transfer_syntaxes.is_empty());
        assert!(!cfg.implementation_class_uid.is_empty());
    }
}