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.
List<ENTITY>	select(List<Long> ids) Read several records from the database by their primary keys.
ENTITY	selectOne(long id) Read a record from the database by its primary key.
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, select, select, select, select, selectDistinct, selectDistinct, selectDistinct, selectOne, selectOne

Method Detail

selectOne

ENTITY selectOne(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.

select

List<ENTITY> select(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.

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.

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.