H-Cache

Введение

1. Это легковесная структура кэширования, основанная на Java Native Framework. Она имитирует memcache и предоставляет такие функции, как кэширование с использованием аннотаций, алгоритм LRU и автоматическое восстановление неиспользуемого кэша.

2. Разработчикам на Java не нужно беспокоиться об удалении и восстановлении кэша, предоставляя различные способы использования кэша.

3. Данные хранятся в памяти, что сокращает время подключения к NoSQL и ускоряет работу кэша.

4. Предоставляет способ настройки Redis.

Инструкция по использованию

1. После того как проект будет преобразован в Maven jar-пакет, его необходимо импортировать в проект и настроить метод запуска кэша в проекте.

Пример:

public void cacheStart() {
    // Способ настройки H-Cache.
    LocalConfig localConfig = new LocalConfig();

    // Указываем префикс ключа для аннотации метода кэширования инструментов, чтобы предотвратить конфликты кэша инструментальных методов (необязательно).
    localConfig.setCacheKey("");

    // Включаем ли автоматическое восстановление (true — включить, false — выключить).
    localConfig.setOpenRecycle(true);

    // Частота проверки автоматического восстановления, передаваемая в секундах.
    localConfig.setRecycleTime(120);

    // Время интервала автоматического восстановления системы, которое будет очищено после последнего использования, если оно превысит указанное время, передаваемое в часах.
    localConfig.setIntervalTime(1);

    // Максимальный объём данных кэша по умолчанию равен 300.
    localConfig.setCacheMaxSize(3000);

    // Запускаем кэш.
    Bootstrap.start(localConfig);
}

// Структура также предоставляет способ настройки кэша базы данных Redis.

Пример:

public void cacheStart(){
    //Способ настройки Redis
    RedisConfig redisConfig=new RedisConfig();
    //Устанавливаем адрес подключения Redis
    redisConfig.setADDRESS("120.0.0.1");
    //Пароль базы данных, по умолчанию пустой
    redisConfig.setKEY(null);
    //Количество экземпляров Jedis в пуле соединений
    redisConfig.setMAX_TOTAL(2000);
    //Максимальное количество незанятых экземпляров Jedis
    redisConfig.setMAX_IDLE(100);
    //Номер порта Redis
    redisConfig.setPORT(6379);
    //Запускаем кэш
    Bootstrap.start(redisConfig);
}  

Использование аннотаций

@CachePut

Поля:

• key — ключ кэша;
• time — срок действия кэша (необязательный параметр);
• fields — стратегия генерации ключей кэша на основе параметров метода (например, public void getUser(User user), тогда @CachePut(key = "getXXXUser",fields = {"user.userName"}).

@CacheClear

Поля:

• key — ключ кэша;
• fields — стратегия генерации ключей кэша на основе параметров метода.

В методах получения данных можно использовать метод put, а в методах изменения или удаления данных — метод clear для удаления данных из кэша и обеспечения доступности данных в кэше.

Вызов методов инструментального класса

1. Получение данных из кэша: HCacheTool.getCache("ключ кэша", тип возвращаемых данных.class); Примечание: при использовании локального кэша можно напрямую использовать HCacheTool.getCache("ключ кэша"). Если настроен Redis, необходимо указать тип возвращаемых данных.

2. Добавление данных в кэш: HCacheTool.setCache("ключ кэша", данные, срок действия); — указание срока действия. HCacheTool.setCache("ключ кэша", данные) — без указания срока действия.

3. Создание счётчика: HCacheTool.createCounter("ключ счётчика", максимальная ёмкость счётчика); — этот метод создаёт счётчик. HCacheTool.increment(""); — увеличивает значение счётчика на 1. Используется для безопасного увеличения количества. Если количество превышает максимальную ёмкость, возвращается false.