翻譯hibernate---org.hibernate.session的API文檔

public interface Session extends SharedSessionContract,EntityManager,HibernateEntiryManager,AutoCloseable;

主要用于java 應(yīng)用和hibernate之間運(yùn)行時(shí)的接口萝招；這是一個(gè)核心的持久化服務(wù)API抽象類(lèi)概念惶翻；

一個(gè)session的生命周期主要由邏輯事務(wù)管理器的開(kāi)始和結(jié)束界定；

session的主要作用是為映射的實(shí)體類(lèi)實(shí)例提供create ,read and delete 操作渺绒；實(shí)例可能以下面三種方式的一種狀態(tài)存在：

transient:從不持久化，不與任何session關(guān)聯(lián)

persistent:與一個(gè)唯一性的session關(guān)聯(lián)

detached:前置持久，不與任何session關(guān)聯(lián)

transient實(shí)例可能通過(guò)調(diào)用sav(),persist(),or saveOrUpdate()進(jìn)行持久化峡捡；Persistent實(shí)例可能通過(guò)transient調(diào)用delete();任何實(shí)例返回一個(gè)由get()或者load()方法返回的持久化對(duì)象劣纲；Detached實(shí)例可能通過(guò)update(),saveOrUpdate(),lock() or replicate()進(jìn)行實(shí)例化逢捺；在transient or detached狀態(tài)下的實(shí)例也可以通過(guò)調(diào)用merge()方法，作為一個(gè)新的持久化對(duì)象進(jìn)行持久化癞季；

save()和persist()在SQL中執(zhí)行的結(jié)果是INSERT,delete()在SQL中執(zhí)行的結(jié)果是DELETE;update()或merge()在SQL中執(zhí)行的是UPDATE劫瞳。持久化實(shí)例在寫(xiě)入時(shí)間段被發(fā)現(xiàn)發(fā)生變化倘潜，且在SQL中執(zhí)行了UPDATE。saveOrUpdate()和replicate()執(zhí)行INSERT或者UPDATE中一種行為志于；

實(shí)現(xiàn)的類(lèi)并不是線(xiàn)程安全的涮因；因此，每個(gè)線(xiàn)程或者事務(wù)應(yīng)該從sessionfactory獲取自己的實(shí)例伺绽；

一個(gè)Session實(shí)例是序列化的养泡，如果他的持久類(lèi)是序列化的；

一個(gè)典型的事務(wù)管理應(yīng)該使用如下的格式：

Session sess = factory.openSession();

Transaction tx;

try{

tx = sess.beginTransaction();

//do some work

tx.commit();

}catch(Exception e){

if(tx!=null)tx.rollback();

throw e;

}finally{

sess.close();

}

具體方法如下

All MethodsInstance Methods Abstract Methods Deprecated Methods

Modifier and TypeMethod and Description

voidaddEventListeners(SessionEventListener...?listeners)

Add one or more listeners to the Session

Session.LockRequest buildLockRequest(LockOptionslockOptions)

Build a LockRequest that specifies the LockMode, pessimistic lock timeout and lock scope.

IdentifierLoadAccess byId(Class?entityClass)

Create anIdentifierLoadAccessinstance to retrieve the specified entity by primary key.

IdentifierLoadAccess byId(StringentityName)

Create anIdentifierLoadAccessinstance to retrieve the specified entity type by primary key.

MultiIdentifierLoadAccess byMultipleIds(Class?entityClass)

Create aMultiIdentifierLoadAccessinstance to retrieve multiple entities at once as specified by primary key values.

MultiIdentifierLoadAccess byMultipleIds(StringentityName)

Create aMultiIdentifierLoadAccessinstance to retrieve multiple entities at once as specified by primary key values.

NaturalIdLoadAccess byNaturalId(Class?entityClass)

Create anNaturalIdLoadAccessinstance to retrieve the specified entity by its natural id.

NaturalIdLoadAccess byNaturalId(StringentityName)

Create anNaturalIdLoadAccessinstance to retrieve the specified entity by its natural id.

SimpleNaturalIdLoadAccess bySimpleNaturalId(Class?entityClass)

Create anSimpleNaturalIdLoadAccessinstance to retrieve the specified entity by its simple (single attribute) natural id.

SimpleNaturalIdLoadAccess bySimpleNaturalId(StringentityName)

Create anSimpleNaturalIdLoadAccessinstance to retrieve the specified entity by its natural id.

voidcancelQuery()

Cancel the execution of the current query.

voidclear()

Completely clear the session.

booleancontains(StringentityName,Objectobject)

Check if this entity is associated with this Session.

Query createFilter(Objectcollection,StringqueryString)

Create aQueryinstance for the given collection and filter string.

Query createNamedQuery(Stringname,Class?resultType)

The JPA-defined named, typed query creation method.

Query createQuery(CriteriaDeletedeleteQuery)

Query createQuery(CriteriaQuery?criteriaQuery)

Query createQuery(CriteriaUpdateupdateQuery)

Query createQuery(StringqueryString)

Create aQueryinstance for the given HQL/JPQL query string.

Query createQuery(StringqueryString,Class?resultType)

Create a typedQueryinstance for the given HQL/JPQL query string.

voiddelete(Objectobject)

Remove a persistent instance from the datastore.

voiddelete(StringentityName,Objectobject)

Remove a persistent instance from the datastore.

voiddisableFetchProfile(Stringname)

Disable a particular fetch profile on this session.

voiddisableFilter(StringfilterName)

Disable the named filter for the current session.

Connection disconnect()

Disconnect the session from its underlying JDBC connection.

?TdoReturningWork(ReturningWork?work)

Controller for allowing users to perform JDBC related work using the Connection managed by this Session.

voiddoWork(Workwork)

Controller for allowing users to perform JDBC related work using the Connection managed by this Session.

voidenableFetchProfile(Stringname)

Enable a particular fetch profile on this session.

Filter enableFilter(StringfilterName)

Enable the named filter for this current session.

voidevict(Objectobject)

Remove this instance from the session cache.

voidflush()

Force this session to flush.

?Tget(Class?entityType,Serializableid)