io.github.yeagy.bss

Class BetterSqlSupport

java.lang.Object

io.github.yeagy.bss.BetterSqlSupport

public final class BetterSqlSupport
extends java.lang.Object

CRUD automagic

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	BetterSqlSupport.BoundBuilder
class	BetterSqlSupport.BoundKeyedBuilder<K>
class	BetterSqlSupport.BoundKeyedResultBuilder<K,T>
class	BetterSqlSupport.BoundResultBuilder<T>
class	BetterSqlSupport.Builder
class	BetterSqlSupport.KeyedBuilder<K>
class	BetterSqlSupport.KeyedResultBuilder<K,T>
class	BetterSqlSupport.ResultBuilder<T>

Method Summary

Modifier and Type	Method and Description
BetterSqlSupport.Builder	builder(java.lang.String sql)
static BetterSqlSupport	from(BetterOptions options)
static BetterSqlSupport	fromDefaults()
<K> K	insert(java.sql.Connection connection, java.lang.String sql, StatementBinding binding) primarily for single INSERT.
<K> K	insert(java.sql.Connection connection, java.lang.String sql, StatementBinding binding, ResultMapping<K> generatedKeyMapping) primarily for single INSERT.
<T> T	query(java.sql.Connection connection, java.lang.String sql, StatementBinding binding, ResultMapping<T> mapping) primarily for single SELECT.
<T> java.util.List<T>	queryList(java.sql.Connection connection, java.lang.String sql, StatementBinding binding, ResultMapping<T> mapping) primarily for bulk SELECT.
<K,T> java.util.Map<K,T>	queryMap(java.sql.Connection connection, java.lang.String sql, StatementBinding binding, ResultMapping<T> resultMapping, ResultMapping<K> keyMapping) primarily for bulk SELECT.
<K,T> java.util.Map<K,java.util.List<T>>	queryMultiMap(java.sql.Connection connection, java.lang.String sql, StatementBinding binding, ResultMapping<T> resultMapping, ResultMapping<K> keyMapping) primarily for bulk SELECT.
int	update(java.sql.Connection connection, java.lang.String sql, StatementBinding binding) primarily for INSERT/UPDATE/DELETE

Methods inherited from class java.lang.Object

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

Method Detail

fromDefaults

public static BetterSqlSupport fromDefaults()

from

public static BetterSqlSupport from(BetterOptions options)

query

public <T> T query(java.sql.Connection connection,
                   java.lang.String sql,
                   StatementBinding binding,
                   ResultMapping<T> mapping)

primarily for single SELECT. also useful for INSERT/UPDATE with RETURNING

Type Parameters:

T - entity type

Parameters:

connection - db connection. close it yourself

sql - sql template

binding - bind parameter values to the PreparedStatement (optional)

mapping - map ResultSet to return entity

Returns:

entity or null

queryList

public <T> java.util.List<T> queryList(java.sql.Connection connection,
                                       java.lang.String sql,
                                       StatementBinding binding,
                                       ResultMapping<T> mapping)

primarily for bulk SELECT. also useful for INSERT/UPDATE with RETURNING

Type Parameters:

T - entity type

Parameters:

connection - db connection. close it yourself

sql - sql template

binding - bind parameter values to the PreparedStatement (optional)

mapping - map ResultSet to return entity

Returns:

list of entity or empty list

queryMap

public <K,T> java.util.Map<K,T> queryMap(java.sql.Connection connection,
                                         java.lang.String sql,
                                         StatementBinding binding,
                                         ResultMapping<T> resultMapping,
                                         ResultMapping<K> keyMapping)

primarily for bulk SELECT. also useful for INSERT/UPDATE with RETURNING

Type Parameters:

K - key type

T - entity type

Parameters:

connection - db connection. close it yourself

sql - sql template

binding - bind parameter values to the PreparedStatement (optional)

resultMapping - map ResultSet to return entity

keyMapping - map ResultSet to a key

Returns:

map of entities by key or empty map

queryMultiMap

public <K,T> java.util.Map<K,java.util.List<T>> queryMultiMap(java.sql.Connection connection,
                                                              java.lang.String sql,
                                                              StatementBinding binding,
                                                              ResultMapping<T> resultMapping,
                                                              ResultMapping<K> keyMapping)

primarily for bulk SELECT. also useful for INSERT/UPDATE with RETURNING

Type Parameters:

K - key type

T - entity type

Parameters:

connection - db connection. close it yourself

sql - sql template

binding - bind parameter values to the PreparedStatement (optional)

resultMapping - map ResultSet to return entity

keyMapping - map ResultSet to a key

Returns:

multi-map of entities by key or empty map

update

public int update(java.sql.Connection connection,
                  java.lang.String sql,
                  StatementBinding binding)

primarily for INSERT/UPDATE/DELETE

Parameters:

connection - db connection. close it yourself

sql - sql template

binding - bind parameter values to the PreparedStatement (optional)

Returns:

number of rows updated

insert

public <K> K insert(java.sql.Connection connection,
                    java.lang.String sql,
                    StatementBinding binding,
                    ResultMapping<K> generatedKeyMapping)

primarily for single INSERT. takes a ResultMapping to handle compound keys. if you need a bulk insert (w or w/o returned keys), try using BetterPreparedStatement directly

generated keys will transparently have their column names extracted from metadata for convenience.

Type Parameters:

K - key type

Parameters:

connection - db connection. close it yourself

sql - sql template

binding - bind parameter values to the PreparedStatement (optional)

generatedKeyMapping - map ResultSet for generated key

Returns:

key mapping result or null

insert

public <K> K insert(java.sql.Connection connection,
                    java.lang.String sql,
                    StatementBinding binding)

primarily for single INSERT. this returns a simple (single field) generated key without supplying a result mapping. if you need a bulk insert (w or w/o returned keys), try using BetterPreparedStatement directly

Type Parameters:

K - key type

Parameters:

connection - db connection. close it yourself

sql - sql template

binding - bind parameter values to the PreparedStatement (optional)

Returns:

key or null

builder

public BetterSqlSupport.Builder builder(java.lang.String sql)