Merge pull request apex-enterprise-patterns#37 from OrtooApps/feature…

…/slight-improvement-to-session-cache

Added removeAll to session cache

framework/default/ortoo-core/default/classes/fflib-extension/caching/SessionCache.cls

@@ -93,6 +93,19 @@ public inherited sharing class SessionCache implements ICacheAdaptor
 		Cache.Session.remove( key );
 	}
 
+	/**
+	 * Instructs the cache to remove all objects from the cache.
+	 *
+	 * Is useful for clearing the cache out completely when the majority of entries would otherwise be dirty.
+	 */
+    public void removeAll()
+    {
+        for ( String thisKey : Cache.Session.getKeys() )
+        {
+            Cache.Session.remove( thisKey );
+        }
+    }
+
 	private String createFullyQualifiedPartitionName()
 	{
 		return Cache.SessionPartition.createFullyQualifiedPartition( PackageUtils.NAMESPACE_PREFIX, PARTITION_NAME );

framework/default/ortoo-core/default/classes/fflib-extension/caching/tests/SessionCacheTest.cls

@@ -120,4 +120,19 @@ private without sharing class SessionCacheTest
 		System.assertEquals( false, new SessionCache().contains( 'keythatneverexisted' ), 'remove, when called for a key that was put, will remove it - checking contains' );
 		System.assertEquals( null, new SessionCache().get( 'keythatneverexisted' ), 'remove, when called for a key that was put, will remove it - checking get' );
 	}
+
+	@isTest
+	private static void removeAll_whenCalled_removesEverythingFromTheCache() // NOPMD: Test method name format
+	{
+		new SessionCache().put( 'key1', '1', DEFAULT_LIFESPAN );
+		new SessionCache().put( 'key2', '2', DEFAULT_LIFESPAN );
+		new SessionCache().put( 'key3', '3', DEFAULT_LIFESPAN );
+
+		SessionCache cache = new SessionCache();
+		cache.removeAll();
+
+		System.assertEquals( false, new SessionCache().contains( 'key1' ), 'remove, when called for a key that was put, will remove it - checking contains' );
+		System.assertEquals( false, new SessionCache().contains( 'key2' ), 'remove, when called for a key that was put, will remove it - checking contains' );
+		System.assertEquals( false, new SessionCache().contains( 'key3' ), 'remove, when called for a key that was put, will remove it - checking contains' );
+	}
 }