com.github.susom.database

Class SqlSelectImpl

java.lang.Object

com.github.susom.database.SqlSelectImpl

All Implemented Interfaces:

SqlSelect

public class SqlSelectImpl
extends Object
implements SqlSelect

This is the key class for configuring (query parameters) and executing a database query.

Author:

garricko

Nested Class Summary

Nested classes/interfaces inherited from interface com.github.susom.database.SqlSelect

SqlSelect.Apply

Constructor Summary

Constructors

Constructor and Description
SqlSelectImpl(Connection connection, DatabaseMock mock, String sql, Options options)

Method Summary

Modifier and Type	Method and Description
SqlSelect	apply(SqlSelect.Apply apply)
SqlSelect	argBigDecimal(BigDecimal arg)
SqlSelect	argBigDecimal(String argName, BigDecimal arg)
SqlSelect	argBoolean(Boolean arg)
SqlSelect	argBoolean(String argName, Boolean arg)
SqlSelect	argDate(Date arg)
SqlSelect	argDate(String argName, Date arg)
SqlSelect	argDateNowPerApp()
SqlSelect	argDateNowPerApp(String argName)
SqlSelect	argDateNowPerDb()
SqlSelect	argDateNowPerDb(String argName)
SqlSelect	argDouble(Double arg)
SqlSelect	argDouble(String argName, Double arg)
SqlSelect	argFloat(Float arg)
SqlSelect	argFloat(String argName, Float arg)
SqlSelect	argInteger(Integer arg)
SqlSelect	argInteger(String argName, Integer arg)
SqlSelect	argLong(Long arg)
SqlSelect	argLong(String argName, Long arg)
SqlSelect	argString(String arg)
SqlSelect	argString(String argName, String arg)
<T> T	query(RowsHandler<T> rowsHandler) This is the most generic and low-level way to iterate the query results.
BigDecimal	queryBigDecimalOrNull()
BigDecimal	queryBigDecimalOrZero()
List<BigDecimal>	queryBigDecimals()
boolean	queryBooleanOrFalse()
Boolean	queryBooleanOrNull()
boolean	queryBooleanOrTrue()
Date	queryDateOrNull()
List<Date>	queryDates()
Double	queryDoubleOrNull()
double	queryDoubleOrZero()
List<Double>	queryDoubles()
<T> T	queryFirstOrNull(RowHandler<T> rowHandler) Query zero or one row.
<T> T	queryFirstOrThrow(RowHandler<T> rowHandler) Query zero or one row.
Float	queryFloatOrNull()
float	queryFloatOrZero()
List<Float>	queryFloats()
Integer	queryIntegerOrNull()
int	queryIntegerOrZero()
List<Integer>	queryIntegers()
Long	queryLongOrNull()
long	queryLongOrZero()
List<Long>	queryLongs() Shorthand for reading numbers from the first column of the result.
<T> List<T>	queryMany(RowHandler<T> rowHandler) Query zero or more rows.
<T> T	queryOneOrNull(RowHandler<T> rowHandler) Query zero or one row.
<T> T	queryOneOrThrow(RowHandler<T> rowHandler) Query exactly one row.
String	queryStringOrEmpty()
String	queryStringOrNull()
List<String>	queryStrings() Shorthand for reading strings from the first column of the result.
SqlSelect	withArgs(SqlArgs args)
SqlSelect	withMaxRows(int rows)
SqlSelect	withTimeoutSeconds(int seconds)

Methods inherited from class java.lang.Object

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

Constructor Detail

SqlSelectImpl

public SqlSelectImpl(Connection connection,
                     DatabaseMock mock,
                     String sql,
                     Options options)

Method Detail

argBoolean

@Nonnull
public SqlSelect argBoolean(Boolean arg)

Specified by:

argBoolean in interface SqlSelect

argBoolean

@Nonnull
public SqlSelect argBoolean(@Nonnull
                                     String argName,
                                     Boolean arg)

Specified by:

argBoolean in interface SqlSelect

argInteger

@Nonnull
public SqlSelect argInteger(Integer arg)

Specified by:

argInteger in interface SqlSelect

argInteger

@Nonnull
public SqlSelect argInteger(@Nonnull
                                     String argName,
                                     Integer arg)

Specified by:

argInteger in interface SqlSelect

argLong

@Nonnull
public SqlSelect argLong(Long arg)

Specified by:

