Add IRedisCollection Update and Save examples (#236)

Author: atrievel

examples/Redis.OM.UpdatingDocuments/Models/Product.cs

@@ -0,0 +1,24 @@
+namespace Redis.OM.UpdatingDocuments.Models;
+
+using Redis.OM.Modeling;
+
+[Document(IndexName = "products-idx", StorageType = StorageType.Json)]
+public class Product
+{
+    [RedisIdField]
+    [Indexed] 
+    public Ulid Id { get; set; }
+
+    [Indexed]
+    public string? Name { get; set; }
+    
+    public string? Description { get; set; } 
+
+    [Indexed(Sortable = true)]        
+    public double Price { get; set; }
+
+    public DateTime DateAdded { get; set; }
+
+    [Indexed]
+    public bool InStock { get; set; }
+}

examples/Redis.OM.UpdatingDocuments/Program.cs

@@ -0,0 +1,58 @@
+using Redis.OM;
+using Redis.OM.UpdatingDocuments.Models;
+
+const string CONNECTION_URI = "redis://localhost:6379";
+
+// create test data
+var coffee = new Product()
+{
+    Name = "coffee",
+    Description = "a hot drink made from the roasted and ground coffee beans",
+    Price = 2.00,
+    DateAdded = DateTime.UtcNow,
+    InStock = false
+};
+
+// connect and create index
+var provider = new RedisConnectionProvider(CONNECTION_URI);
+var connection = provider.Connection;
+var products = provider.RedisCollection<Product>();
+connection.CreateIndex(typeof(Product));
+
+// insert data and save Id for querying later
+var productId = await products.InsertAsync(coffee);
+
+// update using IRedisCollection.Update
+coffee.Description = "Pure developer fuel";
+products.Update(coffee);
+
+// update using IRedisCollection.UpdateAsync
+coffee.Price = 2.50;
+await products.UpdateAsync(coffee);
+
+// update using IRedisCollection.Save
+var updatedCoffee = await products.FindByIdAsync(productId);
+if (updatedCoffee != null)
+{
+    updatedCoffee.InStock = true;
+}
+coffee.InStock = true;
+products.Save();
+
+// update using IRedisCollection.SaveAsync
+updatedCoffee = await products.FindByIdAsync(productId);
+if (updatedCoffee != null)
+{
+    updatedCoffee.DateAdded = DateTime.UtcNow.AddDays(-7);
+}
+coffee.DateAdded = DateTime.UtcNow.AddDays(-7);
+await products.SaveAsync();
+
+// query and validate results
+updatedCoffee = await products.FindByIdAsync(productId);
+
+Console.WriteLine($"{nameof(Product.Name)} - Expected: {coffee.Name} Actual: {updatedCoffee?.Name}");
+Console.WriteLine($"{nameof(Product.Description)} - Expected: {coffee.Description} Actual: {updatedCoffee?.Description}");
+Console.WriteLine($"{nameof(Product.Price)} - Expected: {coffee.Price} Actual: {updatedCoffee?.Price}");
+Console.WriteLine($"{nameof(Product.DateAdded)} - Expected: {coffee.DateAdded.ToUniversalTime()} Actual: {updatedCoffee?.DateAdded.ToUniversalTime()}");
+Console.WriteLine($"{nameof(Product.InStock)} - Expected: {coffee.InStock} Actual: {updatedCoffee?.InStock}");

examples/Redis.OM.UpdatingDocuments/Redis.OM.UpdatingDocuments.csproj

@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net6.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Redis.OM" Version="0.3.1" />
+  </ItemGroup>
+
+</Project>