io.github.yeagy.bss

Class BetterSqlMapper

java.lang.Object

io.github.yeagy.bss.BetterSqlMapper

public final class BetterSqlMapper
extends java.lang.Object

Joinless ORM. No setup required.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	BetterSqlMapper.SelectBuilder<T>

Method Summary

Modifier and Type	Method and Description
int	delete(java.sql.Connection connection, java.util.Collection<?> keys, java.lang.Class<?> clazz) Bulk delete entities with matching primary keys.
void	delete(java.sql.Connection connection, java.lang.Object entity) Delete entity.
int	delete(java.sql.Connection connection, java.lang.Object key, java.lang.Class<?> clazz) Delete entity with matching primary key.
<T> java.util.List<T>	find(java.sql.Connection connection, java.util.Collection<?> keys, java.lang.Class<T> clazz) Find entities with matching primary keys
<T> T	find(java.sql.Connection connection, java.lang.Object key, java.lang.Class<T> clazz) Find entity with matching primary key
static BetterSqlMapper	from(BetterOptions options)
static BetterSqlMapper	fromDefaults()
<T> T	insert(java.sql.Connection connection, T entity) Insert entity.
<T> BetterSqlMapper.SelectBuilder<T>	select(java.lang.String sql, java.lang.Class<T> clazz) Create a Select Builder.
void	update(java.sql.Connection connection, java.lang.Object entity) Update entity.

Methods inherited from class java.lang.Object

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

Method Detail

fromDefaults

public static BetterSqlMapper fromDefaults()

from

public static BetterSqlMapper from(BetterOptions options)

find

public <T> T find(java.sql.Connection connection,
                  java.lang.Object key,
                  java.lang.Class<T> clazz)

Find entity with matching primary key

Type Parameters:

T - entity type

Parameters:

connection - db connection. close it yourself

key - primary key to filter on

clazz - entity type class

Returns:

entity or null

find

public <T> java.util.List<T> find(java.sql.Connection connection,
                                  java.util.Collection<?> keys,
                                  java.lang.Class<T> clazz)

Find entities with matching primary keys

Type Parameters:

T - entity type

Parameters:

connection - db connection. close it yourself

keys - primary keys to filter on

clazz - entity type class

Returns:

entities or empty set

insert

public <T> T insert(java.sql.Connection connection,
                    T entity)

Insert entity.

for auto-generated keys, the primary key has to be null in the entity. if the primary key is non-null, the insert will be formatted to insert with that specified primary key.

dorm will extract the generated key and return it in a copied entity object. this can return a null object if it fails to get the generated key for some reason. if the primary key is non-null, the insert will simply return itself.

Type Parameters:

T - entity type

Parameters:

connection - db connection. close it yourself

entity - entity to insert

Returns:

entity with generated primary key. null if there was no generated key returned. the entity itself if the primary key was non-null.

update

public void update(java.sql.Connection connection,
                   java.lang.Object entity)

Update entity.

Parameters:

connection - db connection. close it yourself

entity - entity to update

delete

public void delete(java.sql.Connection connection,
                   java.lang.Object entity)

Delete entity.

Parameters:

connection - db connection. close it yourself

entity - entity to delete

delete

public int delete(java.sql.Connection connection,
                  java.lang.Object key,
                  java.lang.Class<?> clazz)

Delete entity with matching primary key.

Parameters:

connection - db connection. close it yourself

key - primary key to filter on

clazz - entity type class

Returns:

number of rows deleted

delete

public int delete(java.sql.Connection connection,
                  java.util.Collection<?> keys,
                  java.lang.Class<?> clazz)

Bulk delete entities with matching primary keys.

Parameters:

connection - db connection. close it yourself

keys - primary keys to filter on

clazz - entity type class

Returns:

number of rows updated

select

public <T> BetterSqlMapper.SelectBuilder<T> select(java.lang.String sql,
                                                   java.lang.Class<T> clazz)

Create a Select Builder. Use to automagically create an entity from an appropriate result set.

Type Parameters:

T - entity type

Parameters:

sql - select statement

clazz - entity type class

Returns:

new SelectBuilder for entity type