PHPLIB-351: Update logic for identifying resumable errors

Skip redundant error message checks, since their codes do not overlap with the three errors specifically excluded by the spec and all other server errors are resumable.

Deprecate the unused class constant, which can be removed in 2.0 (PHPLIB-360).

Author: jmikola

src/ChangeStream.php

@@ -19,8 +19,9 @@
 
 use MongoDB\BSON\Serializable;
 use MongoDB\Driver\Cursor;
-use MongoDB\Driver\Exception\ConnectionTimeoutException;
+use MongoDB\Driver\Exception\ConnectionException;
 use MongoDB\Driver\Exception\RuntimeException;
+use MongoDB\Driver\Exception\ServerException;
 use MongoDB\Exception\InvalidArgumentException;
 use MongoDB\Exception\ResumeTokenException;
 use IteratorIterator;
@@ -35,14 +36,22 @@
  */
 class ChangeStream implements Iterator
 {
+    /**
+     * @deprecated 1.4
+     * @todo Remove this in 2.0 (see: PHPLIB-360)
+     */
+    const CURSOR_NOT_FOUND = 43;
+
+    private static $errorCodeCappedPositionLost = 136;
+    private static $errorCodeInterrupted = 11601;
+    private static $errorCodeCursorKilled = 237;
+
     private $resumeToken;
     private $resumeCallable;
     private $csIt;
     private $key = 0;
     private $hasAdvanced = false;
 
-    const CURSOR_NOT_FOUND = 43;
-
     /**
      * Constructor.
      *
@@ -91,7 +100,6 @@ public function key()
      */
     public function next()
     {
-        $resumable = false;
         try {
             $this->csIt->next();
             if ($this->valid()) {
@@ -111,18 +119,9 @@ public function next()
                 $this->resumeCallable = null;
             }
         } catch (RuntimeException $e) {
-            if (strpos($e->getMessage(), "not master") !== false) {
-                $resumable = true;
-            }
-            if ($e->getCode() === self::CURSOR_NOT_FOUND) {
-                $resumable = true;
+            if ($this->isResumableError($e)) {
+                $this->resume();
             }
-            if ($e instanceof ConnectionTimeoutException) {
-                $resumable = true;
-            }
-        }
-        if ($resumable) {
-            $this->resume();
         }
     }
 
@@ -144,18 +143,9 @@ public function rewind()
                 $this->resumeCallable = null;
             }
         } catch (RuntimeException $e) {
-            if (strpos($e->getMessage(), "not master") !== false) {
-                $resumable = true;
+            if ($this->isResumableError($e)) {
+                $this->resume();
             }
-            if ($e->getCode() === self::CURSOR_NOT_FOUND) {
-                $resumable = true;
-            }
-            if ($e instanceof ConnectionTimeoutException) {
-                $resumable = true;
-            }
-        }
-        if ($resumable) {
-            $this->resume();
         }
     }
 
@@ -201,6 +191,30 @@ private function extractResumeToken($document)
         return $resumeToken;
     }
 
+    /**
+     * Determines if an exception is a resumable error.
+     *
+     * @see https://github.com/mongodb/specifications/blob/master/source/change-streams/change-streams.rst#resumable-error
+     * @param RuntimeException $exception
+     * @return boolean
+     */
+    private function isResumableError(RuntimeException $exception)
+    {
+        if ($exception instanceof ConnectionException) {
+            return true;
+        }
+
+        if ( ! $exception instanceof ServerException) {
+            return false;
+        }
+
+        if (in_array($exception->getCode(), [self::$errorCodeCappedPositionLost, self::$errorCodeCursorKilled, self::$errorCodeInterrupted])) {
+            return false;
+        }
+
+        return true;
+    }
+
     /**
      * Creates a new changeStream after a resumable server error.
      *