DataFac.Storage 0.56.11-dev

DTOMaker

Supports model-first development of DTOs (Data Transport Objects) and related POCOs (Plain Old C# Objects). Models are defined as C# interfaces with additional attributes.

Warning: This is pre-release software under active development. Breaking changes may occur.

This repo includes the following packages:

DTOMaker.Models

Attributes for defining simple data models as interfaces in C#.

DTOMaker.MessagePack

A source generator that creates MessagePack DTOs (Data Transport Objects). See https://github.com/MessagePack-CSharp/MessagePack-CSharp.

DTOMaker.Models.MessagePack

Additional attributes used by the DTOMaker.MessagePack source generator, to manage MessagePack entity and member keys.

DTOMaker.MemBlocks

Generates DTOs whose internal data is a single memory block (Memory<byte>). Property getters and setters decode and encode values directly to the block with explicit byte ordering (little-endian or big-endian).

DTOMaker.Models.MemBlocks

Additional attributes used by the DTOMaker.MemBlocks source generator, to manage entity and member memory layout.

DTOMaker.CSPoco

Generates basic POCOs (Plain Old C# Objects) that implement the model interfaces.

DTOMaker.Runtime

Common types used at runtime by DTOMaker generated entities.

Other Features

• Member value types: Boolean, S/Byte, U/Int16/32/64/128, Double, Single, Half, Char, Guid, Decimal
• String member types:
  • Required or nullable strings for CSPoco and MessagePack
  • Non-nullable UTF8-encoded fixed length strings for MemBlocks
• IFreezable support
• Templates as code, template processing
• [Obsolete] members
• Fixed length arrays of above value types.
• polymorphic types

In progress:

• embedded entity members (MessagePack)
• embedded/external entity members (MemBlocks)

Coming soon:

• reservation (hidden members)
• Json (NewtonSoft) generator
• Json (System.Text) generator
• Orleans generator
• ProtobufNet 3.0 generator
• NetStrux generator
• MemBlocks compact layout method
• Enum data types. Workaround - enums can be implemented with an underlying integer property and a cast.
• MemBlocks nullable types. Workaround - T? can be implemented with a pair of members (Boolean, T).

Coming later:

• C# records generator
• Google Protobuf .proto generation
• model.json generation
• command-line alternative
• generic patterns: lists, trees, unions, etc.
• variable length arrays
• logical value equality

Benchmarks

Some benchmarking comparing the serialization and deserialization performance of various generated DTOs can be found at: todo