JiShe.CollectBus/src/JiShe.CollectBus.FreeRedisProvider/IFreeRedisProvider.cs

using FreeRedis;
using JiShe.CollectBus.Common.Models;

namespace JiShe.CollectBus.FreeRedisProvider
{
    public interface IFreeRedisProvider
    {
        /// <summary>
        ///     获取客户端
        /// </summary>
        /// <returns></returns>
        RedisClient Instance { get; set; }

        /// <summary>
        /// 单个添加数据
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="redisCacheKey">主数据存储Hash缓存Key</param>
        /// <param name="redisCacheFocusIndexKey">集中器索引Set缓存Key</param>
        /// <param name="redisCacheScoresIndexKey">集中器排序索引ZSET缓存Key</param>
        /// <param name="redisCacheGlobalIndexKey">集中器采集频率分组全局索引ZSet缓存Key</param>
        /// <param name="data">表计信息</param>
        /// <param name="timestamp">可选时间戳</param>
        /// <returns></returns>
        Task AddMeterCacheData<T>(
        string redisCacheKey,
        string redisCacheFocusIndexKey,
        string redisCacheScoresIndexKey,
        string redisCacheGlobalIndexKey,
        T data,
        DateTimeOffset? timestamp = null) where T : DeviceCacheBasicModel;

        /// <summary>
        /// 批量添加数据
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="redisCacheKey">主数据存储Hash缓存Key</param>
        /// <param name="redisCacheFocusIndexKey">集中器索引Set缓存Key</param>
        /// <param name="redisCacheScoresIndexKey">集中器排序索引ZSET缓存Key</param>
        /// <param name="redisCacheGlobalIndexKey">集中器采集频率分组全局索引ZSet缓存Key</param>
        /// <param name="items">数据集合</param>
        /// <param name="timestamp">可选时间戳</param>
        /// <returns></returns>
        Task BatchAddMeterData<T>(
        string redisCacheKey,
        string redisCacheFocusIndexKey,
        string redisCacheScoresIndexKey,
        string redisCacheGlobalIndexKey,
        IEnumerable<T> items,
        DateTimeOffset? timestamp = null) where T : DeviceCacheBasicModel;

        /// <summary>
        /// 删除指定redis缓存key的缓存数据
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="redisCacheKey">主数据存储Hash缓存Key</param>
        /// <param name="redisCacheFocusIndexKey">集中器索引Set缓存Key</param>
        /// <param name="redisCacheScoresIndexKey">集中器排序索引ZSET缓存Key</param>
        /// <param name="redisCacheGlobalIndexKey">集中器采集频率分组全局索引ZSet缓存Key</param>
        /// <param name="data">表计信息</param>
        /// <returns></returns>
        Task RemoveMeterData<T>(
        string redisCacheKey,
        string redisCacheFocusIndexKey,
        string redisCacheScoresIndexKey,
        string redisCacheGlobalIndexKey,
        T data) where T : DeviceCacheBasicModel;

        /// <summary>
        /// 修改表计缓存信息
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="redisCacheKey">主数据存储Hash缓存Key</param>
        /// <param name="oldRedisCacheFocusIndexKey">旧集中器索引Set缓存Key</param>
        /// <param name="newRedisCacheFocusIndexKey">新集中器索引Set缓存Key</param>
        /// <param name="redisCacheScoresIndexKey">集中器排序索引ZSET缓存Key</param>
        /// <param name="redisCacheGlobalIndexKey">集中器采集频率分组全局索引ZSet缓存Key</param>
        /// <param name="newData">表计信息</param>
        /// <param name="newTimestamp">可选时间戳</param>
        /// <returns></returns>
        Task UpdateMeterData<T>(
        string redisCacheKey,
        string oldRedisCacheFocusIndexKey,
        string newRedisCacheFocusIndexKey,
        string redisCacheScoresIndexKey,
        string redisCacheGlobalIndexKey,
        T newData,
        DateTimeOffset? newTimestamp = null) where T : DeviceCacheBasicModel;



        /// <summary>
        /// 通过全局索引分页查询表计缓存数据
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="redisCacheKey">主数据存储Hash缓存Key</param>
        /// <param name="redisCacheGlobalIndexKey">集中器采集频率分组全局索引ZSet缓存Key</param>
        /// <param name="pageSize">分页尺寸</param>
        /// <param name="lastScore">最后一个索引</param>
        /// <param name="lastMember">最后一个唯一标识</param>
        /// <param name="descending">排序方式</param>
        /// <returns></returns>
        Task<BusCacheGlobalPagedResult<T>> GetGlobalPagedData<T>(
        string redisCacheKey,
        string redisCacheGlobalIndexKey,
        int pageSize = 10,
        decimal? lastScore = null,
        string lastMember = null,
        bool descending = true)
        where T : DeviceCacheBasicModel;
    }
}