@ruiapp/rapid-core 0.9.9 → 0.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (198) hide show
  1. package/CHANGELOG.md +11 -11
  2. package/dist/bootstrapApplicationConfig.d.ts +51 -0
  3. package/dist/index.js +168 -40
  4. package/dist/plugins/auth/services/AuthService.d.ts +7 -1
  5. package/dist/types.d.ts +4 -0
  6. package/package.json +1 -1
  7. package/rollup.config.js +16 -16
  8. package/src/bootstrapApplicationConfig.ts +897 -782
  9. package/src/core/actionHandler.ts +23 -23
  10. package/src/core/eventManager.ts +20 -20
  11. package/src/core/facility.ts +7 -7
  12. package/src/core/http/formDataParser.ts +89 -89
  13. package/src/core/http-types.ts +4 -4
  14. package/src/core/pluginManager.ts +193 -193
  15. package/src/core/providers/runtimeProvider.ts +5 -5
  16. package/src/core/request.ts +96 -96
  17. package/src/core/response.ts +79 -79
  18. package/src/core/routeContext.ts +127 -127
  19. package/src/core/routes/healthz.ts +20 -20
  20. package/src/core/routes/index.ts +3 -3
  21. package/src/core/routesBuilder.ts +110 -110
  22. package/src/core/server.ts +156 -156
  23. package/src/dataAccess/columnTypeMapper.ts +22 -22
  24. package/src/dataAccess/dataAccessTypes.ts +165 -165
  25. package/src/dataAccess/dataAccessor.ts +135 -135
  26. package/src/dataAccess/entityManager.ts +1932 -1932
  27. package/src/dataAccess/entityMapper.ts +111 -111
  28. package/src/dataAccess/entityValidator.ts +33 -33
  29. package/src/dataAccess/propertyMapper.ts +28 -28
  30. package/src/deno-std/assert/assert.ts +9 -9
  31. package/src/deno-std/assert/assertion_error.ts +7 -7
  32. package/src/deno-std/datetime/to_imf.ts +32 -32
  33. package/src/deno-std/encoding/base64.ts +141 -141
  34. package/src/deno-std/http/cookie.ts +372 -372
  35. package/src/facilities/cache/CacheFacilityTypes.ts +29 -29
  36. package/src/facilities/cache/CacheFactory.ts +31 -31
  37. package/src/facilities/cache/MemoryCache.ts +58 -58
  38. package/src/facilities/cache/MemoryCacheProvider.ts +15 -15
  39. package/src/facilities/log/LogFacility.ts +35 -35
  40. package/src/helpers/entityHelper.ts +89 -89
  41. package/src/helpers/filterHelper.ts +148 -148
  42. package/src/helpers/inputHelper.ts +11 -11
  43. package/src/helpers/licenseHelper.ts +29 -29
  44. package/src/helpers/metaHelper.ts +111 -111
  45. package/src/helpers/runCollectionEntityActionHandler.ts +58 -58
  46. package/src/index.ts +82 -82
  47. package/src/plugins/auth/AuthPlugin.ts +107 -103
  48. package/src/plugins/auth/AuthPluginTypes.ts +11 -11
  49. package/src/plugins/auth/actionHandlers/changePassword.ts +61 -61
  50. package/src/plugins/auth/actionHandlers/createSession.ts +68 -68
  51. package/src/plugins/auth/actionHandlers/deleteSession.ts +18 -18
  52. package/src/plugins/auth/actionHandlers/getMyProfile.ts +28 -38
  53. package/src/plugins/auth/actionHandlers/index.ts +8 -8
  54. package/src/plugins/auth/actionHandlers/resetPassword.ts +45 -45
  55. package/src/plugins/auth/models/AccessToken.ts +56 -56
  56. package/src/plugins/auth/models/index.ts +3 -3
  57. package/src/plugins/auth/routes/changePassword.ts +15 -15
  58. package/src/plugins/auth/routes/getMyProfile.ts +15 -15
  59. package/src/plugins/auth/routes/index.ts +7 -7
  60. package/src/plugins/auth/routes/resetPassword.ts +15 -15
  61. package/src/plugins/auth/routes/signin.ts +15 -15
  62. package/src/plugins/auth/routes/signout.ts +15 -15
  63. package/src/plugins/auth/services/AuthService.ts +66 -39
  64. package/src/plugins/cronJob/CronJobPlugin.ts +104 -104
  65. package/src/plugins/cronJob/CronJobPluginTypes.ts +44 -44
  66. package/src/plugins/cronJob/actionHandlers/index.ts +4 -4
  67. package/src/plugins/cronJob/actionHandlers/runCronJob.ts +32 -32
  68. package/src/plugins/cronJob/entityWatchers/cronJobEntityWatchers.ts +24 -24
  69. package/src/plugins/cronJob/entityWatchers/index.ts +4 -4
  70. package/src/plugins/cronJob/models/CronJob.ts +129 -129
  71. package/src/plugins/cronJob/models/index.ts +3 -3
  72. package/src/plugins/cronJob/routes/index.ts +3 -3
  73. package/src/plugins/cronJob/routes/runCronJob.ts +15 -15
  74. package/src/plugins/cronJob/services/CronJobService.ts +252 -252
  75. package/src/plugins/dataManage/DataManagePlugin.ts +163 -163
  76. package/src/plugins/dataManage/actionHandlers/addEntityRelations.ts +15 -15
  77. package/src/plugins/dataManage/actionHandlers/countCollectionEntities.ts +17 -17
  78. package/src/plugins/dataManage/actionHandlers/createCollectionEntitiesBatch.ts +81 -81
  79. package/src/plugins/dataManage/actionHandlers/createCollectionEntity.ts +20 -20
  80. package/src/plugins/dataManage/actionHandlers/deleteCollectionEntities.ts +45 -45
  81. package/src/plugins/dataManage/actionHandlers/deleteCollectionEntityById.ts +20 -20
  82. package/src/plugins/dataManage/actionHandlers/findCollectionEntities.ts +27 -27
  83. package/src/plugins/dataManage/actionHandlers/findCollectionEntityById.ts +30 -30
  84. package/src/plugins/dataManage/actionHandlers/queryDatabase.ts +22 -22
  85. package/src/plugins/dataManage/actionHandlers/removeEntityRelations.ts +15 -15
  86. package/src/plugins/dataManage/actionHandlers/updateCollectionEntityById.ts +38 -38
  87. package/src/plugins/entityAccessControl/EntityAccessControlPlugin.ts +146 -146
  88. package/src/plugins/fileManage/FileManagePlugin.ts +52 -52
  89. package/src/plugins/fileManage/actionHandlers/downloadDocument.ts +65 -65
  90. package/src/plugins/fileManage/actionHandlers/downloadFile.ts +44 -44
  91. package/src/plugins/fileManage/actionHandlers/uploadFile.ts +33 -33
  92. package/src/plugins/fileManage/routes/downloadDocument.ts +15 -15
  93. package/src/plugins/fileManage/routes/downloadFile.ts +15 -15
  94. package/src/plugins/fileManage/routes/index.ts +5 -5
  95. package/src/plugins/fileManage/routes/uploadFile.ts +15 -15
  96. package/src/plugins/license/LicensePlugin.ts +79 -79
  97. package/src/plugins/license/LicensePluginTypes.ts +95 -95
  98. package/src/plugins/license/LicenseService.ts +137 -137
  99. package/src/plugins/license/actionHandlers/getLicense.ts +18 -18
  100. package/src/plugins/license/actionHandlers/index.ts +5 -5
  101. package/src/plugins/license/actionHandlers/updateLicense.ts +24 -24
  102. package/src/plugins/license/helpers/certHelper.ts +21 -21
  103. package/src/plugins/license/helpers/cryptoHelper.ts +47 -47
  104. package/src/plugins/license/models/index.ts +1 -1
  105. package/src/plugins/license/routes/getLicense.ts +15 -15
  106. package/src/plugins/license/routes/index.ts +4 -4
  107. package/src/plugins/license/routes/updateLicense.ts +15 -15
  108. package/src/plugins/mail/MailPlugin.ts +74 -74
  109. package/src/plugins/mail/MailPluginTypes.ts +27 -27
  110. package/src/plugins/mail/MailService.ts +38 -38
  111. package/src/plugins/mail/actionHandlers/index.ts +3 -3
  112. package/src/plugins/mail/models/index.ts +1 -1
  113. package/src/plugins/mail/routes/index.ts +1 -1
  114. package/src/plugins/metaManage/MetaManagePlugin.ts +198 -198
  115. package/src/plugins/metaManage/actionHandlers/getMetaModelDetail.ts +10 -10
  116. package/src/plugins/metaManage/actionHandlers/listMetaModels.ts +9 -9
  117. package/src/plugins/metaManage/actionHandlers/listMetaRoutes.ts +9 -9
  118. package/src/plugins/metaManage/services/MetaService.ts +376 -376
  119. package/src/plugins/notification/NotificationPlugin.ts +68 -68
  120. package/src/plugins/notification/NotificationPluginTypes.ts +13 -13
  121. package/src/plugins/notification/NotificationService.ts +25 -25
  122. package/src/plugins/notification/actionHandlers/index.ts +3 -3
  123. package/src/plugins/notification/models/Notification.ts +60 -60
  124. package/src/plugins/notification/models/index.ts +3 -3
  125. package/src/plugins/notification/routes/index.ts +1 -1
  126. package/src/plugins/routeManage/RouteManagePlugin.ts +64 -64
  127. package/src/plugins/routeManage/actionHandlers/httpProxy.ts +13 -13
  128. package/src/plugins/routeManage/actionHandlers/mock.ts +28 -28
  129. package/src/plugins/sequence/SequencePlugin.ts +146 -146
  130. package/src/plugins/sequence/SequencePluginTypes.ts +69 -69
  131. package/src/plugins/sequence/SequenceService.ts +92 -92
  132. package/src/plugins/sequence/actionHandlers/generateSn.ts +32 -32
  133. package/src/plugins/sequence/actionHandlers/index.ts +4 -4
  134. package/src/plugins/sequence/models/SequenceAutoIncrementRecord.ts +49 -49
  135. package/src/plugins/sequence/models/SequenceRule.ts +42 -42
  136. package/src/plugins/sequence/models/index.ts +4 -4
  137. package/src/plugins/sequence/routes/generateSn.ts +15 -15
  138. package/src/plugins/sequence/routes/index.ts +3 -3
  139. package/src/plugins/sequence/segment-utility.ts +11 -11
  140. package/src/plugins/sequence/segments/autoIncrement.ts +90 -90
  141. package/src/plugins/sequence/segments/dayOfMonth.ts +19 -19
  142. package/src/plugins/sequence/segments/index.ts +9 -9
  143. package/src/plugins/sequence/segments/literal.ts +16 -16
  144. package/src/plugins/sequence/segments/month.ts +19 -19
  145. package/src/plugins/sequence/segments/parameter.ts +20 -20
  146. package/src/plugins/sequence/segments/year.ts +19 -19
  147. package/src/plugins/serverOperation/ServerOperationPlugin.ts +91 -91
  148. package/src/plugins/serverOperation/ServerOperationPluginTypes.ts +15 -15
  149. package/src/plugins/serverOperation/actionHandlers/index.ts +4 -4
  150. package/src/plugins/serverOperation/actionHandlers/runServerOperation.ts +15 -15
  151. package/src/plugins/setting/SettingPlugin.ts +68 -68
  152. package/src/plugins/setting/SettingPluginTypes.ts +37 -37
  153. package/src/plugins/setting/SettingService.ts +213 -213
  154. package/src/plugins/setting/actionHandlers/getSystemSettingValues.ts +30 -30
  155. package/src/plugins/setting/actionHandlers/getUserSettingValues.ts +38 -38
  156. package/src/plugins/setting/actionHandlers/index.ts +6 -6
  157. package/src/plugins/setting/actionHandlers/setSystemSettingValues.ts +30 -30
  158. package/src/plugins/setting/models/SystemSettingGroupSetting.ts +57 -57
  159. package/src/plugins/setting/models/SystemSettingItem.ts +48 -48
  160. package/src/plugins/setting/models/SystemSettingItemSetting.ts +73 -73
  161. package/src/plugins/setting/models/UserSettingGroupSetting.ts +57 -57
  162. package/src/plugins/setting/models/UserSettingItem.ts +55 -55
  163. package/src/plugins/setting/models/UserSettingItemSetting.ts +73 -73
  164. package/src/plugins/setting/models/index.ts +8 -8
  165. package/src/plugins/setting/routes/getSystemSettingValues.ts +15 -15
  166. package/src/plugins/setting/routes/getUserSettingValues.ts +15 -15
  167. package/src/plugins/setting/routes/index.ts +5 -5
  168. package/src/plugins/setting/routes/setSystemSettingValues.ts +15 -15
  169. package/src/plugins/stateMachine/StateMachinePlugin.ts +196 -196
  170. package/src/plugins/stateMachine/StateMachinePluginTypes.ts +48 -48
  171. package/src/plugins/stateMachine/actionHandlers/index.ts +4 -4
  172. package/src/plugins/stateMachine/actionHandlers/sendStateMachineEvent.ts +54 -54
  173. package/src/plugins/stateMachine/models/StateMachine.ts +42 -42
  174. package/src/plugins/stateMachine/models/index.ts +3 -3
  175. package/src/plugins/stateMachine/routes/index.ts +3 -3
  176. package/src/plugins/stateMachine/routes/sendStateMachineEvent.ts +15 -15
  177. package/src/plugins/stateMachine/stateMachineHelper.ts +36 -36
  178. package/src/plugins/webhooks/WebhooksPlugin.ts +148 -148
  179. package/src/plugins/webhooks/pluginConfig.ts +75 -75
  180. package/src/polyfill.ts +5 -5
  181. package/src/proxy/mod.ts +38 -38
  182. package/src/proxy/types.ts +21 -21
  183. package/src/queryBuilder/index.ts +1 -1
  184. package/src/queryBuilder/queryBuilder.ts +755 -755
  185. package/src/server.ts +530 -530
  186. package/src/types/cron-job-types.ts +66 -66
  187. package/src/types.ts +862 -856
  188. package/src/utilities/accessControlUtility.ts +33 -33
  189. package/src/utilities/entityUtility.ts +18 -18
  190. package/src/utilities/errorUtility.ts +15 -15
  191. package/src/utilities/fsUtility.ts +137 -137
  192. package/src/utilities/httpUtility.ts +19 -19
  193. package/src/utilities/jwtUtility.ts +26 -26
  194. package/src/utilities/passwordUtility.ts +26 -26
  195. package/src/utilities/pathUtility.ts +14 -14
  196. package/src/utilities/timeUtility.ts +17 -17
  197. package/src/utilities/typeUtility.ts +15 -15
  198. package/tsconfig.json +19 -19
