HsqlDbCache (onecode-common-client 1.1 API)

java.lang.Object
- com.ds.hsql.HsqlDbCache

所有已实现的接口:: Cache, Map

public class HsqlDbCache
extends Object
implements Cache

作者:: wenzhang

嵌套类概要
- 从接口继承的嵌套类/接口 java.util.Map
  Map.Entry<K,V>

字段概要

字段
限定符和类型	字段和说明
`protected long`	`cacheHits` Maintain the number of cache hits and misses.
`protected long`	`cacheMisses` Maintain the number of cache hits and misses.
`protected int`	`cacheSize` Maintains the current size of the cache in bytes.
`protected Connection`	`conn`
`static String`	`DELETE_CACHE_BYNAME_SQL`
`static String`	`DELETE_CACHE_BYTIME_SQL`
`static String`	`DELETE_CACHE_SQL`
`static String`	`INSERT_CACHE_SQL`
`protected boolean`	`isStopPutWhenFull`
`static String`	`LOAD_ALL_CACHE_SQL`
`static String`	`LOAD_CACHE_BYNAME_ORDERED_SQL`
`static String`	`LOAD_CACHE_BYNAME_SQL`
`static String`	`LOAD_CACHE_COUNT_SQL`
`static String`	`LOAD_CACHE_SQL`
`protected int`	`maxCacheSize` Maximum size in bytes that the cache can grow to.
`protected long`	`maxLifetime` Maximum length of time objects can exist in cache before expiring.
`protected String`	`name` The name of the cache.
`static String`	`TABLE_NAME`

构造器概要

构造器
构造器和说明
`HsqlDbCache(String name, int maxSize, long maxLifetime, HsqlDbServer db)` Create a new cache and specify the maximum size of for the cache in bytes, and the maximum lifetime of objects.

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`protected int`	`calculateSize(Object object)` Returns the size of an object in bytes.
`void`	`clear()` Removes all cached datas from this cache (optional operation).
`boolean`	`containsKey(Object key)`
`boolean`	`containsValue(Object value)`
`protected void`	`cullCache()` Removes objects from cache if the cache is too full.
`protected void`	`deleteExpiredEntries()` Clears all entries out of cache where the entries are older than the maximum defined age.
`Set`	`entrySet()`
`Object`	`get(Object key)`
`long`	`getCacheHits()` Returns the number of cache hits.
`long`	`getCacheMisses()` Returns the number of cache misses.
`int`	`getCacheSize()` Returns the size of the cache contents in bytes.
`int`	`getMaxCacheSize()` Returns the maximum size of the cache in bytes.
`long`	`getMaxLifetime()` Returns the maximum number of milleseconds that any object can live in cache.
`String`	`getName()` Implementation methods of Cache interface
`boolean`	`isEmpty()`
`Set`	`keySet()`
`Object`	`put(Object key, Object value)`
`void`	`putAll(Map map)`
`Object`	`remove(Object key)`
`void`	`setMaxCacheSize(int maxCacheSize)` Sets the maximum size of the cache in bytes.
`void`	`setMaxLifetime(long maxLifetime)` Sets the maximum number of milleseconds that any object can live in cache.
`void`	`setStopPutWhenFull(boolean flag)` set the flag whether stop putting into cache when it was full or not.
`int`	`size()`
`Collection`	`values()`

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 java.util.Map
compute, computeIfAbsent, computeIfPresent, equals, forEach, getOrDefault, hashCode, merge, putIfAbsent, remove, replace, replace, replaceAll

- 字段详细资料
  - conn
```
protected Connection conn
```
  - TABLE_NAME
```
public static final String TABLE_NAME
```
  - DELETE_CACHE_SQL
```
public static final String DELETE_CACHE_SQL
```
  - DELETE_CACHE_BYTIME_SQL
```
public static final String DELETE_CACHE_BYTIME_SQL
```
  - DELETE_CACHE_BYNAME_SQL
```
public static final String DELETE_CACHE_BYNAME_SQL
```
  - INSERT_CACHE_SQL
```
public static final String INSERT_CACHE_SQL
```
  - LOAD_ALL_CACHE_SQL
```
public static final String LOAD_ALL_CACHE_SQL
```
  - LOAD_CACHE_SQL
```
public static final String LOAD_CACHE_SQL
```
  - LOAD_CACHE_BYNAME_SQL
