dingtalk-stream-sdk 0.2.3

DingTalk Stream SDK for Rust
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
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
115
116
117
118
119
120
121
122
123
124

use crate::client::AccessTokenCache;
use crate::handlers::{
    CallbackHandler, DefaultLifecycleListener, EventHandler, LifecycleListener, SystemHandler,
};
use crate::{ClientConfig, Credential};
use std::collections::HashMap;
use std::sync::atomic::{AtomicBool, Ordering};
use std::sync::Arc;
use tokio::sync::RwLock;

mod access_token;
mod download_resources;
mod upload_resources;
pub use upload_resources::*;
mod handle_message;
mod lifecycle;
mod send_message;
use crate::frames::down_message::MessageTopic;
pub use download_resources::DingtalkResource;

/// DingTalk Stream Client
pub struct DingTalkStream {
    /// Credential for authentication
    pub(super) credential: Credential,
    /// Client configuration
    config: ClientConfig,
    /// Event handler
    event_handler: Option<Arc<dyn EventHandler>>,
    /// Callback handlers mapped by topic
    callback_handlers: HashMap<MessageTopic, Arc<dyn CallbackHandler>>,
    /// System handler
    system_handler: Option<Arc<dyn SystemHandler>>,
    /// Whether connected
    connected: AtomicBool,
    /// Whether registered
    registered: AtomicBool,
    /// Access token cache
    access_token: Arc<RwLock<Option<AccessTokenCache>>>,
    http_client: reqwest::Client,
    lifecycle_listener: Arc<dyn LifecycleListener>,
}

impl DingTalkStream {
    /// Create a new DingTalk Stream client
    pub fn new(credential: Credential) -> Self {
        Self::with_config(credential, ClientConfig::default())
    }

    /// Create with custom configuration
    pub fn with_config(credential: Credential, config: ClientConfig) -> Self {
        Self {
            credential,
            config,
            event_handler: None,
            callback_handlers: HashMap::default(),
            system_handler: None,
            connected: AtomicBool::new(false),
            registered: AtomicBool::new(false),
            access_token: Default::default(),
            http_client: reqwest::Client::default(),
            lifecycle_listener: Arc::new(DefaultLifecycleListener::default()),
        }
    }
}

impl DingTalkStream {
    /// Register an event handler
    pub async fn register_event_handler<H: EventHandler + 'static>(
        mut self,
        handler: Arc<H>,
    ) -> Self {
        self.event_handler.replace(handler);
        self
    }

    /// Register a callback handler for a specific topic
    pub async fn register_callback_handler<H: CallbackHandler + 'static>(
        mut self,
        handler: Arc<H>,
    ) -> Self {
        let topic = handler.topic().clone();
        self.callback_handlers.insert(topic, handler);
        self
    }

    /// Register a system handler
    pub async fn register_system_handler<H: SystemHandler + 'static>(
        mut self,
        handler: Arc<H>,
    ) -> Self {
        self.system_handler.replace(handler);
        self
    }

    pub async fn register_lifecycle_listener<L: LifecycleListener + 'static>(
        mut self,
        listener: Arc<L>,
    ) -> Self {
        self.lifecycle_listener = listener;
        self
    }
}

impl DingTalkStream {
    /// Check if connected
    pub fn is_connected(&self) -> bool {
        self.connected.load(Ordering::Relaxed)
    }

    /// Check if registered
    pub fn is_registered(&self) -> bool {
        self.registered.load(Ordering::Relaxed)
    }

    /// Get the credential
    pub fn credential(&self) -> &Credential {
        &self.credential
    }

    /// Get configuration
    pub fn config(&self) -> &ClientConfig {
        &self.config
    }
}