Stage.StatelessSession (Hibernate Reactive Core 1.0.0.Alpha10 API)

All Superinterfaces:
AutoCloseable
All Known Implementing Classes:
StageStatelessSessionImpl
Enclosing interface:
Stage
```
public static interface Stage.StatelessSession
extends AutoCloseable
```
A non-blocking counterpart to the Hibernate org.hibernate.StatelessSession interface, which provides a command-oriented API for performing bulk operations against a database.
A stateless session does not implement a first-level cache nor interact with any second-level cache, nor does it implement transactional write-behind or automatic dirty checking, nor do operations cascade to associated instances. Collections are ignored by a stateless session. Operations performed via a stateless session bypass Hibernate's event model and interceptors.
For certain kinds of work, a stateless session may perform slightly better than a stateful session.
In particular, for a session which loads many entities, use of a StatelessSession alleviates the need to call:
- Stage.Session.clear() or Stage.Session.detach(Object) to perform first-level cache management, and
- Stage.Session.setCacheMode(CacheMode) to bypass interaction with the second-level cache.
Stateless sessions are vulnerable to data aliasing effects, due to the lack of a first-level cache.
See Also:
org.hibernate.StatelessSession

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`void`	`close()` Close the reactive session and release the underlying database connection.
`<R> Stage.Query<R>`	`createNativeQuery(String queryString)` Create an instance of `Stage.Query` for the given SQL query string, or SQL update, insert, or delete statement.
`<R> Stage.Query<R>`	`createNativeQuery(String queryString, Class<R> resultType)` Create an instance of `Stage.Query` for the given SQL query string, using the given `resultType` to interpret the results.
`<R> Stage.Query<R>`	`createNativeQuery(String queryString, ResultSetMapping<R> resultSetMapping)` Create an instance of `Stage.Query` for the given SQL query string, using the given `ResultSetMapping` to interpret the result set.
`<R> Stage.Query<R>`	`createQuery(String queryString)` Create an instance of `Stage.Query` for the given HQL/JPQL query string or HQL/JPQL update or delete statement.
`<R> Stage.Query<R>`	`createQuery(String queryString, Class<R> resultType)` Create an instance of `Stage.Query` for the given HQL/JPQL query string.
`CompletionStage<Stage.StatelessSession>`	`delete(Object entity)` Delete a row.
`<T> CompletionStage<T>`	`get(Class<T> entityClass, Object id)` Retrieve a row.
`<T> CompletionStage<T>`	`get(Class<T> entityClass, Object id, LockMode lockMode)` Retrieve a row, obtaining the specified lock mode.
`<T> ResultSetMapping<T>`	`getResultSetMapping(Class<T> resultType, String mappingName)` Obtain a native SQL result set mapping defined via the annotation `javax.persistence.SqlResultSetMapping`.
`CompletionStage<Stage.StatelessSession>`	`insert(Object entity)` Insert a row.
`boolean`	`isOpen()`
`CompletionStage<Stage.StatelessSession>`	`refresh(Object entity)` Refresh the entity instance state from the database.
`CompletionStage<Stage.StatelessSession>`	`refresh(Object entity, LockMode lockMode)` Refresh the entity instance state from the database.
`CompletionStage<Stage.StatelessSession>`	`update(Object entity)` Update a row.

- Method Detail
  - get
```
<T> CompletionStage<T> get(Class<T> entityClass,
                           Object id)
```
    Retrieve a row.
    Parameters:
    entityClass - The class of the entity to retrieve
    id - The id of the entity to retrieve
    Returns:
    a detached entity instance, via a CompletionStage
    See Also:
    org.hibernate.StatelessSession#get(Class, Serializable)
  - get
```
<T> CompletionStage<T> get(Class<T> entityClass,
                           Object id,
                           LockMode lockMode)
```
    Retrieve a row, obtaining the specified lock mode.
    Parameters:
    entityClass - The class of the entity to retrieve
    id - The id of the entity to retrieve
    lockMode - The lock mode to apply to the entity
    Returns:
    a detached entity instance, via a CompletionStage
    See Also:
    org.hibernate.StatelessSession#get(Class, Serializable, LockMode)
  - createQuery
