chengf
2026-01-27 b6184e2ddf3db37a94f7efb3b619bbc64642a292
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
package com.java110.fee.api.z2;
 
import com.alibaba.fastjson.JSONObject;
import com.java110.dto.importData.MailCallRecord;
import com.java110.utils.util.Assert;
import com.java110.utils.util.BeanConvertUtil;
import org.mybatis.spring.SqlSessionTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
 
import java.util.HashMap;
import java.util.List;
import java.util.Map;
 
/**
 * 邮寄信电联记录信息接口
 * 适配 mail_call_record 表
 * @author dev
 * @date 2025-12-24
 */
@RestController
@RequestMapping(value = "/mailCallRecord")
public class MailCallRecordApi {
 
    @Autowired
    protected SqlSessionTemplate sqlSessionTemplate;
 
    /**
     * 保存单条邮寄信电联记录信息
     *
     * @param reqJson 请求参数
     * @return 响应结果
     * @serviceCode /mailCallRecord/saveMailCallRecord
     * @path /app/mailCallRecord/saveMailCallRecord
     */
    @RequestMapping(value = "/saveMailCallRecord", method = RequestMethod.POST)
    public ResponseEntity<String> saveMailCallRecord(@RequestBody JSONObject reqJson) {
        // 核心参数校验
        Assert.hasKeyAndValue(reqJson, "mailId", "请求报文中未包含邮寄信编号mailId");
        Assert.hasKeyAndValue(reqJson, "callDate", "请求报文中未包含电联日期callDate");
        Assert.hasKeyAndValue(reqJson, "callContact", "请求报文中未包含被电联联系人callContact");
 
        // 转换为实体类
        MailCallRecord record = BeanConvertUtil.covertBean(reqJson, MailCallRecord.class);
 
        // 调用Mapper保存方法
        int insert = sqlSessionTemplate.insert("mailCallRecordServiceDaoImpl.saveMailCallRecord",
                BeanConvertUtil.beanCovertMap(record));
 
        // 构造响应结果
        JSONObject resJson = new JSONObject();
        if (insert > 0) {
            resJson.put("code", "0000");
            resJson.put("msg", "保存邮寄信电联记录信息成功");
        } else {
            resJson.put("code", "0001");
            resJson.put("msg", "保存邮寄信电联记录信息失败");
        }
        resJson.put("count", insert);
        return ResponseEntity.ok(resJson.toJSONString());
    }
 
    /**
     * 批量保存邮寄信电联记录信息
     *
     * @param reqJson 请求参数(包含mailCallRecordList数组)
     * @return 响应结果
     * @serviceCode /mailCallRecord/batchSaveMailCallRecord
     * @path /app/mailCallRecord/batchSaveMailCallRecord
     */
    @RequestMapping(value = "/batchSaveMailCallRecord", method = RequestMethod.POST)
    public ResponseEntity<String> batchSaveMailCallRecord(@RequestBody JSONObject reqJson) {
        Assert.hasKeyAndValue(reqJson, "mailCallRecordList", "请求报文中未包含批量数据列表mailCallRecordList");
 
        // 转换批量数据
        List<MailCallRecord> recordList = BeanConvertUtil.covertBeanList(
                reqJson.getJSONArray("mailCallRecordList"), MailCallRecord.class);
 
        Map<String, Object> param = new HashMap<>();
        param.put("mailCallRecordList", recordList);
 
        // 批量插入
        int insert = sqlSessionTemplate.insert("mailCallRecordServiceDaoImpl.batchSaveMailCallRecord", param);
 
        JSONObject resJson = new JSONObject();
        resJson.put("code", "0000");
        resJson.put("msg", "批量保存邮寄信电联记录信息成功");
        resJson.put("count", insert);
        return ResponseEntity.ok(resJson.toJSONString());
    }
 
    /**
     * 修改邮寄信电联记录信息
     *
     * @param reqJson 请求参数
     * @return 响应结果
     * @serviceCode /mailCallRecord/updateMailCallRecord
     * @path /app/mailCallRecord/updateMailCallRecord
     */
    @RequestMapping(value = "/updateMailCallRecord", method = RequestMethod.POST)
    public ResponseEntity<String> updateMailCallRecord(@RequestBody JSONObject reqJson) {
        // 主键校验(id 或 mailId 二选一)
        boolean hasId = reqJson.containsKey("id") && reqJson.getString("id") != null && !reqJson.getString("id").isEmpty();
        boolean hasMailId = reqJson.containsKey("mailId") && !reqJson.getString("mailId").isEmpty();
        Assert.isTrue(hasId || hasMailId, "请求报文中需包含主键ID,或包含邮寄信编号mailId");
 
        // 转换为实体类
        MailCallRecord record = BeanConvertUtil.covertBean(reqJson, MailCallRecord.class);
 
        // 调用Mapper修改方法
        int update = sqlSessionTemplate.update("mailCallRecordServiceDaoImpl.updateMailCallRecord",
                BeanConvertUtil.beanCovertMap(record));
 
        JSONObject resJson = new JSONObject();
        if (update > 0) {
            resJson.put("code", "0000");
            resJson.put("msg", "修改邮寄信电联记录信息成功");
        } else {
            resJson.put("code", "0001");
            resJson.put("msg", "修改邮寄信电联记录信息失败,未找到对应记录");
        }
        resJson.put("count", update);
        return ResponseEntity.ok(resJson.toJSONString());
    }
 
