net.gdface.facelog.db

类 BaseJunctionTableCache<K1,K2,B extends BaseBean<B>>

java.lang.Object

net.gdface.facelog.db.BaseJunctionTableCache<K1,K2,B>

类型参数:

K1 - 外键1类型(Foreign Key)

K2 - 外键2类型(Foreign Key)

B - 数据库记录对象类型(Java Bean)

public abstract class BaseJunctionTableCache<K1,K2,B extends BaseBean<B>>
extends java.lang.Object

基于 LoadingCache实现MANY-TO-MANY 联接表(junction table)数据缓存,并可以通过TableListener实现缓存数据自动更新
联接表(junction table)定义:主键为两个字段K1,K2,并且两个字段又各是联接另外两张表的外键

作者:

guyadong

嵌套类概要

嵌套类

限定符和类型	类和说明
class	BaseJunctionTableCache.Key

字段概要

字段

限定符和类型	字段和说明
protected TableListener.Adapter<B>	tableListener

构造器概要

构造器

构造器和说明
BaseJunctionTableCache()
BaseJunctionTableCache(ITableCache.UpdateStrategy updateStrategy, long maximumSize, long duration, java.util.concurrent.TimeUnit unit) 构造函数
BaseJunctionTableCache(long maximumSize)
BaseJunctionTableCache(long maximumSize, long durationMinutes)
BaseJunctionTableCache(long maximumSize, long duration, java.util.concurrent.TimeUnit unit)

方法概要

方法

限定符和类型	方法和说明
B	getBean(K1 k1, K2 k2) 返回数据库中与k1,k2(不可为null)匹配的记录 如果没找到记录则抛出异常
B	getBeanIfPresent(K1 k1, K2 k2) 返回内存cache中与k1,k2匹配的记录 如果没找到记录则返回null
java.util.Set<B>	getBeansByK1(K1 k1) 返回数据库中匹配k1的所有记录,没有结果返回则抛出异常
java.util.Set<B>	getBeansByK1IfPresent(K1 k1) 返回内存cache中匹配k1的所有记录,没有结果返回则返回empty Set
java.util.Set<B>	getBeansByK1Unchecked(K1 k1) 返回数据库中匹配k1的所有记录,没有结果返回则返回empty Set
java.util.Set<B>	getBeansByK2(K2 k2) see also getBeansByK1(Object)
java.util.Set<B>	getBeansByK2IfPresent(K2 k2) see also getBeansByK1IfPresent(Object)
java.util.Set<B>	getBeansByK2Unchecked(K2 k2) see also getBeansByK1Unchecked(Object)
B	getBeanUnchecked(K1 k1, K2 k2) 返回数据库中与k1,k2匹配的记录 如果没找到记录则返回null
ITableCache.UpdateStrategy	getUpdateStrategy()
protected abstract java.lang.Object	loadfromDatabase(BaseJunctionTableCache.Key key) 从数据库中加载外键指定的记录,没有找到指定的记录则抛出异常ObjectRetrievalException Key.k1,Key.k2都不为null返回B,否则返回Collection<B> 不可返回null
abstract void	registerListener() 注册侦听器
void	remove(B bean) 从缓存中删除bean指定的记录
protected abstract K1	returnK1(B bean) 返回bean中外键K1值,bean为null时返回null
protected abstract K2	returnK2(B bean) 返回bean中外键K2值,bean为null时返回null
abstract void	unregisterListener() 注销侦听器
void	update(B bean) 更新bean到指定的缓存对象cacheMap

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

tableListener

protected final TableListener.Adapter<B extends BaseBean<B>> tableListener

构造器详细资料

BaseJunctionTableCache

public BaseJunctionTableCache()

BaseJunctionTableCache

public BaseJunctionTableCache(long maximumSize)

BaseJunctionTableCache

public BaseJunctionTableCache(long maximumSize,
                      long durationMinutes)

BaseJunctionTableCache

