@@ -65,8 +65,9 @@ public interface DatabaseClient {
65
65
66
66
/**
67
67
* Creates a {@code DatabaseClient} that will use the provided {@link io.r2dbc.spi.ConnectionFactory}.
68
+ *
68
69
* @param factory The {@code ConnectionFactory} to use for obtaining connections.
69
- * @return a new {@code DatabaseClient}. Guaranteed to be not {@code null}.
70
+ * @return a new {@code DatabaseClient}. Guaranteed to be not {@literal null}.
70
71
*/
71
72
static DatabaseClient create (ConnectionFactory factory ) {
72
73
return new DefaultDatabaseClientBuilder ().connectionFactory (factory ).build ();
@@ -163,7 +164,7 @@ interface GenericExecuteSpec extends BindSpec<GenericExecuteSpec> {
163
164
*
164
165
* @param mappingFunction must not be {@literal null}.
165
166
* @param <R> result type.
166
- * @return a {@link FetchSpec} for configuration what to fetch. Guaranteed to be not {@code null}.
167
+ * @return a {@link FetchSpec} for configuration what to fetch. Guaranteed to be not {@literal null}.
167
168
*/
168
169
<R > FetchSpec <R > map (BiFunction <Row , RowMetadata , R > mappingFunction );
169
170
@@ -199,7 +200,7 @@ interface TypedExecuteSpec<T> extends BindSpec<TypedExecuteSpec<T>> {
199
200
*
200
201
* @param mappingFunction must not be {@literal null}.
201
202
* @param <R> result type.
202
- * @return a {@link FetchSpec} for configuration what to fetch. Guaranteed to be not {@code null}.
203
+ * @return a {@link FetchSpec} for configuration what to fetch. Guaranteed to be not {@literal null}.
203
204
*/
204
205
<R > FetchSpec <R > map (BiFunction <Row , RowMetadata , R > mappingFunction );
205
206
@@ -225,15 +226,16 @@ interface SelectFromSpec {
225
226
* Specify the source {@literal table} to select from.
226
227
*
227
228
* @param table must not be {@literal null} or empty.
228
- * @return a {@link GenericSelectSpec} for further configuration of the select. Guaranteed to be not {@code null}.
229
+ * @return a {@link GenericSelectSpec} for further configuration of the select. Guaranteed to be not
230
+ * {@literal null}.
229
231
*/
230
232
GenericSelectSpec from (String table );
231
233
232
234
/**
233
235
* Specify the source table to select from to using the {@link Class entity class}.
234
236
*
235
237
* @param table must not be {@literal null}.
236
- * @return a {@link TypedSelectSpec} for further configuration of the select. Guaranteed to be not {@code null}.
238
+ * @return a {@link TypedSelectSpec} for further configuration of the select. Guaranteed to be not {@literal null}.
237
239
*/
238
240
<T > TypedSelectSpec <T > from (Class <T > table );
239
241
}
@@ -247,15 +249,16 @@ interface InsertIntoSpec {
247
249
* Specify the target {@literal table} to insert into.
248
250
*
249
251
* @param table must not be {@literal null} or empty.
250
- * @return a {@link GenericInsertSpec} for further configuration of the insert. Guaranteed to be not {@code null}.
252
+ * @return a {@link GenericInsertSpec} for further configuration of the insert. Guaranteed to be not
253
+ * {@literal null}.
251
254
*/
252
255
GenericInsertSpec <Map <String , Object >> into (String table );
253
256
254
257
/**
255
258
* Specify the target table to insert to using the {@link Class entity class}.
256
259
*
257
260
* @param table must not be {@literal null}.
258
- * @return a {@link TypedInsertSpec} for further configuration of the insert. Guaranteed to be not {@code null}.
261
+ * @return a {@link TypedInsertSpec} for further configuration of the insert. Guaranteed to be not {@literal null}.
259
262
*/
260
263
<T > TypedInsertSpec <T > into (Class <T > table );
261
264
}
@@ -279,7 +282,7 @@ interface GenericSelectSpec extends SelectSpec<GenericSelectSpec> {
279
282
*
280
283
* @param mappingFunction must not be {@literal null}.
281
284
* @param <R> result type.
282
- * @return a {@link FetchSpec} for configuration what to fetch. Guaranteed to be not {@code null}.
285
+ * @return a {@link FetchSpec} for configuration what to fetch. Guaranteed to be not {@literal null}.
283
286
*/
284
287
<R > FetchSpec <R > map (BiFunction <Row , RowMetadata , R > mappingFunction );
285
288
@@ -308,7 +311,7 @@ interface TypedSelectSpec<T> extends SelectSpec<TypedSelectSpec<T>> {
308
311
*
309
312
* @param mappingFunction must not be {@literal null}.
310
313
* @param <R> result type.
311
- * @return a {@link FetchSpec} for configuration what to fetch. Guaranteed to be not {@code null}.
314
+ * @return a {@link FetchSpec} for configuration what to fetch. Guaranteed to be not {@literal null}.
312
315
*/
313
316
<R > FetchSpec <R > map (BiFunction <Row , RowMetadata , R > mappingFunction );
314
317
@@ -377,25 +380,27 @@ interface TypedInsertSpec<T> {
377
380
/**
378
381
* Insert the given {@code objectToInsert}.
379
382
*
380
- * @param objectToInsert the object of which the attributes will provide the values for the insert. Must not be {@code null}.
381
- * @return a {@link InsertSpec} for further configuration of the insert. Guaranteed to be not {@code null}.
383
+ * @param objectToInsert the object of which the attributes will provide the values for the insert. Must not be
384
+ * {@literal null}.
385
+ * @return a {@link InsertSpec} for further configuration of the insert. Guaranteed to be not {@literal null}.
382
386
*/
383
387
InsertSpec <Map <String , Object >> using (T objectToInsert );
384
388
385
389
/**
386
390
* Use the given {@code tableName} as insert target.
387
391
*
388
392
* @param tableName must not be {@literal null} or empty.
389
- * @return a {@link TypedInsertSpec} for further configuration of the insert. Guaranteed to be not {@code null}.
393
+ * @return a {@link TypedInsertSpec} for further configuration of the insert. Guaranteed to be not {@literal null}.
390
394
*/
391
395
TypedInsertSpec <T > table (String tableName );
392
396
393
397
/**
394
398
* Insert the given {@link Publisher} to insert one or more objects. Inserts only a single object when calling
395
399
* {@link FetchSpec#one()} or {@link FetchSpec#first()}.
396
400
*
397
- * @param objectToInsert a publisher providing the objects of which the attributes will provide the values for the insert. Must not be {@code null}.
398
- * @return a {@link InsertSpec} for further configuration of the insert. Guaranteed to be not {@code null}.
401
+ * @param objectToInsert a publisher providing the objects of which the attributes will provide the values for the
402
+ * insert. Must not be {@literal null}.
403
+ * @return a {@link InsertSpec} for further configuration of the insert. Guaranteed to be not {@literal null}.
399
404
* @see InsertSpec#fetch()
400
405
*/
401
406
InsertSpec <Map <String , Object >> using (Publisher <T > objectToInsert );
@@ -413,7 +418,7 @@ interface InsertSpec<T> {
413
418
*
414
419
* @param mappingFunction must not be {@literal null}.
415
420
* @param <R> result type.
416
- * @return a {@link FetchSpec} for configuration what to fetch. Guaranteed to be not {@code null}.
421
+ * @return a {@link FetchSpec} for configuration what to fetch. Guaranteed to be not {@literal null}.
417
422
*/
418
423
<R > FetchSpec <R > map (BiFunction <Row , RowMetadata , R > mappingFunction );
419
424
0 commit comments