    /**
     * 删除邮寄信电联记录信息
     *
     * @param reqJson 请求参数
     * @return 响应结果
     * @serviceCode /mailCallRecord/deleteMailCallRecord
     * @path /app/mailCallRecord/deleteMailCallRecord
     */
    @RequestMapping(value = "/deleteMailCallRecord", method = RequestMethod.POST)
    public ResponseEntity<String> deleteMailCallRecord(@RequestBody JSONObject reqJson) {
        // 必要参数校验(至少包含一个筛选条件)
        boolean hasFilter = reqJson.containsKey("id") && reqJson.getString("id") != null && !reqJson.getString("id").isEmpty()
                || reqJson.containsKey("mailId") && !reqJson.getString("mailId").isEmpty()
                || reqJson.containsKey("callResult") && !reqJson.getString("callResult").isEmpty();
        Assert.isTrue(hasFilter, "请求报文中需包含id/mailId/callResult至少一个筛选条件");
 
        // 转换为实体类
        MailCallRecord record = BeanConvertUtil.covertBean(reqJson, MailCallRecord.class);
 
        // 调用Mapper删除方法
        int delete = sqlSessionTemplate.delete("mailCallRecordServiceDaoImpl.deleteMailCallRecord",
                BeanConvertUtil.beanCovertMap(record));
 
        JSONObject resJson = new JSONObject();
        if (delete > 0) {
            resJson.put("code", "0000");
            resJson.put("msg", "删除邮寄信电联记录信息成功");
        } else {
            resJson.put("code", "0001");
            resJson.put("msg", "删除邮寄信电联记录信息失败,未找到对应记录");
        }
        resJson.put("count", delete);
        return ResponseEntity.ok(resJson.toJSONString());
    }
 
    /**
     * 分页查询邮寄信电联记录信息列表
     *
     * @param page            页码(默认1)
     * @param row             每页条数(默认10)
     * @param id              主键ID(可选)
     * @param mailId          邮寄信编号(可选)
     * @param callDate        电联日期(可选)
     * @param callResult      电联结果(可选)
     * @param callContact     被电联联系人(可选)
     * @param caller          电联执行人员(可选)
     * @param startCreateTime 创建时间开始范围(可选)
     * @param endCreateTime   创建时间结束范围(可选)
     * @param startUpdateTime 更新时间开始范围(可选)
     * @param endUpdateTime   更新时间结束范围(可选)
     * @return 响应结果
     * @serviceCode /mailCallRecord/getMailCallRecord
     * @path /app/mailCallRecord/getMailCallRecord
     */
    @RequestMapping(value = "/getMailCallRecord", method = RequestMethod.GET)
    public ResponseEntity<String> getMailCallRecord(
            @RequestParam(value = "page", defaultValue = "1") int page,
            @RequestParam(value = "row", defaultValue = "10") int row,
            @RequestParam(value = "id", required = false) String id,
            @RequestParam(value = "mailId", required = false) String mailId,
            @RequestParam(value = "callDate", required = false) String callDate,
            @RequestParam(value = "callResult", required = false) String callResult,
            @RequestParam(value = "callContact", required = false) String callContact,
            @RequestParam(value = "caller", required = false) String caller,
            @RequestParam(value = "startCreateTime", required = false) String startCreateTime,
            @RequestParam(value = "endCreateTime", required = false) String endCreateTime,
            @RequestParam(value = "startUpdateTime", required = false) String startUpdateTime,
            @RequestParam(value = "endUpdateTime", required = false) String endUpdateTime) {
 
        // 封装查询参数
        Map<String, Object> param = new HashMap<>();
        param.put("page", (page - 1) * row); // 转换为MySQL分页偏移量
        param.put("row", row);
        param.put("id", id);
        param.put("mailId", mailId);
        param.put("callDate", callDate);
        param.put("callResult", callResult);
        param.put("callContact", callContact);
        param.put("caller", caller);
        param.put("startCreateTime", startCreateTime);
        param.put("endCreateTime", endCreateTime);
        param.put("startUpdateTime", startUpdateTime);
        param.put("endUpdateTime", endUpdateTime);
 
        // 查询列表数据
        List<Map<String, Object>> list = sqlSessionTemplate.selectList(
                "mailCallRecordServiceDaoImpl.getMailCallRecord", param);
 
        // 查询总数
        Map<String, Object> countMap = sqlSessionTemplate.selectOne(
                "mailCallRecordServiceDaoImpl.queryMailCallRecordCount", param);
        int total = countMap != null ? Integer.parseInt(countMap.get("count").toString()) : 0;
 
        // 构造分页响应
        JSONObject resJson = new JSONObject();
        resJson.put("code", "0000");
        resJson.put("msg", "查询邮寄信电联记录信息成功");
        resJson.put("page", page);
        resJson.put("row", row);
        resJson.put("total", total);
        resJson.put("data", BeanConvertUtil.covertBeanList(list, MailCallRecord.class));
 
        return ResponseEntity.ok(resJson.toJSONString());
    }
 
