---
title: "Conventions: Deserialization"
url: "https://docs.ravendb.net/6.2/client-api/configuration/deserialization"
version: "6.2"
language: "java"
---

# Conventions: Deserialization

> Client language: Java. Also available for [C#](https://docs.ravendb.net/6.2/client-api/configuration/deserialization.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."

## Customize ObjectMapper

If you need to customize Jackson `ObjectMapper` object used by the client when sending entities to the server you can access and modify its instance:

```java
ObjectMapper entityMapper = conventions.getEntityMapper();
entityMapper.configure(SerializationFeature.FAIL_ON_EMPTY_BEANS, true);
```

## Numbers (de)serialization

RavenDB client supports out of the box all common numeric value types: `int`, `long`, `double` etc.  
Note that although the (de)serialization of `decimals` is fully supported, there are [server side limitations](https://docs.ravendb.net/6.2/server/kb/numbers-in-ravendb.md) to numbers in that range.  
Other number types like `BigInteger` must be treated using custom (de)serialization.

## See also

- [Conventions](https://docs.ravendb.net/6.2/client-api/configuration/conventions.md)
- [Load Balance &amp; Failover](https://docs.ravendb.net/6.2/client-api/configuration/load-balance/overview.md)
- [Serialization](https://docs.ravendb.net/6.2/client-api/configuration/serialization.java.md)
- [Deserialization Security](https://docs.ravendb.net/6.2/client-api/security/deserialization-security.md)
- [Document Identifiers](https://docs.ravendb.net/6.2/client-api/document-identifiers/working-with-document-identifiers.md)
- [Global ID Generation](https://docs.ravendb.net/6.2/client-api/configuration/identifier-generation/global.java.md)
- [Type-specific ID](https://docs.ravendb.net/6.2/client-api/configuration/identifier-generation/type-specific.java.md)
- [Document Store](https://docs.ravendb.net/6.2/client-api/what-is-a-document-store.java.md)