public BaseJunctionTableCache(long maximumSize,
                      long duration,
                      java.util.concurrent.TimeUnit unit)

BaseJunctionTableCache

public BaseJunctionTableCache(ITableCache.UpdateStrategy updateStrategy,
                      long maximumSize,
                      long duration,
                      java.util.concurrent.TimeUnit unit)

构造函数

参数:

updateStrategy - 缓存更新策略

maximumSize - 最大缓存容量,参见 CacheBuilder.maximumSize(long)

duration - 失效时间,参见 CacheBuilder.expireAfterWrite(long, TimeUnit)

unit - duration的时间单位

方法详细资料

returnK1

protected abstract K1 returnK1(B bean)

返回bean中外键K1值,bean为null时返回null

参数:

bean -

返回:

returnK2

protected abstract K2 returnK2(B bean)

返回bean中外键K2值,bean为null时返回null

参数:

bean -

返回:

loadfromDatabase

protected abstract java.lang.Object loadfromDatabase(BaseJunctionTableCache.Key key)
                                              throws java.lang.Exception

从数据库中加载外键指定的记录,没有找到指定的记录则抛出异常ObjectRetrievalException
Key.k1,Key.k2都不为null返回B,否则返回Collection<B>
不可返回null

参数:

key -

返回:

抛出:

ObjectRetrievalException

java.lang.Exception

registerListener

public abstract void registerListener()

注册侦听器

unregisterListener

public abstract void unregisterListener()

注销侦听器

getBeansByK1

public java.util.Set<B> getBeansByK1(K1 k1)
                                                  throws java.util.concurrent.ExecutionException

返回数据库中匹配k1的所有记录,没有结果返回则抛出异常

抛出:

ObjectRetrievalException - not found

java.util.concurrent.ExecutionException

另请参阅:

LoadingCache.get(Object)

getBeansByK1IfPresent

public java.util.Set<B> getBeansByK1IfPresent(K1 k1)

返回内存cache中匹配k1的所有记录,没有结果返回则返回empty Set

另请参阅:

Cache.getIfPresent(Object)

getBeansByK1Unchecked

public java.util.Set<B> getBeansByK1Unchecked(K1 k1)

返回数据库中匹配k1的所有记录,没有结果返回则返回empty Set

抛出:

com.google.common.util.concurrent.UncheckedExecutionException

另请参阅:

LoadingCache.getUnchecked(Object)

getBeansByK2

public java.util.Set<B> getBeansByK2(K2 k2)
                                                  throws java.util.concurrent.ExecutionException

see also getBeansByK1(Object)

抛出:

java.util.concurrent.ExecutionException

getBeansByK2IfPresent

public java.util.Set<B> getBeansByK2IfPresent(K2 k2)

see also getBeansByK1IfPresent(Object)

getBeansByK2Unchecked

public java.util.Set<B> getBeansByK2Unchecked(K2 k2)

see also getBeansByK1Unchecked(Object)

getBean

public B getBean(K1 k1,
        K2 k2)
                              throws java.util.concurrent.ExecutionException

返回数据库中与k1,k2(不可为null)匹配的记录
如果没找到记录则抛出异常

抛出:

ObjectRetrievalException - not found

java.util.concurrent.ExecutionException

另请参阅:

LoadingCache.get(Object)

getBeanIfPresent

public B getBeanIfPresent(K1 k1,
                 K2 k2)

返回内存cache中与k1,k2匹配的记录
如果没找到记录则返回null

另请参阅:

Cache.getIfPresent(Object)

getBeanUnchecked

public B getBeanUnchecked(K1 k1,
                 K2 k2)

返回数据库中与k1,k2匹配的记录
如果没找到记录则返回null

另请参阅:

LoadingCache.getUnchecked(Object)

remove

public void remove(B bean)

从缓存中删除bean指定的记录

update

public void update(B bean)

更新bean到指定的缓存对象cacheMap

参数:

bean -

getUpdateStrategy

public ITableCache.UpdateStrategy getUpdateStrategy()