mm_dao 1.9.1 → 1.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 (198) hide show
  1. package/index.js +3 -17
  2. package/lib/admin.js +24 -0
  3. package/lib/dao.js +38 -1219
  4. package/lib/dao_crud.js +379 -0
  5. package/lib/dao_fields.js +145 -0
  6. package/lib/dao_query.js +238 -0
  7. package/lib/dao_scope.js +203 -0
  8. package/lib/dao_stats.js +129 -0
  9. package/lib/dao_transfer.js +358 -0
  10. package/lib/manager.js +17 -34
  11. package/lib/script.tpl.js +4 -4
  12. package/package.json +10 -3
  13. package/tool/dao/index.js +173 -4
  14. package/tool/dao/tool.json +56 -5
  15. package/tool/dao_admin/index.js +36 -0
  16. package/tool/dao_admin/tool.json +11 -0
  17. package/db/mm/user_account/_meta.json +0 -54
  18. package/db/mm.db +0 -0
  19. package/eslint.config.js +0 -235
  20. package/example/index.js +0 -78
  21. package/lib/tools/dao/index.js +0 -73
  22. package/lib/tools/index.js +0 -16
  23. package/test_db/dao_test_1785991977965/account/1.json +0 -6
  24. package/test_db/dao_test_1785991977965/account/2.json +0 -6
  25. package/test_db/dao_test_1785991977965/account/_meta.json +0 -18
  26. package/test_db/dao_test_1785991977965/role/1.json +0 -7
  27. package/test_db/dao_test_1785991977965/role/2.json +0 -7
  28. package/test_db/dao_test_1785991977965/role/3.json +0 -7
  29. package/test_db/dao_test_1785991977965/role/_meta.json +0 -18
  30. package/test_db/dao_test_1785991977965/tool/_meta.json +0 -18
  31. package/test_db/dao_test_1785991977965/tool/bow_001.json +0 -8
  32. package/test_db/dao_test_1785991977965/tool/robe_001.json +0 -8
  33. package/test_db/dao_test_1785991977965/tool/shield_001.json +0 -8
  34. package/test_db/dao_test_1785991977965/tool/staff_001.json +0 -8
  35. package/test_db/dao_test_1785991977965/tool/sword_001.json +0 -8
  36. package/test_db/dao_test_1785993793800/account/1.json +0 -58
  37. package/test_db/dao_test_1785993793800/account/2.json +0 -25
  38. package/test_db/dao_test_1785993793800/account/_meta.json +0 -18
  39. package/test_db/dao_test_1785993793800/role/1.json +0 -7
  40. package/test_db/dao_test_1785993793800/role/2.json +0 -7
  41. package/test_db/dao_test_1785993793800/role/3.json +0 -7
  42. package/test_db/dao_test_1785993793800/role/_meta.json +0 -18
  43. package/test_db/dao_test_1785993793800/tool/_meta.json +0 -18
  44. package/test_db/dao_test_1785993793800/tool/bow_001.json +0 -8
  45. package/test_db/dao_test_1785993793800/tool/robe_001.json +0 -8
  46. package/test_db/dao_test_1785993793800/tool/shield_001.json +0 -8
  47. package/test_db/dao_test_1785993793800/tool/staff_001.json +0 -8
  48. package/test_db/dao_test_1785993793800/tool/sword_001.json +0 -8
  49. package/test_db/dao_test_1785993841615/account/1.json +0 -58
  50. package/test_db/dao_test_1785993841615/account/2.json +0 -25
  51. package/test_db/dao_test_1785993841615/account/_meta.json +0 -18
  52. package/test_db/dao_test_1785993841615/role/1.json +0 -7
  53. package/test_db/dao_test_1785993841615/role/2.json +0 -7
  54. package/test_db/dao_test_1785993841615/role/3.json +0 -7
  55. package/test_db/dao_test_1785993841615/role/_meta.json +0 -18
  56. package/test_db/dao_test_1785993841615/tool/_meta.json +0 -18
  57. package/test_db/dao_test_1785993841615/tool/bow_001.json +0 -8
  58. package/test_db/dao_test_1785993841615/tool/robe_001.json +0 -8
  59. package/test_db/dao_test_1785993841615/tool/shield_001.json +0 -8
  60. package/test_db/dao_test_1785993841615/tool/staff_001.json +0 -8
  61. package/test_db/dao_test_1785993841615/tool/sword_001.json +0 -8
  62. package/test_db/dao_test_1785998204124/account/1.json +0 -58
  63. package/test_db/dao_test_1785998204124/account/2.json +0 -25
  64. package/test_db/dao_test_1785998204124/account/_meta.json +0 -18
  65. package/test_db/dao_test_1785998204124/role/1.json +0 -7
  66. package/test_db/dao_test_1785998204124/role/2.json +0 -7
  67. package/test_db/dao_test_1785998204124/role/3.json +0 -7
  68. package/test_db/dao_test_1785998204124/role/_meta.json +0 -18
  69. package/test_db/dao_test_1785998204124/tool/_meta.json +0 -18
  70. package/test_db/dao_test_1785998204124/tool/bow_001.json +0 -8
  71. package/test_db/dao_test_1785998204124/tool/robe_001.json +0 -8
  72. package/test_db/dao_test_1785998204124/tool/shield_001.json +0 -8
  73. package/test_db/dao_test_1785998204124/tool/staff_001.json +0 -8
  74. package/test_db/dao_test_1785998204124/tool/sword_001.json +0 -8
  75. package/test_db/dao_test_1785998207460/account/1.json +0 -58
  76. package/test_db/dao_test_1785998207460/account/2.json +0 -25
  77. package/test_db/dao_test_1785998207460/account/_meta.json +0 -18
  78. package/test_db/dao_test_1785998207460/role/1.json +0 -7
  79. package/test_db/dao_test_1785998207460/role/2.json +0 -7
  80. package/test_db/dao_test_1785998207460/role/3.json +0 -7
  81. package/test_db/dao_test_1785998207460/role/_meta.json +0 -18
  82. package/test_db/dao_test_1785998207460/tool/_meta.json +0 -18
  83. package/test_db/dao_test_1785998207460/tool/bow_001.json +0 -8
  84. package/test_db/dao_test_1785998207460/tool/robe_001.json +0 -8
  85. package/test_db/dao_test_1785998207460/tool/shield_001.json +0 -8
  86. package/test_db/dao_test_1785998207460/tool/staff_001.json +0 -8
  87. package/test_db/dao_test_1785998207460/tool/sword_001.json +0 -8
  88. package/test_db/dao_test_1785998210638/account/1.json +0 -58
  89. package/test_db/dao_test_1785998210638/account/2.json +0 -25
  90. package/test_db/dao_test_1785998210638/account/_meta.json +0 -18
  91. package/test_db/dao_test_1785998210638/role/1.json +0 -7
  92. package/test_db/dao_test_1785998210638/role/2.json +0 -7
  93. package/test_db/dao_test_1785998210638/role/3.json +0 -7
  94. package/test_db/dao_test_1785998210638/role/_meta.json +0 -18
  95. package/test_db/dao_test_1785998210638/tool/_meta.json +0 -18
  96. package/test_db/dao_test_1785998210638/tool/bow_001.json +0 -8
  97. package/test_db/dao_test_1785998210638/tool/robe_001.json +0 -8
  98. package/test_db/dao_test_1785998210638/tool/shield_001.json +0 -8
  99. package/test_db/dao_test_1785998210638/tool/staff_001.json +0 -8
  100. package/test_db/dao_test_1785998210638/tool/sword_001.json +0 -8
  101. package/test_db/dao_test_1785998213852/account/1.json +0 -58
  102. package/test_db/dao_test_1785998213852/account/2.json +0 -25
  103. package/test_db/dao_test_1785998213852/account/_meta.json +0 -18
  104. package/test_db/dao_test_1785998213852/role/1.json +0 -7
  105. package/test_db/dao_test_1785998213852/role/2.json +0 -7
  106. package/test_db/dao_test_1785998213852/role/3.json +0 -7
  107. package/test_db/dao_test_1785998213852/role/_meta.json +0 -18
  108. package/test_db/dao_test_1785998213852/tool/_meta.json +0 -18
  109. package/test_db/dao_test_1785998213852/tool/bow_001.json +0 -8
  110. package/test_db/dao_test_1785998213852/tool/robe_001.json +0 -8
  111. package/test_db/dao_test_1785998213852/tool/shield_001.json +0 -8
  112. package/test_db/dao_test_1785998213852/tool/staff_001.json +0 -8
  113. package/test_db/dao_test_1785998213852/tool/sword_001.json +0 -8
  114. package/test_db/dao_test_1785998217094/account/1.json +0 -58
  115. package/test_db/dao_test_1785998217094/account/2.json +0 -25
  116. package/test_db/dao_test_1785998217094/account/_meta.json +0 -18
  117. package/test_db/dao_test_1785998217094/role/1.json +0 -7
  118. package/test_db/dao_test_1785998217094/role/2.json +0 -7
  119. package/test_db/dao_test_1785998217094/role/3.json +0 -7
  120. package/test_db/dao_test_1785998217094/role/_meta.json +0 -18
  121. package/test_db/dao_test_1785998217094/tool/_meta.json +0 -18
  122. package/test_db/dao_test_1785998217094/tool/bow_001.json +0 -8
  123. package/test_db/dao_test_1785998217094/tool/robe_001.json +0 -8
  124. package/test_db/dao_test_1785998217094/tool/shield_001.json +0 -8
  125. package/test_db/dao_test_1785998217094/tool/staff_001.json +0 -8
  126. package/test_db/dao_test_1785998217094/tool/sword_001.json +0 -8
  127. package/test_db/dao_test_1786000291805/account/1.json +0 -58
  128. package/test_db/dao_test_1786000291805/account/2.json +0 -25
  129. package/test_db/dao_test_1786000291805/account/_meta.json +0 -18
  130. package/test_db/dao_test_1786000291805/role/1.json +0 -7
  131. package/test_db/dao_test_1786000291805/role/2.json +0 -7
  132. package/test_db/dao_test_1786000291805/role/3.json +0 -7
  133. package/test_db/dao_test_1786000291805/role/_meta.json +0 -18
  134. package/test_db/dao_test_1786000291805/tool/_meta.json +0 -18
  135. package/test_db/dao_test_1786000291805/tool/bow_001.json +0 -8
  136. package/test_db/dao_test_1786000291805/tool/robe_001.json +0 -8
  137. package/test_db/dao_test_1786000291805/tool/shield_001.json +0 -8
  138. package/test_db/dao_test_1786000291805/tool/staff_001.json +0 -8
  139. package/test_db/dao_test_1786000291805/tool/sword_001.json +0 -8
  140. package/test_db/dao_test_1786001183999/account/1.json +0 -58
  141. package/test_db/dao_test_1786001183999/account/2.json +0 -25
  142. package/test_db/dao_test_1786001183999/account/_meta.json +0 -18
  143. package/test_db/dao_test_1786001183999/role/1.json +0 -7
  144. package/test_db/dao_test_1786001183999/role/2.json +0 -7
  145. package/test_db/dao_test_1786001183999/role/3.json +0 -7
  146. package/test_db/dao_test_1786001183999/role/_meta.json +0 -18
  147. package/test_db/dao_test_1786001183999/tool/_meta.json +0 -18
  148. package/test_db/dao_test_1786001183999/tool/bow_001.json +0 -8
  149. package/test_db/dao_test_1786001183999/tool/robe_001.json +0 -8
  150. package/test_db/dao_test_1786001183999/tool/shield_001.json +0 -8
  151. package/test_db/dao_test_1786001183999/tool/staff_001.json +0 -8
  152. package/test_db/dao_test_1786001183999/tool/sword_001.json +0 -8
  153. package/test_db/dao_test_1786001297521/account/1.json +0 -58
  154. package/test_db/dao_test_1786001297521/account/2.json +0 -25
  155. package/test_db/dao_test_1786001297521/account/_meta.json +0 -18
  156. package/test_db/dao_test_1786001297521/role/1.json +0 -7
  157. package/test_db/dao_test_1786001297521/role/2.json +0 -7
  158. package/test_db/dao_test_1786001297521/role/3.json +0 -7
  159. package/test_db/dao_test_1786001297521/role/_meta.json +0 -18
  160. package/test_db/dao_test_1786001297521/tool/_meta.json +0 -18
  161. package/test_db/dao_test_1786001297521/tool/bow_001.json +0 -8
  162. package/test_db/dao_test_1786001297521/tool/robe_001.json +0 -8
  163. package/test_db/dao_test_1786001297521/tool/shield_001.json +0 -8
  164. package/test_db/dao_test_1786001297521/tool/staff_001.json +0 -8
  165. package/test_db/dao_test_1786001297521/tool/sword_001.json +0 -8
  166. package/test_db/debug_dao_1785992422444/account/1.json +0 -24
  167. package/test_db/debug_dao_1785992422444/account/_meta.json +0 -18
  168. package/test_db/debug_dao_1785992422444/role/1.json +0 -7
  169. package/test_db/debug_dao_1785992422444/role/2.json +0 -7
  170. package/test_db/debug_dao_1785992422444/role/_meta.json +0 -18
  171. package/test_db/debug_dao_1785992422444/tool/_meta.json +0 -18
  172. package/test_db/debug_dao_1785992422444/tool/shield_001.json +0 -7
  173. package/test_db/debug_dao_1785992422444/tool/staff_001.json +0 -7
  174. package/test_db/debug_dao_1785992422444/tool/sword_001.json +0 -7
  175. package/test_db/debug_dao_1785993785567/account/1.json +0 -47
  176. package/test_db/debug_dao_1785993785567/account/_meta.json +0 -18
  177. package/test_db/debug_dao_1785993785567/role/1.json +0 -7
  178. package/test_db/debug_dao_1785993785567/role/2.json +0 -7
  179. package/test_db/debug_dao_1785993785567/role/_meta.json +0 -18
  180. package/test_db/debug_dao_1785993785567/tool/_meta.json +0 -18
  181. package/test_db/debug_dao_1785993785567/tool/shield_001.json +0 -7
  182. package/test_db/debug_dao_1785993785567/tool/staff_001.json +0 -7
  183. package/test_db/debug_dao_1785993785567/tool/sword_001.json +0 -7
  184. package/test_db/debug_dao_check/tool/_meta.json +0 -18
  185. package/test_db/debug_dao_check/tool/sword_001.json +0 -6
  186. package/test_db/test_1785973671479/users/1.json +0 -5
  187. package/test_db/test_1785973671479/users/_meta.json +0 -20
  188. package/tests/dao_test.js +0 -213
  189. package/tests/debug_error_test.js +0 -165
  190. package/tests/debug_test.js +0 -35
  191. package/tests/debug_test2.js +0 -45
  192. package/tests/debug_test3.js +0 -54
  193. package/tests/detailed_error_test.js +0 -171
  194. package/tests/main.test.js +0 -261
  195. package/tests/query.test.js +0 -142
  196. package/tests/scope.test.js +0 -72
  197. package/tests/test.js +0 -325
  198. package/tests/test2.js +0 -64
