com.houkunlin.system.dict.starter.properties.DictPropertiesCache Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of system-dict-starter Show documentation

系统数据字典自动翻译成字典文本。可集合系统数据库中存储的用户数据字典，也可使用枚举做系统数据字典，主要用在返回数据给前端时自动把字典值翻译成字典文本信息； The system data dictionary is automatically translated into dictionary text. The user data dictionary stored in the system database can be aggregated, and the enumeration can also be used as the system data dictionary. It is mainly used to automatically translate dictionary values into dictionary text information when returning data to the front end.

The newest version!

package com.houkunlin.system.dict.starter.properties;

import com.houkunlin.system.dict.starter.DictUtil;
import lombok.*;

import java.time.Duration;

/**
 * 获取字典值缓存配置。配置在使用 {@link DictUtil} 获取字典文本时是否使用缓存。
 * {@link com.houkunlin.system.dict.starter.json.DictText} 最后的处理实际也会调用 {@link DictUtil} 来获取字典文本信息。
 * 在使用 {@link com.houkunlin.system.dict.starter.store.LocalDictStore} 存储时是否启用缓存影响不大，
 * 
 * 但是在使用 {@link com.houkunlin.system.dict.starter.store.RedisDictStore} 存储时，列表页场景可能会有较大的影响，
 * 因为每次获取字典文本都会从Redis中调用，此时假如字典值一致的时候会频繁重复调用，因此增加耗时。
 * 
 * 启用缓存功能能够有效的解决相同字典值重复从Redis读取数据导致耗时增加问题。
 *
 * @author HouKunLin
 * @since 1.4.2
 */
@Data
@ToString
@EqualsAndHashCode
@NoArgsConstructor
@AllArgsConstructor
public class DictPropertiesCache {
    /**
     * 是否启用缓存
     */
    private boolean enabled = true;
    /**
     * 缓存最大容量
     */
    private int maximumSize = 500;
    /**
     * 缓存初始化容量
     */
    private int initialCapacity = 50;
    /**
     * 有效期时长
     */
    private Duration duration = Duration.ofSeconds(30);
    /**
     * 在有效期内同一个字典值未命中指定次数  将快速返回，不再重复请求获取数据字典信息。
     * 例如：一个 userType 类型 值为 2 的字典，在 30 秒内超过 50 次找不到字典文本，那么在本次 30 秒的周期内将不再继续请求字典信息，而是直接返回一个 null 值。
     * 特别是在使用 Redis 存储数据字典信息时，频繁未命中数据将会频繁进行网络IO，因此可能会增加单个接口返回数据的耗时（数据量大转换次数多时）
     */
    private int missNum = 50;
}