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

use rand::{self, Rng, ThreadRng};

/// Options for HyParView [Node](./struct.Node.html).
#[derive(Debug, Clone)]
pub struct NodeOptions<R> {
    /// Random number generator.
    ///
    /// The default random number generator is `ThreadRng`.
    pub rng: R,

    /// Maximum number of nodes in the active view.
    pub max_active_view_size: u8,

    /// Maximum number of nodes in the passive view.
    pub max_passive_view_size: u8,

    /// Protocol parameter that is called `ka` in the [paper].
    ///
    /// [paper]: http://asc.di.fct.unl.pt/~jleitao/pdf/dsn07-leitao.pdf
    pub shuffle_active_view_size: u8,

    /// Protocol parameter that is called `kp` in the [paper].
    ///
    /// [paper]: http://asc.di.fct.unl.pt/~jleitao/pdf/dsn07-leitao.pdf
    pub shuffle_passive_view_size: u8,

    /// Protocol parameter that is called `ARWL` in the [paper].
    ///
    /// This is the initial TTL value for `ForwardJoin` and `Shuffle` messages.
    ///
    /// [paper]: http://asc.di.fct.unl.pt/~jleitao/pdf/dsn07-leitao.pdf
    pub active_random_walk_len: u8,

    /// Protocol parameter that is called `PRWL` in the [paper].
    ///
    /// If TTL is equal to the value,
    ///
    /// [paper]: http://asc.di.fct.unl.pt/~jleitao/pdf/dsn07-leitao.pdf
    pub passive_random_walk_len: u8,
}
impl NodeOptions<ThreadRng> {
    /// Makes a new `NodeOptions` instance with the default settings.
    pub fn new() -> Self {
        Self::default()
    }
}
impl<R: Rng> NodeOptions<R> {
    /// The default value of `max_active_view_size` field.
    pub const DEFAULT_MAX_ACTIVE_VIEW_SIZE: u8 = 4;

    /// The default value of `max_passive_view_size` field.
    pub const DEFAULT_MAX_PASSIVE_VIEW_SIZE: u8 = 24;

    /// The default value of `shuffle_active_view_size` field.
    pub const DEFAULT_SHUFFLE_ACTIVE_VIEW_SIZE: u8 = 2;

    /// The default value of `shuffle_passive_view_size` field.
    pub const DEFAULT_SHUFFLE_PASSIVE_VIEW_SIZE: u8 = 2;

    /// The default value of `active_random_walk_len` field.
    pub const DEFAULT_ACTIVE_RANDOM_WALK_LEN: u8 = 5;

    /// The default value of `passive_random_walk_len` field.
    pub const DEFAULT_PASSIVE_RANDOM_WALK_LEN: u8 = 2;

    /// Sets the random number generator to `rng`.
    pub fn set_rng<S: Rng>(self, rng: S) -> NodeOptions<S> {
        NodeOptions {
            rng,
            max_active_view_size: self.max_active_view_size,
            max_passive_view_size: self.max_passive_view_size,
            shuffle_active_view_size: self.shuffle_active_view_size,
            shuffle_passive_view_size: self.shuffle_passive_view_size,
            active_random_walk_len: self.active_random_walk_len,
            passive_random_walk_len: self.passive_random_walk_len,
        }
    }
}
impl Default for NodeOptions<ThreadRng> {
    fn default() -> Self {
        NodeOptions {
            rng: rand::thread_rng(),
            max_active_view_size: Self::DEFAULT_MAX_ACTIVE_VIEW_SIZE,
            max_passive_view_size: Self::DEFAULT_MAX_PASSIVE_VIEW_SIZE,
            shuffle_active_view_size: Self::DEFAULT_SHUFFLE_ACTIVE_VIEW_SIZE,
            shuffle_passive_view_size: Self::DEFAULT_SHUFFLE_PASSIVE_VIEW_SIZE,
            active_random_walk_len: Self::DEFAULT_ACTIVE_RANDOM_WALK_LEN,
            passive_random_walk_len: Self::DEFAULT_PASSIVE_RANDOM_WALK_LEN,
        }
    }
}