package net.easipay.cache.service;

public interface CacheService {

  /**
   * 向缓存添加键值对,如果 add 的 key 已经存在，则不会更新数据，之前的值将仍然保持相同
   */
  public boolean add(String key, Object value);

  /**
   * 向缓存添加键值对,如果 add 的 key 已经存在，则不会更新数据，之前的值将仍然保持相同,并为该键值对设定逾期时间（即多长时间后该键值对从缓存中删除，单位s
   */
  public boolean add(String key, Object value, int expire);

  /**
   * 向缓存添加键值对,如果key存在则覆盖原来的value
   */
  public boolean set(String key, Object value);

  /**
   * 向缓存添加键值对并为该键值对设定逾期时间（即多长时间后该键值对从缓存中删除，单位s
   */
  public boolean set(String key, Object value, int expire);

  /**
   * 根据键获取缓存管理系统中相应的值
   */
  public <T> Object get(String key, Class<T> clazz);

  /**
   * 根据键获取缓存管理系统中相应的值
   */
  public <T> Object getList(String key, Class<T> clazz);

  /**
   * 根据键删除缓存管理系统中相应的值
   */
  public boolean delete(String key);

  /**
   * 对已存在的 key(键) 的数字值进行自增操作
   */
  public Long incr(String key, Long inc);

  /**
   * 对已存在的 key(键) 的数字值进行自减操作
   */
  public Long decr(String key, Long inc);
}