HUMANiT.Azure.Data 1.2.0-preview-3021

HUMANiT Azure Data

This package provides logic that we miss in .NET for Azure Data access, but that find valuable for our own daily software development. -- the people of HUMANiT

Features

• Cosmos: Simlified access to Azure Cosmos.
• Cosmos Items: Simplifies and size-optimizes serialization into to Azure Cosmos documents.

This package contains features which we require for our own software; therefore, some features are highly custom. If you require a fix, an enhancement, or a more configurable solution, please contact us.

Contact

• Twitter -- stay in touch (@HUMANiTnz)
• Facebook -- message with us (@HUMANiTnz)
• support@humanit.nz -- contact us via email

License

MIT -- free software, hell yeah 🤩

Quickstarts

Cosmos

Located in namespace HUMANiT.Azure.Data.Cosmos.

Quickstart guidance will come.

Cosmos Items

Located in namespace HUMANiT.Azure.Data.Cosmos.Items.

Purpose will be explained later.

The parameterless constructor CosmosItem() ... explained later.

The constructor CosmosItem(TDomainObject) ... explained later.

The property ItemTypeName is a built-in object/document type identifier. It is based on the underlying domain object. Its purpose is to deal with Cosmos DB specifics. Different items have different item type names which allows to select all items of one item type when querying data. However, that requirement is only rarely required. To disable their rendering into Cosmos documents and therefore save storage space, override this property and mark it with Newtonsoft.Json.JsonIgnoreAttribute. Example:

// We override this property, so we can exclude it from the serialization into our Cosmos docs.
[JsonIgnore]
public override string ItemTypeName
{
    get => base.ItemTypeName;
    set => base.ItemTypeName = value;
}

The DetermineItemTypeName() method ... explained later.

The Extract() methods ... explained later.

The ExtractProperties() method ... explained later.

The Restore() method ... explained later.

The Restore...() methods ... explained later.

More guidance will come.