scylla 1.7.0

Async CQL driver for Rust, optimized for ScyllaDB, fully compatible with Apache Cassandra™
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

use std::{net::SocketAddr, sync::Arc};

use crate::{
    cluster::{Node, NodeRef},
    network::Connection,
    routing::Shard,
};

/// The coordinator of a CQL request, i.e., the node+shard that receives
/// and processes the request, and hopefully eventually sends a response.
#[derive(Debug, Clone)]
pub struct Coordinator {
    /// Translated address, i.e., one that the connection is opened against.
    ///
    /// This may be different than [`Node::address`], and may be different on different
    /// connections to the same node, because of various driver mechanisms (address translation,
    /// shard-aware port, client routes). You should never use this
    /// for node identification. Use [`Node::host_id`] of the [`Self::node`] for that.
    connection_address: SocketAddr,
    /// The node that served as coordinator.
    node: Arc<Node>,
    /// Number of the shard, if applicable (present for ScyllaDB nodes, absent for Cassandra).
    shard: Option<Shard>,
}

impl Coordinator {
    pub(crate) fn new(node: NodeRef, shard: Option<Shard>, connection: &Connection) -> Self {
        Self {
            connection_address: connection.get_connect_address(),
            node: Arc::clone(node),
            shard,
        }
    }

    /// Translated address, i.e., one that the connection is opened against.
    ///
    /// This may be different than [`Node::address`], and may be different on different
    /// connections to the same node, because of various driver mechanisms (address translation,
    /// shard-aware port, client routes). You should never use this
    /// for node identification. Use [`Node::host_id`] of the [`Self::node`] for that.
    #[inline]
    pub fn connection_address(&self) -> SocketAddr {
        self.connection_address
    }

    /// The node that served as coordinator of the request.
    #[inline]
    pub fn node(&self) -> NodeRef<'_> {
        &self.node
    }

    /// Number of the shard, if applicable (present for ScyllaDB nodes, absent for Cassandra).
    #[inline]
    pub fn shard(&self) -> Option<Shard> {
        self.shard
    }
}