Module org.datanucleus

Package org.datanucleus.cache

Class SoftRefCache

java.lang.Object

org.datanucleus.cache.SoftRefCache

All Implemented Interfaces:

Map<Object,DNStateManager>, Level1Cache

public class SoftRefCache
extends Object
implements Level1Cache

Level 1 Cache using Soft referenced objects in a Map.

If map entry value object is not actively being used, i.e. no other object has a strong reference to it, it may become garbage collected at the discretion of the garbage collector (typically if the VM is low on memory). If this happens, the entry in the SoftValueMap corresponding to the value object will also be removed.

See Also:

SoftReference

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K extends Object,V extends Object>

Field Summary

Fields

Modifier and Type	Field	Description
static String	NAME

Fields inherited from interface org.datanucleus.cache.Level1Cache

NONE_NAME

Constructor Summary

Constructors

Constructor	Description
SoftRefCache()

Method Summary

Modifier and Type	Method	Description
void	clear()
boolean	containsKey(Object id)
boolean	containsValue(Object value)
Set	entrySet()
DNStateManager	get(Object id)
DNStateManager	getUnique(CacheUniqueKey key)	Method to retrieve StateManager for the specified unique key.
boolean	isEmpty()
Set	keySet()
DNStateManager	put(Object id, DNStateManager sm)
void	putAll(Map t)
Object	putUnique(CacheUniqueKey key, DNStateManager sm)	Method to store a StateManager for this unique key.
DNStateManager	remove(Object id)
int	size()
Collection	values()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, equals, forEach, getOrDefault, hashCode, merge, putIfAbsent, remove, replace, replace, replaceAll

Field Detail

NAME

public static final String NAME

See Also:

Constant Field Values

Constructor Detail

SoftRefCache

public SoftRefCache()

Method Detail

put

public DNStateManager put(Object id,
                          DNStateManager sm)

Specified by:

put in interface Map<Object,DNStateManager>

get

public DNStateManager get(Object id)

Specified by:

get in interface Map<Object,DNStateManager>

containsKey

public boolean containsKey(Object id)

Specified by:

containsKey in interface Map<Object,DNStateManager>

remove

public DNStateManager remove(Object id)

Specified by:

remove in interface Map<Object,DNStateManager>

clear

public void clear()

Specified by:

clear in interface Map<Object,DNStateManager>

containsValue

public boolean containsValue(Object value)

Specified by:

containsValue in interface Map<Object,DNStateManager>

entrySet

public Set entrySet()

Specified by:

entrySet in interface Map<Object,DNStateManager>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Map<Object,DNStateManager>

keySet

public Set keySet()

Specified by:

keySet in interface Map<Object,DNStateManager>

putAll

public void putAll(Map t)

Specified by:

putAll in interface Map<Object,DNStateManager>

size

public int size()

Specified by:

size in interface Map<Object,DNStateManager>

values

public Collection values()

Specified by:

values in interface Map<Object,DNStateManager>

getUnique

public DNStateManager getUnique(CacheUniqueKey key)

Description copied from interface: Level1Cache

Method to retrieve StateManager for the specified unique key.

Specified by:

getUnique in interface Level1Cache

Parameters:

key - Unique key

Returns:

StateManager if one is cached for this unique key

putUnique

public Object putUnique(CacheUniqueKey key,
                        DNStateManager sm)

Description copied from interface: Level1Cache

Method to store a StateManager for this unique key.

Specified by:

putUnique in interface Level1Cache

Parameters:

key - The unique key

sm - StateManager

Returns:

The previous StateManager for this unique key if one was present, otherwise null