package com.service;

import com.baomidou.mybatisplus.mapper.Wrapper;
import com.baomidou.mybatisplus.service.IService;
import com.utils.PageUtils;
import com.entity.FapiaoxinxiEntity;
import java.util.List;
import java.util.Map;
import com.entity.vo.FapiaoxinxiVO;
import org.apache.ibatis.annotations.Param;
import com.entity.view.FapiaoxinxiView;

// 发票信息
//此接口定义了与发票信息相关的业务逻辑操作，继承自 MyBatis-Plus 的 IService 接口，
 // 具备对 FapiaoxinxiEntity 实体的基本增删改查功能，同时提供了一些自定义的查询和分页方法。
 // @author
 // @email
 // @date 2021-04-24 15:19:31

public interface FapiaoxinxiService extends IService<FapiaoxinxiEntity> {

	//根据传入的参数对发票信息进行分页查询。
	 // @param params 包含查询条件和分页信息的参数映射，如页码、每页记录数、筛选条件等。
	 // @return 封装了分页信息和查询结果的 PageUtils 对象，包含当前页的发票信息列表、总记录数、总页数等。

	PageUtils queryPage(Map<String, Object> params);

	//根据指定的查询条件，查询发票信息值对象（VO）列表。
	 // 值对象（VO）通常用于封装特定业务场景下需要展示或处理的数据，可能只包含实体类的部分字段。
	 //@param wrapper 用于构建查询条件的包装器，可设置各种条件（如等于、大于、小于等）来筛选发票信息。
	 // @return 符合查询条件的发票信息值对象列表，如果没有符合条件的数据则返回空列表。

	List<FapiaoxinxiVO> selectListVO(Wrapper<FapiaoxinxiEntity> wrapper);

	//根据指定的查询条件，查询单个发票信息值对象（VO）。
	 //@param wrapper 用于构建查询条件的包装器。
	 //@return 符合查询条件的单个发票信息值对象，如果没有符合条件的数据则返回 null。

	FapiaoxinxiVO selectVO(@Param("ew") Wrapper<FapiaoxinxiEntity> wrapper);

	// 根据指定的查询条件，查询发票信息视图对象列表。
	//视图对象通常用于展示数据，可能包含关联查询或格式化后的数据。
	 // @param wrapper 用于构建查询条件的包装器。
	// @return 符合查询条件的发票信息视图对象列表，如果没有符合条件的数据则返回空列表。

	List<FapiaoxinxiView> selectListView(Wrapper<FapiaoxinxiEntity> wrapper);

	//根据指定的查询条件，查询单个发票信息视图对象。
	 //@param wrapper 用于构建查询条件的包装器。
	 // @return 符合查询条件的单个发票信息视图对象，如果没有符合条件的数据则返回 null。

	FapiaoxinxiView selectView(@Param("ew") Wrapper<FapiaoxinxiEntity> wrapper);

	//根据传入的参数和查询条件对发票信息进行分页查询。
	 //@param params 包含查询条件和分页信息的参数映射。
	 //@param wrapper 用于构建查询条件的包装器，可进一步细化查询条件。
	 //@return 封装了分页信息和查询结果的 PageUtils 对象。

	PageUtils queryPage(Map<String, Object> params, Wrapper<FapiaoxinxiEntity> wrapper);
}