argLong in interface SqlSelect

argLong

@Nonnull
public SqlSelect argLong(@Nonnull
                                  String argName,
                                  Long arg)

Specified by:

argLong in interface SqlSelect

argFloat

@Nonnull
public SqlSelect argFloat(Float arg)

Specified by:

argFloat in interface SqlSelect

argFloat

@Nonnull
public SqlSelect argFloat(@Nonnull
                                   String argName,
                                   Float arg)

Specified by:

argFloat in interface SqlSelect

argDouble

@Nonnull
public SqlSelect argDouble(Double arg)

Specified by:

argDouble in interface SqlSelect

argDouble

@Nonnull
public SqlSelect argDouble(@Nonnull
                                    String argName,
                                    Double arg)

Specified by:

argDouble in interface SqlSelect

argBigDecimal

@Nonnull
public SqlSelect argBigDecimal(BigDecimal arg)

Specified by:

argBigDecimal in interface SqlSelect

argBigDecimal

@Nonnull
public SqlSelect argBigDecimal(@Nonnull
                                        String argName,
                                        BigDecimal arg)

Specified by:

argBigDecimal in interface SqlSelect

argString

@Nonnull
public SqlSelect argString(String arg)

Specified by:

argString in interface SqlSelect

argString

@Nonnull
public SqlSelect argString(@Nonnull
                                    String argName,
                                    String arg)

Specified by:

argString in interface SqlSelect

argDate

@Nonnull
public SqlSelect argDate(Date arg)

Specified by:

argDate in interface SqlSelect

argDate

@Nonnull
public SqlSelect argDate(@Nonnull
                                  String argName,
                                  Date arg)

Specified by:

argDate in interface SqlSelect

argDateNowPerApp

@Nonnull
public SqlSelect argDateNowPerApp()

Specified by:

argDateNowPerApp in interface SqlSelect

argDateNowPerApp

@Nonnull
public SqlSelect argDateNowPerApp(@Nonnull
                                           String argName)

Specified by:

argDateNowPerApp in interface SqlSelect

argDateNowPerDb

@Nonnull
public SqlSelect argDateNowPerDb()

Specified by:

argDateNowPerDb in interface SqlSelect

argDateNowPerDb

@Nonnull
public SqlSelect argDateNowPerDb(@Nonnull
                                          String argName)

Specified by:

argDateNowPerDb in interface SqlSelect

withTimeoutSeconds

@Nonnull
public SqlSelect withTimeoutSeconds(int seconds)

Specified by:

withTimeoutSeconds in interface SqlSelect

withMaxRows

@Nonnull
public SqlSelect withMaxRows(int rows)

Specified by:

withMaxRows in interface SqlSelect

withArgs

@Nonnull
public SqlSelect withArgs(SqlArgs args)

Specified by:

withArgs in interface SqlSelect

apply

@Nonnull
public SqlSelect apply(SqlSelect.Apply apply)

Specified by:

apply in interface SqlSelect

queryBooleanOrNull

@Nullable
public Boolean queryBooleanOrNull()

Specified by:

queryBooleanOrNull in interface SqlSelect

queryBooleanOrFalse

public boolean queryBooleanOrFalse()

Specified by:

queryBooleanOrFalse in interface SqlSelect

queryBooleanOrTrue

public boolean queryBooleanOrTrue()

Specified by:

queryBooleanOrTrue in interface SqlSelect

queryLongOrNull

@Nullable
public Long queryLongOrNull()

Specified by:

queryLongOrNull in interface SqlSelect

queryLongOrZero

public long queryLongOrZero()

Specified by:

queryLongOrZero in interface SqlSelect

queryLongs

@Nonnull
public List<Long> queryLongs()

Description copied from interface: SqlSelect

Shorthand for reading numbers from the first column of the result.

Specified by:

queryLongs in interface SqlSelect

Returns:

the first column values, omitting any that were null

queryIntegerOrNull

@Nullable
public Integer queryIntegerOrNull()

Specified by:

queryIntegerOrNull in interface SqlSelect

queryIntegerOrZero

public int queryIntegerOrZero()

Specified by:

queryIntegerOrZero in interface SqlSelect

queryIntegers

@Nonnull
public List<Integer> queryIntegers()

Specified by:

queryIntegers in interface SqlSelect

queryFloatOrNull

@Nullable
public Float queryFloatOrNull()

Specified by:

