|
|
package com.itheima.dao;
|
|
|
|
|
|
import com.itheima.po.DormRepair;
|
|
|
import org.apache.ibatis.annotations.Param;
|
|
|
|
|
|
import java.util.List;
|
|
|
|
|
|
/**
|
|
|
* @program: dormitorySystem
|
|
|
* @description: 维修登记，该接口主要定义了针对宿舍维修相关数据进行操作的一系列方法，这些方法会在对应的数据库访问实现类（例如MyBatis框架下的Mapper XML文件对应的具体实现类）中得以实现，
|
|
|
* 进而完成宿舍维修数据在数据库中的增删改查以及分页查询等业务操作。
|
|
|
* @author: Joyrocky
|
|
|
* @create: 2019-04-27 17:20
|
|
|
**/
|
|
|
public interface DormRepairDao {
|
|
|
|
|
|
/**
|
|
|
* 进行分页查询相关操作的方法声明部分
|
|
|
* 分页查询通常涉及两个核心步骤，一是统计符合特定条件的记录总条数，二是获取指定页码对应的记录列表，以下两个方法分别对应这两个功能。
|
|
|
*/
|
|
|
|
|
|
/**
|
|
|
* 获取总条数的方法声明
|
|
|
* 根据传入的宿舍维修记录的唯一标识ID以及宿舍楼栋信息等条件，从数据库中统计出符合这些条件的宿舍维修记录的总条数。
|
|
|
* 使用@Param注解为参数指定名称，方便在对应的SQL语句（例如MyBatis的Mapper XML文件里的SQL语句）中准确引用这些参数进行条件筛选和数据统计。
|
|
|
*
|
|
|
* @param d_id 宿舍维修记录的唯一标识ID（可为null，用于根据具体ID精确筛选统计，若为null则不按此条件筛选）。
|
|
|
* @param d_dormbuilding 宿舍楼栋信息（可为null，用于根据楼栋信息进行模糊或精确筛选统计，若为null则不按此条件筛选）。
|
|
|
* @return 返回符合条件的宿舍维修记录的总条数，类型为Integer。
|
|
|
*/
|
|
|
//获取总条数
|
|
|
public Integer totalCount(@Param("d_id") Integer d_id, @Param("d_dormbuilding") String d_dormbuilding);
|
|
|
|
|
|
/**
|
|
|
* 获取用户列表的方法声明
|
|
|
* 根据传入的宿舍维修记录的唯一标识ID、宿舍楼栋信息以及当前页码、每页显示数量等条件，从数据库中获取对应页的宿舍维修记录信息列表。
|
|
|
* 通过@Param注解明确参数名称，确保在SQL语句中能正确引用各参数来获取准确的数据。
|
|
|
*
|
|
|
* @param d_id 宿舍维修记录的唯一标识ID（可为null，用于根据具体ID精确筛选获取列表，若为null则不按此条件筛选）。
|
|
|
* @param d_dormbuilding 宿舍楼栋信息（可为null，用于根据楼栋信息进行模糊或精确筛选获取列表，若为null则不按此条件筛选）。
|
|
|
* @param currentPage 当前页码，用于确定要获取哪一页的数据，例如currentPage为1表示获取第一页的宿舍维修记录信息。
|
|
|
* @param pageSize 每页显示的记录数量，比如pageSize为10表示每页展示10条宿舍维修记录信息。
|
|
|
* @return 返回符合条件的当前页的宿舍维修记录信息列表，类型为List<DormRepair>。
|
|
|
*/
|
|
|
//获取用户列表
|
|
|
public List<DormRepair> getDormRepairList(@Param("d_id") Integer d_id, @Param("d_dormbuilding") String d_dormbuilding, @Param("currentPage") Integer currentPage, @Param("pageSize") Integer pageSize);
|
|
|
|
|
|
/**
|
|
|
* 添加宿舍信息的方法声明，这里准确来说是添加宿舍维修信息的方法声明
|
|
|
* 接收一个包含宿舍维修详细信息的DormRepair对象，将其信息插入到数据库中，实现添加宿舍维修记录的操作。
|
|
|
*
|
|
|
* @param dormrepair 包含要添加的宿舍维修详细信息的对象，例如维修的宿舍编号、维修项目、报修时间等相关信息。
|
|
|
* @return 返回一个整数，表示数据库受影响的行数，通常添加成功返回1，添加失败返回0等情况（具体取决于数据库操作的返回机制）。
|
|
|
*/
|
|
|
public int addDormRepair(DormRepair dormrepair); //添加宿舍信息
|
|
|
|
|
|
/**
|
|
|
* 删除宿舍信息的方法声明，此处确切是删除宿舍维修信息的方法声明
|
|
|
* 根据传入的宿舍维修记录的唯一标识ID，从数据库中删除对应的宿舍维修记录。
|
|
|
*
|
|
|
* @param r_id 要删除的宿舍维修记录的唯一标识ID。
|
|
|
* @return 返回一个整数，表示数据库受影响的行数，一般删除成功返回1，若未找到对应记录则删除失败返回0（具体取决于数据库操作的返回机制）。
|
|
|
*/
|
|
|
public int deleteDormRepair(Integer r_id); //删除宿舍信息
|
|
|
|
|
|
/**
|
|
|
* 修改宿舍信息的方法声明，也就是修改宿舍维修信息的方法声明
|
|
|
* 接收一个包含修改后宿舍维修信息的DormRepair对象，依据对象中的信息更新数据库中对应的宿舍维修记录。
|
|
|
*
|
|
|
* @param dormrepair 包含修改后的宿舍维修详细信息的对象，比如更新后的维修进度、维修完成时间等信息。
|
|
|
* @return 返回一个整数，表示数据库受影响的行数，一般更新成功返回1，更新失败返回0等情况（具体取决于数据库操作的返回机制）。
|
|
|
*/
|
|
|
public int updateDormRepair(DormRepair dormrepair); //修改宿舍信息
|
|
|
|
|
|
/**
|
|
|
* 根据宿舍维修记录ID查询宿舍维修信息的方法声明
|
|
|
* 根据传入的宿舍维修记录的唯一标识ID，从数据库中查找并返回对应的宿舍维修记录信息（以DormRepair对象形式返回）。
|
|
|
*
|
|
|
* @param r_id 要查询的宿舍维修记录的唯一标识ID。
|
|
|
* @return 返回查找到的DormRepair对象，如果没有找到对应记录则返回null。
|
|
|
*/
|
|
|
public DormRepair findDormRepairById(Integer r_id);
|
|
|
|
|
|
/**
|
|
|
* 获取所有宿舍维修信息的方法声明
|
|
|
* 从数据库中查询并返回所有的宿舍维修记录信息列表，用于一些需要获取全部宿舍维修数据的场景，比如导出所有宿舍维修信息等操作。
|
|
|
*
|
|
|
* @return 返回包含所有宿舍维修信息的列表，类型为List<DormRepair>。
|
|
|
*/
|
|
|
public List<DormRepair> getAll();
|
|
|
|
|
|
} |
