continuing new cache integration

docs/gotcha.txt

@@ -7,6 +7,18 @@ upgrading from one version to the next, or even between multiple
 versions. Be sure to heed the warnings contained herein as they will
 save you many hours of grief.
 
+8.0.0
+--------------------------------------------------------------------
+ * WebGUI 8 is not API compatible with WebGUI 7. If you have custom
+   code, chances are you'll need to update it to make it work with
+   WebGUI 8.
+
+ * WebGUI now requires memcached.
+
+ * WebGUI now requires the following Perl Modules:
+	- Memcached::libmemcached (0.3102)
+
+
 7.8.0
 --------------------------------------------------------------------
 

docs/migration.txt

@@ -4,3 +4,12 @@ WebGUI 8 Migration Guide
 The information contained herein documents the API changes that have occurred in the WebGUI 8 development effort and how to migrate your code to accomodate the new APIs.
 
 
+WebGUI::Cache
+=============
+WebGUI::Cache has been completely rewritten. If you were using the cache API in the past, you'll need to update your code to reflect the changes. NOTE: you can get a cached reference to the cache object from WebGUI::Session, which will be substantially faster than instantiating the object yourself.
+
+my $cache = $session->cache;
+
+
+
+

lib/WebGUI/Session.pm

@@ -109,6 +109,28 @@ sub asset {
 
 #-------------------------------------------------------------------
 
+=head2 cache ( ) 
+
+Returns a WebGUI::Cache object, which is connected to the WebGUI memcached server.
+
+=cut
+
+sub cache {
+	my $self = shift;
+	unless (exists $self->{_cache}) {
+        my $cache = WebGUI::Cache->new($self);
+		if (defined $cache) {
+			$self->{_cache} = $cache;
+		}
+		else {
+		    $self->log->fatal("Couldn't connect to WebGUI memcached server, and can't continue without it.");
+		}
+	}
+	return $self->{_cache};
+}
+
+#-------------------------------------------------------------------
+
 =head2 close
 
 Cleans up a WebGUI session information from memory and disconnects from any resources opened by the session.

sbin/testEnvironment.pl

@@ -133,6 +133,7 @@ checkModule('Digest::SHA',                  '5.47'       );
 checkModule("CSS::Minifier::XS",            "0.03"       );
 checkModule("JavaScript::Minifier::XS",     "0.05"       );
 checkModule("Readonly",                     "1.03"       );
+checkModule("Memcached::libmemcached",      "0.3102"     );
 
 failAndExit("Required modules are missing, running no more checks.") if $missingModule;