add error handler, multiple tweaks and fixes

Author: gwhalin

doc/CHANGELOG.txt

@@ -1,3 +1,7 @@
+08 Jul 2007 (gwhalin)
+	-- add support for ErrorHandler hook (submitted by Dan Zivkovic @ Apple)
+	-- ability to disable URLEncoding keys
+
 08 Apr 2007 (gwhalin)
 	-- added addOrIncr/addOrDecr methods
 	-- internal map changed to avoid possible key collision in internal data

src/com/danga/MemCached/ErrorHandler.java

@@ -0,0 +1,59 @@
+package com.danga.MemCached;
+
+/**
+ * This is an interface implemented by classes that want to receive callbacks
+ * in the event of an error in {@link MemCachedClient}. The implementor can do
+ * things like flush caches or perform additioonal logging.
+ *
+ * @author Dan Zivkovic <[email protected]>
+ * @version 1.5
+ */
+public interface ErrorHandler {
+
+    /**
+     * Called for errors thrown during initialization.
+     */
+    public void handleErrorOnInit( final MemCachedClient client ,
+                                   final Throwable error );
+
+    /**
+     * Called for errors thrown during {@link MemCachedClient#get(String)} and related methods.
+     */
+    public void handleErrorOnGet( final MemCachedClient client ,
+                                  final Throwable error ,
+                                  final String cacheKey );
+
+    /**
+     * Called for errors thrown during {@link MemCachedClient#getMulti(String)} and related methods.
+     */
+    public void handleErrorOnGet( final MemCachedClient client ,
+                                  final Throwable error ,
+                                  final String[] cacheKeys );
+
+    /**
+     * Called for errors thrown during {@link MemCachedClient#set(String,Object)} and related methods.
+     */
+    public void handleErrorOnSet( final MemCachedClient client ,
+                                  final Throwable error ,
+                                  final String cacheKey );
+
+    /**
+     * Called for errors thrown during {@link MemCachedClient#delete(String)} and related methods.
+     */
+    public void handleErrorOnDelete( final MemCachedClient client ,
+                                     final Throwable error ,
+                                     final String cacheKey );
+
+    /**
+     * Called for errors thrown during {@link MemCachedClient#flushAll()} and related methods.
+     */
+    public void handleErrorOnFlush( final MemCachedClient client ,
+                                    final Throwable error );
+
+    /**
+     * Called for errors thrown during {@link MemCachedClient#stats()} and related methods.
+     */
+    public void handleErrorOnStats( final MemCachedClient client ,
+                                    final Throwable error );
+
+} // interface