org.hrorm

Interface Dao<ENTITY>

Type Parameters:

ENTITY - The type of the data to be persisted.

All Superinterfaces:

KeylessDao<ENTITY>

All Known Implementing Classes:

DaoImpl

public interface Dao<ENTITY>
extends KeylessDao<ENTITY>

A Dao is an interface that allows basic CRUD operations to be performed. Using a Dao, you can insert, select, update, and delete records.

Method Summary

Modifier and Type	Method and Description
void	atomicDelete(ENTITY item) Run a delete statement in the database within a transaction.
void	atomicUpdate(ENTITY item) Run an update statement to change the values in the database associated with an existing record.
void	delete(ENTITY item) Run a delete statement in the database.
Queries	queries() Access the SQL this Dao is using.
ENTITY	select(long id) Read a record from the database by its primary key.
List<ENTITY>	selectMany(List<Long> ids) Read several records from the database by their primary keys.
void	update(ENTITY item) Run an update statement to change the values in the database associated with an existing record.

Methods inherited from interface org.hrorm.KeylessDao

atomicInsert, foldingSelect, insert, runBigDecimalFunction, runLongFunction, select, select, selectAll, selectAll, selectByColumns, selectManyByColumns, selectManyByColumns

Method Detail

update

void update(ENTITY item)

Run an update statement to change the values in the database associated with an existing record. Updates are applied by primary key.

Parameters:

item - An instance of the class with a populated primary key field and updated field values.

delete

void delete(ENTITY item)

Run a delete statement in the database. Deletion is done by primary key.

Parameters:

item - An instance of type ENTITY with a populated primary key.

select

ENTITY select(long id)

Read a record from the database by its primary key.

Parameters:

id - The primary key of the record desired.

Returns:

The populated instance of type ENTITY.

selectMany

List<ENTITY> selectMany(List<Long> ids)

Read several records from the database by their primary keys.

Parameters:

ids - The primary keys of the records desired.

Returns:

A list of populated instances of type ENTITY.

atomicUpdate

void atomicUpdate(ENTITY item)

Run an update statement to change the values in the database associated with an existing record. Updates are applied by primary key. The update will occur within a transaction that is managed within the Dao. The Dao will either commit or rollback the transaction and close the underlying Connection when complete.

Parameters:

item - An instance of the class with a populated primary key field and updated field values.

atomicDelete

void atomicDelete(ENTITY item)

Run a delete statement in the database within a transaction. Deletion is done by primary key. The delete will occur within a transaction that is managed within the Dao. The Dao will either commit or rollback the transaction and close the underlying Connection when complete.

Parameters:

item - An instance of type ENTITY with a populated primary key.

queries

Queries queries()

Access the SQL this Dao is using.

The SQL provided is suitable for being passed to a PreparedStatement.

Returns:

An object containing the literal SQL.