@ruiapp/rapid-core 0.9.8 → 0.9.9

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 (196) hide show
  1. package/CHANGELOG.md +11 -11
  2. package/dist/helpers/entityHelper.d.ts +2 -2
  3. package/dist/index.js +28 -23
  4. package/package.json +1 -1
  5. package/rollup.config.js +16 -16
  6. package/src/bootstrapApplicationConfig.ts +782 -782
  7. package/src/core/actionHandler.ts +23 -23
  8. package/src/core/eventManager.ts +20 -20
  9. package/src/core/facility.ts +7 -7
  10. package/src/core/http/formDataParser.ts +89 -89
  11. package/src/core/http-types.ts +4 -4
  12. package/src/core/pluginManager.ts +193 -193
  13. package/src/core/providers/runtimeProvider.ts +5 -5
  14. package/src/core/request.ts +96 -96
  15. package/src/core/response.ts +79 -79
  16. package/src/core/routeContext.ts +127 -127
  17. package/src/core/routes/healthz.ts +20 -20
  18. package/src/core/routes/index.ts +3 -3
  19. package/src/core/routesBuilder.ts +110 -110
  20. package/src/core/server.ts +156 -156
  21. package/src/dataAccess/columnTypeMapper.ts +22 -22
  22. package/src/dataAccess/dataAccessTypes.ts +165 -165
  23. package/src/dataAccess/dataAccessor.ts +135 -135
  24. package/src/dataAccess/entityManager.ts +1932 -1932
  25. package/src/dataAccess/entityMapper.ts +111 -111
  26. package/src/dataAccess/entityValidator.ts +33 -33
  27. package/src/dataAccess/propertyMapper.ts +28 -28
  28. package/src/deno-std/assert/assert.ts +9 -9
  29. package/src/deno-std/assert/assertion_error.ts +7 -7
  30. package/src/deno-std/datetime/to_imf.ts +32 -32
  31. package/src/deno-std/encoding/base64.ts +141 -141
  32. package/src/deno-std/http/cookie.ts +372 -372
  33. package/src/facilities/cache/CacheFacilityTypes.ts +29 -29
  34. package/src/facilities/cache/CacheFactory.ts +31 -31
  35. package/src/facilities/cache/MemoryCache.ts +58 -58
  36. package/src/facilities/cache/MemoryCacheProvider.ts +15 -15
  37. package/src/facilities/log/LogFacility.ts +35 -35
  38. package/src/helpers/entityHelper.ts +89 -76
  39. package/src/helpers/filterHelper.ts +148 -148
  40. package/src/helpers/inputHelper.ts +11 -11
  41. package/src/helpers/licenseHelper.ts +29 -29
  42. package/src/helpers/metaHelper.ts +111 -111
  43. package/src/helpers/runCollectionEntityActionHandler.ts +58 -58
  44. package/src/index.ts +82 -82
  45. package/src/plugins/auth/AuthPlugin.ts +103 -103
  46. package/src/plugins/auth/AuthPluginTypes.ts +11 -11
  47. package/src/plugins/auth/actionHandlers/changePassword.ts +61 -61
  48. package/src/plugins/auth/actionHandlers/createSession.ts +68 -68
  49. package/src/plugins/auth/actionHandlers/deleteSession.ts +18 -18
  50. package/src/plugins/auth/actionHandlers/getMyProfile.ts +38 -38
  51. package/src/plugins/auth/actionHandlers/index.ts +8 -8
  52. package/src/plugins/auth/actionHandlers/resetPassword.ts +45 -45
  53. package/src/plugins/auth/models/AccessToken.ts +56 -56
  54. package/src/plugins/auth/models/index.ts +3 -3
  55. package/src/plugins/auth/routes/changePassword.ts +15 -15
  56. package/src/plugins/auth/routes/getMyProfile.ts +15 -15
  57. package/src/plugins/auth/routes/index.ts +7 -7
  58. package/src/plugins/auth/routes/resetPassword.ts +15 -15
  59. package/src/plugins/auth/routes/signin.ts +15 -15
  60. package/src/plugins/auth/routes/signout.ts +15 -15
  61. package/src/plugins/auth/services/AuthService.ts +39 -39
  62. package/src/plugins/cronJob/CronJobPlugin.ts +104 -104
  63. package/src/plugins/cronJob/CronJobPluginTypes.ts +44 -44
  64. package/src/plugins/cronJob/actionHandlers/index.ts +4 -4
  65. package/src/plugins/cronJob/actionHandlers/runCronJob.ts +32 -32
  66. package/src/plugins/cronJob/entityWatchers/cronJobEntityWatchers.ts +24 -24
  67. package/src/plugins/cronJob/entityWatchers/index.ts +4 -4
  68. package/src/plugins/cronJob/models/CronJob.ts +129 -129
  69. package/src/plugins/cronJob/models/index.ts +3 -3
  70. package/src/plugins/cronJob/routes/index.ts +3 -3
  71. package/src/plugins/cronJob/routes/runCronJob.ts +15 -15
  72. package/src/plugins/cronJob/services/CronJobService.ts +252 -252
  73. package/src/plugins/dataManage/DataManagePlugin.ts +163 -163
  74. package/src/plugins/dataManage/actionHandlers/addEntityRelations.ts +15 -15
  75. package/src/plugins/dataManage/actionHandlers/countCollectionEntities.ts +17 -17
  76. package/src/plugins/dataManage/actionHandlers/createCollectionEntitiesBatch.ts +81 -81
  77. package/src/plugins/dataManage/actionHandlers/createCollectionEntity.ts +20 -20
  78. package/src/plugins/dataManage/actionHandlers/deleteCollectionEntities.ts +45 -45
  79. package/src/plugins/dataManage/actionHandlers/deleteCollectionEntityById.ts +20 -20
  80. package/src/plugins/dataManage/actionHandlers/findCollectionEntities.ts +27 -27
  81. package/src/plugins/dataManage/actionHandlers/findCollectionEntityById.ts +30 -30
  82. package/src/plugins/dataManage/actionHandlers/queryDatabase.ts +22 -22
  83. package/src/plugins/dataManage/actionHandlers/removeEntityRelations.ts +15 -15
  84. package/src/plugins/dataManage/actionHandlers/updateCollectionEntityById.ts +38 -38
  85. package/src/plugins/entityAccessControl/EntityAccessControlPlugin.ts +146 -146
  86. package/src/plugins/fileManage/FileManagePlugin.ts +52 -52
  87. package/src/plugins/fileManage/actionHandlers/downloadDocument.ts +65 -65
  88. package/src/plugins/fileManage/actionHandlers/downloadFile.ts +44 -44
  89. package/src/plugins/fileManage/actionHandlers/uploadFile.ts +33 -33
  90. package/src/plugins/fileManage/routes/downloadDocument.ts +15 -15
  91. package/src/plugins/fileManage/routes/downloadFile.ts +15 -15
  92. package/src/plugins/fileManage/routes/index.ts +5 -5
  93. package/src/plugins/fileManage/routes/uploadFile.ts +15 -15
  94. package/src/plugins/license/LicensePlugin.ts +79 -79
  95. package/src/plugins/license/LicensePluginTypes.ts +95 -95
  96. package/src/plugins/license/LicenseService.ts +137 -137
  97. package/src/plugins/license/actionHandlers/getLicense.ts +18 -18
  98. package/src/plugins/license/actionHandlers/index.ts +5 -5
  99. package/src/plugins/license/actionHandlers/updateLicense.ts +24 -24
  100. package/src/plugins/license/helpers/certHelper.ts +21 -21
  101. package/src/plugins/license/helpers/cryptoHelper.ts +47 -47
  102. package/src/plugins/license/models/index.ts +1 -1
  103. package/src/plugins/license/routes/getLicense.ts +15 -15
  104. package/src/plugins/license/routes/index.ts +4 -4
  105. package/src/plugins/license/routes/updateLicense.ts +15 -15
  106. package/src/plugins/mail/MailPlugin.ts +74 -74
  107. package/src/plugins/mail/MailPluginTypes.ts +27 -27
  108. package/src/plugins/mail/MailService.ts +38 -38
  109. package/src/plugins/mail/actionHandlers/index.ts +3 -3
  110. package/src/plugins/mail/models/index.ts +1 -1
  111. package/src/plugins/mail/routes/index.ts +1 -1
  112. package/src/plugins/metaManage/MetaManagePlugin.ts +198 -198
  113. package/src/plugins/metaManage/actionHandlers/getMetaModelDetail.ts +10 -10
  114. package/src/plugins/metaManage/actionHandlers/listMetaModels.ts +9 -9
  115. package/src/plugins/metaManage/actionHandlers/listMetaRoutes.ts +9 -9
  116. package/src/plugins/metaManage/services/MetaService.ts +376 -376
  117. package/src/plugins/notification/NotificationPlugin.ts +68 -68
  118. package/src/plugins/notification/NotificationPluginTypes.ts +13 -13
  119. package/src/plugins/notification/NotificationService.ts +25 -25
  120. package/src/plugins/notification/actionHandlers/index.ts +3 -3
  121. package/src/plugins/notification/models/Notification.ts +60 -60
  122. package/src/plugins/notification/models/index.ts +3 -3
  123. package/src/plugins/notification/routes/index.ts +1 -1
  124. package/src/plugins/routeManage/RouteManagePlugin.ts +64 -64
  125. package/src/plugins/routeManage/actionHandlers/httpProxy.ts +13 -13
  126. package/src/plugins/routeManage/actionHandlers/mock.ts +28 -28
  127. package/src/plugins/sequence/SequencePlugin.ts +146 -146
  128. package/src/plugins/sequence/SequencePluginTypes.ts +69 -69
  129. package/src/plugins/sequence/SequenceService.ts +92 -92
  130. package/src/plugins/sequence/actionHandlers/generateSn.ts +32 -32
  131. package/src/plugins/sequence/actionHandlers/index.ts +4 -4
  132. package/src/plugins/sequence/models/SequenceAutoIncrementRecord.ts +49 -49
  133. package/src/plugins/sequence/models/SequenceRule.ts +42 -42
  134. package/src/plugins/sequence/models/index.ts +4 -4
  135. package/src/plugins/sequence/routes/generateSn.ts +15 -15
  136. package/src/plugins/sequence/routes/index.ts +3 -3
  137. package/src/plugins/sequence/segment-utility.ts +11 -11
  138. package/src/plugins/sequence/segments/autoIncrement.ts +90 -90
  139. package/src/plugins/sequence/segments/dayOfMonth.ts +19 -19
  140. package/src/plugins/sequence/segments/index.ts +9 -9
  141. package/src/plugins/sequence/segments/literal.ts +16 -16
  142. package/src/plugins/sequence/segments/month.ts +19 -19
  143. package/src/plugins/sequence/segments/parameter.ts +20 -20
  144. package/src/plugins/sequence/segments/year.ts +19 -19
  145. package/src/plugins/serverOperation/ServerOperationPlugin.ts +91 -91
  146. package/src/plugins/serverOperation/ServerOperationPluginTypes.ts +15 -15
  147. package/src/plugins/serverOperation/actionHandlers/index.ts +4 -4
  148. package/src/plugins/serverOperation/actionHandlers/runServerOperation.ts +15 -15
  149. package/src/plugins/setting/SettingPlugin.ts +68 -68
  150. package/src/plugins/setting/SettingPluginTypes.ts +37 -37
  151. package/src/plugins/setting/SettingService.ts +213 -213
  152. package/src/plugins/setting/actionHandlers/getSystemSettingValues.ts +30 -30
  153. package/src/plugins/setting/actionHandlers/getUserSettingValues.ts +38 -38
  154. package/src/plugins/setting/actionHandlers/index.ts +6 -6
  155. package/src/plugins/setting/actionHandlers/setSystemSettingValues.ts +30 -30
  156. package/src/plugins/setting/models/SystemSettingGroupSetting.ts +57 -57
  157. package/src/plugins/setting/models/SystemSettingItem.ts +48 -48
  158. package/src/plugins/setting/models/SystemSettingItemSetting.ts +73 -73
  159. package/src/plugins/setting/models/UserSettingGroupSetting.ts +57 -57
  160. package/src/plugins/setting/models/UserSettingItem.ts +55 -55
  161. package/src/plugins/setting/models/UserSettingItemSetting.ts +73 -73
  162. package/src/plugins/setting/models/index.ts +8 -8
  163. package/src/plugins/setting/routes/getSystemSettingValues.ts +15 -15
  164. package/src/plugins/setting/routes/getUserSettingValues.ts +15 -15
  165. package/src/plugins/setting/routes/index.ts +5 -5
  166. package/src/plugins/setting/routes/setSystemSettingValues.ts +15 -15
  167. package/src/plugins/stateMachine/StateMachinePlugin.ts +196 -196
  168. package/src/plugins/stateMachine/StateMachinePluginTypes.ts +48 -48
  169. package/src/plugins/stateMachine/actionHandlers/index.ts +4 -4
  170. package/src/plugins/stateMachine/actionHandlers/sendStateMachineEvent.ts +54 -54
  171. package/src/plugins/stateMachine/models/StateMachine.ts +42 -42
  172. package/src/plugins/stateMachine/models/index.ts +3 -3
  173. package/src/plugins/stateMachine/routes/index.ts +3 -3
  174. package/src/plugins/stateMachine/routes/sendStateMachineEvent.ts +15 -15
  175. package/src/plugins/stateMachine/stateMachineHelper.ts +36 -36
  176. package/src/plugins/webhooks/WebhooksPlugin.ts +148 -148
  177. package/src/plugins/webhooks/pluginConfig.ts +75 -75
  178. package/src/polyfill.ts +5 -5
  179. package/src/proxy/mod.ts +38 -38
  180. package/src/proxy/types.ts +21 -21
  181. package/src/queryBuilder/index.ts +1 -1
  182. package/src/queryBuilder/queryBuilder.ts +755 -755
  183. package/src/server.ts +530 -530
  184. package/src/types/cron-job-types.ts +66 -66
  185. package/src/types.ts +856 -856
  186. package/src/utilities/accessControlUtility.ts +33 -33
  187. package/src/utilities/entityUtility.ts +18 -18
  188. package/src/utilities/errorUtility.ts +15 -15
  189. package/src/utilities/fsUtility.ts +137 -137
  190. package/src/utilities/httpUtility.ts +19 -19
  191. package/src/utilities/jwtUtility.ts +26 -26
  192. package/src/utilities/passwordUtility.ts +26 -26
  193. package/src/utilities/pathUtility.ts +14 -14
  194. package/src/utilities/timeUtility.ts +17 -17
  195. package/src/utilities/typeUtility.ts +15 -15
  196. 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
+ }