Examples of org.infinispan.atomic.AtomicMap

org.infinispan.atomic.AtomicMap
This is a special type of Map geared for use in Infinispan. AtomicMaps have two major characteristics:
1. Atomic locking and isolation over the entire collection
2. Fine-grained serialization of deltas
1. Atomic locking and isolation over the entire collection
This allows the entire AtomicMap to be locked when making changes even to certain entries within the map, and also isolates the map for safe reading (see {@link IsolationLevel} while concurrent writes may be going on.

2. Fine-grained serialization of deltas
AtomicMap implementations also implement the {@link DeltaAware} interface. This powerful interface allows thegeneration and application of deltas, and requires that implementations are capable of tracking changes made to it during the course of a transaction. This helps since when performing replications to update remote nodes, the entire map need not be serialized and transported all the time, as serializing and transporting {@link Delta}instances would work just as well, and typically be much smaller and hence faster to serialize and transport.

Applications requiring either or both of the characteristics described above are encouraged to use AtomicMaps with Infinispan, however the real benefit is often only seen where a combination of both characteristics are required.

Usage
AtomicMaps should be constructed and "registered" with Infinispan using the {@link AtomicMapLookup} helper. Thishelper ensures threadsafe construction and registration of AtomicMap instances in Infinispan's data container. E.g.:
AtomicMap<String, Integer> map = AtomicMapLookup.getAtomicMap(cache, "my_atomic_map_key");

Referential Integrity
It is important to note that concurrent readers of an AtomicMap will essentially have the same view of the contents of the underlying structure, but since AtomicMaps use internal proxies, readers are isolated from concurrent writes and {@link IsolationLevel#READ_COMMITTED} and {@link IsolationLevel#REPEATABLE_READ} semantics are guaranteed.However, this guarantee is only present if the values stored in an AtomicMap are immutable (e.g., Strings, primitives, and other immutable types).

Mutable value objects which happen to be stored in an AtomicMap may be updated and, prior to being committed, or even replaced in the map, be visible to concurrent readers. Hence, AtomicMaps are not suitable for use with mutable value objects.

This interface, for all practical purposes, is just a marker interface that indicates that maps of this type will be locked atomically in the cache and replicated in a fine grained manner, as it does not add any additional methods to {@link java.util.Map}.
@author Manik Surtani @see DeltaAware @see Delta @see AtomicHashMap @see AtomicMapLookup @since 4.0

   public void testAtomicHashMap() throws Exception {
      Cache cache1 = cache(0, "replQueue");
      Cache cache2 = cache(1, "replQueue");
      TransactionManager transactionManager = TestingUtil.getTransactionManager(cache1);
      transactionManager.begin();
      AtomicMap am = AtomicMapLookup.getAtomicMap(cache1, "foo");
      am.put("sub-key", "sub-value");
      transactionManager.commit();


      ReplQueueTestScheduledExecutorFactory.command.run();


      //in next 5 secs, expect the replication to occur

View Full Code Here

    * @throws Exception
    */
   private Set<FullyQualifiedSessionId> getSSOSessions(String ssoId) throws Exception
   {
      CacheKey key = new CacheKey(ssoId,CacheKey.Type.SESSION);
      AtomicMap m = AtomicMapLookup.getAtomicMap(cache, key, true);
      return m!=null ? m.keySet() : Collections.EMPTY_SET;
   }

View Full Code Here

    * @throws Exception
    */
   private void putSessionInCache(String ssoId, FullyQualifiedSessionId fullyQualifiedSessionId) throws Exception
   {
      CacheKey key = new CacheKey(ssoId,CacheKey.Type.SESSION);
      AtomicMap m = AtomicMapLookup.getAtomicMap(cache, key, true);
      m.put(fullyQualifiedSessionId, null);
   }

View Full Code Here

    * @throws Exception
    */
   private void removeSessionFromCache(String ssoId, FullyQualifiedSessionId fullyQualifiedSessionId) throws Exception
   {
      CacheKey key = new CacheKey(ssoId,CacheKey.Type.SESSION);
      AtomicMap m = AtomicMapLookup.getAtomicMap(cache, key, false);
      if (m != null)
      {
         m.remove(fullyQualifiedSessionId);
      }
   }

View Full Code Here

   }


   public void testAtomicHashMap() throws Exception {
      TransactionManager transactionManager = TestingUtil.getTransactionManager(cache1);
      transactionManager.begin();
      AtomicMap am = AtomicMapLookup.getAtomicMap(cache1, "foo");
      am.put("sub-key", "sub-value");
      transactionManager.commit();


      ReplicationQueue replicationQueue = TestingUtil.extractComponent(cache1, ReplicationQueue.class);
      replicationQueue.flush();

View Full Code Here

         Fqn parent = fqn.getSubFqn(0, i);
         Object childName = fqn.get(i);
         // make sure a data key exists in the cache
         assert c.containsKey(new NodeKey(parent, NodeKey.Type.DATA)) : "Node [" + parent + "] does not have a Data atomic map!";
         assert c.containsKey(new NodeKey(parent, NodeKey.Type.STRUCTURE)) : "Node [" + parent + "] does not have a Structure atomic map!";
         AtomicMap am = c.getAtomicMap(new NodeKey(parent, NodeKey.Type.STRUCTURE));
         boolean hasChild = am.containsKey(childName);
         assert hasChild : "Node [" + parent + "] does not have a child [" + childName + "] in its Structure atomic map!";
      }
   }

View Full Code Here


   @SuppressWarnings("unchecked")
   public V remove(Fqn fqn, K key) {
      startAtomic();
      try {
         AtomicMap map = cache.getAtomicMap(new NodeKey(fqn, NodeKey.Type.DATA));
         return map == null ? null : (V) map.remove(key);
      }
      finally {
         endAtomic();
      }
   }

View Full Code Here


   @SuppressWarnings("unchecked")
   public V remove(Fqn fqn, K key) {
      startAtomic();
      try {
         AtomicMap map = cache.getAtomicMap(new NodeKey(fqn, NodeKey.Type.DATA));
         return map == null ? null : (V) map.remove(key);
      }
      finally {
         endAtomic();
      }
   }

View Full Code Here

   public void testAtomicHashMap() throws Exception {
      Cache cache1 = cache(0, "replQueue");
      Cache cache2 = cache(1, "replQueue");
      TransactionManager transactionManager = TestingUtil.getTransactionManager(cache1);
      transactionManager.begin();
      AtomicMap am = AtomicMapLookup.getAtomicMap(cache1, "foo");
      am.put("sub-key", "sub-value");
      transactionManager.commit();


      ReplQueueTestScheduledExecutorFactory.command.run();


      //in next 5 secs, expect the replication to occur

View Full Code Here

   public void testAtomicHashMap() throws Exception {
      Cache cache1 = cache(0, "replQueue");
      Cache cache2 = cache(1, "replQueue");
      TransactionManager transactionManager = TestingUtil.getTransactionManager(cache1);
      transactionManager.begin();
      AtomicMap am = AtomicMapLookup.getAtomicMap(cache1, "foo");
      am.put("sub-key", "sub-value");
      transactionManager.commit();


      ReplQueueTestScheduledExecutorFactory.command.run();


      //in next 5 secs, expect the replication to occur

View Full Code Here

0 1

TOP

Related Classes of org.infinispan.atomic.AtomicMap

org.infinispan.api.tree.TreeCacheAPITest

org.infinispan.replication.ReplicationQueueTest

org.infinispan.tree.TreeCacheImpl

org.jboss.web.tomcat.service.session.sso.ispn.SSOClusterManager

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.