    /**
     * 查询邮寄信电联记录统计信息
     *
     * @param mailId          邮寄信编号(可选)
     * @param callResult      电联结果(可选)
     * @param startCreateTime 创建时间开始范围(可选)
     * @param endCreateTime   创建时间结束范围(可选)
     * @return 响应结果
     * @serviceCode /mailCallRecord/queryMailCallRecordStatistics
     * @path /app/mailCallRecord/queryMailCallRecordStatistics
     */
    @RequestMapping(value = "/queryMailCallRecordStatistics", method = RequestMethod.GET)
    public ResponseEntity<String> queryMailCallRecordStatistics(
            @RequestParam(value = "mailId", required = false) String mailId,
            @RequestParam(value = "callResult", required = false) String callResult,
            @RequestParam(value = "startCreateTime", required = false) String startCreateTime,
            @RequestParam(value = "endCreateTime", required = false) String endCreateTime) {
 
        // 封装查询参数
        Map<String, Object> param = new HashMap<>();
        param.put("mailId", mailId);
        param.put("callResult", callResult);
        param.put("startCreateTime", startCreateTime);
        param.put("endCreateTime", endCreateTime);
 
        // 统计查询
        Map<String, Object> statistics = sqlSessionTemplate.selectOne(
                "mailCallRecordServiceDaoImpl.queryMailCallRecordStatistics", param);
 
        JSONObject resJson = new JSONObject();
        resJson.put("code", "0000");
        resJson.put("msg", "统计邮寄信电联记录信息成功");
        resJson.put("data", statistics);
 
        return ResponseEntity.ok(resJson.toJSONString());
    }
 
    /**
     * 按年月分组统计邮寄信电联记录数量
     *
     * @param mailId          邮寄信编号(可选)
     * @param callResult      电联结果(可选)
     * @param startCreateTime 创建时间开始范围(可选)
     * @param endCreateTime   创建时间结束范围(可选)
     * @return 响应结果
     * @serviceCode /mailCallRecord/queryMailCallRecordByMonth
     * @path /app/mailCallRecord/queryMailCallRecordByMonth
     */
    @RequestMapping(value = "/queryMailCallRecordByMonth", method = RequestMethod.GET)
    public ResponseEntity<String> queryMailCallRecordByMonth(
            @RequestParam(value = "mailId", required = false) String mailId,
            @RequestParam(value = "callResult", required = false) String callResult,
            @RequestParam(value = "startCreateTime", required = false) String startCreateTime,
            @RequestParam(value = "endCreateTime", required = false) String endCreateTime) {
 
        // 封装查询参数
        Map<String, Object> param = new HashMap<>();
        param.put("mailId", mailId);
        param.put("callResult", callResult);
        param.put("startCreateTime", startCreateTime);
        param.put("endCreateTime", endCreateTime);
 
        // 按年月统计查询
        List<Map<String, Object>> resultList = sqlSessionTemplate.selectList(
                "mailCallRecordServiceDaoImpl.queryMailCallRecordByMonth", param);
 
        JSONObject resJson = new JSONObject();
        resJson.put("code", "0000");
        resJson.put("msg", "按年月分组统计邮寄信电联记录数量成功");
        resJson.put("data", resultList);
 
        return ResponseEntity.ok(resJson.toJSONString());
    }
 
    /**
     * 根据mail_id查询最新的邮寄信电联记录信息
     *
     * @param mailId 邮寄信编号(必选)
     * @return 响应结果
     * @serviceCode /mailCallRecord/getLatestMailCallRecordByMailId
     * @path /app/mailCallRecord/getLatestMailCallRecordByMailId
     */
    @RequestMapping(value = "/getLatestMailCallRecordByMailId", method = RequestMethod.GET)
    public ResponseEntity<String> getLatestMailCallRecordByMailId(
            @RequestParam(value = "mailId") String mailId) {
 
        // 参数校验
        Assert.hasLength(mailId, "邮寄信编号mailId不能为空");
 
        // 封装查询参数
        Map<String, Object> param = new HashMap<>();
        param.put("mailId", mailId);
 
        // 查询最新记录
        Map<String, Object> recordMap = sqlSessionTemplate.selectOne(
                "mailCallRecordServiceDaoImpl.getLatestMailCallRecordByMailId", param);
        MailCallRecord record = null;
        if (recordMap != null) {
            record = BeanConvertUtil.covertBean(recordMap, MailCallRecord.class);
        }
 
        JSONObject resJson = new JSONObject();
        resJson.put("code", "0000");
        resJson.put("msg", "查询最新邮寄信电联记录信息成功");
        resJson.put("data", record);
 
        return ResponseEntity.ok(resJson.toJSONString());
    }
}