From 204691be18aed46c439d36fca333b5927f8a592d Mon Sep 17 00:00:00 2001 From: Lukas Eder Date: Wed, 19 May 2021 15:14:05 +0200 Subject: [PATCH] [jOOQ/jOOQ#11892] Added documentation to ResultQuery --- jOOQ/src/main/java/org/jooq/ResultQuery.java | 593 ++++++++++++++++++- 1 file changed, 565 insertions(+), 28 deletions(-) diff --git a/jOOQ/src/main/java/org/jooq/ResultQuery.java b/jOOQ/src/main/java/org/jooq/ResultQuery.java index 7f0a31a1ef..f469594adc 100644 --- a/jOOQ/src/main/java/org/jooq/ResultQuery.java +++ b/jOOQ/src/main/java/org/jooq/ResultQuery.java @@ -151,6 +151,9 @@ public interface ResultQuery extends Query, Iterable, Publi *

* In order to keep open {@link ResultSet}s and fetch records lazily, use * {@link #fetchLazy()} instead and then operate on {@link Cursor}. + *

+ * This method is not affected by + * {@link Settings#getFetchIntermediateResult()}. * * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -353,6 +356,11 @@ public interface ResultQuery extends Query, Iterable, Publi * ... with the exception of allowing client code to ignore the need for * managing resources, which are handled inside of the * collect() method. + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @param collector The collector that collects all records and accumulates * them into a result type. @@ -422,12 +430,14 @@ public interface ResultQuery extends Query, Iterable, Publi * Execute the query and return all values for a field from the generated * result. *

- * This is the same as calling {@link #fetch()} and then - * {@link Result#getValues(Field, Class)} - *

* The {@link Converter} that is provided by * {@link Configuration#converterProvider()} will be used to convert the * value to U + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -440,8 +450,10 @@ public interface ResultQuery extends Query, Iterable, Publi * Execute the query and return all values for a field from the generated * result. *

- * This is the same as calling {@link #fetch()} and then - * {@link Result#getValues(Field, Converter)} + * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -454,8 +466,10 @@ public interface ResultQuery extends Query, Iterable, Publi * Execute the query and return all values for a field index from the * generated result. *

- * This is the same as calling {@link #fetch()} and then - * {@link Result#getValues(int)} + * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -467,12 +481,14 @@ public interface ResultQuery extends Query, Iterable, Publi * Execute the query and return all values for a field index from the * generated result. *

- * This is the same as calling {@link #fetch()} and then - * {@link Result#getValues(int, Class)} - *

* The {@link Converter} that is provided by * {@link Configuration#converterProvider()} will be used to convert the * value to U + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -485,8 +501,10 @@ public interface ResultQuery extends Query, Iterable, Publi * Execute the query and return all values for a field index from the * generated result. *

- * This is the same as calling {@link #fetch()} and then - * {@link Result#getValues(int, Converter)} + * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -499,8 +517,10 @@ public interface ResultQuery extends Query, Iterable, Publi * Execute the query and return all values for a field name from the * generated result. *

- * This is the same as calling {@link #fetch()} and then - * {@link Result#getValues(String)} + * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -512,12 +532,14 @@ public interface ResultQuery extends Query, Iterable, Publi * Execute the query and return all values for a field name from the * generated result. *

- * This is the same as calling {@link #fetch()} and then - * {@link Result#getValues(String, Class)} - *

* The {@link Converter} that is provided by * {@link Configuration#converterProvider()} will be used to convert the * value to U + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -530,8 +552,10 @@ public interface ResultQuery extends Query, Iterable, Publi * Execute the query and return all values for a field name from the * generated result. *

- * This is the same as calling {@link #fetch()} and then - * {@link Result#getValues(String, Converter)} + * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -544,8 +568,10 @@ public interface ResultQuery extends Query, Iterable, Publi * Execute the query and return all values for a field name from the * generated result. *

- * This is the same as calling {@link #fetch()} and then - * {@link Result#getValues(Name)} + * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -557,12 +583,14 @@ public interface ResultQuery extends Query, Iterable, Publi * Execute the query and return all values for a field name from the * generated result. *

- * This is the same as calling {@link #fetch()} and then - * {@link Result#getValues(Name, Class)} - *

* The {@link Converter} that is provided by * {@link Configuration#converterProvider()} will be used to convert the * value to U + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -575,8 +603,10 @@ public interface ResultQuery extends Query, Iterable, Publi * Execute the query and return all values for a field name from the * generated result. *

- * This is the same as calling {@link #fetch()} and then - * {@link Result#getValues(Name, Converter)} + * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -1784,6 +1814,11 @@ public interface ResultQuery extends Query, Iterable, Publi /** * Execute the query and return the generated result as a list of name/value * maps. + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -1807,6 +1842,11 @@ public interface ResultQuery extends Query, Iterable, Publi * by default. Use {@link Settings#isAttachRecords()} to override this * behaviour. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param The key's generic field type @@ -1834,6 +1874,11 @@ public interface ResultQuery extends Query, Iterable, Publi * by default. Use {@link Settings#isAttachRecords()} to override this * behaviour. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldIndex The key field. Client code must assure that this @@ -1860,6 +1905,11 @@ public interface ResultQuery extends Query, Iterable, Publi * by default. Use {@link Settings#isAttachRecords()} to override this * behaviour. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldName The key field. Client code must assure that this @@ -1886,6 +1936,11 @@ public interface ResultQuery extends Query, Iterable, Publi * by default. Use {@link Settings#isAttachRecords()} to override this * behaviour. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldName The key field. Client code must assure that this @@ -1908,6 +1963,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(Field, Field)} instead, if your keys * are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. *

* If the argument {@link Field}s are the same as the ones you've provided @@ -1937,6 +1997,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(int, int)} instead, if your keys are * non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldIndex The key field. Client code must assure that this @@ -1960,6 +2025,16 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(String, String)} instead, if your keys * are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldName The key field. Client code must assure that this @@ -1983,6 +2058,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(Name, Name)} instead, if your keys * are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldName The key field. Client code must assure that this @@ -2006,6 +2086,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(Field[])} instead, if your keys are * non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keys The keys. Client code must assure that keys are unique in the @@ -2028,6 +2113,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(int[])} instead, if your keys are * non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldIndexes The keys. Client code must assure that keys are @@ -2050,6 +2140,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(String[])} instead, if your keys are * non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldNames The keys. Client code must assure that keys are @@ -2072,6 +2167,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(Name[])} instead, if your keys are * non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldNames The keys. Client code must assure that keys are @@ -2094,6 +2194,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(Field[], Field[])} instead, if your * keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keys The keys. Client code must assure that keys are unique in the @@ -2117,6 +2222,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(int[], int[])} instead, if your keys * are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldIndexes The keys. Client code must assure that keys are @@ -2140,6 +2250,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(String[], String[])} instead, if your * keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldNames The keys. Client code must assure that keys are @@ -2163,6 +2278,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(Name[], Name[])} instead, if your * keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldNames The keys. Client code must assure that keys are @@ -2186,6 +2306,11 @@ public interface ResultQuery extends Query, Iterable, Publi * in the result set. Use {@link #fetchGroups(Field[], Class)} instead, if * your keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keys The keys. Client code must assure that keys are unique in the @@ -2213,6 +2338,11 @@ public interface ResultQuery extends Query, Iterable, Publi * in the result set. Use {@link #fetchGroups(int[], Class)} instead, if * your keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldIndexes The keys. Client code must assure that keys are @@ -2240,6 +2370,11 @@ public interface ResultQuery extends Query, Iterable, Publi * in the result set. Use {@link #fetchGroups(String[], Class)} instead, if * your keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldNames The keys. Client code must assure that keys are @@ -2267,6 +2402,11 @@ public interface ResultQuery extends Query, Iterable, Publi * in the result set. Use {@link #fetchGroups(Name[], Class)} instead, if * your keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldNames The keys. Client code must assure that keys are @@ -2294,6 +2434,11 @@ public interface ResultQuery extends Query, Iterable, Publi * in the result set. Use {@link #fetchGroups(Field[], RecordMapper)} * instead, if your keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keys The keys. Client code must assure that keys are unique in the @@ -2321,6 +2466,11 @@ public interface ResultQuery extends Query, Iterable, Publi * in the result set. Use {@link #fetchGroups(int[], RecordMapper)} instead, * if your keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldIndexes The keys. Client code must assure that keys are @@ -2348,6 +2498,11 @@ public interface ResultQuery extends Query, Iterable, Publi * in the result set. Use {@link #fetchGroups(String[], RecordMapper)} * instead, if your keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldNames The keys. Client code must assure that keys are @@ -2375,6 +2530,11 @@ public interface ResultQuery extends Query, Iterable, Publi * in the result set. Use {@link #fetchGroups(Name[], RecordMapper)} * instead, if your keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldNames The keys. Client code must assure that keys are @@ -2406,6 +2566,11 @@ public interface ResultQuery extends Query, Iterable, Publi * in the result set. Use {@link #fetchGroups(Class)} instead, if your keys * are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyType The key type. If this is null, the resulting @@ -2434,6 +2599,11 @@ public interface ResultQuery extends Query, Iterable, Publi * in the result set. Use {@link #fetchGroups(Class, Class)} instead, if * your keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyType The key type. If this is null, the resulting @@ -2463,6 +2633,11 @@ public interface ResultQuery extends Query, Iterable, Publi * in the result set. Use {@link #fetchGroups(Class, RecordMapper)} instead, * if your keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyType The key type. If this is null, the resulting @@ -2492,6 +2667,11 @@ public interface ResultQuery extends Query, Iterable, Publi * in the result set. Use {@link #fetchGroups(RecordMapper)} instead, if * your keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyMapper The key mapper. @@ -2519,6 +2699,11 @@ public interface ResultQuery extends Query, Iterable, Publi * in the result set. Use {@link #fetchGroups(RecordMapper, Class)} instead, * if your keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyMapper The key mapper. @@ -2547,6 +2732,11 @@ public interface ResultQuery extends Query, Iterable, Publi * in the result set. Use {@link #fetchGroups(RecordMapper, RecordMapper)} * instead, if your keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyMapper The key mapper. @@ -2571,6 +2761,11 @@ public interface ResultQuery extends Query, Iterable, Publi * non-unique in the result set. Use {@link #fetchGroups(Table)} instead, if * your keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param table The key table. Client code must assure that keys are unique @@ -2593,6 +2788,11 @@ public interface ResultQuery extends Query, Iterable, Publi * non-unique in the result set. Use {@link #fetchGroups(Table, Table)} * instead, if your keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyTable The key table. Client code must assure that keys are @@ -2616,6 +2816,11 @@ public interface ResultQuery extends Query, Iterable, Publi * in the result set. Use {@link #fetchGroups(Table, Class)} instead, if * your keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param table The key table. Client code must assure that keys are unique @@ -2642,6 +2847,11 @@ public interface ResultQuery extends Query, Iterable, Publi * in the result set. Use {@link #fetchGroups(Table, RecordMapper)} instead, * if your keys are non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param table The key table. Client code must assure that keys are unique @@ -2668,6 +2878,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(Field, Class)} instead, if your key * is non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param key The key. Client code must assure that key is unique in the @@ -2691,6 +2906,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(int, Class)} instead, if your key * is non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldIndex The key. Client code must assure that key is unique @@ -2714,6 +2934,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(String, Class)} instead, if your key * is non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldName The key. Client code must assure that key is unique @@ -2737,6 +2962,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(Name, Class)} instead, if your key * is non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldName The key. Client code must assure that key is unique @@ -2760,6 +2990,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(Field, Class)} instead, if your key * is non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param key The key. Client code must assure that key is unique in the @@ -2783,6 +3018,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(int, Class)} instead, if your key is * non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldIndex The key. Client code must assure that key is unique @@ -2806,6 +3046,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(String, Class)} instead, if your key * is non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldName The key. Client code must assure that key is unique @@ -2829,6 +3074,11 @@ public interface ResultQuery extends Query, Iterable, Publi * result set. Use {@link #fetchGroups(Name, Class)} instead, if your key * is non-unique. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldName The key. Client code must assure that key is unique @@ -2855,6 +3105,11 @@ public interface ResultQuery extends Query, Iterable, Publi * by default. Use {@link Settings#isAttachRecords()} to override this * behaviour. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param The key's generic field type @@ -2878,6 +3133,11 @@ public interface ResultQuery extends Query, Iterable, Publi * by default. Use {@link Settings#isAttachRecords()} to override this * behaviour. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldIndex The key field index. @@ -2900,6 +3160,11 @@ public interface ResultQuery extends Query, Iterable, Publi * by default. Use {@link Settings#isAttachRecords()} to override this * behaviour. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldName The key field name. @@ -2922,6 +3187,11 @@ public interface ResultQuery extends Query, Iterable, Publi * by default. Use {@link Settings#isAttachRecords()} to override this * behaviour. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldName The key field name. @@ -2940,6 +3210,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(Field, Field)}, this method allows for non-unique * keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. *

* If the argument {@link Field}s are the same as the ones you've provided @@ -2966,6 +3241,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(int, int)}, this method allows for non-unique * keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldIndex The key field index. @@ -2985,6 +3265,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(String, String)}, this method allows for * non-unique keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldName The key field name. @@ -3004,6 +3289,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(Name, Name)}, this method allows for * non-unique keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldName The key field name. @@ -3023,6 +3313,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(Field[])}, this method allows for non-unique keys * in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keys The keys used for result grouping. If this is @@ -3043,6 +3338,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(int[])}, this method allows for non-unique keys * in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldIndexes The keys used for result grouping. If this is @@ -3063,6 +3363,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(String[])}, this method allows for non-unique * keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldNames The keys used for result grouping. If this is @@ -3083,6 +3388,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(Name[])}, this method allows for non-unique * keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldNames The keys used for result grouping. If this is @@ -3103,6 +3413,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(Field[], Field[])}, this method allows for * non-unique keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keys The keys used for result grouping. If this is @@ -3124,6 +3439,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(int[], int[])}, this method allows for non-unique * keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldIndexes The keys used for result grouping. If this is @@ -3145,6 +3465,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(String[], String[])}, this method allows for * non-unique keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldNames The keys used for result grouping. If this is @@ -3166,6 +3491,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(Name[], Name[])}, this method allows for * non-unique keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldNames The keys used for result grouping. If this is @@ -3187,6 +3517,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(Field[], Class)}, this method allows for * non-unique keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keys The keys. If this is null or an empty array, the @@ -3210,6 +3545,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(int[], Class)}, this method allows for * non-unique keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldIndexes The keys. If this is null or an empty @@ -3233,6 +3573,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(String[], Class)}, this method allows for * non-unique keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldNames The keys. If this is null or an empty @@ -3256,6 +3601,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(Name[], Class)}, this method allows for * non-unique keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldNames The keys. If this is null or an empty @@ -3279,6 +3629,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(Field[], RecordMapper)}, this method allows for * non-unique keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keys The keys. If this is null or an empty array, the @@ -3302,6 +3657,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(int[], RecordMapper)}, this method allows for * non-unique keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldIndexes The keys. If this is null or an empty @@ -3325,6 +3685,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(String[], RecordMapper)}, this method allows for * non-unique keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldNames The keys. If this is null or an empty @@ -3348,6 +3713,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(Name[], RecordMapper)}, this method allows for * non-unique keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldNames The keys. If this is null or an empty @@ -3375,6 +3745,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(Class)}, this method allows for non-unique keys * in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyType The key type. If this is null, the resulting @@ -3399,6 +3774,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(Class, Class)}, this method allows for non-unique * keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyType The key type. If this is null, the resulting @@ -3424,6 +3804,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(Class, RecordMapper)}, this method allows for * non-unique keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyType The key type. If this is null, the resulting @@ -3449,6 +3834,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(RecordMapper, RecordMapper)}, this method allows * for non-unique keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyMapper The key mapper. @@ -3472,6 +3862,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(RecordMapper, Class)}, this method allows for * non-unique keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyMapper The key mapper. @@ -3496,6 +3891,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(RecordMapper, RecordMapper)}, this method allows * for non-unique keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyMapper The key mapper. @@ -3516,6 +3916,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(Table)}, this method allows for non-unique keys * in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param table The key table. May not be null. @@ -3534,6 +3939,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(Table, Table)}, this method allows for non-unique * keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyTable The key table. May not be null. @@ -3553,6 +3963,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(Table, Class)}, this method allows for non-unique * keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param table The key table. May not be null. @@ -3575,6 +3990,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Unlike {@link #fetchMap(Table, RecordMapper)}, this method allows for * non-unique keys in the result set. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param table The key table. May not be null. @@ -3594,6 +4014,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Return a {@link Map} with results grouped by the given key and mapped * into the given entity type. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param The key's generic field type @@ -3615,6 +4040,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Return a {@link Map} with results grouped by the given key and mapped * into the given entity type. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldIndex The key field index. @@ -3634,6 +4064,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Return a {@link Map} with results grouped by the given key and mapped * into the given entity type. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldName The key field name. @@ -3653,6 +4088,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Return a {@link Map} with results grouped by the given key and mapped * into the given entity type. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldName The key field name. @@ -3672,6 +4112,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Return a {@link Map} with results grouped by the given key and mapped by * the given mapper. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param The key's generic field type @@ -3693,6 +4138,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Return a {@link Map} with results grouped by the given key and mapped by * the given mapper. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldIndex The key field index. @@ -3712,6 +4162,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Return a {@link Map} with results grouped by the given key and mapped by * the given mapper. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldName The key field name. @@ -3731,6 +4186,11 @@ public interface ResultQuery extends Query, Iterable, Publi * Return a {@link Map} with results grouped by the given key and mapped by * the given mapper. *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. + *

* The resulting map is iteration order preserving. * * @param keyFieldName The key field name. @@ -3965,6 +4425,11 @@ public interface ResultQuery extends Query, Iterable, Publi /** * Fetch results into a custom mapper callback. + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @param mapper The mapper callback * @return The result. This will never be null. @@ -3976,6 +4441,11 @@ public interface ResultQuery extends Query, Iterable, Publi /** * Execute the query and return all values for a field index from the * generated result. + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -3991,6 +4461,11 @@ public interface ResultQuery extends Query, Iterable, Publi * The {@link Converter} that is provided by * {@link Configuration#converterProvider()} will be used to convert the * value to U + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -4002,6 +4477,11 @@ public interface ResultQuery extends Query, Iterable, Publi /** * Execute the query and return all values for a field index from the * generated result. + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -4013,6 +4493,11 @@ public interface ResultQuery extends Query, Iterable, Publi /** * Execute the query and return all values for a field name from the * generated result. + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -4028,6 +4513,11 @@ public interface ResultQuery extends Query, Iterable, Publi * The {@link Converter} that is provided by * {@link Configuration#converterProvider()} will be used to convert the * value to U + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -4039,6 +4529,11 @@ public interface ResultQuery extends Query, Iterable, Publi /** * Execute the query and return all values for a field name from the * generated result. + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -4050,6 +4545,11 @@ public interface ResultQuery extends Query, Iterable, Publi /** * Execute the query and return all values for a field name from the * generated result. + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -4065,6 +4565,11 @@ public interface ResultQuery extends Query, Iterable, Publi * The {@link Converter} that is provided by * {@link Configuration#converterProvider()} will be used to convert the * value to U + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -4076,6 +4581,11 @@ public interface ResultQuery extends Query, Iterable, Publi /** * Execute the query and return all values for a field name from the * generated result. + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -4091,6 +4601,11 @@ public interface ResultQuery extends Query, Iterable, Publi * If the argument {@link Field}s are the same as the ones you've provided * to {@link DSLContext#select(SelectField)}, then you could also just call * {@link #collect(Collector)} with {@link Records#toSet()}. + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -4106,6 +4621,11 @@ public interface ResultQuery extends Query, Iterable, Publi * The {@link Converter} that is provided by * {@link Configuration#converterProvider()} will be used to convert the * value to U + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -4117,6 +4637,11 @@ public interface ResultQuery extends Query, Iterable, Publi /** * Execute the query and return all values for a field from the generated * result. + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query @@ -4128,8 +4653,10 @@ public interface ResultQuery extends Query, Iterable, Publi /** * Map resulting records onto a custom type. *

- * This is the same as calling fetch().into(type). See - * {@link Record#into(Class)} for more details + * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @param The generic entity type. * @param type The entity type. @@ -4153,6 +4680,11 @@ public interface ResultQuery extends Query, Iterable, Publi * The result and its contained records are attached to the original * {@link Configuration} by default. Use {@link Settings#isAttachRecords()} * to override this behaviour. + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @param The generic table record type. * @param table The table type. @@ -4183,6 +4715,11 @@ public interface ResultQuery extends Query, Iterable, Publi /** * Fetch results into a custom mapper callback. + *

+ * Whether this fetches an intermediate {@link Result} (accessible by + * {@link ExecuteListener} implementations), or streams records directly to + * the collector producing the result is governed by + * {@link Settings#getFetchIntermediateResult()}. * * @param mapper The mapper callback * @return The result. This will never be null.