package com.takensoft.cms.accesCtrl.service;

import com.takensoft.cms.accesCtrl.vo.AccesCtrlVO;

import com.takensoft.common.exception.CustomUpdateFailException;
import jakarta.servlet.http.HttpServletRequest;
import org.springframework.dao.DataAccessException;

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

/**
 * @author takensoft
 * @since 2024.04.01
 * @modification
 *     since    |    author    | description
 *  2024.04.01  |  takensoft   | 최초 등록
 *  2024.04.09  |  takensoft   | accesCtrlSave, findAllAccesCtrlSecurity, findByAccesCtrl 추가
 *  2024.04.12  |  takensoft   | findAll 추가
 *  2024.04.15  |  takensoft   | accesCtrlUpdate 추가
 *
 * 접근 제어 관련 인터페이스
 */
public interface AccesCtrlService {

    /**
     * @param accesCtrlVO - 접근 제어 정보
     * @return Map<String, Object>
     *  - result : 접근 제어 등록 결과
     *  - acsCntrlId : 접근 제어 아이디
     *
     * 접근 제어 등록
     */
    public Map<String, Object> accesCtrlSave(AccesCtrlVO accesCtrlVO);

    /**
     * @param accesCtrlVO - 접근 제어 정보
     * @return int - 접근 제어 수정 결과
     *
     * 접근 제어 수정
     */
    public int accesCtrlUpdate(AccesCtrlVO accesCtrlVO);

    /**
     * @param params - 검색조건 및 페이징 정보
     * @return Map<String, Object>
     *  - list : 접근 제어 목록
     *  - pagination : 페이징 정보
     *  - codeList : 접근 제어 하위 코드 그룹 목록
     *
     * 접근 제어 조회(관리자 페이지용)
     */
    public Map<String, Object> findAll(Map<String, String> params);

    /**
     * @param ip - 아이피
     * @return List<AccesCtrlVO> - 접근 제어 정보를 담고 있는 객체 목록
     *
     * 접근 제어 조회(시스템용 - 시큐리티 접근 제어)
     */
    public List<AccesCtrlVO> findAllAccesCtrlSecurity(String ip);

    /**
     * @param acsCntrlId - 접근 제어 아이디
     * @return Map<String, Object>
     *  - accesCtrl : 접근 제어 정보
     *  - codeList : 접근 제어 하위 코드 그룹 목록
     *
     * 접근 제어 상세 조회
     */
    public Map<String, Object> findByAccesCtrl(int acsCntrlId);
}