```
public static final String LOAD_CACHE_BYNAME_SQL
```
  - LOAD_CACHE_COUNT_SQL
```
public static final String LOAD_CACHE_COUNT_SQL
```
  - LOAD_CACHE_BYNAME_ORDERED_SQL
```
public static final String LOAD_CACHE_BYNAME_ORDERED_SQL
```
  - maxCacheSize
```
protected int maxCacheSize
```
    Maximum size in bytes that the cache can grow to.
  - cacheSize
```
protected int cacheSize
```
    Maintains the current size of the cache in bytes.
  - maxLifetime
```
protected long maxLifetime
```
    Maximum length of time objects can exist in cache before expiring.
  - cacheHits
```
protected long cacheHits
```
    Maintain the number of cache hits and misses. A cache hit occurs every time the get method is called and the cache contains the requested object. A cache miss represents the opposite occurence.
    Keeping track of cache hits and misses lets one measure how efficient the cache is; the higher the percentage of hits, the more efficient.
  - cacheMisses
```
protected long cacheMisses
```
    Maintain the number of cache hits and misses. A cache hit occurs every time the get method is called and the cache contains the requested object. A cache miss represents the opposite occurence.
    Keeping track of cache hits and misses lets one measure how efficient the cache is; the higher the percentage of hits, the more efficient.
  - name
```
protected String name
```
    The name of the cache.
  - isStopPutWhenFull
```
protected boolean isStopPutWhenFull
```
- 构造器详细资料
  - HsqlDbCache
```
public HsqlDbCache(String name,
                   int maxSize,
                   long maxLifetime,
                   HsqlDbServer db)
```
    Create a new cache and specify the maximum size of for the cache in bytes, and the maximum lifetime of objects.
    
    参数:
    
    name - a name for the cache.
    
    maxSize - the maximum size of the cache in bytes. -1 means the cache has no max size.
    
    maxLifetime - the maximum amount of time objects can exist in cache before being deleted. -1 means objects never expire.
- 方法详细资料
  - put
```
public Object put(Object key,
                  Object value)
```
    指定者:
    
    put 在接口中 Map
  - get
```
public Object get(Object key)
```
    指定者:
    
    get 在接口中 Map
  - remove
```
public Object remove(Object key)
```
    指定者:
    
    remove 在接口中 Map
  - clear
```
public void clear()
```
    从接口复制的说明: Cache
    
    Removes all cached datas from this cache (optional operation).
    
    指定者:
    
    clear 在接口中 Cache
    
    指定者:
    
    clear 在接口中 Map
  - size
```
public int size()
```
    指定者:
    
    size 在接口中 Map
  - isEmpty
```
public boolean isEmpty()
```
    指定者:
    
    isEmpty 在接口中 Map
  - values
```
public Collection values()
```
    指定者:
    
    values 在接口中 Map
  - containsKey
```
public boolean containsKey(Object key)
```
    指定者:
    
    containsKey 在接口中 Map
  - putAll
```
public void putAll(Map map)
```
    指定者:
    
    putAll 在接口中 Map
  - containsValue
```
public boolean containsValue(Object value)
```
    指定者:
    
    containsValue 在接口中 Map
  - entrySet
```
public Set entrySet()
```
    指定者:
    
    entrySet 在接口中 Map
  - keySet
```
public Set keySet()
```
    指定者:
    
    keySet 在接口中 Map
  - getName
```
public String getName()
```
    Implementation methods of Cache interface
    
    指定者:
    
    getName 在接口中 Cache
    
    返回:
    
    the name of the cache.
  - getCacheHits
```
public long getCacheHits()
```
    从接口复制的说明: Cache
    
    Returns the number of cache hits. A cache hit occurs every time the get method is called and the cache contains the requested object.
    Keeping track of cache hits and misses lets one measure how efficient the cache is; the higher the percentage of hits, the more efficient.
    
    指定者:
    
    getCacheHits 在接口中 Cache
    
    返回:
    
    the number of cache hits.
  - getCacheMisses
```
public long getCacheMisses()
```
    从接口复制的说明: Cache
    
    Returns the number of cache misses. A cache miss occurs every time the get method is called and the cache does not contain the requested object.
    Keeping track of cache hits and misses lets one measure how efficient the cache is; the higher the percentage of hits, the more efficient.
    
    指定者:
    
    getCacheMisses 在接口中 Cache
    
    返回:
    
    the number of cache hits.
  - getCacheSize
