Migration: Changes in Conventions

Raven.Client.Document.DocumentConvention has been renamed and moved to Raven.Client.Documents.Conventions.DocumentConventions.

Serialization and deserialization of entities can be customized using:

• CustomizeJsonSerializer
• DeserializeEntityFromBlittable

new DocumentStore
{
    Conventions =
    {
        CustomizeJsonSerializer = serializer => throw new CodeOmitted(),
        DeserializeEntityFromBlittable = (type, blittable) => throw new CodeOmitted()
    }
}.Initialize();

In order to customize bulk insert serialization you can use BulkInsert.TrySerializeEntityToJsonStream convention:

new DocumentStore
{
    Conventions =
    {
        BulkInsert =
        {
            TrySerializeEntityToJsonStream = (entity, metadata, writer) => throw new CodeOmitted(),
        }
    }
}.Initialize();

The DocumentKeyGenerator has been removed. Use AsyncDocumentIdGenerator instead.

DefaultQueryingConsistency convention has been removed. Check the related article discussing how to deal with non stale results.

The DefaultUseOptimisticConcurrency has been renamed to UseOptimisticConcurrency.

The FindIdentityPropertyNameFromEntityName has been renamed to FindIdentityPropertyNameFromCollectionName.

Renamed to FindCollectionName and FindCollectionNameForDynamic.

It has been removed. Only string identifiers are supported.

The client will failover automatically to a different node in the cluster.
The Read requests can be customized by using the ReadBalanceBehavior convention.

The support for DTC transactions has been dropped.

Removed. The multi gets are processed in async manner on the server side.

Renamed to TransformTypeCollectionNameToDocumentIdPrefix.

Renamed to RegisterAsyncIdConvention

Removed. Use RegisterAsyncIdConvention.

Removed. Check How Client Integrates With Replication and Cluster article.

The client listens to changes by default and evicts cached items if they change on the server side.

Removed. Indexes are automatically replicated within the cluster. Transformers has been removed completely.

Use ReadBalanceBehavior.FastestNode to if you need to ensure that get requests will executed against the fastest node in the cluster.

Removed. Check How Client Integrates With Replication and Cluster article.

Removed. In 4.0 queries on IDs are supported by default.

Removed. There is no longer option to determine caching per request. Cache size can be controlled using MaxHttpCacheSize convention.