diff --git a/jOOQ/src/main/java/org/jooq/DSLContext.java b/jOOQ/src/main/java/org/jooq/DSLContext.java index 90ee324cc5..1adaeea239 100644 --- a/jOOQ/src/main/java/org/jooq/DSLContext.java +++ b/jOOQ/src/main/java/org/jooq/DSLContext.java @@ -578,9 +578,8 @@ public interface DSLContext extends Scope , AutoCloseable { * escape literals when concatenated into SQL clauses! * * @param sql The SQL - * @return The results from the executed query. This is never - * null, even if the database returns no - * {@link ResultSet} + * @return The results from the executed query. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @see SQL */ @@ -606,9 +605,8 @@ public interface DSLContext extends Scope , AutoCloseable { * escape literals when concatenated into SQL clauses! * * @param sql The SQL - * @return The results from the executed query. This is never - * null, even if the database returns no - * {@link ResultSet} + * @return The results from the executed query. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @see SQL */ @@ -638,9 +636,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param sql The SQL * @param bindings The bindings - * @return The results from the executed query. This is never - * null, even if the database returns no - * {@link ResultSet} + * @return The results from the executed query. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see SQL */ @@ -672,7 +668,8 @@ public interface DSLContext extends Scope , AutoCloseable { * parts can be injected * @param parts The {@link QueryPart} objects that are rendered at the * {numbered placeholder} locations - * @return The results from the executed query + * @return The results from the executed query. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @see SQL */ @@ -704,9 +701,7 @@ public interface DSLContext extends Scope , AutoCloseable { * escape literals when concatenated into SQL clauses! * * @param sql The SQL - * @return The results from the executed query. This is never - * null, even if the database returns no - * {@link ResultSet} + * @return The cursor. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see SQL */ @@ -738,9 +733,7 @@ public interface DSLContext extends Scope , AutoCloseable { * escape literals when concatenated into SQL clauses! * * @param sql The SQL - * @return The results from the executed query. This is never - * null, even if the database returns no - * {@link ResultSet} + * @return The cursor. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see SQL */ @@ -776,9 +769,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param sql The SQL * @param bindings The bindings - * @return The results from the executed query. This is never - * null, even if the database returns no - * {@link ResultSet} + * @return The cursor. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see SQL */ @@ -816,9 +807,7 @@ public interface DSLContext extends Scope , AutoCloseable { * parts can be injected * @param parts The {@link QueryPart} objects that are rendered at the * {numbered placeholder} locations - * @return The results from the executed query. This is never - * null, even if the database returns no - * {@link ResultSet} + * @return The cursor. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see SQL */ @@ -847,9 +836,8 @@ public interface DSLContext extends Scope , AutoCloseable { * escape literals when concatenated into SQL clauses! * * @param sql The SQL - * @return The results from the executed query. This is never - * null, even if the database returns no - * {@link ResultSet} + * @return The completion stage. The completed result will never be + * null. * @see SQL */ @Support @@ -875,9 +863,8 @@ public interface DSLContext extends Scope , AutoCloseable { * escape literals when concatenated into SQL clauses! * * @param sql The SQL - * @return The results from the executed query. This is never - * null, even if the database returns no - * {@link ResultSet} + * @return The completion stage. The completed result will never be + * null. * @see SQL */ @Support @@ -907,9 +894,8 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param sql The SQL * @param bindings The bindings - * @return The results from the executed query. This is never - * null, even if the database returns no - * {@link ResultSet} + * @return The completion stage. The completed result will never be + * null. * @see SQL */ @Support @@ -941,10 +927,8 @@ public interface DSLContext extends Scope , AutoCloseable { * parts can be injected * @param parts The {@link QueryPart} objects that are rendered at the * {numbered placeholder} locations - * @return The results from the executed query. This is never - * null, even if the database returns no - * {@link ResultSet} - * @throws DataAccessException if something went wrong executing the query + * @return The completion stage. The completed result will never be + * null. * @see SQL */ @Support @@ -970,9 +954,8 @@ public interface DSLContext extends Scope , AutoCloseable { * escape literals when concatenated into SQL clauses! * * @param sql The SQL - * @return The results from the executed query. This is never - * null, even if the database returns no - * {@link ResultSet} + * @return The completion stage. The completed result will never be + * null. * @see SQL */ @Support @@ -998,9 +981,8 @@ public interface DSLContext extends Scope , AutoCloseable { * escape literals when concatenated into SQL clauses! * * @param sql The SQL - * @return The results from the executed query. This is never - * null, even if the database returns no - * {@link ResultSet} + * @return The completion stage. The completed result will never be + * null. * @see SQL */ @Support @@ -1030,9 +1012,8 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param sql The SQL * @param bindings The bindings - * @return The results from the executed query. This is never - * null, even if the database returns no - * {@link ResultSet} + * @return The completion stage. The completed result will never be + * null. * @see SQL */ @Support @@ -1064,10 +1045,8 @@ public interface DSLContext extends Scope , AutoCloseable { * parts can be injected * @param parts The {@link QueryPart} objects that are rendered at the * {numbered placeholder} locations - * @return The results from the executed query. This is never - * null, even if the database returns no - * {@link ResultSet} - * @throws DataAccessException if something went wrong executing the query + * @return The completion stage. The completed result will never be + * null. * @see SQL */ @Support @@ -1236,9 +1215,7 @@ public interface DSLContext extends Scope , AutoCloseable { * escape literals when concatenated into SQL clauses! * * @param sql The SQL - * @return The results from the executed query. This is never - * null, even if the database returns no - * {@link ResultSet} + * @return The results. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see SQL */ @@ -1261,9 +1238,7 @@ public interface DSLContext extends Scope , AutoCloseable { * escape literals when concatenated into SQL clauses! * * @param sql The SQL - * @return The results from the executed query. This is never - * null, even if the database returns no - * {@link ResultSet} + * @return The results. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see SQL */ @@ -1290,9 +1265,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param sql The SQL * @param bindings The bindings - * @return The results from the executed query. This is never - * null, even if the database returns no - * {@link ResultSet} + * @return The results. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see SQL */ @@ -1325,7 +1298,7 @@ public interface DSLContext extends Scope , AutoCloseable { * parts can be injected * @param parts The {@link QueryPart} objects that are rendered at the * {numbered placeholder} locations - * @return The results from the executed query + * @return The results. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see SQL */ @@ -1351,7 +1324,7 @@ public interface DSLContext extends Scope , AutoCloseable { * escape literals when concatenated into SQL clauses! * * @param sql The SQL - * @return The results from the executed query. + * @return The record or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record * @see SQL @@ -1378,7 +1351,7 @@ public interface DSLContext extends Scope , AutoCloseable { * escape literals when concatenated into SQL clauses! * * @param sql The SQL - * @return The results from the executed query. + * @return The record or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record * @see SQL @@ -1409,8 +1382,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param sql The SQL * @param bindings The bindings - * @return The results from the executed query. This may be - * null if the database returned no records + * @return The record or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record * @see SQL @@ -1443,8 +1415,7 @@ public interface DSLContext extends Scope , AutoCloseable { * parts can be injected * @param parts The {@link QueryPart} objects that are rendered at the * {numbered placeholder} locations - * @return The results from the executed query. This may be - * null if the database returned no records + * @return The record or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record * @see SQL @@ -1591,8 +1562,7 @@ public interface DSLContext extends Scope , AutoCloseable { * escape literals when concatenated into SQL clauses! * * @param sql The SQL - * @return The result value from the executed query. This may be - * null if the database returned no records + * @return The value or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record * @throws InvalidResultException if the query returned a record with more @@ -1621,8 +1591,7 @@ public interface DSLContext extends Scope , AutoCloseable { * escape literals when concatenated into SQL clauses! * * @param sql The SQL - * @return The result value from the executed query. This may be - * null if the database returned no records + * @return The value or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record * @throws InvalidResultException if the query returned a record with more @@ -1655,8 +1624,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param sql The SQL * @param bindings The bindings - * @return The results from the executed query. This may be - * null if the database returned no records + * @return The value or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record * @throws InvalidResultException if the query returned a record with more @@ -1691,8 +1659,7 @@ public interface DSLContext extends Scope , AutoCloseable { * parts can be injected * @param parts The {@link QueryPart} objects that are rendered at the * {numbered placeholder} locations - * @return The results from the executed query. This may be - * null if the database returned no records + * @return The value or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record * @throws InvalidResultException if the query returned a record with more @@ -1849,8 +1816,7 @@ public interface DSLContext extends Scope , AutoCloseable { * escape literals when concatenated into SQL clauses! * * @param sql The SQL - * @return The result values from the executed query. This is never - * null. + * @return The values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see SQL */ @@ -1876,8 +1842,7 @@ public interface DSLContext extends Scope , AutoCloseable { * escape literals when concatenated into SQL clauses! * * @param sql The SQL - * @return The result values from the executed query. This is never - * null. + * @return The values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see SQL */ @@ -1907,8 +1872,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param sql The SQL * @param bindings The bindings - * @return The results from the executed query. This is never - * null. + * @return The values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see SQL */ @@ -1940,8 +1904,7 @@ public interface DSLContext extends Scope , AutoCloseable { * parts can be injected * @param parts The {@link QueryPart} objects that are rendered at the * {numbered placeholder} locations - * @return The results from the executed query. This is never - * null. + * @return The values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see SQL */ @@ -2222,7 +2185,7 @@ public interface DSLContext extends Scope , AutoCloseable { * Result at once. * * @param rs The JDBC ResultSet to fetch data from - * @return The resulting jOOQ Result + * @return The resulting jOOQ Result. This will never be null. * @throws DataAccessException if something went wrong executing the query */ @Support @@ -2243,7 +2206,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param fields The fields to use in the desired output - * @return The resulting jOOQ Result + * @return The resulting jOOQ Result. This will never be null. * @throws DataAccessException if something went wrong executing the query */ @Support @@ -2264,7 +2227,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param types The data types to use in the desired output - * @return The resulting jOOQ Result + * @return The resulting jOOQ Result. This will never be null. * @throws DataAccessException if something went wrong executing the query */ @Support @@ -2285,7 +2248,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param types The data types to use in the desired output - * @return The resulting jOOQ Result + * @return The resulting jOOQ Result. This will never be null. * @throws DataAccessException if something went wrong executing the query */ @Support @@ -2299,7 +2262,7 @@ public interface DSLContext extends Scope , AutoCloseable { * was more than one resulting record. * * @param rs The JDBC ResultSet to fetch data from - * @return The resulting jOOQ record + * @return The record or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record */ @@ -2318,7 +2281,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param fields The fields to use in the desired output - * @return The resulting jOOQ record + * @return The record or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record */ @@ -2337,7 +2300,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param types The data types to use in the desired output - * @return The resulting jOOQ record + * @return The record or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record */ @@ -2356,7 +2319,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param types The data types to use in the desired output - * @return The resulting jOOQ record + * @return The record or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record */ @@ -2445,7 +2408,7 @@ public interface DSLContext extends Scope , AutoCloseable { * was more than one resulting record. * * @param rs The JDBC ResultSet to fetch data from - * @return The resulting value + * @return The value or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record * @throws InvalidResultException if the query returned a record with more @@ -2466,7 +2429,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param field The field to use in the desired output - * @return The resulting value + * @return The value or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record * @throws InvalidResultException if the query returned a record with more @@ -2487,7 +2450,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param type The data type to use in the desired output - * @return The resulting value + * @return The value or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record * @throws InvalidResultException if the query returned a record with more @@ -2508,7 +2471,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param type The data types to use in the desired output - * @return The resulting value + * @return The value or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record * @throws InvalidResultException if the query returned a record with more @@ -2604,7 +2567,7 @@ public interface DSLContext extends Scope , AutoCloseable { * contained column's values. * * @param rs The JDBC ResultSet to fetch data from - * @return The resulting values + * @return The values. This will never be null. * @throws DataAccessException if something went wrong executing the query */ @Support @@ -2619,7 +2582,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param field The field to use in the desired output - * @return The resulting values + * @return The values. This will never be null. * @throws DataAccessException if something went wrong executing the query */ @Support @@ -2634,7 +2597,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param type The data type to use in the desired output - * @return The resulting values + * @return The values. This will never be null. * @throws DataAccessException if something went wrong executing the query */ @Support @@ -2649,7 +2612,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param type The data types to use in the desired output - * @return The resulting values + * @return The values. This will never be null. * @throws DataAccessException if something went wrong executing the query */ @Support @@ -2662,7 +2625,7 @@ public interface DSLContext extends Scope , AutoCloseable { * into a jOOQ Result at once. * * @param rs The JDBC ResultSet to fetch data from - * @return The resulting jOOQ Result + * @return The cursor. This will never be null. * @throws DataAccessException if something went wrong executing the query */ @Support @@ -2679,7 +2642,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param fields The fields to use in the desired output - * @return The resulting jOOQ Result + * @return The cursor. This will never be null. * @throws DataAccessException if something went wrong executing the query */ @Support @@ -2696,7 +2659,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param types The data types to use in the desired output - * @return The resulting jOOQ Result + * @return The cursor. This will never be null. * @throws DataAccessException if something went wrong executing the query */ @Support @@ -2713,7 +2676,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param types The data types to use in the desired output - * @return The resulting jOOQ Result + * @return The cursor. This will never be null. * @throws DataAccessException if something went wrong executing the query */ @Support @@ -2726,7 +2689,8 @@ public interface DSLContext extends Scope , AutoCloseable { * completed by a task running in the {@link ForkJoinPool#commonPool()}. * * @param rs The JDBC ResultSet to fetch data from - * @return The resulting jOOQ Result + * @return The completion stage. The completed result will never be + * null. */ @Support CompletionStage> fetchAsync(ResultSet rs); @@ -2740,8 +2704,8 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param fields The fields to use in the desired output - * @return The resulting jOOQ Result - * @throws DataAccessException if something went wrong executing the query + * @return The completion stage. The completed result will never be + * null. */ @Support CompletionStage> fetchAsync(ResultSet rs, Field... fields); @@ -2755,8 +2719,8 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param types The data types to use in the desired output - * @return The resulting jOOQ Result - * @throws DataAccessException if something went wrong executing the query + * @return The completion stage. The completed result will never be + * null. */ @Support CompletionStage> fetchAsync(ResultSet rs, DataType... types); @@ -2770,8 +2734,8 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param types The data types to use in the desired output - * @return The resulting jOOQ Result - * @throws DataAccessException if something went wrong executing the query + * @return The completion stage. The completed result will never be + * null. */ @Support CompletionStage> fetchAsync(ResultSet rs, Class... types); @@ -2781,7 +2745,8 @@ public interface DSLContext extends Scope , AutoCloseable { * completed by a task running in the given executor. * * @param rs The JDBC ResultSet to fetch data from - * @return The resulting jOOQ Result + * @return The completion stage. The completed result will never be + * null. */ @Support CompletionStage> fetchAsync(Executor executor, ResultSet rs); @@ -2795,8 +2760,8 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param fields The fields to use in the desired output - * @return The resulting jOOQ Result - * @throws DataAccessException if something went wrong executing the query + * @return The completion stage. The completed result will never be + * null. */ @Support CompletionStage> fetchAsync(Executor executor, ResultSet rs, Field... fields); @@ -2810,8 +2775,8 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param types The data types to use in the desired output - * @return The resulting jOOQ Result - * @throws DataAccessException if something went wrong executing the query + * @return The completion stage. The completed result will never be + * null. */ @Support CompletionStage> fetchAsync(Executor executor, ResultSet rs, DataType... types); @@ -2825,8 +2790,8 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param rs The JDBC ResultSet to fetch data from * @param types The data types to use in the desired output - * @return The resulting jOOQ Result - * @throws DataAccessException if something went wrong executing the query + * @return The completion stage. The completed result will never be + * null. */ @Support CompletionStage> fetchAsync(Executor executor, ResultSet rs, Class... types); @@ -2903,7 +2868,7 @@ public interface DSLContext extends Scope , AutoCloseable { * This is the same as calling fetchFromTXT(string, "{null}") * * @param string The formatted string - * @return The transformed result + * @return The transformed result. This will never be null. * @see #fetchFromTXT(String, String) * @throws DataAccessException If the supplied string does not adhere to the * above format rules. @@ -2966,7 +2931,7 @@ public interface DSLContext extends Scope , AutoCloseable { * @param string The formatted string * @param nullLiteral The string literal to be used as null * value. - * @return The transformed result + * @return The transformed result. This will never be null. * @throws DataAccessException If the supplied string does not adhere to the * above format rules. */ @@ -3007,7 +2972,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * * @param string The HTML-formatted string. - * @return The transformed result + * @return The transformed result. This will never be null. * @throws DataAccessException If the supplied string does not adhere to the * above format rules. */ @@ -3036,7 +3001,7 @@ public interface DSLContext extends Scope , AutoCloseable { * Strings * * @param string The CSV string - * @return The transformed result + * @return The transformed result. This will never be null. * @throws DataAccessException If anything went wrong parsing the CSV file * @see #fetchFromCSV(String, char) */ @@ -3065,7 +3030,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param string The CSV string * @param delimiter The delimiter to expect between records - * @return The transformed result + * @return The transformed result. This will never be null. * @throws DataAccessException If anything went wrong parsing the CSV file * @see #fetchFromCSV(String) * @see #fetchFromStringData(List) @@ -3095,7 +3060,7 @@ public interface DSLContext extends Scope , AutoCloseable { * * @param string The CSV string * @param header Whether to parse the first line as a CSV header line - * @return The transformed result + * @return The transformed result. This will never be null. * @throws DataAccessException If anything went wrong parsing the CSV file * @see #fetchFromCSV(String, char) */ @@ -3124,7 +3089,7 @@ public interface DSLContext extends Scope , AutoCloseable { * @param string The CSV string * @param header Whether to parse the first line as a CSV header line * @param delimiter The delimiter to expect between records - * @return The transformed result + * @return The transformed result. This will never be null. * @throws DataAccessException If anything went wrong parsing the CSV file * @see #fetchFromCSV(String) * @see #fetchFromStringData(List) @@ -3151,7 +3116,7 @@ public interface DSLContext extends Scope , AutoCloseable { * Strings * * @param string The JSON string - * @return The transformed result + * @return The transformed result. This will never be null. * @throws DataAccessException If anything went wrong parsing the JSON file */ @Support @@ -3172,7 +3137,7 @@ public interface DSLContext extends Scope , AutoCloseable { * null. * * @param data The data to be transformed into a Result - * @return The transformed result + * @return The transformed result. This will never be null. * @see #fetchFromStringData(List) */ Result fetchFromStringData(String[]... data); @@ -3192,7 +3157,7 @@ public interface DSLContext extends Scope , AutoCloseable { * null. * * @param data The data to be transformed into a Result - * @return The transformed result + * @return The transformed result. This will never be null. */ Result fetchFromStringData(List data); @@ -3211,7 +3176,7 @@ public interface DSLContext extends Scope , AutoCloseable { * @param data The data to be transformed into a Result * @param header Whether to interpret the first line as a set of column * names. - * @return The transformed result + * @return The transformed result. This will never be null. */ Result fetchFromStringData(List data, boolean header); @@ -8196,7 +8161,7 @@ public interface DSLContext extends Scope , AutoCloseable { * results. * * @param query The query to execute - * @return The result + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see ResultQuery#fetch() */ @@ -8207,7 +8172,7 @@ public interface DSLContext extends Scope , AutoCloseable { * a cursor. * * @param query The query to execute - * @return The cursor + * @return The cursor. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see ResultQuery#fetchLazy() */ @@ -8220,7 +8185,8 @@ public interface DSLContext extends Scope , AutoCloseable { * completed by a task running in the {@link ForkJoinPool#commonPool()}. * * @param query The query to execute - * @return The result + * @return The completion stage. The completed result will never be + * null. * @see ResultQuery#fetchAsync() */ CompletionStage> fetchAsync(ResultQuery query); @@ -8230,7 +8196,8 @@ public interface DSLContext extends Scope , AutoCloseable { * completed by a task running in the given executor. * * @param query The query to execute - * @return The result + * @return The completion stage. The completed result will never be + * null. * @see ResultQuery#fetchAsync() */ CompletionStage> fetchAsync(Executor executor, ResultQuery query); @@ -8252,7 +8219,7 @@ public interface DSLContext extends Scope , AutoCloseable { * a cursor. * * @param query The query to execute - * @return The results + * @return The results. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see ResultQuery#fetchMany() */ @@ -8263,7 +8230,7 @@ public interface DSLContext extends Scope , AutoCloseable { * a record. * * @param query The query to execute - * @return The record + * @return The record or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record * @see ResultQuery#fetchOne() @@ -8289,7 +8256,7 @@ public interface DSLContext extends Scope , AutoCloseable { * DSLContext and return a single value. * * @param query The query to execute - * @return The value. + * @return The value or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record * @throws InvalidResultException if the query returned a record with more @@ -8303,7 +8270,7 @@ public interface DSLContext extends Scope , AutoCloseable { * DSLContext and return a single value. * * @param field The field for which to fetch a single value. - * @return The value. + * @return The value or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record * @throws InvalidResultException if the query returned a record with more @@ -8344,7 +8311,7 @@ public interface DSLContext extends Scope , AutoCloseable { * DSLContext and return all values for the only column. * * @param query The query to execute - * @return The values. + * @return The values. This will never be null. * @throws DataAccessException if something went wrong executing the query */ > List fetchValues(ResultQuery query) throws DataAccessException; @@ -8353,7 +8320,7 @@ public interface DSLContext extends Scope , AutoCloseable { * Fetch all values in a given {@link Table}'s {@link TableField} * * @param field The field for which to fetch all values. - * @return The values. + * @return The values. This will never be null. * @throws DataAccessException if something went wrong executing the query */ List fetchValues(TableField field) throws DataAccessException; @@ -8469,6 +8436,8 @@ public interface DSLContext extends Scope , AutoCloseable { * {@link Configuration} by default. Use {@link Settings#isAttachRecords()} * to override this behaviour. * + * @return The results from the executed query. This will never be + * null. * @throws DataAccessException if something went wrong executing the query */ @Support @@ -8482,6 +8451,8 @@ public interface DSLContext extends Scope , AutoCloseable { * {@link Configuration} by default. Use {@link Settings#isAttachRecords()} * to override this behaviour. * + * @return The results from the executed query. This will never be + * null. * @throws DataAccessException if something went wrong executing the query */ @Support @@ -8495,7 +8466,7 @@ public interface DSLContext extends Scope , AutoCloseable { * default. Use {@link Settings#isAttachRecords()} to override this * behaviour. * - * @return The record or null if no record was returned + * @return The record or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record */ @@ -8510,7 +8481,7 @@ public interface DSLContext extends Scope , AutoCloseable { * default. Use {@link Settings#isAttachRecords()} to override this * behaviour. * - * @return The record or null if no record was returned + * @return The record or null, if no record was found. * @throws DataAccessException if something went wrong executing the query * @throws TooManyRowsException if the query returned more than one record */ @@ -8585,6 +8556,7 @@ public interface DSLContext extends Scope , AutoCloseable { * {@link Configuration} by default. Use {@link Settings#isAttachRecords()} * to override this behaviour. * + * @return The cursor. This will never be null. * @throws DataAccessException if something went wrong executing the query */ @Support @@ -8598,6 +8570,7 @@ public interface DSLContext extends Scope , AutoCloseable { * {@link Configuration} by default. Use {@link Settings#isAttachRecords()} * to override this behaviour. * + * @return The cursor. This will never be null. * @throws DataAccessException if something went wrong executing the query */ @Support @@ -8612,6 +8585,9 @@ public interface DSLContext extends Scope , AutoCloseable { * The result and its contained records are attached to this * {@link Configuration} by default. Use {@link Settings#isAttachRecords()} * to override this behaviour. + * + * @return The completion stage. The completed result will never be + * null. */ @Support CompletionStage> fetchAsync(Table table); @@ -8623,6 +8599,9 @@ public interface DSLContext extends Scope , AutoCloseable { * The result and its contained records are attached to this * {@link Configuration} by default. Use {@link Settings#isAttachRecords()} * to override this behaviour. + * + * @return The completion stage. The completed result will never be + * null. */ @Support CompletionStage> fetchAsync(Table table, Condition condition); @@ -8634,6 +8613,9 @@ public interface DSLContext extends Scope , AutoCloseable { * The result and its contained records are attached to this * {@link Configuration} by default. Use {@link Settings#isAttachRecords()} * to override this behaviour. + * + * @return The completion stage. The completed result will never be + * null. */ @Support CompletionStage> fetchAsync(Executor executor, Table table); @@ -8645,6 +8627,9 @@ public interface DSLContext extends Scope , AutoCloseable { * The result and its contained records are attached to this * {@link Configuration} by default. Use {@link Settings#isAttachRecords()} * to override this behaviour. + * + * @return The completion stage. The completed result will never be + * null. */ @Support CompletionStage> fetchAsync(Executor executor, Table table, Condition condition); diff --git a/jOOQ/src/main/java/org/jooq/ResultQuery.java b/jOOQ/src/main/java/org/jooq/ResultQuery.java index 562f11aa0e..e6b7fff694 100644 --- a/jOOQ/src/main/java/org/jooq/ResultQuery.java +++ b/jOOQ/src/main/java/org/jooq/ResultQuery.java @@ -111,7 +111,7 @@ public interface ResultQuery extends Query, Iterable { * In order to keep open {@link ResultSet}s and fetch records lazily, use * {@link #fetchLazy()} instead and then operate on {@link Cursor}. * - * @return The result. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query */ Result fetch() throws DataAccessException; @@ -131,7 +131,7 @@ public interface ResultQuery extends Query, Iterable { * but not for result fetching. The returned ResultSet can also * be used with {@link DSLContext#fetch(ResultSet)}. * - * @return The result. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query */ ResultSet fetchResultSet() throws DataAccessException; @@ -199,7 +199,7 @@ public interface ResultQuery extends Query, Iterable { *

* Client code is responsible for closing the cursor after use. * - * @return The resulting cursor. + * @return The resulting cursor. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see #fetchLazy(int) */ @@ -241,7 +241,7 @@ public interface ResultQuery extends Query, Iterable { * {@link Configuration} by default. Use {@link Settings#isAttachRecords()} * to override this behaviour. * - * @return The resulting records + * @return The resulting records. This will never be null. * @throws DataAccessException if something went wrong executing the query */ Results fetchMany() throws DataAccessException; @@ -253,7 +253,7 @@ public interface ResultQuery extends Query, Iterable { * This is the same as calling {@link #fetch()} and then * {@link Result#getValues(Field)} * - * @return The resulting values. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query */ List fetch(Field field) throws DataAccessException; @@ -265,7 +265,7 @@ public interface ResultQuery extends Query, Iterable { * This is the same as calling {@link #fetch()} and then * {@link Result#getValues(Field, Class)} * - * @return The resulting values. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Record#getValue(Field, Class) */ @@ -278,7 +278,7 @@ public interface ResultQuery extends Query, Iterable { * This is the same as calling {@link #fetch()} and then * {@link Result#getValues(Field, Converter)} * - * @return The resulting values. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Record#getValue(Field, Converter) */ @@ -291,7 +291,7 @@ public interface ResultQuery extends Query, Iterable { * This is the same as calling {@link #fetch()} and then * {@link Result#getValues(int)} * - * @return The resulting values. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query */ List fetch(int fieldIndex) throws DataAccessException; @@ -303,7 +303,7 @@ public interface ResultQuery extends Query, Iterable { * This is the same as calling {@link #fetch()} and then * {@link Result#getValues(int, Class)} * - * @return The resulting values. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Record#getValue(int, Class) */ @@ -316,7 +316,7 @@ public interface ResultQuery extends Query, Iterable { * This is the same as calling {@link #fetch()} and then * {@link Result#getValues(int, Converter)} * - * @return The resulting values. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Record#getValue(int, Converter) */ @@ -329,7 +329,7 @@ public interface ResultQuery extends Query, Iterable { * This is the same as calling {@link #fetch()} and then * {@link Result#getValues(String)} * - * @return The resulting values. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query */ List fetch(String fieldName) throws DataAccessException; @@ -341,7 +341,7 @@ public interface ResultQuery extends Query, Iterable { * This is the same as calling {@link #fetch()} and then * {@link Result#getValues(String, Class)} * - * @return The resulting values. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Record#getValue(String, Class) */ @@ -354,7 +354,7 @@ public interface ResultQuery extends Query, Iterable { * This is the same as calling {@link #fetch()} and then * {@link Result#getValues(String, Converter)} * - * @return The resulting values. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Record#getValue(String, Converter) */ @@ -367,7 +367,7 @@ public interface ResultQuery extends Query, Iterable { * This is the same as calling {@link #fetch()} and then * {@link Result#getValues(Name)} * - * @return The resulting values. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query */ List fetch(Name fieldName) throws DataAccessException; @@ -379,7 +379,7 @@ public interface ResultQuery extends Query, Iterable { * This is the same as calling {@link #fetch()} and then * {@link Result#getValues(Name, Class)} * - * @return The resulting values. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Record#getValue(Name, Class) */ @@ -392,7 +392,7 @@ public interface ResultQuery extends Query, Iterable { * This is the same as calling {@link #fetch()} and then * {@link Result#getValues(Name, Converter)} * - * @return The resulting values. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Record#getValue(Name, Converter) */ @@ -1170,7 +1170,7 @@ public interface ResultQuery extends Query, Iterable { * Execute the query and return the generated result as a list of name/value * maps. * - * @return The result. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key field returned two or more * equal values from the result set. @@ -1194,7 +1194,8 @@ public interface ResultQuery extends Query, Iterable { * @param The key's generic field type * @param key The key field. Client code must assure that this field is * unique in the result set. - * @return A Map containing the results + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key field returned two or more * equal values from the result set. @@ -1216,7 +1217,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyFieldIndex The key field. Client code must assure that this * field is unique in the result set. - * @return A Map containing the results + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key field returned two or more * equal values from the result set. @@ -1238,7 +1240,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyFieldName The key field. Client code must assure that this * field is unique in the result set. - * @return A Map containing the results + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key field returned two or more * equal values from the result set. @@ -1260,7 +1263,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyFieldName The key field. Client code must assure that this * field is unique in the result set. - * @return A Map containing the results + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key field returned two or more * equal values from the result set. @@ -1281,7 +1285,8 @@ public interface ResultQuery extends Query, Iterable { * @param key The key field. Client code must assure that this field is * unique in the result set. * @param value The value field - * @return A Map containing the results + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key field returned two or more * equal values from the result set. @@ -1300,7 +1305,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyFieldIndex The key field. Client code must assure that this * field is unique in the result set. * @param valueFieldIndex The value field - * @return A Map containing the results + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key field returned two or more * equal values from the result set. @@ -1319,7 +1325,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyFieldName The key field. Client code must assure that this * field is unique in the result set. * @param valueFieldName The value field - * @return A Map containing the results + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key field returned two or more * equal values from the result set. @@ -1338,7 +1345,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyFieldName The key field. Client code must assure that this * field is unique in the result set. * @param valueFieldName The value field - * @return A Map containing the results + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key field returned two or more * equal values from the result set. @@ -1356,7 +1364,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keys The keys. Client code must assure that keys are unique in the * result set. - * @return A Map containing the results. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key list is non-unique in the * result set. @@ -1374,7 +1383,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyFieldIndexes The keys. Client code must assure that keys are * unique in the result set. - * @return A Map containing the results. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key list is non-unique in the * result set. @@ -1392,7 +1402,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyFieldNames The keys. Client code must assure that keys are * unique in the result set. - * @return A Map containing the results. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key list is non-unique in the * result set. @@ -1410,7 +1421,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyFieldNames The keys. Client code must assure that keys are * unique in the result set. - * @return A Map containing the results. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key list is non-unique in the * result set. @@ -1430,7 +1442,8 @@ public interface ResultQuery extends Query, Iterable { * result set. If this is null or an empty array, * the resulting map will contain at most one entry. * @param type The entity type. - * @return A Map containing the results. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the keys are non-unique in the result * set. @@ -1453,7 +1466,8 @@ public interface ResultQuery extends Query, Iterable { * unique in the result set. If this is null or an * empty array, the resulting map will contain at most one entry. * @param type The entity type. - * @return A Map containing the results. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the keys are non-unique in the result * set. @@ -1477,7 +1491,8 @@ public interface ResultQuery extends Query, Iterable { * unique in the result set. If this is null or an * empty array, the resulting map will contain at most one entry. * @param type The entity type. - * @return A Map containing the results. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the keys are non-unique in the result * set. @@ -1501,7 +1516,8 @@ public interface ResultQuery extends Query, Iterable { * unique in the result set. If this is null or an * empty array, the resulting map will contain at most one entry. * @param type The entity type. - * @return A Map containing the results. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the keys are non-unique in the result * set. @@ -1525,7 +1541,8 @@ public interface ResultQuery extends Query, Iterable { * result set. If this is null or an empty array, * the resulting map will contain at most one entry. * @param mapper The mapper callback. - * @return A Map containing the results. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the keys are non-unique in the result * set. @@ -1549,7 +1566,8 @@ public interface ResultQuery extends Query, Iterable { * unique in the result set. If this is null or an * empty array, the resulting map will contain at most one entry. * @param mapper The mapper callback. - * @return A Map containing the results. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the keys are non-unique in the result * set. @@ -1573,7 +1591,8 @@ public interface ResultQuery extends Query, Iterable { * unique in the result set. If this is null or an * empty array, the resulting map will contain at most one entry. * @param mapper The mapper callback. - * @return A Map containing the results. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the keys are non-unique in the result * set. @@ -1597,7 +1616,8 @@ public interface ResultQuery extends Query, Iterable { * unique in the result set. If this is null or an * empty array, the resulting map will contain at most one entry. * @param mapper The mapper callback. - * @return A Map containing the results. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the keys are non-unique in the result * set. @@ -1623,7 +1643,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyType The key type. If this is null, the resulting * map will contain at most one entry. - * @return A Map containing grouped results + * @return A Map containing grouped results. This will never be + * null. * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records * @throws InvalidResultException if the key list is non-unique in the @@ -1649,7 +1670,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyType The key type. If this is null, the resulting * map will contain at most one entry. * @param valueType The value type. - * @return A Map containing grouped results + * @return A Map containing grouped results. This will never be + * null. * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records * @throws InvalidResultException if the key list is non-unique in the @@ -1675,7 +1697,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyType The key type. If this is null, the resulting * map will contain at most one entry. * @param valueMapper The value mapper. - * @return A Map containing grouped results + * @return A Map containing grouped results. This will never be + * null. * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records * @throws InvalidResultException if the key list is non-unique in the @@ -1699,7 +1722,8 @@ public interface ResultQuery extends Query, Iterable { * your keys are non-unique. * * @param keyMapper The key mapper. - * @return A Map containing grouped results + * @return A Map containing grouped results. This will never be + * null. * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records * @throws InvalidResultException if the key list is non-unique in the @@ -1724,7 +1748,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyMapper The key mapper. * @param valueType The value type. - * @return A Map containing grouped results + * @return A Map containing grouped results. This will never be + * null. * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records * @throws InvalidResultException if the key list is non-unique in the @@ -1749,7 +1774,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyMapper The key mapper. * @param valueMapper The value mapper. - * @return A Map containing grouped results + * @return A Map containing grouped results. This will never be + * null. * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records * @throws InvalidResultException if the key list is non-unique in the @@ -1770,7 +1796,8 @@ public interface ResultQuery extends Query, Iterable { * * @param table The key table. Client code must assure that keys are unique * in the result set. May not be null. - * @return A Map containing the results. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key list is non-unique in the * result set. @@ -1789,7 +1816,8 @@ public interface ResultQuery extends Query, Iterable { * @param table The key table. Client code must assure that keys are unique * in the result set. May not be null. * @param type The entity type. - * @return A Map containing the results. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the keys are non-unique in the result * set. @@ -1812,7 +1840,8 @@ public interface ResultQuery extends Query, Iterable { * @param table The key table. Client code must assure that keys are unique * in the result set. May not be null. * @param mapper The mapper callback. - * @return A Map containing the results. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the keys are non-unique in the result * set. @@ -1835,7 +1864,8 @@ public interface ResultQuery extends Query, Iterable { * @param key The key. Client code must assure that key is unique in the * result set. * @param type The entity type. - * @return A Map containing the result. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key is non-unique in the result * set. @@ -1854,7 +1884,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyFieldIndex The key. Client code must assure that key is unique * in the result set. * @param type The entity type. - * @return A Map containing the result. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key is non-unique in the result * set. @@ -1873,7 +1904,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyFieldName The key. Client code must assure that key is unique * in the result set. * @param type The entity type. - * @return A Map containing the result. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key is non-unique in the result * set. @@ -1892,7 +1924,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyFieldName The key. Client code must assure that key is unique * in the result set. * @param type The entity type. - * @return A Map containing the result. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key is non-unique in the result * set. @@ -1911,7 +1944,8 @@ public interface ResultQuery extends Query, Iterable { * @param key The key. Client code must assure that key is unique in the * result set. * @param mapper The mapper callback. - * @return A Map containing the result. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key is non-unique in the result * set. @@ -1930,7 +1964,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyFieldIndex The key. Client code must assure that key is unique * in the result set. * @param mapper The mapper callback. - * @return A Map containing the result. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key is non-unique in the result * set. @@ -1949,7 +1984,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyFieldName The key. Client code must assure that key is unique * in the result set. * @param mapper The mapper callback. - * @return A Map containing the result. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key is non-unique in the result * set. @@ -1968,7 +2004,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyFieldName The key. Client code must assure that key is unique * in the result set. * @param mapper The mapper callback. - * @return A Map containing the result. + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws InvalidResultException if the key is non-unique in the result * set. @@ -1989,7 +2026,8 @@ public interface ResultQuery extends Query, Iterable { * * @param The key's generic field type * @param key The key field. - * @return A Map containing the results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoGroups(Field) */ @@ -2007,7 +2045,8 @@ public interface ResultQuery extends Query, Iterable { * behaviour. * * @param keyFieldIndex The key field index. - * @return A Map containing the results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoGroups(int) */ @@ -2025,7 +2064,8 @@ public interface ResultQuery extends Query, Iterable { * behaviour. * * @param keyFieldName The key field name. - * @return A Map containing the results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoGroups(String) */ @@ -2043,7 +2083,8 @@ public interface ResultQuery extends Query, Iterable { * behaviour. * * @param keyFieldName The key field name. - * @return A Map containing the results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoGroups(Name) */ @@ -2060,7 +2101,8 @@ public interface ResultQuery extends Query, Iterable { * @param The value's generic field type * @param key The key field. * @param value The value field - * @return A Map containing the results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoGroups(Field, Field) */ @@ -2075,7 +2117,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyFieldIndex The key field index. * @param valueFieldIndex The value field index. - * @return A Map containing the results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoGroups(int, int) */ @@ -2090,7 +2133,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyFieldName The key field name. * @param valueFieldName The value field name. - * @return A Map containing the results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoGroups(String, String) */ @@ -2105,7 +2149,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyFieldName The key field name. * @param valueFieldName The value field name. - * @return A Map containing the results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoGroups(Name, Name) */ @@ -2121,7 +2166,8 @@ public interface ResultQuery extends Query, Iterable { * @param keys The keys used for result grouping. If this is * null or an empty array, the resulting map will * contain at most one entry. - * @return A Map containing grouped results + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoGroups(Field[]) */ @@ -2137,7 +2183,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyFieldIndexes The keys used for result grouping. If this is * null or an empty array, the resulting map will * contain at most one entry. - * @return A Map containing grouped results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoGroups(int[]) */ @@ -2153,7 +2200,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyFieldNames The keys used for result grouping. If this is * null or an empty array, the resulting map will * contain at most one entry. - * @return A Map containing grouped results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoGroups(String[]) */ @@ -2169,7 +2217,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyFieldNames The keys used for result grouping. If this is * null or an empty array, the resulting map will * contain at most one entry. - * @return A Map containing grouped results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoGroups(Name[]) */ @@ -2185,7 +2234,8 @@ public interface ResultQuery extends Query, Iterable { * @param keys The keys. If this is null or an empty array, the * resulting map will contain at most one entry. * @param type The entity type. - * @return A Map containing grouped results + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2204,7 +2254,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyFieldIndexes The keys. If this is null or an empty * array, the resulting map will contain at most one entry. * @param type The entity type. - * @return A Map containing grouped results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2223,7 +2274,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyFieldNames The keys. If this is null or an empty * array, the resulting map will contain at most one entry. * @param type The entity type. - * @return A Map containing grouped results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2242,7 +2294,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyFieldNames The keys. If this is null or an empty * array, the resulting map will contain at most one entry. * @param type The entity type. - * @return A Map containing grouped results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2261,7 +2314,8 @@ public interface ResultQuery extends Query, Iterable { * @param keys The keys. If this is null or an empty array, the * resulting map will contain at most one entry. * @param mapper The mapper callback. - * @return A Map containing grouped results + * @return A Map containing grouped results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2280,7 +2334,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyFieldIndexes The keys. If this is null or an empty * array, the resulting map will contain at most one entry. * @param mapper The mapper callback. - * @return A Map containing grouped results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2300,7 +2355,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyFieldNames The keys. If this is null or an empty * array, the resulting map will contain at most one entry. * @param mapper The mapper callback. - * @return A Map containing grouped results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2320,7 +2376,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyFieldNames The keys. If this is null or an empty * array, the resulting map will contain at most one entry. * @param mapper The mapper callback. - * @return A Map containing grouped results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2343,7 +2400,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyType The key type. If this is null, the resulting * map will contain at most one entry. - * @return A Map containing grouped results + * @return A Map containing grouped results. This will never be + * null. * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records * @see DefaultRecordMapper @@ -2364,7 +2422,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyType The key type. If this is null, the resulting * map will contain at most one entry. * @param valueType The value type. - * @return A Map containing grouped results + * @return A Map containing grouped results. This will never be + * null. * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records * @see DefaultRecordMapper @@ -2386,7 +2445,8 @@ public interface ResultQuery extends Query, Iterable { * @param keyType The key type. If this is null, the resulting * map will contain at most one entry. * @param valueMapper The value mapper. - * @return A Map containing grouped results + * @return A Map containing grouped results. This will never be + * null. * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records * @see DefaultRecordMapper @@ -2406,7 +2466,8 @@ public interface ResultQuery extends Query, Iterable { * for non-unique keys in the result set. * * @param keyMapper The key mapper. - * @return A Map containing grouped results + * @return A Map containing the results. This will never be + * null. * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records * @see DefaultRecordMapper @@ -2426,7 +2487,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyMapper The key mapper. * @param valueType The value type. - * @return A Map containing grouped results + * @return A Map containing the results. This will never be + * null. * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records * @see DefaultRecordMapper @@ -2447,7 +2509,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyMapper The key mapper. * @param valueMapper The value mapper. - * @return A Map containing grouped results + * @return A Map containing the results. This will never be + * null. * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records * @see DefaultRecordMapper @@ -2463,7 +2526,8 @@ public interface ResultQuery extends Query, Iterable { * in the result set. * * @param table The key table. May not be null. - * @return A Map containing grouped results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoGroups(Field[]) */ @@ -2478,7 +2542,8 @@ public interface ResultQuery extends Query, Iterable { * * @param table The key table. May not be null. * @param type The entity type. - * @return A Map containing grouped results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2497,7 +2562,8 @@ public interface ResultQuery extends Query, Iterable { * * @param table The key table. May not be null. * @param mapper The mapper callback. - * @return A Map containing grouped results + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2515,6 +2581,8 @@ public interface ResultQuery extends Query, Iterable { * @param The generic entity type. * @param key The key field. * @param type The entity type. + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2530,6 +2598,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyFieldIndex The key field index. * @param type The entity type. + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2545,6 +2615,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyFieldName The key field name. * @param type The entity type. + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2560,6 +2632,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyFieldName The key field name. * @param type The entity type. + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2577,6 +2651,8 @@ public interface ResultQuery extends Query, Iterable { * @param The generic entity type. * @param key The key field. * @param mapper The mapper callback. + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2592,6 +2668,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyFieldIndex The key field index. * @param mapper The mapper callback. + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2607,6 +2685,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyFieldName The key field name. * @param mapper The mapper callback. + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2622,6 +2702,8 @@ public interface ResultQuery extends Query, Iterable { * * @param keyFieldName The key field name. * @param mapper The mapper callback. + * @return A Map containing the results. This will never be + * null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2637,7 +2719,7 @@ public interface ResultQuery extends Query, Iterable { * You can access data like this * 

query.fetchArray()[recordIndex][fieldIndex]
* - * @return The result. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArrays() */ @@ -2647,7 +2729,7 @@ public interface ResultQuery extends Query, Iterable { * Execute the query and return the generated result as an array of records. *

* - * @return The result. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#toArray(Object[]) */ @@ -2662,7 +2744,8 @@ public interface ResultQuery extends Query, Iterable { * * @return The resulting values. This may be an array type more concrete * than Object[], depending on whether jOOQ has any - * knowledge about fieldIndex's actual type. + * knowledge about fieldIndex's actual type. This will + * never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(int) */ @@ -2675,7 +2758,7 @@ public interface ResultQuery extends Query, Iterable { * You can access data like this * 

query.fetchArray(fieldIndex)[recordIndex]
* - * @return The resulting values. + * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(int, Class) */ @@ -2688,7 +2771,7 @@ public interface ResultQuery extends Query, Iterable { * You can access data like this * 
query.fetchArray(fieldIndex)[recordIndex]
 * - * @return The resulting values. + * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(int, Converter) */ @@ -2703,7 +2786,8 @@ public interface ResultQuery extends Query, Iterable { * * @return The resulting values. This may be an array type more concrete * than Object[], depending on whether jOOQ has any - * knowledge about fieldName's actual type. + * knowledge about fieldName's actual type. This will + * never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(String) */ @@ -2716,7 +2800,7 @@ public interface ResultQuery extends Query, Iterable { * You can access data like this * 
query.fetchArray(fieldName)[recordIndex]
 * - * @return The resulting values. + * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(String, Converter) */ @@ -2729,7 +2813,7 @@ public interface ResultQuery extends Query, Iterable { * You can access data like this * 
query.fetchArray(fieldName)[recordIndex]
 * - * @return The resulting values. + * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(String, Class) */ @@ -2744,7 +2828,8 @@ public interface ResultQuery extends Query, Iterable { * * @return The resulting values. This may be an array type more concrete * than Object[], depending on whether jOOQ has any - * knowledge about fieldName's actual type. + * knowledge about fieldName's actual type. This will + * never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(Name) */ @@ -2757,7 +2842,7 @@ public interface ResultQuery extends Query, Iterable { * You can access data like this * 
query.fetchArray(fieldName)[recordIndex]
 * - * @return The resulting values. + * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(Name, Converter) */ @@ -2770,7 +2855,7 @@ public interface ResultQuery extends Query, Iterable { * You can access data like this * 
query.fetchArray(fieldName)[recordIndex]
 * - * @return The resulting values. + * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(Name, Class) */ @@ -2783,7 +2868,7 @@ public interface ResultQuery extends Query, Iterable { * You can access data like this * 
query.fetchArray(field)[recordIndex]
 * - * @return The resulting values. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(Field) */ @@ -2796,7 +2881,7 @@ public interface ResultQuery extends Query, Iterable { * You can access data like this * 
query.fetchArray(field)[recordIndex]
 * - * @return The resulting values. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(Field, Class) */ @@ -2809,7 +2894,7 @@ public interface ResultQuery extends Query, Iterable { * You can access data like this * 
query.fetchArray(field)[recordIndex]
 * - * @return The resulting values. + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(Field, Converter) */ @@ -2819,7 +2904,7 @@ public interface ResultQuery extends Query, Iterable { * Execute the query and return all values for a field index from the * generated result. * - * @return The resulting values. + * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(int) */ @@ -2829,7 +2914,7 @@ public interface ResultQuery extends Query, Iterable { * Execute the query and return all values for a field index from the * generated result. * - * @return The resulting values. + * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(int, Class) */ @@ -2839,7 +2924,7 @@ public interface ResultQuery extends Query, Iterable { * Execute the query and return all values for a field index from the * generated result. * - * @return The resulting values. + * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(int, Converter) */ @@ -2849,7 +2934,7 @@ public interface ResultQuery extends Query, Iterable { * Execute the query and return all values for a field name from the * generated result. * - * @return The resulting values. + * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(String) */ @@ -2859,7 +2944,7 @@ public interface ResultQuery extends Query, Iterable { * Execute the query and return all values for a field name from the * generated result. * - * @return The resulting values. + * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(String, Converter) */ @@ -2869,7 +2954,7 @@ public interface ResultQuery extends Query, Iterable { * Execute the query and return all values for a field name from the * generated result. * - * @return The resulting values. + * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(String, Class) */ @@ -2879,7 +2964,7 @@ public interface ResultQuery extends Query, Iterable { * Execute the query and return all values for a field name from the * generated result. * - * @return The resulting values. + * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(Name) */ @@ -2889,7 +2974,7 @@ public interface ResultQuery extends Query, Iterable { * Execute the query and return all values for a field name from the * generated result. * - * @return The resulting values. + * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(Name, Converter) */ @@ -2899,7 +2984,7 @@ public interface ResultQuery extends Query, Iterable { * Execute the query and return all values for a field name from the * generated result. * - * @return The resulting values. + * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(Name, Class) */ @@ -2909,7 +2994,7 @@ public interface ResultQuery extends Query, Iterable { * Execute the query and return all values for a field from the generated * result. * - * @return The resulting values. + * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(Field) */ @@ -2919,7 +3004,7 @@ public interface ResultQuery extends Query, Iterable { * Execute the query and return all values for a field from the generated * result. * - * @return The resulting values. + * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(Field, Class) */ @@ -2929,7 +3014,7 @@ public interface ResultQuery extends Query, Iterable { * Execute the query and return all values for a field from the generated * result. * - * @return The resulting values. + * @return The resulting values. This will never be null. * @throws DataAccessException if something went wrong executing the query * @see Result#intoArray(Field, Converter) */ @@ -2945,6 +3030,7 @@ public interface ResultQuery extends Query, Iterable { * @param type The entity type. * @see Record#into(Class) * @see Result#into(Class) + * @return The results. This will never be null. * @throws DataAccessException if something went wrong executing the query * @throws MappingException wrapping any reflection or data type conversion * exception that might have occurred while mapping records @@ -2964,6 +3050,7 @@ public interface ResultQuery extends Query, Iterable { * * @param The generic table record type. * @param table The table type. + * @return The results. This will never be null. * @see Record#into(Table) * @see Result#into(Table) * @throws DataAccessException if something went wrong executing the query @@ -2987,7 +3074,7 @@ public interface ResultQuery extends Query, Iterable { * Fetch results into a custom mapper callback. * * @param mapper The mapper callback - * @return The custom mapped records + * @return The result. This will never be null. * @throws DataAccessException if something went wrong executing the query */ List fetch(RecordMapper mapper) throws DataAccessException; @@ -2996,12 +3083,18 @@ public interface ResultQuery extends Query, Iterable { /** * Fetch results in a new {@link CompletionStage} that is asynchronously * completed by a task running in the {@link ForkJoinPool#commonPool()}. + * + * @return The completion stage. The completed result will never be + * null. */ CompletionStage> fetchAsync(); /** * Fetch results in a new {@link CompletionStage} that is asynchronously * completed by a task running in the given executor. + * + * @return The completion stage. The completed result will never be + * null. */ CompletionStage> fetchAsync(Executor executor);