liding
2026-01-30 4579e4929a95836cf4f9d3029b97133791fc8e78
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
package com.ruoyi.fakeWarehousing.controller;
 
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.ruoyi.fakeWarehousing.dto.FakeDeliveryTrackDto;
import com.ruoyi.fakeWarehousing.pojo.FakeDeliveryTrack;
import com.ruoyi.fakeWarehousing.service.IFakeDeliveryTrackService;
import com.ruoyi.framework.aspectj.lang.annotation.Log;
import com.ruoyi.framework.aspectj.lang.enums.BusinessType;
import com.ruoyi.framework.web.domain.R;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.web.bind.annotation.*;
 
import javax.annotation.Resource;
import java.util.Arrays;
 
/**
 * 发货跟踪管理控制器
 * 基础路径:/fakeWarehousing/deliveryTrack
 */
@Api(tags = "发货跟踪管理接口")
@RestController
@RequestMapping("/fakeWarehousing/deliveryTrack")
public class FakeDeliveryTrackController {
 
    @Resource
    private IFakeDeliveryTrackService fakeDeliveryTrackService;
 
    /**
     * 分页查询发货跟踪列表
     *
     * @param page  分页参数
     * @param track 查询条件
     * @return 分页结果
     */
    @GetMapping("/list")
    @ApiOperation(value = "分页查询发货跟踪列表", notes = "分页查询发货跟踪列表")
    public IPage<FakeDeliveryTrack> list(Page<FakeDeliveryTrack> page, FakeDeliveryTrackDto trackDto) {
        return fakeDeliveryTrackService.selectAll(page, trackDto);
    }
 
    /**
     * 根据ID查询发货跟踪详情
     *
     * @param id 发货跟踪主键ID
     * @return 发货跟踪详情
     */
    @GetMapping("/{id}")
    @ApiOperation(value = "根据ID查询发货跟踪详情", notes = "根据ID查询发货跟踪详情")
    public R<FakeDeliveryTrack> getInfo(@PathVariable Long id) {
        return R.ok(fakeDeliveryTrackService.getById(id));
    }
 
    /**
     * 新增发货跟踪记录
     *
     * @param track 发货跟踪实体(含订单关联信息、发货信息等核心字段)
     * @return 操作结果
     */
    @Log(title = "新增发货跟踪记录", businessType = BusinessType.INSERT)
    @PostMapping
    @ApiOperation(value = "新增发货跟踪记录", notes = "新增发货跟踪记录")
    public R add(@RequestBody FakeDeliveryTrack track) {
        return R.ok(fakeDeliveryTrackService.saveDetail(track));
    }
 
    /**
     * 修改发货跟踪记录
     *
     * @param track 发货跟踪实体(必须包含主键ID)
     * @return 操作结果
     */
    @Log(title = "修改发货跟踪记录", businessType = BusinessType.UPDATE)
    @PutMapping
    @ApiOperation(value = "修改发货跟踪记录", notes = "修改发货跟踪记录")
    public R edit(@RequestBody FakeDeliveryTrack track) {
        if (track.getId() == null) {
            return R.fail("修改失败,发货跟踪ID不能为空");
        }
        return R.ok(fakeDeliveryTrackService.updateById(track));
    }
 
    /**
     * 删除发货跟踪记录(支持单条/多条删除)
     *
     * @param ids 发货跟踪主键ID数组
     * @return 操作结果
     */
    @Log(title = "发货跟踪管理", businessType = BusinessType.DELETE)
    @DeleteMapping("/{ids}")
    @ApiOperation(value = "删除发货跟踪记录", notes = "删除发货跟踪记录(支持单条/多条)")
    public R remove(@PathVariable Long[] ids) {
        return R.ok(fakeDeliveryTrackService.removeByIds(Arrays.asList(ids)));
    }
}