net.handle.hdllib
Class JDBCache

java.lang.Object
  net.handle.hdllib.JDBCache

All Implemented Interfaces:

Cache

public class JDBCache
extends java.lang.Object
implements Cache

Class used to cache values in a local database file.

Constructor Summary

JDBCache(java.io.File cacheDBFile)

Method Summary

void	clear() Remove all values from the cache
void	close()
byte[][]	getCachedValues(byte[] handle, byte[][] reqTypes, int[] reqIndexes) Returns any non-expired handle values that are in the caches storage.
void	setCachedValues(byte[] handle, HandleValue[] newValues, byte[][] newTypeList, int[] newIndexList) Store the given handle values after a query for the handle.
void	setMaximumHandles(int maxHandles) Set the maximum size for the cache by the number of handles.
void	setMaximumSize(int maxSize) Set the maximum size for the cache by the number of bytes used for storage.

Methods inherited from class java.lang.Object

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

Constructor Detail

JDBCache

public JDBCache(java.io.File cacheDBFile)
         throws java.lang.Exception

Throws:

java.lang.Exception

Method Detail

getCachedValues

public byte[][] getCachedValues(byte[] handle,
                                byte[][] reqTypes,
                                int[] reqIndexes)
                         throws java.lang.Exception

Returns any non-expired handle values that are in the caches storage. A null return value indicates that the requested values aren't in the cache. Returning the an array of values (including an array of zero length) indicates that the returned values are the only values from the requested set (ie the handle doesn't have any more values from the requested set). ***** Speed is important in this method *****

Specified by:

getCachedValues in interface Cache

Throws:

java.lang.Exception

setCachedValues

public void setCachedValues(byte[] handle,
                            HandleValue[] newValues,
                            byte[][] newTypeList,
                            int[] newIndexList)
                     throws java.lang.Exception

Store the given handle values after a query for the handle. The query was performed with the given type-list and index-list. ***** Speed is less important in this method *****

Specified by:

setCachedValues in interface Cache

Throws:

java.lang.Exception

setMaximumHandles

public void setMaximumHandles(int maxHandles)

Set the maximum size for the cache by the number of handles. NOT IMPLEMENTED!

Specified by:

setMaximumHandles in interface Cache

setMaximumSize

public void setMaximumSize(int maxSize)

Set the maximum size for the cache by the number of bytes used for storage. NOT IMPLEMENTED!

Specified by:

setMaximumSize in interface Cache

clear

public void clear()
           throws java.lang.Exception

Remove all values from the cache

Specified by:

clear in interface Cache

Throws:

java.lang.Exception

close

public void close()
           throws java.lang.Exception

Specified by:

close in interface Cache

Throws:

java.lang.Exception