UUID.Serialization.Newtonsoft

A Newtonsoft.Json serialization provider for the UUID library.

Installation

dotnet add package UUID.Serialization.Newtonsoft

Usage

Basic Usage

using Newtonsoft.Json; // Register the converter globally JsonSerializerSettings settings = new() { Converters = { new UUIDConverter() } }; // Serialize var uuid = new UUID(); string json = JsonConvert.SerializeObject(uuid, settings); // Deserialize UUID deserializedUuid = JsonConvert.DeserializeObject<UUID>(json, settings);

With Models

public class UserModel { public UUID Id { get; set; } public string Name { get; set; } } // Register converter JsonSerializerSettings settings = new() { Converters = { new UUIDConverter() } }; // Serialize model var user = new UserModel { Id = new UUID(), Name = "John Doe" }; string json = JsonConvert.SerializeObject(user, settings); // Deserialize model UserModel deserializedUser = JsonConvert.DeserializeObject<UserModel>(json, settings);

Using Attributes

public class UserModel { [JsonConverter(typeof(UUIDConverter))] public UUID Id { get; set; } public string Name { get; set; } } // No need to register converter globally var user = new UserModel { Id = new UUID(), Name = "John Doe" }; string json = JsonConvert.SerializeObject(user);

Features

• Seamless integration with Newtonsoft.Json
• Efficient string conversion
• Comprehensive error handling
• Thread-safe implementation
• Full documentation with XML comments
• Support for null handling
• Custom error messages for better debugging
• Support for JsonConverter attribute

Error Handling

The converter provides detailed error messages for common scenarios:

• Null values: "Cannot convert null value to UUID"
• Invalid string formats: Includes the attempted value in error message
• Empty strings: "Cannot convert empty string to UUID"