Azure Cosmos DB è un database distribuito interamente gestito che persiste i documenti in formato JSON. Oltre ad alcuni campi obbligatori o riservati presenti nel grafo, come id e _ts, il resto può contenere qualsiasi struttura semplice o complessa di oggetti, la quale viene interamente indicizzata, se non diversamente indicata.
L'SDK per .NET che abbiamo a disposizione utilizza la famosa libreria Json.NET per serializzare e deserializzare un grafo, la quale permette di utilizzare gli attributi per alterare il comportamento. Delle volte però gli attributi non sono sufficienti oppure non vogliamo sporcare il dominio con questo genere di informazioni. Nelle ultime versioni del client, fortunatamente, per il .NET Framework e per .NET Standard, è stata inserita la facoltà di personalizzare il motore tramite un oggetto personalizzato di JsonSerializerSettings.
Nell'esempio seguente viene mostrato come possiamo creare il DocumentClient passando delle impostazioni che gestiscono se marcare i tipi sugli oggetti, come gestire i valori nulli e come trattare i tipi enumerati.
var settings = new JsonSerializerSettings
{
    TypeNameHandling = TypeNameHandling.Objects,
    NullValueHandling = NullValueHandling.Include,
    Converters = {new StringEnumConverter()}
};
var client = new DocumentClient(serviceEndPoint, settings);
Queste sono alcune delle possibilità che ci sono offerte. Per le altre rimandiamo alla documentazione ufficiale.
https://www.newtonsoft.com/json/help/html/SerializingJSON.htm
Commenti
Per inserire un commento, devi avere un account.
Fai il login e torna a questa pagina, oppure registrati alla nostra community.
Approfondimenti
- Utilizzare Container Queries nominali
- Configuratione e utilizzo .NET Aspire CLI
- Utilizzare WhenEach per processare i risultati di una lista di task
- Configurare e gestire sidecar container in Azure App Service
- Anonimizzare i dati sensibili nei log di Azure Front Door
- Evitare memory leaks nelle closure JavaScript
- Aggiornare a .NET 9 su Azure App Service
- Introduzione ai web component HTML
- Gestire eccezioni nei plugin di Semantic Kernel in ASP.NET Core Web API
- Conoscere il rendering Server o WebAssembly a runtime in Blazor
- Rendere le variabili read-only in una pipeline di Azure DevOps
- Creare una libreria CSS universale: Immagini


