Add setResult() to Query.

This will allow beforeFind() callbacks to avoid query execution by
setting seeding results.

lib/Cake/ORM/Query.php

@@ -82,6 +82,14 @@ class Query extends DatabaseQuery {
 		'matching' => 1
 	];
 
+/**
+ * A hydrated ResultSet.
+ *
+ * @var Cake\ORM\ResultSet
+ * @see setResult()
+ */
+	protected $_results;
+
 /**
  * Returns the default table object that will be used by this query,
  * that is, the table that will appear in the from clause.
@@ -305,16 +313,38 @@ public function normalizedContainments() {
 		return $this->_normalizedContainments = $contain;
 	}
 
+/**
+ * Set the result set for a query.
+ *
+ * Setting the resultset of a query will make execute() a no-op. Instead
+ * of executing the SQL query and fetching results, the ResultSet provided to this
+ * method will be returned.
+ *
+ * This method is most useful when combined with results stored in a persistent cache.
+ *
+ * @param Cake\ORM\ResultSet $results The results this query should return.
+ * @return Query The query instance.
+ */
+	public function setResult(ResultSet $results) {
+		$this->_results = $results;
+		return $this;
+	}
+
 /**
  * Compiles the SQL representation of this query and executes it using the
- * provided connection object. Returns a ResultSet iterator object
+ * provided connection object. Returns a ResultSet iterator object.
+ *
+ * If a result set was set using setResult() that ResultSet will be returned.
  *
  * Resulting object is traversable, so it can be used in any loop as you would
  * with an array.
  *
  * @return Cake\ORM\ResultSet
  */
 	public function execute() {
+		if (isset($this->_results)) {
+			return $this->_results;
+		}
 		return new ResultSet($this, parent::execute());
 	}
 

lib/Cake/Test/TestCase/ORM/QueryTest.php

@@ -19,6 +19,7 @@
 use Cake\Core\Configure;
 use Cake\Model\ConnectionManager;
 use Cake\ORM\Query;
+use Cake\ORM\ResultSet;
 use Cake\ORM\Table;
 
 /**
@@ -812,4 +813,17 @@ public function testFilteringByBelongsToMany() {
 		$this->assertEquals($expected, $results);
 	}
 
+/**
+ * Test setResult()
+ *
+ * @return void
+ */
+	public function testSetResult() {
+		$query = new Query($this->connection);
+		$stmt = $this->getMock('Cake\Database\StatementInterface');
+		$results = new ResultSet($query, $stmt);
+		$query->setResult($results);
+		$this->assertSame($results, $query->execute());
+	}
+
 }