---
title: "How to Check for Session Changes"
url: "https://docs.ravendb.net/6.2/client-api/session/how-to/check-if-there-are-any-changes-on-a-session"
version: "6.2"
language: "java"
---

# How to Check for Session Changes

> Client language: Java. Also available for [C#](https://docs.ravendb.net/6.2/client-api/session/how-to/check-if-there-are-any-changes-on-a-session.md), [Python](https://docs.ravendb.net/6.2/client-api/session/how-to/check-if-there-are-any-changes-on-a-session.python.md), [PHP](https://docs.ravendb.net/6.2/client-api/session/how-to/check-if-there-are-any-changes-on-a-session.php.md), [Node.js](https://docs.ravendb.net/6.2/client-api/session/how-to/check-if-there-are-any-changes-on-a-session.nodejs.md).
>
> RavenDB publishes an official agent skill for coding assistants at https://docs.ravendb.net/skills/ravendb/SKILL.md (also installable with `npx skills add ravendb/skills`). The skill describes itself as: "Read this before writing any RavenDB query, client call or /databases/ request. Covers server setup, document modelling, the Node.js, .NET and Python clients, RQL, indexes, vector search and AI agents. Code written from recall tends to run and return the wrong rows, because RQL resembles SQL and the clients take field names as plain strings."

Single entity can be checked for changes using [hasChanged](https://docs.ravendb.net/6.2/client-api/session/how-to/check-if-entity-has-changed.java.md) method, but there is also a possibility to check if there are any changes on a session or even what has changed.
Both the `hasChanges`  method and the `whatChanged` method are available in the `advanced` session operations.

## HasChanges

Property indicates if the session contains any changes. If there are any new, changed or deleted entities.

```java
boolean hasChanges()
```

### Example

```java
try (IDocumentSession session = store.openSession()) {
  Assert.assertFalse(session.advanced().hasChanges());

  Employee employee = new Employee();
  employee.setFirstName("John");
  employee.setLastName("Doe");

  session.store(employee);

  Assert.assertTrue(session.advanced().hasChanges());
}
```

## WhatChanged

Method returns all changes for each entity stored within the session. Including name of the field/property that changed, its old and new value, and change type.

```java
Map<String, List<DocumentsChanges>> whatChanged()
```

| ReturnValue | |
| - | - |
| Map\<String, List\<DocumentsChanges>> | Map containing list of changes per document ID. |

### Example I

```java
try (IDocumentSession session = store.openSession()) {
  Employee employee = new Employee();
  employee.setFirstName("Joe");
  employee.setLastName("Doe");
  session.store(employee);

  Map<String, List<DocumentsChanges>> changes = session.advanced().whatChanged();
  List<DocumentsChanges> employeeChanges = changes.get("employees/1-A");
  DocumentsChanges.ChangeType change
      = employeeChanges.get(0).getChange(); // DocumentsChanges.ChangeType.DOCUMENT_ADDED

}
```

### Example II

```java
try (IDocumentSession session = store.openSession()) {
  Employee employee = session.load(Employee.class, "employees/1-A");// 'Joe Doe'
  employee.setFirstName("John");
  employee.setLastName("Shmoe");

  Map<String, List<DocumentsChanges>> changes = session.advanced().whatChanged();
  List<DocumentsChanges> employeeChanges = changes.get("employees/1-A");
  DocumentsChanges change1
      = employeeChanges.get(0); //DocumentsChanges.ChangeType.FIELD_CHANGED
  DocumentsChanges change2
      = employeeChanges.get(1); //DocumentsChanges.ChangeType.FIELD_CHANGED
}
```

## See also

- [What is a session and how does it work](https://docs.ravendb.net/6.2/client-api/session/what-is-a-session-and-how-does-it-work.java.md)
- [How to check for entity changes](https://docs.ravendb.net/6.2/client-api/session/how-to/check-if-entity-has-changed.java.md)
- [Evict entity from session](https://docs.ravendb.net/6.2/client-api/session/how-to/evict-entity-from-a-session.java.md)
- [Refresh entity](https://docs.ravendb.net/6.2/client-api/session/how-to/refresh-entity.java.md)
