Skip to main content

light_fw_core/reactive/
proxy.rs

1//! Трейт «реактивного класса» и его состояние.
2
3use super::observer::PropertyId;
4
5/// Реактивный класс (аналог `reactive`-объекта в Vue).
6///
7/// Макрос `#[proxy]` реализует этот трейт автоматически. Каждое свойство
8/// структуры-потомка регистрируется у обозревателя, поэтому чтения и записи
9/// участвуют в отслеживании зависимостей.
10pub trait Proxy: 'static {
11    /// Состояние реактивности этого объекта.
12    fn proxy_state(&self) -> &ProxyState;
13
14    /// Имя типа для диагностики.
15    fn proxy_type_name(&self) -> &'static str {
16        self.proxy_state().type_name
17    }
18
19    /// Уведомляет обозревателя об изменении всех свойств объекта
20    /// (принудительная перерисовка всех зависимых элементов).
21    fn invalidate(&self) {
22        let properties: Vec<PropertyId> = self.proxy_state().properties.to_vec();
23        for property in properties {
24            super::observer::trigger(property);
25        }
26    }
27}
28
29/// Состояние реактивного класса: имя типа и список свойств.
30#[derive(Clone, Debug)]
31pub struct ProxyState {
32    type_name: &'static str,
33    properties: Box<[PropertyId]>,
34}
35
36impl PartialEq for ProxyState {
37    /// Равенство — по имени типа: идентификаторы свойств принадлежат
38    /// конкретному объекту и не должны мешать сравнению значений.
39    fn eq(&self, other: &Self) -> bool {
40        self.type_name == other.type_name
41    }
42}
43
44impl ProxyState {
45    /// Создаёт состояние для типа `T` с перечнем свойств.
46    pub fn new<T: 'static>(properties: &[PropertyId]) -> Self {
47        Self {
48            type_name: std::any::type_name::<T>(),
49            properties: properties.to_vec().into_boxed_slice(),
50        }
51    }
52
53    /// Имя типа реактивного класса.
54    pub fn type_name(&self) -> &'static str {
55        self.type_name
56    }
57
58    /// Идентификаторы всех свойств объекта.
59    pub fn properties(&self) -> &[PropertyId] {
60        &self.properties
61    }
62}