student.web

Class ApplicationPersistentMap<T>

java.lang.Object

student.web.AbstractPersistentMap<T>

student.web.ApplicationPersistentMap<T>

Type Parameters:

T - The type of objects to store in the map

All Implemented Interfaces:

Map<String,T>, PersistentMap<T>

public class ApplicationPersistentMap<T>
extends AbstractPersistentMap<T>

This class represents a PersistentMap whose contents are shared only by separate executions of a single program. In the constructor, you provide a unique "application identifier" as a string, and the persistent values stored in this map will only be accessible to other ApplicationPersistentMap instances that were created with the same application identifier.

In other respects, an ApplicationPersistentMap works just like a SharedPersistentMap. Read the documentation for that class, and for the PersistentMap interface, to learn how to use this class.

Version:

$Revision: 1.5 $, $Date: 2011/06/21 14:57:28 $

Author:

Mike Woods, Last changed by $Author: mwoodsvt $

Nested Class Summary

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

Map.Entry<K,V>

Field Summary

Fields

Modifier and Type	Field and Description
static String	APP_STORE

Fields inherited from class student.web.AbstractPersistentMap

loader, typeAware

Constructor Summary

Constructors

Constructor and Description
ApplicationPersistentMap(String applicationIdentifier, Class<T> genericClass) Create a new map that associates keys with values of the specified class.
ApplicationPersistentMap(String applicationIdentifier, Class<T> genericClass, ClassLoader loader) NOT FOR STUDENT USE.

Method Summary

Modifier and Type	Method and Description
static String	findIdentifier(String contextMap)
protected String	getCacheId(String uniqueId) Get the cache ID for this map.

Methods inherited from class student.web.AbstractPersistentMap

clear, containsKey, containsValue, entrySet, get, getPersistentObject, isEmpty, keySet, put, putAll, remove, removePersistentObject, setPersistentObject, size, 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

APP_STORE

public static final String APP_STORE

See Also:

Constant Field Values

Constructor Detail

ApplicationPersistentMap

public ApplicationPersistentMap(String applicationIdentifier,
                                Class<T> genericClass)

Create a new map that associates keys with values of the specified class. Initially, the map will contain all of the key/value associations that have been previously stored in other instances of this class using the same application identifier,.

Typical usage: if you want an application persistent map that stores objects of class Widget, then:

 ApplicationPersistentMap<Widget> map = new ApplicationPersistentMap<Widget>( Widget.class );
 

Parameters:

applicationIdentifier - A non-null, non-empty string used to uniquely identify the application using this map. All instances created with the same application identifier will "share" the same set of key/value mappings.

genericClass - The Class object that represents the generic type T, the type of values stored in this map.

ApplicationPersistentMap

public ApplicationPersistentMap(String applicationIdentifier,
                                Class<T> genericClass,
                                ClassLoader loader)

NOT FOR STUDENT USE. ONLY USE IF YOU KNOW WHAT YOU ARE DOING!

Parameters:

genericClass - Class type

loader - custom class loader to use to load classes

Method Detail

getCacheId

protected String getCacheId(String uniqueId)

Description copied from class: AbstractPersistentMap

Get the cache ID for this map.

Specified by:

getCacheId in class AbstractPersistentMap<T>

Returns:

This map's cache ID.

findIdentifier

public static String findIdentifier(String contextMap)