@@ -1,252 +1,252 @@
1
- import { CronJob } from "cron";
2
- import { IRpdServer } from "~/core/server";
3
- import { find, isNil, isString, Many } from "lodash";
4
- import { RouteContext } from "~/core/routeContext";
5
- import { validateLicense } from "~/helpers/licenseHelper";
6
- import { JobRunningResult, NamedCronJobInstance, SysCronJob, UpdateJobConfigOptions } from "../CronJobPluginTypes";
7
- import { CronJobConfiguration } from "~/types/cron-job-types";
8
- import { ActionHandlerContext } from "~/core/actionHandler";
9
- import { formatDateTimeWithTimezone, getNowStringWithTimezone } from "~/utilities/timeUtility";
10
-
11
- export default class CronJobService {
12
- #server: IRpdServer;
13
- #namedJobInstances: NamedCronJobInstance[];
14
-
15
- constructor(server: IRpdServer) {
16
- this.#server = server;
17
- }
18
-
19
- /**
20
- * 根据编号获取定时任务配置信息
21
- * @param code
22
- * @returns
23
- */
24
- getJobConfigurationByCode(code: string) {
25
- return find(this.#server.listCronJobs(), (job) => job.code === code);
26
- }
27
-
28
- #createJobInstance(job: CronJobConfiguration) {
29
- return CronJob.from({
30
- ...(job.jobOptions || {}),
31
- cronTime: job.cronTime,
32
- onTick: async () => {
33
- await this.executeJob(job);
34
- },
35
- });
36
- }
37
-
38
- async #startJobInstance(routeContext: RouteContext, jobConfiguration: CronJobConfiguration, jobInstance: CronJob) {
39
- const server = this.#server;
40
- const jobCode = jobConfiguration.code;
41
- const cronJobManager = server.getEntityManager<SysCronJob>("sys_cron_job");
42
- const cronJobInDb = await cronJobManager.findEntity({
43
- routeContext,
44
- filters: [{ operator: "eq", field: "code", value: jobCode }],
45
- });
46
-
47
- if (cronJobInDb) {
48
- let nextRunningTime: string | null;
49
- nextRunningTime = formatDateTimeWithTimezone(jobInstance.nextDate().toISO());
50
-
51
- await cronJobManager.updateEntityById({
52
- routeContext,
53
- id: cronJobInDb.id,
54
- entityToSave: {
55
- nextRunningTime,
56
- } as Partial<SysCronJob>,
57
- });
58
- }
59
-
60
- jobInstance.start();
61
- }
62
-
63
- async #setJobNextRunningTime(routeContext: RouteContext, jobCode: string, nextRunningTime: string | null) {
64
- const server = this.#server;
65
- const cronJobManager = server.getEntityManager<SysCronJob>("sys_cron_job");
66
- const cronJobInDb = await cronJobManager.findEntity({
67
- routeContext,
68
- filters: [{ operator: "eq", field: "code", value: jobCode }],
69
- });
70
- await cronJobManager.updateEntityById({
71
- routeContext,
72
- id: cronJobInDb.id,
73
- entityToSave: {
74
- nextRunningTime,
75
- } as Partial<SysCronJob>,
76
- });
77
- }
78
-
79
- /**
80
- * 重新加载定时任务
81
- */
82
- async reloadJobs() {
83
- const server = this.#server;
84
- const routeContext = RouteContext.newSystemOperationContext(server);
85
-
86
- if (this.#namedJobInstances) {
87
- for (const job of this.#namedJobInstances) {
88
- job.instance.stop();
89
- }
90
- }
91
-
92
- this.#namedJobInstances = [];
93
-
94
- const cronJobManager = server.getEntityManager<SysCronJob>("sys_cron_job");
95
- const cronJobConfigurationsInDb = await cronJobManager.findEntities({ routeContext });
96
-
97
- const cronJobConfigurations = server.listCronJobs();
98
- for (const cronJobConfig of cronJobConfigurations) {
99
- const jobCode = cronJobConfig.code;
100
- const jobConfigInDb = find(cronJobConfigurationsInDb, { code: jobCode });
101
- if (jobConfigInDb) {
102
- overrideJobConfig(cronJobConfig, jobConfigInDb);
103
- }
104
-
105
- if (cronJobConfig.disabled) {
106
- await this.#setJobNextRunningTime(routeContext, jobCode, null);
107
- continue;
108
- }
109
-
110
- const jobInstance = this.#createJobInstance(cronJobConfig);
111
- await this.#startJobInstance(routeContext, cronJobConfig, jobInstance);
112
-
113
- this.#namedJobInstances.push({
114
- code: jobCode,
115
- instance: jobInstance,
116
- });
117
- }
118
- }
119
-
120
- /**
121
- * 执行指定任务
122
- * @param job
123
- * @param input
124
- */
125
- async executeJob(job: CronJobConfiguration, input?: any) {
126
- const server = this.#server;
127
- const logger = server.getLogger();
128
-
129
- const jobCode = job.code;
130
- logger.info(`Executing cron job '${jobCode}'...`);
131
-
132
- let handlerContext: ActionHandlerContext = {
133
- logger,
134
- routerContext: RouteContext.newSystemOperationContext(server),
135
- next: null,
136
- server,
137
- applicationConfig: null,
138
- input,
139
- };
140
-
141
- let result: JobRunningResult;
142
- let lastErrorMessage: string | null;
143
- let lastErrorStack: string | null;
144
- try {
145
- validateLicense(server);
146
-
147
- if (job.actionHandlerCode) {
148
- const actionHandler = server.getActionHandlerByCode(job.code);
149
- await actionHandler(handlerContext, job.handleOptions);
150
- } else {
151
- await job.handler(handlerContext, job.handleOptions);
152
- }
153
- result = "success";
154
- logger.info(`Completed cron job '${jobCode}'...`);
155
- } catch (ex: any) {
156
- logger.error('Cron job "%s" execution error: %s', jobCode, ex.message);
157
- if (isString(ex)) {
158
- lastErrorMessage = ex;
159
- } else {
160
- lastErrorMessage = ex.message;
161
- lastErrorStack = ex.stack;
162
- }
163
- result = "failed";
164
-
165
- if (job.onError) {
166
- try {
167
- await job.onError(handlerContext, ex);
168
- } catch (ex) {
169
- logger.error('Error handler of cron job "%s" execution failed: %s', jobCode, ex.message);
170
- }
171
- }
172
- }
173
-
174
- try {
175
- const cronJobManager = server.getEntityManager<SysCronJob>("sys_cron_job");
176
- const cronJobInDb = await cronJobManager.findEntity({
177
- filters: [{ operator: "eq", field: "code", value: jobCode }],
178
- });
179
-
180
- if (cronJobInDb) {
181
- let nextRunningTime: string | null;
182
- const namedJobInstance = find(this.#namedJobInstances, { code: jobCode });
183
- if (namedJobInstance && namedJobInstance.instance) {
184
- nextRunningTime = formatDateTimeWithTimezone(namedJobInstance.instance.nextDate().toISO());
185
- }
186
-
187
- await cronJobManager.updateEntityById({
188
- id: cronJobInDb.id,
189
- entityToSave: {
190
- nextRunningTime,
191
- lastRunningResult: result,
192
- lastRunningTime: getNowStringWithTimezone(),
193
- lastErrorMessage,
194
- lastErrorStack,
195
- } as Partial<SysCronJob>,
196
- });
197
- }
198
- } catch (ex: any) {
199
- logger.error("Failed to saving cron job running result. job code: %s, error: %s", jobCode, ex.message);
200
- }
201
- }
202
-
203
- async updateJobConfig(routeContext: RouteContext, options: UpdateJobConfigOptions) {
204
- const server = this.#server;
205
- const cronJobs = server.listCronJobs();
206
- const jobCode = options.code;
207
- if (!jobCode) {
208
- throw new Error(`options.code is required.`);
209
- }
210
-
211
- const cronJobConfig = find(cronJobs, { code: jobCode });
212
- if (!cronJobConfig) {
213
- throw new Error(`Cron job with code "${jobCode}" not found.`);
214
- }
215
-
216
- if (!(["cronTime", "disabled", "jobOptions"] as (keyof typeof options)[]).some((field) => !isNil(options[field]))) {
217
- return;
218
- }
219
-
220
- overrideJobConfig(cronJobConfig, options);
221
-
222
- const namedJobInstance = find(this.#namedJobInstances, { code: jobCode });
223
- if (namedJobInstance && namedJobInstance.instance) {
224
- namedJobInstance.instance.stop();
225
- namedJobInstance.instance = null;
226
- }
227
-
228
- if (cronJobConfig.disabled) {
229
- await this.#setJobNextRunningTime(routeContext, jobCode, null);
230
- } else {
231
- const jobInstance = this.#createJobInstance(cronJobConfig);
232
- await this.#startJobInstance(routeContext, cronJobConfig, jobInstance);
233
-
234
- if (namedJobInstance) {
235
- namedJobInstance.instance = jobInstance;
236
- } else {
237
- this.#namedJobInstances.push({
238
- code: cronJobConfig.code,
239
- instance: jobInstance,
240
- });
241
- }
242
- }
243
- }
244
- }
245
-
246
- function overrideJobConfig(original: Partial<SysCronJob> | CronJobConfiguration, overrides: Partial<SysCronJob>) {
247
- (["cronTime", "disabled", "jobOptions"] as (keyof typeof overrides)[]).forEach((field: string) => {
248
- if (!isNil(overrides[field])) {
249
- original[field] = overrides[field];
250
- }
251
- });
252
- }
1
+ import { CronJob } from "cron";
2
+ import { IRpdServer } from "~/core/server";
3
+ import { find, isNil, isString, Many } from "lodash";
4
+ import { RouteContext } from "~/core/routeContext";
5
+ import { validateLicense } from "~/helpers/licenseHelper";
6
+ import { JobRunningResult, NamedCronJobInstance, SysCronJob, UpdateJobConfigOptions } from "../CronJobPluginTypes";
7
+ import { CronJobConfiguration } from "~/types/cron-job-types";
8
+ import { ActionHandlerContext } from "~/core/actionHandler";
9
+ import { formatDateTimeWithTimezone, getNowStringWithTimezone } from "~/utilities/timeUtility";
10
+
11
+ export default class CronJobService {
12
+ #server: IRpdServer;
13
+ #namedJobInstances: NamedCronJobInstance[];
14
+
15
+ constructor(server: IRpdServer) {
16
+ this.#server = server;
17
+ }
18
+
19
+ /**
20
+ * 根据编号获取定时任务配置信息
21
+ * @param code
22
+ * @returns
23
+ */
24
+ getJobConfigurationByCode(code: string) {
25
+ return find(this.#server.listCronJobs(), (job) => job.code === code);
26
+ }
27
+
28
+ #createJobInstance(job: CronJobConfiguration) {
29
+ return CronJob.from({
30
+ ...(job.jobOptions || {}),
31
+ cronTime: job.cronTime,
32
+ onTick: async () => {
33
+ await this.executeJob(job);
34
+ },
35
+ });
36
+ }
37
+
38
+ async #startJobInstance(routeContext: RouteContext, jobConfiguration: CronJobConfiguration, jobInstance: CronJob) {
39
+ const server = this.#server;
40
+ const jobCode = jobConfiguration.code;
41
+ const cronJobManager = server.getEntityManager<SysCronJob>("sys_cron_job");
42
+ const cronJobInDb = await cronJobManager.findEntity({
43
+ routeContext,
44
+ filters: [{ operator: "eq", field: "code", value: jobCode }],
45
+ });
46
+
47
+ if (cronJobInDb) {
48
+ let nextRunningTime: string | null;
49
+ nextRunningTime = formatDateTimeWithTimezone(jobInstance.nextDate().toISO());
50
+
51
+ await cronJobManager.updateEntityById({
52
+ routeContext,
53
+ id: cronJobInDb.id,
54
+ entityToSave: {
55
+ nextRunningTime,
56
+ } as Partial<SysCronJob>,
57
+ });
58
+ }
59
+
60
+ jobInstance.start();
61
+ }
62
+
63
+ async #setJobNextRunningTime(routeContext: RouteContext, jobCode: string, nextRunningTime: string | null) {
64
+ const server = this.#server;
65
+ const cronJobManager = server.getEntityManager<SysCronJob>("sys_cron_job");
66
+ const cronJobInDb = await cronJobManager.findEntity({
67
+ routeContext,
68
+ filters: [{ operator: "eq", field: "code", value: jobCode }],
69
+ });
70
+ await cronJobManager.updateEntityById({
71
+ routeContext,
72
+ id: cronJobInDb.id,
73
+ entityToSave: {
74
+ nextRunningTime,
75
+ } as Partial<SysCronJob>,
76
+ });
77
+ }
78
+
79
+ /**
80
+ * 重新加载定时任务
81
+ */
82
+ async reloadJobs() {
83
+ const server = this.#server;
84
+ const routeContext = RouteContext.newSystemOperationContext(server);
85
+
86
+ if (this.#namedJobInstances) {
87
+ for (const job of this.#namedJobInstances) {
88
+ job.instance.stop();
89
+ }
90
+ }
91
+
92
+ this.#namedJobInstances = [];
93
+
94
+ const cronJobManager = server.getEntityManager<SysCronJob>("sys_cron_job");
95
+ const cronJobConfigurationsInDb = await cronJobManager.findEntities({ routeContext });
96
+
97
+ const cronJobConfigurations = server.listCronJobs();
98
+ for (const cronJobConfig of cronJobConfigurations) {
99
+ const jobCode = cronJobConfig.code;
100
+ const jobConfigInDb = find(cronJobConfigurationsInDb, { code: jobCode });
101
+ if (jobConfigInDb) {
102
+ overrideJobConfig(cronJobConfig, jobConfigInDb);
103
+ }
104
+
105
+ if (cronJobConfig.disabled) {
106
+ await this.#setJobNextRunningTime(routeContext, jobCode, null);
107
+ continue;
108
+ }
109
+
110
+ const jobInstance = this.#createJobInstance(cronJobConfig);
111
+ await this.#startJobInstance(routeContext, cronJobConfig, jobInstance);
112
+
113
+ this.#namedJobInstances.push({
114
+ code: jobCode,
115
+ instance: jobInstance,
116
+ });
117
+ }
118
+ }
119
+
120
+ /**
121
+ * 执行指定任务
122
+ * @param job
123
+ * @param input
124
+ */
125
+ async executeJob(job: CronJobConfiguration, input?: any) {
126
+ const server = this.#server;
127
+ const logger = server.getLogger();
128
+
129
+ const jobCode = job.code;
130
+ logger.info(`Executing cron job '${jobCode}'...`);
131
+
132
+ let handlerContext: ActionHandlerContext = {
133
+ logger,
134
+ routerContext: RouteContext.newSystemOperationContext(server),
135
+ next: null,
136
+ server,
137
+ applicationConfig: null,
138
+ input,
139
+ };
140
+
141
+ let result: JobRunningResult;
142
+ let lastErrorMessage: string | null;
143
+ let lastErrorStack: string | null;
144
+ try {
145
+ validateLicense(server);
146
+
147
+ if (job.actionHandlerCode) {
148
+ const actionHandler = server.getActionHandlerByCode(job.code);
149
+ await actionHandler(handlerContext, job.handleOptions);
150
+ } else {
151
+ await job.handler(handlerContext, job.handleOptions);
152
+ }
153
+ result = "success";
154
+ logger.info(`Completed cron job '${jobCode}'...`);
155
+ } catch (ex: any) {
156
+ logger.error('Cron job "%s" execution error: %s', jobCode, ex.message);
157
+ if (isString(ex)) {
158
+ lastErrorMessage = ex;
159
+ } else {
160
+ lastErrorMessage = ex.message;
161
+ lastErrorStack = ex.stack;
162
+ }
163
+ result = "failed";
164
+
165
+ if (job.onError) {
166
+ try {
167
+ await job.onError(handlerContext, ex);
168
+ } catch (ex) {
169
+ logger.error('Error handler of cron job "%s" execution failed: %s', jobCode, ex.message);
170
+ }
171
+ }
172
+ }
173
+
174
+ try {
175
+ const cronJobManager = server.getEntityManager<SysCronJob>("sys_cron_job");
176
+ const cronJobInDb = await cronJobManager.findEntity({
177
+ filters: [{ operator: "eq", field: "code", value: jobCode }],
178
+ });
179
+
180
+ if (cronJobInDb) {
181
+ let nextRunningTime: string | null;
182
+ const namedJobInstance = find(this.#namedJobInstances, { code: jobCode });
183
+ if (namedJobInstance && namedJobInstance.instance) {
184
+ nextRunningTime = formatDateTimeWithTimezone(namedJobInstance.instance.nextDate().toISO());
185
+ }
186
+
187
+ await cronJobManager.updateEntityById({
188
+ id: cronJobInDb.id,
189
+ entityToSave: {
190
+ nextRunningTime,
191
+ lastRunningResult: result,
192
+ lastRunningTime: getNowStringWithTimezone(),
193
+ lastErrorMessage,
194
+ lastErrorStack,
195
+ } as Partial<SysCronJob>,
196
+ });
197
+ }
198
+ } catch (ex: any) {
199
+ logger.error("Failed to saving cron job running result. job code: %s, error: %s", jobCode, ex.message);
200
+ }
201
+ }
202
+
203
+ async updateJobConfig(routeContext: RouteContext, options: UpdateJobConfigOptions) {
204
+ const server = this.#server;
205
+ const cronJobs = server.listCronJobs();
206
+ const jobCode = options.code;
207
+ if (!jobCode) {
208
+ throw new Error(`options.code is required.`);
209
+ }
210
+
211
+ const cronJobConfig = find(cronJobs, { code: jobCode });
212
+ if (!cronJobConfig) {
213
+ throw new Error(`Cron job with code "${jobCode}" not found.`);
214
+ }
215
+
216
+ if (!(["cronTime", "disabled", "jobOptions"] as (keyof typeof options)[]).some((field) => !isNil(options[field]))) {
217
+ return;
218
+ }
219
+
220
+ overrideJobConfig(cronJobConfig, options);
221
+
222
+ const namedJobInstance = find(this.#namedJobInstances, { code: jobCode });
223
+ if (namedJobInstance && namedJobInstance.instance) {
224
+ namedJobInstance.instance.stop();
225
+ namedJobInstance.instance = null;
226
+ }
227
+
228
+ if (cronJobConfig.disabled) {
229
+ await this.#setJobNextRunningTime(routeContext, jobCode, null);
230
+ } else {
231
+ const jobInstance = this.#createJobInstance(cronJobConfig);
232
+ await this.#startJobInstance(routeContext, cronJobConfig, jobInstance);
233
+
234
+ if (namedJobInstance) {
235
+ namedJobInstance.instance = jobInstance;
236
+ } else {
237
+ this.#namedJobInstances.push({
238
+ code: cronJobConfig.code,
239
+ instance: jobInstance,
240
+ });
241
+ }
242
+ }
243
+ }
244
+ }
245
+
246
+ function overrideJobConfig(original: Partial<SysCronJob> | CronJobConfiguration, overrides: Partial<SysCronJob>) {
247
+ (["cronTime", "disabled", "jobOptions"] as (keyof typeof overrides)[]).forEach((field: string) => {
248
+ if (!isNil(overrides[field])) {
249
+ original[field] = overrides[field];
250
+ }
251
+ });
252
+ }