缓存工具类

package com.zyq.util;

import lombok.Data;

import java.util.*;
import java.util.concurrent.ConcurrentLinkedDeque;

/**
 * 缓存工具类
 * <p>
 * 【说明】
 * 写这个工具类的背景是因为页面有的时候需要携带参数从A页面跳转到B页面，如果参数长度过大，
 * 就会导致url拼接过长，而url的长度是有限的。因此前端可以先请求后端，后端将数据保存在某处，
 * 然后返回一个uuid给前端，前端携带该uuid跳转到B页面，再通过该uuid拿到数据，
 * 这样就可以解决页面跳转参数过长丢失数据的问题。
 * <p>
 * 该工具类适用单节点部署的项目，或者多节点部署时路由规则是按用户进行路由的（写这个工具类也是先了解了该项目是单体部署的）。
 * 如果是多节点项目部署，且后端路由规则不是根据用户的话，那么该工具类就不适用。
 * 比如第一次请求获取的是后端1节点生成的uuid，但是再次访问的时候把uuid携带到了后端2节点，因此是获取不到的。
 * （可以将对应的数据缓存到Redis或数据库的方式进行存取）
 *
 * @author zyqok
 * @since 2023/7/20
 */
public class UserCacheUtils {

    /**
     * 清理过期数据最小周期时间（单位：毫秒），当前为1分钟
     */
    private static final long MIN_CLEAR_MILLISECONDS = 6000;

    /**
     * 缓存最小时间（单位：秒），当前为1秒
     */
    private static final long MIN_CACHE_SECONDS = 1;

    /**
     * 缓存最大时间（单位：秒），当前为1天
     */
    private static final long MAX_CACHE_SECONDS = 24 * 60 * 60;

    /**
     * 上一次清理过期数据的时间
     */
    private static long lastClearExpireTime = System.currentTimeMillis();

    /**
     * 缓存的数据
     */
    private static ConcurrentLinkedDeque<UserData> caches;


    /**
     * 清理过期数据
     */
    private static synchronized void clearExpire() {
        final long currentTime = System.currentTimeMillis();
        final long diffTime = currentTime - lastClearExpireTime;
        if (diffTime > MIN_CLEAR_MILLISECONDS && Objects.nonNull(caches)) {
            lastClearExpireTime = currentTime;
            caches.removeIf(o -> o.getExpireTime() <= currentTime);
        }
    }

    /**
     * 去获取过期时间
     *
     * @param seconds 缓存的时间（单位秒），区间为[1秒，24小时]
     */
    private static long getExpireTime(long seconds) {
        if (seconds < MIN_CACHE_SECONDS) {
            seconds = MIN_CACHE_SECONDS;
        }
        if (seconds > MAX_CACHE_SECONDS) {
            seconds = MAX_CACHE_SECONDS;
        }
        return System.currentTimeMillis() + seconds * 1000;
    }

    /**
     * 缓存数据
     *
     * @param userId 用户ID
     * @param val    缓存的数据（数据不能为null）
     * @return uuid 唯一性id
     */
    public static String put(int userId, Object val) {
        return put(userId, val, 60L);
    }

    /**
     * 缓存数据
     *
     * @param userId  用户ID
     * @param val     数据
     * @param seconds 秒
     * @return uuid 唯一性id
     */
    public static String put(int userId, Object val, long seconds) {
        clearExpire();
        if (Objects.isNull(val)) {
            return "";
        }
        String uuid = UUID.randomUUID().toString().replace("-", "");
        UserData data = new UserData();
        data.setUuid(uuid);
        data.setUserId(userId);
        data.setExpireTime(getExpireTime(seconds));
        data.setData(val);
        if (Objects.isNull(caches)) {
            caches = new ConcurrentLinkedDeque<>();
        }
        caches.add(data);
        return uuid;
    }

    /**
     * 获取缓存数据
     *
     * @param uuid uuid
     * @return 缓存的数据
     */
    public static Object get(int userId, String uuid) {
        clearExpire();
        if (Objects.isNull(uuid) || uuid.trim().isEmpty() || Objects.isNull(caches)) {
            return null;
        }
        for (UserData data : caches) {
            if (data.getUuid().equals(uuid) && data.getUserId() == userId) {
                return data.getData();
            }
        }
        return null;
    }


    @Data
    static class UserData {
        private String uuid;
        private int userId;
        private long expireTime;
        private Object data;
    }


}