com.jniwrapper.util

Class FunctionCache

java.lang.Object

com.jniwrapper.util.FunctionCache

public class FunctionCache
extends java.lang.Object

Allows to cache softly-referenced Function instances, which provides automatic removal of unreferenced instances under low memory conditions. When initialized with a library name, the cache automatically creates the library instance.

See Also:

SoftCache

Constructor Summary

Constructors

Constructor and Description
FunctionCache(Library library) Creates a cache that uses the passed library instance.
FunctionCache(java.lang.String libraryName) Creates a cache for the library with the passed name.

Method Summary

Modifier and Type	Method and Description
Function	getFunction(java.lang.String name) Gets a function specified by the name in the cache, or queries the function instance from the associated library, and caches it for subsequent requests.
void	getVariable(java.lang.String name, Parameter variable)

Methods inherited from class java.lang.Object

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

Constructor Detail

FunctionCache

public FunctionCache(java.lang.String libraryName)

Creates a cache for the library with the passed name. The actual library instance will be created for the passed name on demand.

Parameters:

libraryName - a name of the library.

Throws:

java.lang.IllegalArgumentException - of the passed value is null or empty string.

FunctionCache

public FunctionCache(Library library)

Creates a cache that uses the passed library instance.

Parameters:

library - a library to be used by the cache.

Throws:

java.lang.NullPointerException - if the passed library instance is null.

Method Detail

getFunction

public Function getFunction(java.lang.String name)

Gets a function specified by the name in the cache, or queries the function instance from the associated library, and caches it for subsequent requests.

Parameters:

name - the name of the function to get.

Returns:

non-null Function instance.

Throws:

NoSuchFunctionException - if a function is not found in the associated library.

getVariable

public void getVariable(java.lang.String name,
                        Parameter variable)