```
<R> Stage.Query<R> createQuery(String queryString)
```
    Create an instance of Stage.Query for the given HQL/JPQL query string or HQL/JPQL update or delete statement. In the case of an update or delete, the returned Stage.Query must be executed using Stage.Query.executeUpdate() which returns an affected row count.
    Parameters:
    queryString - The HQL/JPQL query, update or delete statement
    Returns:
    The Stage.Query instance for manipulation and execution
    See Also:
    Stage.Session.createQuery(String)
  - createQuery
```
<R> Stage.Query<R> createQuery(String queryString,
                               Class<R> resultType)
```
    Create an instance of Stage.Query for the given HQL/JPQL query string.
    Parameters:
    queryString - The HQL/JPQL query
    resultType - the Java type returned in each row of query results
    Returns:
    The Stage.Query instance for manipulation and execution
    See Also:
    Stage.Session.createQuery(String, Class)
  - createNativeQuery
```
<R> Stage.Query<R> createNativeQuery(String queryString)
```
    Create an instance of Stage.Query for the given SQL query string, or SQL update, insert, or delete statement. In the case of an update, insert or delete, the returned Stage.Query must be executed using Stage.Query.executeUpdate() which returns an affected row count. In the case of a query:
    Parameters:
    queryString - The SQL select, update, insert, or delete statement
    See Also:
    Stage.Session.createNativeQuery(String)
  - createNativeQuery
```
<R> Stage.Query<R> createNativeQuery(String queryString,
                                     Class<R> resultType)
```
    Create an instance of Stage.Query for the given SQL query string, using the given resultType to interpret the results.
    Parameters:
    queryString - The SQL query
    resultType - the Java type returned in each row of query results
    Returns:
    The Stage.Query instance for manipulation and execution
    See Also:
    Stage.Session.createNativeQuery(String, Class)
  - createNativeQuery
```
<R> Stage.Query<R> createNativeQuery(String queryString,
                                     ResultSetMapping<R> resultSetMapping)
```
    Create an instance of Stage.Query for the given SQL query string, using the given ResultSetMapping to interpret the result set.
    Parameters:
    queryString - The SQL query
    resultSetMapping - the result set mapping
    Returns:
    The Stage.Query instance for manipulation and execution
    See Also:
    Stage.Session.createNativeQuery(String, ResultSetMapping)
  - insert
```
CompletionStage<Stage.StatelessSession> insert(Object entity)
```
    Insert a row.
    Parameters:
    entity - a new transient instance
    See Also:
    org.hibernate.StatelessSession#insert(Object)
  - delete
```
CompletionStage<Stage.StatelessSession> delete(Object entity)
```
    Delete a row.
    Parameters:
    entity - a detached entity instance
    See Also:
    org.hibernate.StatelessSession#delete(Object)
  - update
```
CompletionStage<Stage.StatelessSession> update(Object entity)
```
    Update a row.
    Parameters:
    entity - a detached entity instance
    See Also:
    org.hibernate.StatelessSession#update(Object)
  - refresh
```
CompletionStage<Stage.StatelessSession> refresh(Object entity)
```
    Refresh the entity instance state from the database.
    Parameters:
    entity - The entity to be refreshed.
    See Also:
    org.hibernate.StatelessSession#refresh(Object)
  - refresh
```
CompletionStage<Stage.StatelessSession> refresh(Object entity,
                                                LockMode lockMode)
```
    Refresh the entity instance state from the database.
    Parameters:
    entity - The entity to be refreshed.
    lockMode - The LockMode to be applied.
    See Also:
    org.hibernate.StatelessSession#refresh(Object, LockMode)
  - getResultSetMapping
```
<T> ResultSetMapping<T> getResultSetMapping(Class<T> resultType,
                                            String mappingName)
```
    Obtain a native SQL result set mapping defined via the annotation javax.persistence.SqlResultSetMapping.
  - isOpen
```
boolean isOpen()
```
    Returns:
    false if close() has been called
  - close
```
void close()
```
    Close the reactive session and release the underlying database connection.
    Specified by:
    close in interface AutoCloseable

Interface Stage.StatelessSession

Method Summary

Method Detail

get

get

createQuery

createQuery

createNativeQuery

createNativeQuery

createNativeQuery

insert

delete

update

refresh

refresh

getResultSetMapping

isOpen

close