@ruiapp/rapid-core 0.9.0 → 0.9.2

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