package com.lideeyunji.service.infra.service;

import com.lideeyunji.tool.framework.common.pojo.PageResult;
import com.lideeyunji.service.infra.dto.ApiAccessLogCreateReqDTO;
import com.lideeyunji.service.infra.controller.vo.logger.ApiAccessLogPageReqVO;
import com.lideeyunji.service.infra.entity.ApiAccessLogDO;

/**
 * API 访问日志 Service 接口
 *
 * @author 金灯剑客
 */
public interface IApiAccessLogService {

    /**
     * 创建 API 访问日志
     *
     * @param createReqDTO API 访问日志
     */
    void createApiAccessLog(ApiAccessLogCreateReqDTO createReqDTO);

    /**
     * 获得 API 访问日志分页
     *
     * @param pageReqVO 分页查询
     * @return API 访问日志分页
     */
    PageResult<ApiAccessLogDO> getApiAccessLogPage(ApiAccessLogPageReqVO pageReqVO);

    /**
     * 清理 exceedDay 天前的访问日志
     *
     * @param exceedDay 超过多少天就进行清理
     * @param deleteLimit 清理的间隔条数
     */
    Integer cleanAccessLog(Integer exceedDay, Integer deleteLimit);

}
