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
//! 异步任务句柄托管:自动清理已完成任务、统一 abort 收口
//!
//! 插件与后台服务常散落 `tokio::spawn` 的句柄管理:裸 `Vec<JoinHandle>`
//! 会随时间无限增长(已完成任务不被移除),停机时也没有统一的 abort 入口。
//! [`TaskHandles`] 提供:
//!
//! - [`push`](TaskHandles::push):入队时顺带清理已完成句柄,内存有界;
//! - [`abort_all`](TaskHandles::abort_all):停机时一次性中止全部任务;
//! - [`all_finished`](TaskHandles::all_finished):观测全部任务是否自然结束。
//!
//! ```rust
//! use wordval_utils::task_handle::TaskHandles;
//!
//! # async fn demo() {
//! let handles = TaskHandles::default();
//! handles.push(tokio::spawn(async { /* 后台工作 */ }));
//! handles.abort_all();
//! # }
//! ```
use Mutex;
use JoinHandle;
/// 异步任务句柄集合(不施加 spawn/join 策略,只管存取与清理)