queryFloatOrNull in interface SqlSelect

queryFloatOrZero

public float queryFloatOrZero()

Specified by:

queryFloatOrZero in interface SqlSelect

queryFloats

@Nonnull
public List<Float> queryFloats()

Specified by:

queryFloats in interface SqlSelect

queryDoubleOrNull

@Nullable
public Double queryDoubleOrNull()

Specified by:

queryDoubleOrNull in interface SqlSelect

queryDoubleOrZero

public double queryDoubleOrZero()

Specified by:

queryDoubleOrZero in interface SqlSelect

queryDoubles

@Nonnull
public List<Double> queryDoubles()

Specified by:

queryDoubles in interface SqlSelect

queryBigDecimalOrNull

@Nullable
public BigDecimal queryBigDecimalOrNull()

Specified by:

queryBigDecimalOrNull in interface SqlSelect

queryBigDecimalOrZero

@Nonnull
public BigDecimal queryBigDecimalOrZero()

Specified by:

queryBigDecimalOrZero in interface SqlSelect

queryBigDecimals

@Nonnull
public List<BigDecimal> queryBigDecimals()

Specified by:

queryBigDecimals in interface SqlSelect

queryStringOrNull

public String queryStringOrNull()

Specified by:

queryStringOrNull in interface SqlSelect

queryStringOrEmpty

@Nonnull
public String queryStringOrEmpty()

Specified by:

queryStringOrEmpty in interface SqlSelect

queryStrings

@Nonnull
public List<String> queryStrings()

Description copied from interface: SqlSelect

Shorthand for reading strings from the first column of the result.

Specified by:

queryStrings in interface SqlSelect

Returns:

the first column values, omitting any that were null

queryDateOrNull

@Nullable
public Date queryDateOrNull()

Specified by:

queryDateOrNull in interface SqlSelect

queryDates

@Nonnull
public List<Date> queryDates()

Specified by:

queryDates in interface SqlSelect

query

public <T> T query(RowsHandler<T> rowsHandler)

Description copied from interface: SqlSelect

This is the most generic and low-level way to iterate the query results. Consider using one of the other methods that can handle the iteration for you.

Specified by:

query in interface SqlSelect

Parameters:

rowsHandler - the process() method of this handler will be called once and it will be responsible for iterating the results

queryOneOrNull

public <T> T queryOneOrNull(RowHandler<T> rowHandler)

Description copied from interface: SqlSelect

Query zero or one row. If zero rows are available a null will be returned. If more than one row is available a ConstraintViolationException will be thrown.

Specified by:

queryOneOrNull in interface SqlSelect

Parameters:

rowHandler - the process() method of this handler will be called once if there are results, or will not be called if there are no results

queryOneOrThrow

public <T> T queryOneOrThrow(RowHandler<T> rowHandler)

Description copied from interface: SqlSelect

Query exactly one row. If zero rows are available or more than one row is available a ConstraintViolationException will be thrown.

Specified by:

queryOneOrThrow in interface SqlSelect

Parameters:

rowHandler - the process() method of this handler will be called once if there are results, or will not be called if there are no results

queryFirstOrNull

public <T> T queryFirstOrNull(RowHandler<T> rowHandler)

Description copied from interface: SqlSelect

Query zero or one row. If zero rows are available a null will be returned. If more than one row is available the first row will be returned.

Specified by:

queryFirstOrNull in interface SqlSelect

Parameters:

rowHandler - the process() method of this handler will be called once if there are results (for the first row), or will not be called if there are no results

queryFirstOrThrow

public <T> T queryFirstOrThrow(RowHandler<T> rowHandler)

Description copied from interface: SqlSelect

Query zero or one row. If zero rows are available a ConstraintViolationException will be thrown. If more than one row is available the first row will be returned.

Specified by:

queryFirstOrThrow in interface SqlSelect

Parameters:

rowHandler - the process() method of this handler will be called once if there are results (for the first row), or will not be called if there are no results

queryMany

public <T> List<T> queryMany(RowHandler<T> rowHandler)

Description copied from interface: SqlSelect

Query zero or more rows. If zero rows are available an empty list will be returned. If one or more rows are available each row will be read and added to a list, which is returned.

Specified by:

queryMany in interface SqlSelect

Parameters:

rowHandler - the process() method of this handler will be called once for each row in the result, or will not be called if there are no results. Only non-null values returned will be added to the result list.