package com.itheima.service;  // 定义该接口所属的包路径为 com.itheima.service

import com.itheima.po.DormClean;  // 导入 DormClean 类，表示宿舍卫生的实体类
import com.itheima.po.PageInfo;  // 导入 PageInfo 类，用于封装分页信息

import java.util.List;  // 导入 List 类，用于存储多个 DormClean 对象

/**
 * @program: dormitorySystem  // 程序名称：宿舍管理系统
 * @description: 宿舍卫生服务接口  // 本接口定义了宿舍卫生相关的服务方法
 * @author: Joyrocky  // 作者：Joyrocky
 * @create: 2019-04-24 15:18  // 创建时间：2019年4月24日，15:18
 **/
public interface DormCleanService {

    /**
     * 分页查询宿舍卫生信息
     * @param d_id 宿舍ID，查询条件
     * @param d_dormbuilding 宿舍楼名，查询条件
     * @param pageIndex 当前页码
     * @param pageSize 每页显示的记录数
     * @return 返回封装了分页信息的 PageInfo 对象，包含查询结果和分页信息
     */
    public PageInfo<DormClean> findPageInfo(Integer d_id, String d_dormbuilding, Integer pageIndex, Integer pageSize);

    /**
     * 添加宿舍卫生信息
     * @param dormclean 要添加的宿舍卫生对象
     * @return 返回影响的行数，通常 1 表示添加成功，0 表示添加失败
     */
    public int addDormClean(DormClean dormclean);  // 添加宿舍卫生信息

    /**
     * 删除宿舍卫生信息
     * @param g_id 要删除的宿舍卫生记录ID
     * @return 返回影响的行数，通常 1 表示删除成功，0 表示删除失败
     */
    public int deleteDormClean(Integer g_id);  // 删除宿舍卫生信息

    /**
     * 修改宿舍卫生信息
     * @param dormclean 要更新的宿舍卫生对象
     * @return 返回影响的行数，通常 1 表示更新成功，0 表示更新失败
     */
    public int updateDormClean(DormClean dormclean);  // 修改宿舍卫生信息

    /**
     * 根据宿舍卫生ID查询单条记录
     * @param g_id 宿舍卫生记录的ID
     * @return 返回一个 DormClean 对象，表示查询到的宿舍卫生信息
     */
    public DormClean findDormCleanById(Integer g_id);  // 根据ID查询单条宿舍卫生信息

    /**
     * 获取所有宿舍卫生记录
     * @return 返回一个 List<DormClean>，包含所有宿舍卫生记录
     */
    public List<DormClean> getAll();  // 获取所有宿舍卫生记录
}