@@ -0,0 +1,238 @@
1
+ const { string } = require('mm_helper');
2
+
3
+ /**
4
+ * 查询条件构建
5
+ * 本文件为 Dao 原型扩展的职责分片:参数抽取、字段/排序设置、查询串构建。
6
+ * 函数最终挂载到 Dao.prototype,内部通过 this 访问 Dao 实例。
7
+ */
8
+
9
+ /**
10
+ * SQL操作准备
11
+ * @param {object} db 数据库操作类
12
+ * @param {object} query 查询条件
13
+ * @returns {object} 返回准备参数
14
+ */
15
+ function ready(db, query) {
16
+ let cg = this.config;
17
+ let qy = { ...query };
18
+ this._extractQuery(db, qy, cg);
19
+ return {
20
+ cg,
21
+ qy,
22
+ };
23
+ }
24
+
25
+ /**
26
+ * 抽取控制参数,确保 qy 中只剩真正的 SQL 查询条件
27
+ * 按 filter 清单逐个抽取,与取值真假无关(page=0、size='' 同样会被抽走),
28
+ * 只有真值才赋给数据管理器,避免把空值写成 ''
29
+ * @param {object} db 数据库操作类
30
+ * @param {object} qy 查询条件
31
+ * @param {object} cg 配置
32
+ * @returns {object} 清理后的查询条件
33
+ * @private
34
+ */
35
+ function _extractQuery(db, qy, cg) {
36
+ let f = this._getFilter(cg);
37
+ for (let k in f) {
38
+ let name = f[k] || k;
39
+ let value = qy[name];
40
+ if (value === undefined) {
41
+ continue;
42
+ }
43
+ if (f[k] && value) {
44
+ db[k] = value;
45
+ }
46
+ delete qy[name];
47
+ }
48
+ // 空值不作为查询条件,避免被拼成 `field` = 'undefined'
49
+ for (let key in qy) {
50
+ if (qy[key] === undefined || qy[key] === null) {
51
+ delete qy[key];
52
+ }
53
+ }
54
+ return qy;
55
+ }
56
+
57
+ /**
58
+ * 转为查询条件字符串
59
+ * @param {object} db 数据库管理器
60
+ * @param {object} query 查寻条件
61
+ * @param {object} method 方法
62
+ * @returns {string} 返回查询条件
63
+ */
64
+ function toWhere(db, query, method) {
65
+ let { cg, qy } = this.ready(db, query);
66
+ this._setDbConfig(db, cg, query);
67
+ qy = this._setQueryField(db, query, cg, method, qy);
68
+ qy = this._setOrderBy(db, query, cg, qy);
69
+ return this._buildQueryString(db, qy, cg);
70
+ }
71
+
72
+ /**
73
+ * 设置数据库配置
74
+ * @param {object} db 数据库管理器
75
+ * @param {object} cg 配置
76
+ * @param {object} query 查询条件
77
+ * @private
78
+ */
79
+ function _setDbConfig(db, cg, query) {
80
+ let f = this._getFilter(cg);
81
+ // 只有未传 size 时才套用配置的分页大小(显式传 0 表示不分页,不能被覆盖)
82
+ let size = query[f.size];
83
+ if ((size === undefined || size === null || size === '') && cg.page_size) {
84
+ db.size = cg.page_size + 0;
85
+ }
86
+ if (db.size > 0 && db.page === 0) {
87
+ db.page = 1;
88
+ }
89
+ }
90
+
91
+ /**
92
+ * 设置查询字段
93
+ * @param {object} db 数据库管理器
94
+ * @param {object} query 查询条件
95
+ * @param {object} cg 配置
96
+ * @param {object} method 方法
97
+ * @param {object} qy 查询条件对象
98
+ * @returns {object} 更新后的查询条件对象
99
+ * @private
100
+ */
101
+ function _setQueryField(db, query, cg, method, qy) {
102
+ // 取本 dao 的配置(默认 + cg),不读 db.config.filter:后者是共享配置记录,会被其他 dao 覆盖
103
+ let f = this._getFilter(cg);
104
+ let field = query[f.field];
105
+ if (string.has(cg.field, '*{0}*')) {
106
+ if (field) {
107
+ let safe_field = typeof field === 'string' && string.validate(field, 'username') ? field : '';
108
+ if (safe_field) {
109
+ db.field = cg.field.replace('{0}', safe_field);
110
+ } else {
111
+ db.field = cg.field_default || cg.field + '';
112
+ }
113
+ } else if (method === 'get_obj' && cg.field_obj) {
114
+ db.field = cg.field_obj + '';
115
+ } else if (cg.field_default) {
116
+ db.field = cg.field_default + '';
117
+ }
118
+ } else {
119
+ db.field = cg.field + '';
120
+ if (field) {
121
+ return { ...qy, [f.field]: field };
122
+ }
123
+ }
124
+ return qy;
125
+ }
126
+
127
+ /**
128
+ * 设置排序方式
129
+ * @param {object} db 数据库管理器
130
+ * @param {object} query 查询条件
131
+ * @param {object} cg 配置
132
+ * @param {object} qy 查询条件对象
133
+ * @returns {object} 更新后的查询条件对象
134
+ * @private
135
+ */
136
+ function _setOrderBy(db, query, cg, qy) {
137
+ // 同上:按本 dao 的配置取参数名
138
+ let f = this._getFilter(cg);
139
+ let orderby = query[f.orderby];
140
+ if (string.has(cg.orderby, '*{0}*')) {
141
+ if (orderby) {
142
+ let safe_orderby = typeof orderby === 'string' && string.validate(orderby, 'username') ? orderby : '';
143
+ if (safe_orderby) {
144
+ db.orderby = cg.orderby.replace('{0}', safe_orderby);
145
+ } else {
146
+ db.orderby = cg.orderby_default || cg.orderby + '';
147
+ }
148
+ } else if (cg.orderby_default) {
149
+ db.orderby = cg.orderby_default + '';
150
+ }
151
+ } else {
152
+ db.orderby = cg.orderby + '';
153
+ if (orderby) {
154
+ return { ...qy, [f.orderby]: orderby };
155
+ }
156
+ }
157
+ return qy;
158
+ }
159
+
160
+ /**
161
+ * 构建查询字符串
162
+ * @param {object} db 数据库管理器
163
+ * @param {object} qy 查询条件对象
164
+ * @param {object} cg 配置
165
+ * @returns {string} 查询字符串
166
+ * @private
167
+ */
168
+ function _buildQueryString(db, qy, cg) {
169
+ return this._appendDefault(this._tplQuery(db, qy, cg), qy, cg.query_default, db);
170
+ }
171
+
172
+ /**
173
+ * 按本 dao 的分隔符拼接查询条件
174
+ * 分隔符存放在数据管理器的共享配置记录中,直接赋值会串到同表模型的其它请求,
175
+ * 因此仅在本次拼接期间生效,用完立即还原
176
+ * @param {object} db 数据库管理器
177
+ * @param {object} qy 查询条件对象
178
+ * @param {object} cg 配置
179
+ * @returns {string} 查询条件字符串
180
+ * @private
181
+ */
182
+ function _tplQuery(db, qy, cg) {
183
+ let cf = db.config;
184
+ if (!cf) {
185
+ return db.tplQuery(qy, cg.query);
186
+ }
187
+ let prev = cf.separator;
188
+ let sep = cg.separator;
189
+ if (sep === prev) {
190
+ return db.tplQuery(qy, cg.query);
191
+ }
192
+ cf.separator = sep;
193
+ try {
194
+ return db.tplQuery(qy, cg.query);
195
+ } finally {
196
+ if (prev === undefined) {
197
+ delete cf.separator;
198
+ } else {
199
+ cf.separator = prev;
200
+ }
201
+ }
202
+ }
203
+
204
+ /**
205
+ * 追加默认查询条件
206
+ * @param {string} query_str 已有查询条件
207
+ * @param {object} qy 查询条件对象
208
+ * @param {object} qt 默认查询条件模板
209
+ * @param {object} db 数据库管理器
210
+ * @returns {string} 追加后的查询条件
211
+ * @private
212
+ */
213
+ function _appendDefault(query_str, qy, qt, db) {
214
+ if (!qt || Object.keys(qt).length === 0) {
215
+ return query_str;
216
+ }
217
+ let ctx = (db && db.context) || {};
218
+ for (let k in qt) {
219
+ if (!qy[k]) {
220
+ // 用 AND 而非 &&:&& 只有 MySQL 认,SQLite 会当成语法错误,
221
+ // 而默认条件通常是用户/机构隔离条件,必须与具体数据库无关
222
+ query_str += ' AND ' + this._fillTpl(qt[k], ctx);
223
+ }
224
+ }
225
+ return query_str.replace(/^ AND /, '');
226
+ }
227
+
228
+ module.exports = {
229
+ ready,
230
+ _extractQuery,
231
+ toWhere,
232
+ _setDbConfig,
233
+ _setQueryField,
234
+ _setOrderBy,
235
+ _buildQueryString,
236
+ _tplQuery,
237
+ _appendDefault
238
+ };
@@ -0,0 +1,203 @@
1
+ const { getSql, sqlAdmin } = require('mm_sql');
2
+
3
+ /**
4
+ * 数据源选择与执行入口
5
+ * 本文件为 Dao 原型扩展的职责分片:占位符解析、模板填充、数据源派生与 run 入口。
6
+ * 函数最终挂载到 Dao.prototype,内部通过 this 访问 Dao 实例。
7
+ */
8
+
9
+ /**
10
+ * 解析本次调用的占位符取值
11
+ *
12
+ * 取值只来自两处,顺序即优先级:
13
+ * 1. options —— 宿主注入的上下文(已登录态、已校验的归属),可信;
14
+ * 2. query —— 请求参数,未登录/脚本调用时唯一的入口,属于「申请值」。
15
+ *
16
+ * 谁是可信的、该不该采信 query,是宿主的职责(在调用 dao 之前覆盖 query);
17
+ * 本层不认识 org_id、不认识租户,只认识「占位符 {key} 用同名的值填」。
18
+ * @param {object} [options] 宿主上下文
19
+ * @param {object} [query] 请求查询参数
20
+ * @returns {object} 占位符取值表
21
+ * @private
22
+ */
23
+ function _scope(options, query) {
24
+ let out = {};
25
+ const take = function (src) {
26
+ if (!src || typeof src !== 'object') {
27
+ return;
28
+ }
29
+ for (let k in src) {
30
+ let v = src[k];
31
+ if (v === undefined || v === null || v === '') {
32
+ continue;
33
+ }
34
+ // 只收标量:对象/数组不是占位符的取值
35
+ let t = typeof v;
36
+ if (t === 'string' || t === 'number' || t === 'boolean') {
37
+ out[k] = v;
38
+ }
39
+ }
40
+ };
41
+ take(query);
42
+ take(options);
43
+ return out;
44
+ }
45
+
46
+ /**
47
+ * 填充模板里的占位符 {key}
48
+ * 未解析的占位符一律置 0:隔离条件取不到归属时匹配空集(fail-closed),
49
+ * 而不是把 `{user_id}` 原样拼进 SQL 变成语法错误。
50
+ * @param {string} tpl 模板字符串
51
+ * @param {object} scope 取值表
52
+ * @returns {string} 填充结果
53
+ * @private
54
+ */
55
+ function _fillTpl(tpl, scope) {
56
+ let s = String(tpl);
57
+ if (s.indexOf('{') === -1) {
58
+ return s;
59
+ }
60
+ return s.replace(/\{(\w+)\}/g, function (all, key) {
61
+ let v = scope ? scope[key] : undefined;
62
+ return v === undefined || v === null || v === '' ? '0' : String(v);
63
+ });
64
+ }
65
+
66
+ /**
67
+ * 派生数据源配置:把 way 段里的 {key} 用取值表填上
68
+ *
69
+ * 库名/目录里出现占位符,即表示「本表按该字段分库」——例如 sqlite 的
70
+ * database 写成 org_{org_id},就由 org_id 决定打开 org_6.db。
71
+ * 这是纯约定,不需要在 dao.json 里额外声明隔离粒度。
72
+ * @param {object} sql_config 数据源配置
73
+ * @param {object} scope 取值表
74
+ * @returns {{key: string, config: object}|null} 派生结果;无占位符返回 null
75
+ * @throws {Error} 占位符取不到值时抛错(不允许打开 org_{org_id}.db 这种字面量库)
76
+ * @private
77
+ */
78
+ function _derive(sql_config, scope) {
79
+ let way = sql_config.way || sql_config.db_type;
80
+ let seg = way ? sql_config[way] : null;
81
+ if (!seg || typeof seg !== 'object') {
82
+ return null;
83
+ }
84
+ let keys = ['database', 'dir'];
85
+ let parts = [];
86
+ let has = false;
87
+ let config = { ...sql_config, [way]: { ...seg } };
88
+ for (let i = 0; i < keys.length; i++) {
89
+ let name = keys[i];
90
+ let raw = seg[name];
91
+ if (typeof raw !== 'string' || raw.indexOf('{') === -1) {
92
+ continue;
93
+ }
94
+ has = true;
95
+ let filled = String(raw).replace(/\{(\w+)\}/g, function (all, key) {
96
+ let v = scope ? scope[key] : undefined;
97
+ if (v === undefined || v === null || v === '') {
98
+ throw new Error('数据源占位符 {' + key + '} 取不到值,已拒绝按字面量打开数据库:' + raw);
99
+ }
100
+ return String(v);
101
+ });
102
+ config[way][name] = filled;
103
+ parts.push(filled);
104
+ }
105
+ return has ? { key: parts.join('|'), config } : null;
106
+ }
107
+
108
+ /**
109
+ * 获取本驱动绑定的 Sql 实例(数据源由本驱动配置决定)
110
+ * 作用域即数据域:os / user / org / project / client / app 各自可独立配置数据库;
111
+ * 未单独配置 sql 时复用进程级主库,便于同库分域与后续平滑拆库。
112
+ *
113
+ * 配置里有占位符(如 sqlite 的 database: 'org_{org_id}')时按取值派生独立实例:
114
+ * 不同 org_id 必须是不同的连接,共用实例会让第二个机构拿到第一个机构的库。
115
+ * @param {object} [scope] 占位符取值表(见 _scope/_derive)
116
+ * @returns {object} Sql 实例
117
+ * @private
118
+ */
119
+ function _getSql(scope) {
120
+ let name = this.config.scope || 'os';
121
+ let sql_config = this.config.sql;
122
+ if (!sql_config) {
123
+ return getSql();
124
+ }
125
+ let derived = this._derive(sql_config, scope);
126
+ if (!derived) {
127
+ if (!this._sql) {
128
+ this._sql = sqlAdmin(name, sql_config);
129
+ }
130
+ return this._sql;
131
+ }
132
+ if (!this._scoped_sql) {
133
+ this._scoped_sql = new Map();
134
+ }
135
+ let hit = this._scoped_sql.get(derived.key);
136
+ if (!hit) {
137
+ // 实例名带上派生值:mm_admin 只在首次创建时吃 config,
138
+ // 名字相同就会直接返回上一个实例的库
139
+ hit = sqlAdmin(name + '_' + derived.key, derived.config);
140
+ this._scoped_sql.set(derived.key, hit);
141
+ }
142
+ return hit;
143
+ }
144
+
145
+ /**
146
+ * 获取数据库管理器(委托本驱动绑定的 Sql 实例)
147
+ * @param {object} [scope] 占位符取值表
148
+ * @returns {object} 数据库管理器实例
149
+ */
150
+ function db(scope) {
151
+ return this._getSql(scope).db();
152
+ }
153
+
154
+ /**
155
+ * 读取并执行 .sql 文件脚本(委托本驱动绑定的 Sql 实例)
156
+ * @param {string} fpath SQL 文件路径
157
+ * @returns {Promise<object>} 执行结果统计对象
158
+ */
159
+ function load(fpath) {
160
+ return this._getSql().load(fpath);
161
+ }
162
+
163
+ /**
164
+ * 执行修改
165
+ * @param {object} query 查询url参数
166
+ * @param {object} body 修改时置入body的参数
167
+ * @param {object} [db] 数据库管理器,不传时由本驱动按自身配置选择数据源
168
+ * @param {object} [options] 宿主上下文(user_id / org_id 等占位符取值,优先于 query)
169
+ * @returns {Promise<object>} 返回执行结果
170
+ */
171
+ async function run(query, body, db, options) {
172
+ // 占位符取值在入口处解析一次,后续 main / 默认条件 / 默认字段共用同一份,
173
+ // 避免各层各解析一次导致「选库用了一个值、过滤用了另一个值」
174
+ let context = this._scope(options, query);
175
+ if (!db) {
176
+ db = this._getSql(context).db();
177
+ }
178
+ let params = {
179
+ query,
180
+ body,
181
+ context,
182
+ };
183
+ params = await this.before(params, db);
184
+ if (await this.check(params, db)) {
185
+ let ret = await this.main(params, db);
186
+ if (!ret.error) {
187
+ db.ret = ret;
188
+ return this.after(params, db);
189
+ }
190
+ return ret;
191
+ }
192
+ return null;
193
+ }
194
+
195
+ module.exports = {
196
+ _scope,
197
+ _fillTpl,
198
+ _derive,
199
+ _getSql,
200
+ db,
201
+ load,
202
+ run
203
+ };
@@ -0,0 +1,129 @@
1
+ const path = require('path');
2
+ const { string } = require('mm_helper');
3
+ const { getRet } = require('mm_ret');
4
+
5
+ /**
6
+ * 分组统计与模型导出
7
+ * 本文件为 Dao 原型扩展的职责分片:sum / avg / count 分组统计与 getModel。
8
+ * 函数最终挂载到 Dao.prototype,内部通过 this 访问 Dao 实例。
9
+ */
10
+
11
+ /**
12
+ * 分组统计(sum、avg、count 共用)
13
+ * @param {object} db 数据库管理器
14
+ * @param {object} param 查询条件
15
+ * @param {string} method 统计方法名 groupSumSql / groupAvgSql / groupCountSql
16
+ * @returns {Promise<object>} 返回执行结果
17
+ * @private
18
+ */
19
+ async function _statMain(db, param, method) {
20
+ let pm = { ...param };
21
+ let f = this._getFilter(this.config);
22
+ let orderby = pm[f.orderby] || '';
23
+ let groupby = pm[f.groupby];
24
+ let field = pm[f.field];
25
+ delete pm[f.orderby];
26
+ delete pm[f.groupby];
27
+ delete pm[f.field];
28
+ if (!groupby || !field) {
29
+ return getRet().error(30000, '参数groupby、field是必须的,且值不能为空!');
30
+ }
31
+ let query_str = this.toWhere(db, pm, 'get_list');
32
+ let list = await db[method](query_str, groupby, field, orderby);
33
+ if (!list.length && db.error) {
34
+ return getRet().body(db.error);
35
+ }
36
+ return getRet().list(list);
37
+ }
38
+
39
+ /**
40
+ * 总计
41
+ * @param {object} db 数据库管理器
42
+ * @param {object} param 查询条件
43
+ * @returns {Promise<object>} 返回执行结果
44
+ */
45
+ async function sumMain(db, param) {
46
+ return this._statMain(db, param, 'groupSumSql');
47
+ }
48
+
49
+ /**
50
+ * 总计
51
+ * @param {object} db 数据库管理器
52
+ * @param {object} query 查询条件
53
+ * @param {object} body 正文参数
54
+ * @returns {Promise<object>} 返回执行结果
55
+ */
56
+ async function sum(db, query, body) {
57
+ return this.sumMain(db, { ...query, ...body });
58
+ }
59
+
60
+ /**
61
+ * 平均值
62
+ * @param {object} db 数据库管理器
63
+ * @param {object} param 查询条件
64
+ * @returns {Promise<object>} 返回执行结果
65
+ */
66
+ async function avgMain(db, param) {
67
+ return this._statMain(db, param, 'groupAvgSql');
68
+ }
69
+
70
+ /**
71
+ * 平均值
72
+ * @param {object} db 数据库管理器
73
+ * @param {object} query 查询条件
74
+ * @param {object} body 正文参数
75
+ * @returns {Promise<object>} 返回执行结果
76
+ */
77
+ async function avg(db, query, body) {
78
+ return this.avgMain(db, { ...query, ...body });
79
+ }
80
+
81
+ /**
82
+ * 计数
83
+ * @param {object} db 数据库管理器
84
+ * @param {object} param 查询条件
85
+ * @returns {Promise<object>} 返回执行结果
86
+ */
87
+ async function countMain(db, param) {
88
+ return this._statMain(db, param, 'groupCountSql');
89
+ }
90
+
91
+ /**
92
+ * 计数
93
+ * @param {object} db 数据库管理器
94
+ * @param {object} query 查询条件
95
+ * @param {object} body 正文参数
96
+ * @returns {Promise<object>} 返回执行结果
97
+ */
98
+ async function count(db, query, body) {
99
+ return this.countMain(db, { ...query, ...body });
100
+ }
101
+
102
+ /**
103
+ * 获取模型
104
+ * @param {string} type 模型类型
105
+ * @returns {object} 返回获取到的模型
106
+ */
107
+ function getModel(type) {
108
+ let model = { ...this.config };
109
+ let dir = this.config.dir || '';
110
+ let l = path.sep;
111
+ let app_name = string.between(dir, 'app' + l, l);
112
+ let plugin_name = string.between(dir, 'plugin' + l, l);
113
+ let name = path.basename(dir);
114
+ model.app = app_name;
115
+ model.plugin = plugin_name;
116
+ model.name = model.name || app_name + '_' + name;
117
+ return model;
118
+ }
119
+
120
+ module.exports = {
121
+ _statMain,
122
+ sumMain,
123
+ sum,
124
+ avgMain,
125
+ avg,
126
+ countMain,
127
+ count,
128
+ getModel
129
+ };