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}