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

时间:2024-10-22 07:34:06

承接上篇文章:/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.首先,创建如图所示的四个文件夹和一个子文件夹

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

(1)在书写代码前,需要先创建好数据库表

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

 (2)在 domain 层下,创建 (Class),对应数据表字段可以写出如下代码:

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

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

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

(1)在 mapper 层下创建 (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<>();
        ("dev_id", devId)
                .ge("start_time",startTime)
                .le("end_time",endTime)
                .orderBy(true,true,"create_time");
        //rfproject数据填充(为了swagger界面能够显示)
        List<RfProject> rfProjects = (queryWrapper);
        for(RfProject rfProject : rfProjects){
            QueryWrapper<RfSample> queryWrapperSample = new QueryWrapper<>();
            ("project_id", ());
            QueryWrapper<RfPictureUrl> queryWrapperUrl = new QueryWrapper<>();
            ("project_id", ());
            ((queryWrapperSample));
            ((queryWrapperUrl));
        }
        return (queryWrapper);
    }
}

业务逻辑涉及数据表的查询,使用 Mybatis-Plus 的好处在于,Mybatis-Plus 提供的 QueryWrapper类可以简化SQL语句的书写。QueryWraper的方法简洁,功能可参考博客:/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 = (devId, startTime, endTime);
        return success("获取时间段内工程数据成功", res);
    }