```
public int getCacheSize()
```
    从接口复制的说明: Cache
    
    Returns the size of the cache contents in bytes. This value is only a rough approximation, so cache users should expect that actual VM memory used by the cache could be significantly higher than the value reported by this method.
    
    指定者:
    
    getCacheSize 在接口中 Cache
    
    返回:
    
    the size of the cache contents in bytes.
  - getMaxCacheSize
```
public int getMaxCacheSize()
```
    从接口复制的说明: Cache
    
    Returns the maximum size of the cache in bytes. If the cache grows larger than the max size, the least frequently used items will be removed. If the max cache size is set to -1, there is no size limit.
    
    指定者:
    
    getMaxCacheSize 在接口中 Cache
    
    返回:
    
    the maximum size of the cache in bytes.
  - setMaxCacheSize
```
public void setMaxCacheSize(int maxCacheSize)
```
    从接口复制的说明: Cache
    
    Sets the maximum size of the cache in bytes. If the cache grows larger than the max size, the least frequently used items will be removed. If the max cache size is set to -1, there is no size limit.
    
    指定者:
    
    setMaxCacheSize 在接口中 Cache
    
    参数:
    
    maxCacheSize - the maximum size of the cache in bytes.
  - getMaxLifetime
```
public long getMaxLifetime()
```
    从接口复制的说明: Cache
    
    Returns the maximum number of milleseconds that any object can live in cache. Once the specified number of milleseconds passes, the object will be automatically expried from cache. If the max lifetime is set to -1, then objects never expire.
    
    指定者:
    
    getMaxLifetime 在接口中 Cache
    
    返回:
    
    the maximum number of milleseconds before objects are expired.
  - setMaxLifetime
```
public void setMaxLifetime(long maxLifetime)
```
    从接口复制的说明: Cache
    
    Sets the maximum number of milleseconds that any object can live in cache. Once the specified number of milleseconds passes, the object will be automatically expried from cache. If the max lifetime is set to -1, then objects never expire.
    
    指定者:
    
    setMaxLifetime 在接口中 Cache
    
    参数:
    
    maxLifetime - the maximum number of milleseconds before objects are expired.
  - calculateSize
```
protected int calculateSize(Object object)
```
    Returns the size of an object in bytes. Determining size by serialization is only used as a last resort.
    
    返回:
    
    the size of an object in bytes.
  - deleteExpiredEntries
```
protected void deleteExpiredEntries()
```
    Clears all entries out of cache where the entries are older than the maximum defined age.
  - cullCache
```
protected void cullCache()
```
    Removes objects from cache if the cache is too full. "Too full" is defined as within 3% of the maximum cache size. Whenever the cache is is too big, the least frequently used elements are deleted until the cache is at least 10% empty.
  - setStopPutWhenFull
```
public void setStopPutWhenFull(boolean flag)
```
    从接口复制的说明: Cache
    
    set the flag whether stop putting into cache when it was full or not.
    
    指定者:
    
    setStopPutWhenFull 在接口中 Cache

类 HsqlDbCache

嵌套类概要

从接口继承的嵌套类/接口 java.util.Map

字段概要

构造器概要

方法概要

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

从接口继承的方法 java.util.Map

字段详细资料

conn

TABLE_NAME

DELETE_CACHE_SQL

DELETE_CACHE_BYTIME_SQL

DELETE_CACHE_BYNAME_SQL

INSERT_CACHE_SQL

LOAD_ALL_CACHE_SQL

LOAD_CACHE_SQL

LOAD_CACHE_BYNAME_SQL

LOAD_CACHE_COUNT_SQL

LOAD_CACHE_BYNAME_ORDERED_SQL

maxCacheSize

cacheSize

maxLifetime

cacheHits

cacheMisses

name

isStopPutWhenFull

构造器详细资料

HsqlDbCache

方法详细资料

put

get

remove

clear

size

isEmpty

values

containsKey

putAll

containsValue

entrySet

keySet

getName

getCacheHits

getCacheMisses

getCacheSize

getMaxCacheSize

setMaxCacheSize

getMaxLifetime

setMaxLifetime

calculateSize

deleteExpiredEntries

cullCache

setStopPutWhenFull