com.googlecode.kevinarpe.papaya.jooq

Interface JooqDatabaseQueryService

All Known Implementing Classes:

JooqDatabaseQueryServiceImp

@ThreadSafe
public interface JooqDatabaseQueryService

ThreadSafe? All implementations expected to be thread-safe by calling synchronize while executing queries.

Author:

Kevin Connor ARPE (kevinarpe@gmail.com) See JooqSqliteDatabaseQueryService in module kevinarpe-papaya-jooq-sqlite.

Method Summary

Modifier and Type	Method and Description
void	deleteOneRow(JooqDatabaseConnection dbConn, org.jooq.Delete<? extends org.jooq.Record> deleteQuery) This is a convenience method to call deleteRows(JooqDatabaseConnection, Delete, CountMatcher) where rowCountMatcher is ExactlyCountMatcher.ONE.
void	deleteRows(JooqDatabaseConnection dbConn, org.jooq.Delete<? extends org.jooq.Record> deleteQuery, CountMatcher rowCountMatcher) Deletes rows, then checks row count.
void	insertOneRow(JooqDatabaseConnection dbConn, org.jooq.Insert<? extends org.jooq.Record> insertQuery) This is a convenience method to call insertRows(JooqDatabaseConnection, Insert, CountMatcher) where rowCountMatcher is ExactlyCountMatcher.ONE.
void	insertRows(JooqDatabaseConnection dbConn, org.jooq.Insert<? extends org.jooq.Record> insertQuery, CountMatcher rowCountMatcher) Inserts rows, then checks row count.
<TRecord extends org.jooq.Record,TResultQuery extends org.jooq.ResultQuery<TRecord>> TRecord	selectRow(JooqDatabaseConnection dbConn, TResultQuery selectQuery) This is a convenience method to call selectRowList(JooqDatabaseConnection, ResultQuery, CountMatcher) where rowCountMatcher is ExactlyCountMatcher.ONE.
<TRecord extends org.jooq.Record,TResultQuery extends org.jooq.ResultQuery<TRecord>> org.jooq.Result<TRecord>	selectRowList(JooqDatabaseConnection dbConn, TResultQuery selectQuery, CountMatcher rowCountMatcher) Selects rows, then checks result row count.
<TValue,TResultQuery extends org.jooq.ResultQuery<org.jooq.Record1<TValue>>> TValue	selectValue(JooqDatabaseConnection dbConn, TResultQuery selectQuery) This is a convenience method to call selectRow(JooqDatabaseConnection, ResultQuery) with a query that selects only a single column.
<TValue,TResultQuery extends org.jooq.ResultQuery<org.jooq.Record1<TValue>>> com.google.common.collect.ImmutableList<TValue>	selectValueList(JooqDatabaseConnection dbConn, TResultQuery selectQuery, CountMatcher rowCountMatcher) This is a convenience method to call selectRowList(JooqDatabaseConnection, ResultQuery, CountMatcher) with a query that selects only a single column.
<TRecord extends org.jooq.Record,TResultQuery extends org.jooq.ResultQuery<TRecord>> TRecord	trySelectRow(JooqDatabaseConnection dbConn, TResultQuery selectQuery) This is a convenience method to call selectRowList(JooqDatabaseConnection, ResultQuery, CountMatcher) where rowCountMatcher is AtMostCountMatcher.ONE.
<TValue,TResultQuery extends org.jooq.ResultQuery<org.jooq.Record1<TValue>>> TValue	trySelectValue(JooqDatabaseConnection dbConn, TResultQuery selectQuery) This is a convenience method to call trySelectRow(JooqDatabaseConnection, ResultQuery) with a query that selects only a single column.
void	updateOneRow(JooqDatabaseConnection dbConn, org.jooq.Update<? extends org.jooq.Record> updateQuery) This is a convenience method to call updateRows(JooqDatabaseConnection, Update, CountMatcher) where rowCountMatcher is ExactlyCountMatcher.ONE.
void	updateRows(JooqDatabaseConnection dbConn, org.jooq.Update<? extends org.jooq.Record> updateQuery, CountMatcher rowCountMatcher) Updates rows, then checks row count.

Method Detail

selectRowList

@Blocking
<TRecord extends org.jooq.Record,TResultQuery extends org.jooq.ResultQuery<TRecord>> org.jooq.Result<TRecord> selectRowList(JooqDatabaseConnection dbConn,
                                                                                                                                      TResultQuery selectQuery,
                                                                                                                                      CountMatcher rowCountMatcher)
                                                                                                                               throws Exception

Selects rows, then checks result row count.

Parameters:

dbConn - database connection

selectQuery - query to select rows

rowCountMatcher - matcher for result row count

Returns:

result of select query
empty is possible if allowed by rowCountMatcher

Throws:

Exception - if database I/O error or query syntax error
if result row count does not match rowCountMatcher

See Also:

selectRow(JooqDatabaseConnection, ResultQuery), trySelectRow(JooqDatabaseConnection, ResultQuery), selectValueList(JooqDatabaseConnection, ResultQuery, CountMatcher)

selectRow

@Blocking
<TRecord extends org.jooq.Record,TResultQuery extends org.jooq.ResultQuery<TRecord>> TRecord selectRow(JooqDatabaseConnection dbConn,
                                                                                                                 TResultQuery selectQuery)
                                                                                                          throws Exception

This is a convenience method to call selectRowList(JooqDatabaseConnection, ResultQuery, CountMatcher)
where rowCountMatcher is ExactlyCountMatcher.ONE.

Throws:

Exception

See Also:

