js.transaction.hibernate

Interface SessionManager

All Known Implementing Classes:

SessionManagerImpl

public interface SessionManager

Hibernate session manager present a simplified alternative for Hibernate session interface. It is used to save, query and delete objects and collections to/from persistence layer. Direct object and collection handling is performed by this interface; for more complex queries delegate query interfaces, see HqlQuery and SqlQuery.

Delete methods provided by this interface work only if entity ID property is named id. Behavior is not specified if entity uses alternative names.

Method Summary

Modifier and Type	Method and Description
void	delete(Class<?> type, Collection<Integer> ids) Delete collection of objects of requested type, in a single database query.
void	delete(Class<?> type, Object id) Delete the object identified by id, of requested type.
void	delete(String entityName, Collection<Integer> ids) Delete collection of objects mapped to requested entity, in a single database query.
void	delete(String entityName, Object id) Delete the object identified by id and mapped to requested entity.
boolean	exists(String existsClause, Object... parameters)
<T> T	get(Class<T> type, Serializable id, String... lazyFields) Query to retrieve object by ID.
org.hibernate.Session	getSession() Access to low level ;-) Hibernate session.
HqlQuery	HQL(String hql, Object... parameters) Create a HQL query instance wrapping given query string.
<T> void	save(Collection<T> collection) Convenient way to save or update collection of objects.
void	save(Object object) Save or update the object.
void	save(String entity, Object object) Save or update object instance mapped to requested entity name.
SqlQuery	SQL(String sql, Object... parameters) Create a SQL query instance wrapping given query string.

Method Detail

save

void save(Object object)

Save or update the object. This method uses default entity name inferred from object class simple name.

Parameters:

object - object to save.

save

void save(String entity,
          Object object)

Save or update object instance mapped to requested entity name.

Parameters:

entity - mapped entity name,

object - object instance to persist.

save

<T> void save(Collection<T> collection)

Convenient way to save or update collection of objects. This method simply traverse the collection invoking save(Object) for every object.

Type Parameters:

T - collection type.

Parameters:

collection - collection of objects to persist.

get

<T> T get(Class<T> type,
          Serializable id,
          String... lazyFields)

Query to retrieve object by ID. Expected type should be properly mapped and supports lazy fields. By default fields declared as lazy into mapping are not loaded from database and are left null into returned instance. Anyway, this method has an optional lazy field names argument that is used to force fields loading.

Type Parameters:

T - class type.

Parameters:

type - expected object type,

id - desired object ID,

lazyFields - optional lazy mapped fields to be initialized.

Returns:

persisted instance or null.

delete

void delete(Class<?> type,
            Object id)

Delete the object identified by id, of requested type. Type is used to infer entity name that on its turn determine the table on which delete is performed.

This method works only if entity ID property is named id. This method behavior is not specified if entity uses alternative names.

Parameters:

type - object type,

id - object id.

delete

void delete(String entityName,
            Object id)

Delete the object identified by id and mapped to requested entity. Entity is used to determine the table on which delete is performed.

This method works only if entity ID property is named id. This method behavior is not specified if entity uses alternative names.

Parameters:

entityName - entity name,

id - object id.

delete

void delete(Class<?> type,
            Collection<Integer> ids)

Delete collection of objects of requested type, in a single database query. This method uses type to infer entity name, that is, uses type simple name. Note that this method does not repeatedly invoke delete(Class, Object) on collection id values; it executes delete in a single database statement using IN clause.

This method works only if entity ID property is named id. This method behavior is not specified if entity uses alternative names.

Parameters:

type - object type,

ids - collection of id values.

delete

void delete(String entityName,
            Collection<Integer> ids)

Delete collection of objects mapped to requested entity, in a single database query. Note that this method does not repeatedly invoke delete(String, Object) on collection id values; it executes delete in a single database statement using IN clause.

This method works only if entity ID property is named id. This method behavior is not specified if entity uses alternative names.

Parameters:

entityName - Hibernate entity name,

ids - collection of id values.

exists

boolean exists(String existsClause,
               Object... parameters)

HQL

HqlQuery HQL(String hql,
             Object... parameters)

Create a HQL query instance wrapping given query string.

Parameters:

hql - HQL statement with optional positioned parameters markup, that is question mark sign,

parameters - variable number of parameters mapped by position.

Returns:

HQL query instance.

SQL

SqlQuery SQL(String sql,
             Object... parameters)

Create a SQL query instance wrapping given query string.

Parameters:

sql - SQL statement with optional positioned parameters markup, that is question mark sign,

parameters - variable number of parameters mapped by position.

Returns:

SQL query instance.

getSession

org.hibernate.Session getSession()

Access to low level ;-) Hibernate session.

Returns:

Hibernate session.