快速掌握SpringBoot项目中的domain、mapper、service、controller层作用与书写格式

承接上篇文章：http://t.csdn.cn/49QHB

①四个层负责的功能与作用：

1. Domain:包含业务实体,用于传输和封装数据。作用:作为数据载体,用于在各个模块之间传递业务数据。

2. Mapper:实现Domain与数据库表的映射及数据访问逻辑。作用:负责数据访问,将业务实体与数据库表进行映射,实现查询、新增、删除和修改操作。

3. Service:包含复杂的业务逻辑处理。 作用:负责业务逻辑相关处理,通过调用Mapper层的方法访问数据库,然后返回处理结果。Service层隐藏了数据访问细节,提供更加抽象的业务接口。

4. Controller:接收请求和解析参数,调用Service层的业务方法,返回响应。作用:负责请求接收、响应返回和参数解析,通过调用Service层的方法处理业务,然后将结果返回给客户端。所以,Controller层依赖Service层,但Service层不依赖于Controller层。

总结来说:

• Domain:用于数据传输,承载数据。
• Mapper:实现数据库操作,负责数据访问。
• Service:处理业务逻辑,通过Mapper层访问数据库。
• Controller:请求接收/响应返回,通过Service层处理业务逻辑。

②下面以具体代码，演示一般的书写逻辑与格式：

1.首先，创建如图所示的四个文件夹和一个子文件夹

2.domain层直接映射到数据库表，首先进行domain层代码的书写

（1）在书写代码前，需要先创建好数据库表

这里我以我已经创建好的 rf_ice_data 表为例进行演示，设计表格的参数如下：

（2）在 domain 层下，创建 RfIceData.java（Class），对应数据表字段可以写出如下代码：

@Data
public class RfIceData {
    @TableId(value = "id",type = IdType.AUTO)
    private Integer id;
    private String devId;
    private Date time;
    private Double temperature;
    private Double latitude;
    private Double longitude;
    @TableField(fill = FieldFill.INSERT)
    private Date createTime;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private Date updateTime;
    private int isDelete;
    private int projectId;
}

（3）以此类推，你的项目用到多少个表，就在 domain 下对应写多少个 java 文件

3.书写Mapper，实现对数据库字段的多种操作

（1）在 mapper 层下创建 RfIceData.java（Interface），书写以下代码

@Mapper
public interface RfIceDataMapper extends BaseMapper<RfIceData> {
}

（2）其他表，类比（1）进行书写，核心就是继承BaseMapper

4.书写Service，实现业务设计的逻辑部分（这里以条件查询为例）

（1）先写接口，确定逻辑功能的输入输出

public interface IRfDataService {
    /**
     * Description: 获取该设备该时间段内的全部数据批次
     * date: 2023/3/28 20:03
     * @param devId
     * @param startTime
     * @param endTime
     * @author: hzy
     * @since JDK 1.8
     */
    List<RfProject> getProjectDataByTime(String devId, String startTime, String endTime);
}

List为接口返回类型，（）内为传入参数

（2）在 impl 内书写接口的实现

@Service
@RequiredArgsConstructor
@Slf4j

public class RfDataServiceImpl implements IRfDataService {

    private final RfIceDataMapper rfIceDataMapper;

    @Override
    public List<RfProject> getProjectDataByTime(String devId, String startTime, String endTime) {
        QueryWrapper<RfProject> queryWrapper = new QueryWrapper<>();
        queryWrapper.eq("dev_id", devId)
                .ge("start_time",startTime)
                .le("end_time",endTime)
                .orderBy(true,true,"create_time");
        //rfproject数据填充（为了swagger界面能够显示）
        List<RfProject> rfProjects = rfProjectMapper.selectList(queryWrapper);
        for(RfProject rfProject : rfProjects){
            QueryWrapper<RfSample> queryWrapperSample = new QueryWrapper<>();
            queryWrapperSample.eq("project_id", rfProject.getId());
            QueryWrapper<RfPictureUrl> queryWrapperUrl = new QueryWrapper<>();
            queryWrapperUrl.eq("project_id", rfProject.getId());
            rfProject.setSampleList(rfSampleMapper.selectList(queryWrapperSample));
            rfProject.setUrlList(rfPictureUrlMapper.selectList(queryWrapperUrl));
        }
        return rfProjectMapper.selectList(queryWrapper);
    }
}

业务逻辑涉及数据表的查询，使用 Mybatis-Plus 的好处在于，Mybatis-Plus 提供的 QueryWrapper类可以简化SQL语句的书写。QueryWraper的方法简洁，功能可参考博客：http://t.csdn.cn/gGnCz

5.书写Controller，一般为简单调用service实现逻辑的接口，将结果返回至客户端，由app或前端处理这些数据。至此，后台的任务可以认为初步结束。

@RestController
@RequiredArgsConstructor
@RequestMapping(value = "/rf/RfDeviceData")
@Api(tags = {"冰箱app数据接口"},produces = MediaType.APPLICATION_JSON_VALUE)

public class RfDataController extends BaseController {

    private final IRfDataService rfDataService;

    @ApiOperation("获取该设备该时间段内的全部数据批次")
    @PostMapping("/getProjectDataByTime")
    public Map<String, Object> getProjectDataByTime(String devId,String startTime,String endTime){
        List<RfProject> res = rfDataService.getProjectDataByTime(devId, startTime, endTime);
        return success("获取时间段内工程数据成功", res);
    }