Mutiny.SessionFactory (Hibernate Reactive Core 1.0.0.Alpha10 API)

All Superinterfaces:: AutoCloseable

All Known Implementing Classes:: MutinySessionFactoryImpl

Enclosing interface:: Mutiny

public static interface Mutiny.SessionFactory
extends AutoCloseable

Factory for reactive sessions.

A Mutiny.SessionFactory may be obtained from an instance of javax.persistence.EntityManagerFactory as follows:

 Mutiny.SessionFactory sessionFactory =
                        createEntityManagerFactory("example")
                                .unwrap(Mutiny.SessionFactory.class);

Here, configuration properties must be specified in persistence.xml.

Alternatively, a Mutiny.SessionFactory may be obtained via programmatic configuration of Hibernate using:

 Configuration configuration = new Configuration();
 ...
 Mutiny.SessionFactory sessionFactory =
                configuration.buildSessionFactory(
                        new ReactiveServiceRegistryBuilder()
                                .applySettings( configuration.getProperties() )
                                .build()
                )
                .unwrap(Mutiny.SessionFactory.class);

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`void`	`close()` Destroy the session factory and clean up its connection pool.
`Cache`	`getCache()` Obtain the `Cache` object for managing the second-level cache.
`CriteriaBuilder`	`getCriteriaBuilder()`
`Metamodel`	`getMetamodel()` Obtain the JPA `Metamodel` for the persistence unit.
`boolean`	`isOpen()`
`Mutiny.Session`	`openSession()` Obtain a new `reactive session`, the main interaction point between the user's program and Hibernate Reactive.
`Mutiny.Session`	`openSession(String tenantId)` Obtain a new `reactive session` for a specified tenant.
`Mutiny.StatelessSession`	`openStatelessSession()` Obtain a `reactive stateless session`.
`<T> <any>`	`withSession(Function<Mutiny.Session,<any>> work)` Perform work using a `reactive session`.
`<T> <any>`	`withSession(String tenantId, Function<Mutiny.Session,<any>> work)` Perform work using a `reactive session` for a specified tenant.
`<T> <any>`	`withTransaction(BiFunction<Mutiny.Session,Mutiny.Transaction,<any>> work)` Perform work using a `reactive session` within an associated `transaction`.
`<T> <any>`	`withTransaction(String tenantId, BiFunction<Mutiny.Session,Mutiny.Transaction,<any>> work)` Perform work using a `reactive session` for a specified tenant within an associated `transaction`.

- Method Detail
  - openSession
```
Mutiny.Session openSession()
```
    Obtain a new reactive session, the main interaction point between the user's program and Hibernate Reactive.
    The underlying database connection is obtained lazily when the returned Mutiny.Session needs to access the database.
    The client must explicitly close the session by calling Mutiny.Session.close().
    See Also:
    withSession(Function)
  - openSession
```
Mutiny.Session openSession(String tenantId)
```
    Obtain a new reactive session for a specified tenant.
    The underlying database connection is obtained lazily when the returned Mutiny.Session needs to access the database.
    The client must explicitly close the session by calling Mutiny.Session.close().
    Parameters:
    tenantId - the id of the tenant
    See Also:
    withSession(Function)
  - openStatelessSession
```
Mutiny.StatelessSession openStatelessSession()
```
    Obtain a reactive stateless session.
    The underlying database connection is obtained lazily when the returned Mutiny.StatelessSession needs to access the database.
    The client must explicitly close the session by calling Mutiny.StatelessSession.close().
  - withSession
```
<T> <any> withSession(Function<Mutiny.Session,<any>> work)
```
    Perform work using a reactive session.
    The session will be closed automatically.
    Parameters:
    work - a function which accepts the session and returns the result of the work as a Uni.
  - withSession
```
<T> <any> withSession(String tenantId,
                      Function<Mutiny.Session,<any>> work)
```
    Perform work using a reactive session for a specified tenant.
    The session will be closed automatically.
    Parameters:
    tenantId - the id of the tenant
    work - a function which accepts the session and returns the result of the work as a Uni.
  - withTransaction
```
<T> <any> withTransaction(BiFunction<Mutiny.Session,Mutiny.Transaction,<any>> work)
```
    Perform work using a reactive session within an associated transaction.
    The session will be flushed and closed automatically, and the transaction committed automatically.
    Parameters:
    work - a function which accepts the session and returns the result of the work as a Uni.
    See Also:
    withSession(Function), Mutiny.Session.withTransaction(Function)
  - withTransaction
```
<T> <any> withTransaction(String tenantId,
                          BiFunction<Mutiny.Session,Mutiny.Transaction,<any>> work)
```
    Perform work using a reactive session for a specified tenant within an associated transaction.
    The session will be flushed and closed automatically, and the transaction committed automatically.
    Parameters:
    tenantId - the id of the tenant
    work - a function which accepts the session and returns the result of the work as a Uni.
    See Also:
    withSession(Function), Mutiny.Session.withTransaction(Function)
  - getCriteriaBuilder
```
CriteriaBuilder getCriteriaBuilder()
```
    Returns:
    an instance of CriteriaBuilder for creating criteria queries.
  - getMetamodel
```
Metamodel getMetamodel()
```
    Obtain the JPA Metamodel for the persistence unit.
  - getCache
```
Cache getCache()
```
    Obtain the Cache object for managing the second-level cache.
  - close
```
void close()
```
    Destroy the session factory and clean up its connection pool.
    Specified by:
    close in interface AutoCloseable
  - isOpen
```
boolean isOpen()
```
    Returns:
    false if close() has been called

Interface Mutiny.SessionFactory

Method Summary

Method Detail

openSession

openSession

openStatelessSession

withSession

withSession

withTransaction

withTransaction

getCriteriaBuilder

getMetamodel

getCache

close

isOpen