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

//! Stitch API Request Messages

use std::vec::Vec;

use serde::ser::Serialize;

/// Trait that defines fields needed to send a record to stitch.
///
/// # Example
///
/// ```
/// # use stitch::Message;
/// struct User {
///     id: u64,
///     email: String,
///     first_name: String,
///     last_name: String,
/// }
///
/// impl Message for User {
///     fn get_table_name(&self) -> String {
///         String::from("users")
///     }
///
///     fn get_keys(&self) -> Vec<String> {
///         vec![String::from("id")]
///     }
/// }
/// ```
pub trait Message {
    /// Table name of this record. Determines destination schema.
    fn get_table_name(&self) -> String;

    /// Primary keys of this record.
    fn get_keys(&self) -> Vec<String>;
}

/// Struct that is Serializable and Sendable to stitch.
/// Ultimately, this type is converted to a `RawUpsertRequest`
/// before sending to stitch, this is done in order to make use
/// of `serde` automatic derive `Serialize`.
#[derive(Debug)]
pub struct UpsertRequest<T>
where
    T: Message + Serialize,
{
    client_id: u32,
    sequence: u64,
    data: T,
}

impl<T> UpsertRequest<T>
where
    T: Message + Serialize,
{
    /// Creates new `UpsertRequest`.
    ///
    /// * `sequence` - Unique id. This field is used by stitch in order
    /// to know how to order messages correctly. This should be a monotonically
    /// increasing number, current time in milliseconds is often used.
    pub fn new(client_id: u32, sequence: u64, data: T) -> Self {
        UpsertRequest {
            client_id,
            sequence,
            data,
        }
    }

    /// All `UpsertRequest`s are of stitch action `upsert`.
    fn get_action(&self) -> &'static str {
        "upsert"
    }

    /// Returns the table name from the underlying `Message` type.
    fn get_table_name(&self) -> String {
        self.data.get_table_name()
    }

    /// Returns the keys from the underlying `Message` type.
    fn get_keys(&self) -> Vec<String> {
        self.data.get_keys()
    }
}

/// Serializable representation of `UpsertRecord`.
#[derive(Debug, Serialize)]
pub struct RawUpsertRequest<T>
where
    T: Message + Serialize,
{
    client_id: u32,
    sequence: u64,
    table_name: String,
    action: &'static str,
    key_names: Vec<String>,
    data: T,
}

/// Convert `UpsertRequest` into `RawUpsertRequest`.
impl<T> From<UpsertRequest<T>> for RawUpsertRequest<T>
where
    T: Message + Serialize,
{
    fn from(rec: UpsertRequest<T>) -> Self {
        RawUpsertRequest {
            client_id: rec.client_id,
            sequence: rec.sequence,
            table_name: rec.get_table_name(),
            action: rec.get_action(),
            key_names: rec.get_keys(),
            data: rec.data,
        }
    }
}