package com.cm.population.service.censusmsg;

import com.cm.common.exception.RemoveException;
import com.cm.common.exception.SaveException;
import com.cm.common.exception.SearchException;
import com.cm.common.pojo.ListPage;
import com.cm.common.result.SuccessResult;
import com.cm.common.result.SuccessResultData;
import com.cm.common.result.SuccessResultList;
import com.cm.population.pojo.dtos.censusmsg.CensusMsgDTO;
import com.cm.population.pojo.vos.censusmsg.CensusMsgVO;

import java.util.List;
import java.util.Map;

/**
 * @ClassName: ICensusMsgService
 * @Description: 户籍信息
 * @Author: WenG
 * @Date: 2020-11-16 11:20
 * @Version: 1.0
 **/
public interface ICensusMsgService {

    /**
     * 新增户籍信息
     *
     * @param censusMsgVO
     * @return
     * @throws Exception
     */
    SuccessResult saveCensusMsg(CensusMsgVO censusMsgVO) throws Exception;

    /**
     * 新增户籍信息(APP)
     *
     * @param token
     * @param censusMsgVO
     * @return
     * @throws Exception
     */
    SuccessResult saveCensusMsgByToken(String token, CensusMsgVO censusMsgVO) throws Exception;

    /**
     * 新增户籍信息
     *
     * @param censusMsgVO
     * @return censusMsgId
     * @throws Exception
     */
    String saveCensusMsgReturnId(CensusMsgVO censusMsgVO) throws Exception;

    /**
     * 新增户籍信息(APP)
     *
     * @param token
     * @param censusMsgVO
     * @return censusMsgId
     * @throws Exception
     */
    String saveCensusMsgByTokenReturnId(String token, CensusMsgVO censusMsgVO) throws Exception;

    /**
     * 删除户籍信息
     *
     * @param ids
     * @return
     * @throws RemoveException
     */
    SuccessResult removeCensusMsg(String ids) throws RemoveException;

    /**
     * 删除户籍信息（物理删除）
     *
     * @param ids
     * @throws RemoveException
     */
    void deleteCensusMsg(String ids) throws RemoveException;

    /**
     * 删除户籍信息(APP)
     *
     * @param token
     * @param ids
     * @return
     * @throws RemoveException
     */
    SuccessResult removeCensusMsgByToken(String token, String ids) throws RemoveException;

    /**
     * 修改户籍信息
     *
     * @param censusMsgId
     * @param censusMsgVO
     * @return
     * @throws Exception
     */
    SuccessResult updateCensusMsg(String censusMsgId, CensusMsgVO censusMsgVO) throws Exception;

    /**
     * 修改户籍信息(APP)
     *
     * @param token
     * @param censusMsgId
     * @param censusMsgVO
     * @return
     * @throws Exception
     */
    SuccessResult updateCensusMsgByToken(String token, String censusMsgId, CensusMsgVO censusMsgVO) throws Exception;

    /**
     * 户籍信息详情(通过ID)
     *
     * @param censusMsgId
     * @return
     * @throws SearchException
     */
    CensusMsgDTO getCensusMsgById(String censusMsgId) throws SearchException;

    /**
     * 户籍信息列表
     *
     * @param params
     * @return
     * @throws SearchException
     */
    List<CensusMsgDTO> listCensusMsg(Map<String, Object> params) throws SearchException;

    /**
     * 户籍信息分页列表
     *
     * @param page
     * @return
     * @throws SearchException
     */
    SuccessResultList<List<CensusMsgDTO>> listPageCensusMsg(ListPage page) throws SearchException;

    /**
     * 户籍信息统计
     *
     * @param params
     * @return
     * @throws SearchException
     */
    Integer countNumberCensusMsg(Map<String, Object> params) throws SearchException;

    /**
     * 户籍信息统计
     *
     * @param params
     * @return
     * @throws SearchException
     */
    SuccessResultData<Integer> countCensusMsg(Map<String, Object> params) throws SearchException;

    /**
     * 通过身份证号码查询户籍信息是否存在
     * @param idCardNumber
     * @return
     */
    CensusMsgDTO hasMsg(String idCardNumber);
}