cache策略(二)基类

cache策略(二)基类
把一些用到的基类都列表出来吧
BaseCache.java 如下：
package com.sillycat.easyview.plugin.cache.base;

import java.util.Comparator;

import com.sillycat.easyview.plugin.commons.exceptions.CacheException;

/**
* CACHE的管理策略，允许实现类支持只读型的CACHE、读写型的CACHE、事务型的CACHE等等
*/
public interface BaseCache {
/**
* 试图从CACHE中取回存储的值
*/
public Object get(Object key, long txTimestamp) throws CacheException;

/**
* 试图将从数据库中取回的值存储到CACHE中去
*/
public boolean put(Object key, Object value, long txTimestamp,
    Object version, Comparator versionComparator, boolean minimalPut)
    throws CacheException;

/**
* 如果是读写型、事务的需要支持这个操作。
*/
public SoftLock lock(Object key, Object version) throws CacheException;

/**
* 当一个对象失效时将其从CACHE中清除，在事务被完成之前。 这个方法在同步型CACHE操作中使用
*/
public void evict(Object key) throws CacheException;

/**
* 当一个对象被更新时在CACHE中更新，在事务被完成之前。 这个方法在同步型CACHE操作中使用
*/
public boolean update(Object key, Object value) throws CacheException;

/**
* 当一个对象被插入时调用，在事务被完成之前。 取代evict操作。
*/
public boolean insert(Object key, Object value) throws CacheException;

public void release(Object key, SoftLock lock) throws CacheException;

public boolean afterUpdate(Object key, Object value, Object version,
    SoftLock lock) throws CacheException;

public boolean afterInsert(Object key, Object value, Object version)
    throws CacheException;

/**
* 直接将一个对象从CACHE中清除，无需考虑事务
*/
public void remove(Object key) throws CacheException;

/**
* 清除CACHE中的所有对象
*/
public void clear() throws CacheException;

/**
* 清除所有资源程
*/
public void destroy();

/**
* 将底层的真正实现的CACHE设置进来。
*/
public void setCache(Cache cache);

public static interface SoftLock {
}

/**
* 取得CACHE的区域名称
*/
public String getRegionName();

/**
* 取得被包装的CACHE实现
*/
public Cache getCache();
}

Cache.java 如下：
package com.sillycat.easyview.plugin.cache.base;

import java.util.Map;

import com.sillycat.easyview.plugin.commons.exceptions.CacheException;


/**
*
* 通用的CACHE接口，并非每一种CACHE均会实现以下的接口
*
*/
public interface Cache {
/**
* 从cache中得到一个对象
*/
public Object read(Object key) throws CacheException;

/**
* 取得一条记录，无事务
*/
public Object get(Object key) throws CacheException;

/**
* 增加一条记录
*/
public void put(Object key, Object value) throws CacheException;

/**
* 更新一条记录
*/
public void update(Object key, Object value) throws CacheException;

/**
* 移走一条记录
*/
public void remove(Object key) throws CacheException;

/**
* 清除CACHE
*/
public void clear() throws CacheException;

/**
* Clean up
*/
public void destroy() throws CacheException;

/**
* 如果是一个分布式CACHE, 上锁
*/
public void lock(Object key) throws CacheException;

/**
* 如果是一个分布式CACHE，解锁
*/
public void unlock(Object key) throws CacheException;

/**
* 产生一个时间点
*/
public long nextTimestamp();

/**
* Get a reasonable "lock timeout"
*/
public int getTimeout();

/**
* REGION的名字
*/
public String getRegionName();

/**
* 当前CACHE内存的消耗空间 The number of bytes consumed by this region; -1 if unknown
* or unsupported
*/
public long getSizeInMemory();

/**
* 内存中的所有CACHE的条目.
* @return The count of entries in memory; -1 if unknown or unsupported.
*/
public long getElementCountInMemory();

/**
* 硬盘中的所有CACHE条目
*/
public long getElementCountOnDisk();

/**
* optional operation
*/
public Map toMap();
}

CacheProvider.java 的接口，需要provider去实现的东东
package com.sillycat.easyview.plugin.cache.base;

import java.util.Properties;

import com.sillycat.easyview.plugin.commons.exceptions.CacheException;

/**
* 具体Cache创建类
*
*/
public interface CacheProvider {
/**
* 配置一个CACHE
*/
public Cache buildCache(String regionName) throws CacheException;

/**
* Generate a timestamp
*/
public long nextTimestamp();

/**
* 回调函数，以执行一些必要的初始化过程
*
* @param properties
*            current configuration settings.
*/
public void start() throws CacheException;

/**
* 回调函数，以停止一个CACHE服务台s
*/
public void stop();

public Properties getProperties() throws CacheException;
}