翻译hibernate---org.hibernate.session的API文档

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

主要用于java 应用和hibernate之间运行时的接口；这是一个核心的持久化服务API抽象类概念；

一个session的生命周期主要由逻辑事务管理器的开始和结束界定；

session的主要作用是为映射的实体类实例提供create ,read and delete 操作；实例可能以下面三种方式的一种状态存在：

transient:从不持久化，不与任何session关联

persistent:与一个唯一性的session关联

detached:前置持久，不与任何session关联

transient实例可能通过调用sav(),persist(),or saveOrUpdate()进行持久化；Persistent实例可能通过transient调用delete();任何实例返回一个由get()或者load()方法返回的持久化对象；Detached实例可能通过update(),saveOrUpdate(),lock() or replicate()进行实例化；在transient or detached状态下的实例也可以通过调用merge()方法，作为一个新的持久化对象进行持久化；

save()和persist()在SQL中执行的结果是INSERT,delete()在SQL中执行的结果是DELETE;update()或merge()在SQL中执行的是UPDATE。持久化实例在写入时间段被发现发生变化，且在SQL中执行了UPDATE。saveOrUpdate()和replicate()执行INSERT或者UPDATE中一种行为；

实现的类并不是线程安全的；因此，每个线程或者事务应该从sessionfactory获取自己的实例；

一个Session实例是序列化的，如果他的持久类是序列化的；

一个典型的事务管理应该使用如下的格式：

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)