namespace Dpz.Core.Service;

[Obsolete("缓存辅助接口已过时，请使用 CacheAttribute 配合源生成缓存装饰器。")]
public interface ICacheService
{
    string BuildCacheKey(string method, object? parameters = null);

    /// <summary>
    /// 从缓存获取数据或通过工厂方法设置缓存
    /// </summary>
    Task<T> GetOrSetCacheAsync<T>(
        string methodName,
        Func<FusionCacheFactoryExecutionContext<T>, CancellationToken, Task<T>> factory,
        object? parameters = null,
        Action<FusionCacheEntryOptions>? setupAction = null,
        CancellationToken cancellationToken = default
    );

    /// <summary>
    /// 尝试从缓存获取数据
    /// </summary>
    ValueTask<MaybeValue<T>> TryGetFromCacheAsync<T>(
        string methodName,
        object? parameters = null,
        CancellationToken cancellationToken = default
    );

    /// <summary>
    /// 设置缓存数据
    /// </summary>
    Task SetCacheAsync<T>(
        string methodName,
        T value,
        object? parameters = null,
        CancellationToken cancellationToken = default,
        params string[] additionalTags
    );

    /// <summary>
    /// 移除缓存
    /// </summary>
    /// <param name="methodName"></param>
    /// <param name="parameters"></param>
    /// <param name="cancellationToken">传播通知操作应取消的通知令牌</param>
    /// <returns></returns>
    Task RemoveCacheAsync(
        string methodName,
        object? parameters = null,
        CancellationToken cancellationToken = default
    );

    /// <summary>
    /// 获取分页数据或通过工厂方法设置缓存
    /// </summary>
    /// <param name="methodName"></param>
    /// <param name="factory"></param>
    /// <param name="parameters"></param>
    /// <param name="setupAction"></param>
    /// <param name="cancellationToken">传播通知操作应取消的通知令牌</param>
    /// <param name="additionalTags"></param>
    /// <typeparam name="T"></typeparam>
    /// <returns></returns>
    Task<IPagedList<T>> GetOrSetPagedListAsync<T>(
        string methodName,
        Func<List<string>, CancellationToken, Task<IPagedList<T>>> factory,
        object? parameters = null,
        Action<FusionCacheEntryOptions>? setupAction = null,
        CancellationToken cancellationToken = default,
        params string[] additionalTags
    );

    /// <summary>
    /// 根据方法名称清除缓存
    /// </summary>
    /// <returns></returns>
    ValueTask RemoveByMethodAsync(string methodName, CancellationToken cancellationToken = default);

    /// <summary>
    /// 根据前缀清除缓存
    /// </summary>
    /// <returns></returns>
    ValueTask RemoveByPrefixAsync(CancellationToken cancellationToken = default);
}