[QUESTION] v5 Example of how to use custom serializers?

Hello, I’m a newbie to LiteDB and currently evaluating it for my purposes. I’ve tried to refer to the documentation, however it seems a lot of it is for v4 which is apparently out-of-date?

My question related to whether there is a concrete example of how to perform a customized de/serialization of any object.

My classes will be used by external developers, so I do not wish to decorate classes with LiteDB-specific tags.

As such, how would I go about persisting a class such as this:

public class Record 
{
   string Field1 {get; set;}
   string Field2 {get; set;}
   [NonSerialized]
   string DontPersistField { get; set; }
}

Note that the class has no ‘Id’ field and I would like to omit ‘DontPersistField’ from being stored (it is marked as ‘NonSerialized’).

What is the correct way of persisting this in LiteDB without having to alter my class structure?

Thanks!

[lbnascimento]

@devmaestro1 If you want a solution that ignores fields with NonSerializedAttribute and works for any type, you could create a custom mapper class that inherits from BsonMapper and overrides GetTypeMembers:

public class MyMapper : BsonMapper
{
    protected override IEnumerable<MemberInfo> GetTypeMembers(Type type)
    {
        return base.GetTypeMembers(type).Where(m => !m.IsDefined(typeof(NonSerializedAttribute), true));
    }
}

//Usage
var mapper = new MyMapper();
mapper.IncludeFields = true; //the mapper only serializes properties by default
                             //this command is needed to serialize fields too
using var db = new LiteDatabase("database.db", mapper);

• Is there an intention to support standard “ISerialization”-type functionality and attributes (eg. Serialize/Deserialize)?
• Is there any interface supported by LiteDb (such as “ISerializable”) that would allow each class to define how it should be serialized rather than having it centralized in the Mapper class?

LiteDB does not support these features currently, however they could be considered for the future.

• Is there any method that is called after serialization/deserialization so I can perform any additional “cleanup” tasks on the object prior to its use?

You could achieve this with custom serializers and deserializers:

mapper.RegisterType<MyClass>
(
    serialize: o =>
    {
        var doc = new BsonDocument();
        doc["_id"] = o.Id;
        doc["Field1"] = o.Field1;
        //whatever you want to do
        return doc;
    },
    deserialize: doc =>
    {
        var o = new MyClass();
        o.Id = doc["_id"];
        o.Field1 = doc["Field1"];
        //whatever you want to do
        return o;
    }
);

[devmaestro1]

Thank you very much for your response on this. It has really helped me understand LiteDB a lot better.