Session (Nitrite 4.2.2 API)

java.lang.Object
- org.dizitart.no2.transaction.Session

All Implemented Interfaces:

AutoCloseable
```
public class Session
extends Object
implements AutoCloseable
```
A session represents a transactional context for a Nitrite database. It provides methods to create a new transaction.
A session should be closed after use to release any resources associated with it.
If a session is closed and the transaction is not committed, all opened transactions will get rolled back and all volatile data gets discarded for the session.

Since:

4.0

Author:

Anindya Chatterjee

Constructor Summary

Constructors
Constructor Description

Session(Nitrite nitrite, org.dizitart.no2.common.concurrent.LockService lockService)
Instantiates a new Session.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`Transaction`	`beginTransaction()`	Begins a new transaction.
`void`	`checkState()`	Checks state of the session.
`void`	`close()`

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Session
```
public Session(Nitrite nitrite,
               org.dizitart.no2.common.concurrent.LockService lockService)
```
    Instantiates a new Session.
    
    Parameters:
    
    nitrite - the nitrite
    
    lockService - the lock service
- Method Detail
  - beginTransaction
```
public Transaction beginTransaction()
```
    Begins a new transaction.
    
    Returns:
    
    the new transaction.
  - close
```
public void close()
```
    Specified by:
    
    close in interface AutoCloseable
  - checkState
```
public void checkState()
```
    Checks state of the session. If the session is not active, it will throw a TransactionException.
    
    Throws:
    
    TransactionException - when the session is not active, and a transaction is initiated in this session.