com.googlecode.kevinarpe.papaya.jooq

Class JooqDatabaseQueryServiceImp

java.lang.Object

com.googlecode.kevinarpe.papaya.jooq.JooqDatabaseQueryServiceImp

All Implemented Interfaces:

JooqDatabaseQueryService

@FullyTested
 @ThreadSafe
public final class JooqDatabaseQueryServiceImp
extends Object
implements JooqDatabaseQueryService

Author:

Kevin Connor ARPE (kevinarpe@gmail.com)

Constructor Summary

Constructors

Constructor and Description
JooqDatabaseQueryServiceImp(ExceptionThrower exceptionThrower)

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 JooqDatabaseQueryService.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 JooqDatabaseQueryService.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 JooqDatabaseQueryService.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 JooqDatabaseQueryService.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 JooqDatabaseQueryService.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 JooqDatabaseQueryService.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 JooqDatabaseQueryService.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 JooqDatabaseQueryService.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.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JooqDatabaseQueryServiceImp

public JooqDatabaseQueryServiceImp(ExceptionThrower exceptionThrower)

Method Detail

selectRowList

@Blocking
public <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.

Specified by:

selectRowList in interface JooqDatabaseQueryService

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:

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

selectRow

@Blocking
public <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 JooqDatabaseQueryService.selectRowList(JooqDatabaseConnection, ResultQuery, CountMatcher)
where rowCountMatcher is ExactlyCountMatcher.ONE.

Specified by:

selectRow in interface JooqDatabaseQueryService

Throws:

Exception

See Also:

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

trySelectRow

@Nullable
 @Blocking
public <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 JooqDatabaseQueryService.selectRowList(JooqDatabaseConnection, ResultQuery, CountMatcher)
where rowCountMatcher is AtMostCountMatcher.ONE.

Specified by:

trySelectRow in interface JooqDatabaseQueryService

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:

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

selectValueList

@Blocking
public <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 JooqDatabaseQueryService.selectRowList(JooqDatabaseConnection, ResultQuery, CountMatcher)
with a query that selects only a single column. The result is converted to an ImmutableList.

Specified by:

selectValueList in interface JooqDatabaseQueryService

Throws:

Exception

See Also:

JooqDatabaseQueryService.selectValue(JooqDatabaseConnection, ResultQuery)

selectValue

@Blocking
public <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 JooqDatabaseQueryService.selectRow(JooqDatabaseConnection, ResultQuery)
with a query that selects only a single column.

Specified by:

selectValue in interface JooqDatabaseQueryService

Throws:

Exception

See Also:

JooqDatabaseQueryService.trySelectValue(JooqDatabaseConnection, ResultQuery)

trySelectValue

@Nullable
 @Blocking
public <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 JooqDatabaseQueryService.trySelectRow(JooqDatabaseConnection, ResultQuery)
with a query that selects only a single column.

Specified by:

trySelectValue in interface JooqDatabaseQueryService

Throws:

Exception

See Also:

JooqDatabaseQueryService.selectValue(JooqDatabaseConnection, ResultQuery)

insertRows

@Blocking
public 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

Specified by:

insertRows in interface JooqDatabaseQueryService

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:

JooqDatabaseQueryService.insertOneRow(JooqDatabaseConnection, Insert)

insertOneRow

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

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

Specified by:

insertOneRow in interface JooqDatabaseQueryService

Throws:

Exception

updateRows

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

Updates rows, then checks row count.

Specified by:

updateRows in interface JooqDatabaseQueryService

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:

JooqDatabaseQueryService.updateOneRow(JooqDatabaseConnection, Update)

updateOneRow

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

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

Specified by:

updateOneRow in interface JooqDatabaseQueryService

Throws:

Exception

deleteRows

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

Deletes rows, then checks row count.

Specified by:

deleteRows in interface JooqDatabaseQueryService

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:

JooqDatabaseQueryService.deleteOneRow(JooqDatabaseConnection, Delete)

deleteOneRow

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

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

Specified by:

deleteOneRow in interface JooqDatabaseQueryService

Throws:

Exception