From b507f112a25134a40229966bde32c4e8ad4238f4 Mon Sep 17 00:00:00 2001
From: lukaseder <lukas.eder@gmail.com>
Date: Fri, 15 Dec 2017 10:23:21 +0100
Subject: [PATCH] [#6923] Clarify the meaning of MockResult.data == null

---
 .../main/java/org/jooq/tools/jdbc/MockResult.java  | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/jOOQ/src/main/java/org/jooq/tools/jdbc/MockResult.java b/jOOQ/src/main/java/org/jooq/tools/jdbc/MockResult.java
index 2a42eb8505..d216a440fa 100644
--- a/jOOQ/src/main/java/org/jooq/tools/jdbc/MockResult.java
+++ b/jOOQ/src/main/java/org/jooq/tools/jdbc/MockResult.java
@@ -76,10 +76,16 @@ public class MockResult {
     /**
      * The result data associated with this execution result.
      * <p>
-     * This object describes the result data (including meta data). If the given
-     * query execution did not provide any results, this may be
-     * <code>null</code>. Note, that this can also be used to provide a result
-     * for {@link Statement#getGeneratedKeys()}
+     * This object describes the result data (including meta data).
+     * <p>
+     * If the given query execution did not provide any results (as in
+     * <code>{@link Statement#execute(String)} == false</code>), this may be
+     * <code>null</code>. This is not the same as producing an <em>empty</em>
+     * result, which can only be modelled by an empty {@link Result}, containing
+     * column information but no rows.
+     * </p>
+     * Note, that this can also be used to provide a result for
+     * {@link Statement#getGeneratedKeys()}
      */
     public final Result<?> data;