selectRowList(JooqDatabaseConnection, ResultQuery, CountMatcher), selectValue(JooqDatabaseConnection, ResultQuery)

trySelectRow

@Nullable
 @Blocking
<TRecord extends org.jooq.Record,TResultQuery extends org.jooq.ResultQuery<TRecord>> TRecord trySelectRow(JooqDatabaseConnection dbConn,
                                                                                                                               TResultQuery selectQuery)
                                                                                                                        throws Exception

This is a convenience method to call selectRowList(JooqDatabaseConnection, ResultQuery, CountMatcher)
where rowCountMatcher is AtMostCountMatcher.ONE.

Returns:

• if zero rows are found, return null
• if one row is found, return the row
• if more than one row is found, throw an exception

Throws:

Exception

See Also:

selectRowList(JooqDatabaseConnection, ResultQuery, CountMatcher), selectRow(JooqDatabaseConnection, ResultQuery), trySelectValue(JooqDatabaseConnection, ResultQuery)

selectValueList

@Blocking
<TValue,TResultQuery extends org.jooq.ResultQuery<org.jooq.Record1<TValue>>> com.google.common.collect.ImmutableList<TValue> selectValueList(JooqDatabaseConnection dbConn,
                                                                                                                                                       TResultQuery selectQuery,
                                                                                                                                                       CountMatcher rowCountMatcher)
                                                                                                                                                throws Exception

This is a convenience method to call selectRowList(JooqDatabaseConnection, ResultQuery, CountMatcher)
with a query that selects only a single column. The result is converted to an ImmutableList.

Throws:

Exception

See Also:

selectValue(JooqDatabaseConnection, ResultQuery)

selectValue

@Blocking
<TValue,TResultQuery extends org.jooq.ResultQuery<org.jooq.Record1<TValue>>> TValue selectValue(JooqDatabaseConnection dbConn,
                                                                                                          TResultQuery selectQuery)
                                                                                                   throws Exception

This is a convenience method to call selectRow(JooqDatabaseConnection, ResultQuery)
with a query that selects only a single column.

Throws:

Exception

See Also:

trySelectValue(JooqDatabaseConnection, ResultQuery)

trySelectValue

@Nullable
 @Blocking
<TValue,TResultQuery extends org.jooq.ResultQuery<org.jooq.Record1<TValue>>> TValue trySelectValue(JooqDatabaseConnection dbConn,
                                                                                                                        TResultQuery selectQuery)
                                                                                                                 throws Exception

This is a convenience method to call trySelectRow(JooqDatabaseConnection, ResultQuery)
with a query that selects only a single column.

Throws:

Exception

See Also:

selectValue(JooqDatabaseConnection, ResultQuery)

insertRows

@Blocking
void insertRows(JooqDatabaseConnection dbConn,
                          org.jooq.Insert<? extends org.jooq.Record> insertQuery,
                          CountMatcher rowCountMatcher)
                   throws Exception

Inserts rows, then checks row count.

See: JooqSqliteDatabaseQueryService.getSqliteLastInsertRowId(JooqDatabaseConnection) in module kevinarpe-papaya-jooq-sqlite

Parameters:

dbConn - database connection

insertQuery - query to insert rows

rowCountMatcher - matcher for row count

Throws:

Exception - if database I/O error or query syntax error
if row count does not match rowCountMatcher

See Also:

insertOneRow(JooqDatabaseConnection, Insert)

insertOneRow

@Blocking
void insertOneRow(JooqDatabaseConnection dbConn,
                            org.jooq.Insert<? extends org.jooq.Record> insertQuery)
                     throws Exception

This is a convenience method to call insertRows(JooqDatabaseConnection, Insert, CountMatcher)
where rowCountMatcher is ExactlyCountMatcher.ONE.

Throws:

Exception

updateRows

@Blocking
void updateRows(JooqDatabaseConnection dbConn,
                          org.jooq.Update<? extends org.jooq.Record> updateQuery,
                          CountMatcher rowCountMatcher)
                   throws Exception

Updates rows, then checks row count.

Parameters:

dbConn - database connection

updateQuery - query to update rows

rowCountMatcher - matcher for row count

Throws:

Exception - if database I/O error or query syntax error
if row count does not match rowCountMatcher

See Also:

updateOneRow(JooqDatabaseConnection, Update)

updateOneRow

@Blocking
void updateOneRow(JooqDatabaseConnection dbConn,
                            org.jooq.Update<? extends org.jooq.Record> updateQuery)
                     throws Exception

This is a convenience method to call updateRows(JooqDatabaseConnection, Update, CountMatcher)
where rowCountMatcher is ExactlyCountMatcher.ONE.

Throws:

Exception

deleteRows

@Blocking
void deleteRows(JooqDatabaseConnection dbConn,
                          org.jooq.Delete<? extends org.jooq.Record> deleteQuery,
                          CountMatcher rowCountMatcher)
                   throws Exception

Deletes rows, then checks row count.

Parameters:

dbConn - database connection

deleteQuery - query to delete rows

rowCountMatcher - matcher for row count

Throws:

Exception - if database I/O error or query syntax error
if row count does not match rowCountMatcher

See Also:

deleteOneRow(JooqDatabaseConnection, Delete)

deleteOneRow

@Blocking
void deleteOneRow(JooqDatabaseConnection dbConn,
                            org.jooq.Delete<? extends org.jooq.Record> deleteQuery)
                     throws Exception

This is a convenience method to call deleteRows(JooqDatabaseConnection, Delete, CountMatcher)
where rowCountMatcher is ExactlyCountMatcher.ONE.

Throws:

Exception