Add sample application for ScalarDB Cluster .NET Client SDK

Author: Dima-X

.gitignore

@@ -0,0 +1,31 @@
+using System.CommandLine;
+
+namespace ScalarDbClusterSample.Commands;
+
+public static class GetCustomerInfoCommand
+{
+    private const string Name = "GetCustomerInfo";
+    private const string Description = "Get customer information";
+
+    private const string ArgName = "id";
+    private const string ArgDescription = "customer ID";
+
+    public static Command Create()
+    {
+        var customerIdArg = new Argument<int>(ArgName, ArgDescription);
+        var getCustomerInfoCommand = new Command(Name, Description)
+        {
+            customerIdArg
+        };
+
+        getCustomerInfoCommand.SetHandler(async customerId =>
+        {
+            using var sample = new Sample();
+            var customerInfo = await sample.GetCustomerInfo(customerId);
+            
+            Console.WriteLine(customerInfo);
+        }, customerIdArg);
+        
+        return getCustomerInfoCommand;
+    }
+}

dotnet/scalardb-cluster-sample/Commands/GetCustomerInfoCommand.cs

@@ -0,0 +1,31 @@
+using System.CommandLine;
+
+namespace ScalarDbClusterSample.Commands;
+
+public static class GetOrderCommand
+{
+    private const string Name = "GetOrder";
+    private const string Description = "Get order information by order ID";
+
+    private const string ArgName = "id";
+    private const string ArgDescription = "order ID";
+
+    public static Command Create()
+    {
+        var orderIdArg = new Argument<string>(ArgName, ArgDescription);
+        var getOrderCommand = new Command(Name, Description)
+        {
+            orderIdArg
+        };
+
+        getOrderCommand.SetHandler(async orderId =>
+        {
+            using var sample = new Sample();
+            var order = await sample.GetOrderByOrderId(orderId);
+            
+            Console.WriteLine(order);
+        }, orderIdArg);
+    
+        return getOrderCommand;
+    }
+}

dotnet/scalardb-cluster-sample/Commands/GetOrderCommand.cs

@@ -0,0 +1,31 @@
+using System.CommandLine;
+
+namespace ScalarDbClusterSample.Commands;
+
+public static class GetOrdersCommand
+{
+    private const string Name = "GetOrders";
+    private const string Description = "Get information about orders by customer ID";
+
+    private const string ArgName = "customer_id";
+    private const string ArgDescription = "customer ID";
+
+    public static Command Create()
+    {
+        var customerIdArg = new Argument<int>(ArgName, ArgDescription);
+        var getOrdersCommand = new Command(Name, Description)
+        {
+            customerIdArg
+        };
+
+        getOrdersCommand.SetHandler(async customerId =>
+        {
+            using var sample = new Sample();
+            var orders = await sample.GetOrdersByCustomerId(customerId);
+            
+            Console.WriteLine(orders);
+        }, customerIdArg);
+        
+        return getOrdersCommand;
+    }
+}

dotnet/scalardb-cluster-sample/Commands/GetOrdersCommand.cs

@@ -0,0 +1,39 @@
+using System.CommandLine;
+using ScalarDB.Client.Exceptions;
+
+namespace ScalarDbClusterSample.Commands;
+
+public static class LoadInitialDataCommand
+{
+    private const string Name = "LoadInitialData";
+    private const string Description = "Load initial data";
+
+    public static Command Create()
+    {
+        var loadInitialDataCommand = new Command(Name, Description);
+        loadInitialDataCommand.SetHandler(async () =>
+        {
+            using var sample = new Sample();
+            await sample.CreateTables();
+
+            var attempts = 10;
+            while (attempts-- > 0)
+            {
+                try
+                {
+                    await sample.LoadInitialData();
+                }
+                catch (IllegalArgumentException)
+                {
+                    // there's can be a lag until ScalarDB Cluster recognize namespaces and tables created
+                    // in some databases like Cassandra, so if this command was called for the first time
+                    // the first attempts can fail with 'The namespace does not exist' error
+                    
+                    await Task.Delay(TimeSpan.FromSeconds(1));
+                }
+            }
+        });
+        
+        return loadInitialDataCommand;
+    }
+}

dotnet/scalardb-cluster-sample/Commands/LoadInitialDataCommand.cs

@@ -0,0 +1,54 @@
+using System.CommandLine;
+
+namespace ScalarDbClusterSample.Commands;
+
+public static class PlaceOrderCommand
+{
+    private const string Name = "PlaceOrder";
+    private const string Description = "Place an order";
+
+    private const string ArgName1 = "customer_id";
+    private const string ArgDescription1 = "customer ID";
+    private const string ArgName2 = "orders";
+    private const string ArgDescription2 = "orders. The format is \"<Item ID>:<Count>,<Item ID>:<Count>,...\"";
+
+    public static Command Create()
+    {
+        var customerIdArg = new Argument<int>(ArgName1, ArgDescription1);
+        var ordersArg = new Argument<Dictionary<int, int>>(
+            name: ArgName2,
+            parse: arg =>
+            {
+                var argStr = arg.Tokens.First().Value;
+                var orders = argStr
+                             .Split(',')
+                             .Select(s => s.Split(':'))
+                             .ToDictionary(
+                                 s => Int32.Parse(s[0]),
+                                 s => Int32.Parse(s[1])
+                             );
+
+                return orders;
+            },
+            description: ArgDescription2)
+        {
+            Arity = ArgumentArity.ExactlyOne
+        };
+
+        var placeOrderCommand = new Command(Name, Description)
+        {
+            customerIdArg,
+            ordersArg
+        };
+
+        placeOrderCommand.SetHandler(async (customerId, orders) =>
+        {
+            using var sample = new Sample();
+            var order = await sample.PlaceOrder(customerId, orders);
+            
+            Console.WriteLine(order);
+        }, customerIdArg, ordersArg);
+
+        return placeOrderCommand;
+    }
+}

dotnet/scalardb-cluster-sample/Commands/PlaceOrderCommand.cs

@@ -0,0 +1,33 @@
+using System.CommandLine;
+
+namespace ScalarDbClusterSample.Commands;
+
+public static class RepaymentCommand
+{
+    private const string Name = "Repayment";
+    private const string Description = "Repayment";
+
+    private const string ArgName1 = "customer_id";
+    private const string ArgDescription1 = "customer ID";
+    private const string ArgName2 = "amount";
+    private const string ArgDescription2 = "amount of the money for repayment";
+
+    public static Command Create()
+    {
+        var customerIdArg = new Argument<int>(ArgName1, ArgDescription1);
+        var amountArg = new Argument<int>(ArgName2, ArgDescription2);
+        var repaymentCommand = new Command(Name, Description)
+        {
+            customerIdArg,
+            amountArg
+        };
+
+        repaymentCommand.SetHandler(async (customerId, amount) =>
+        {
+            using var sample = new Sample();
+            await sample.Repayment(customerId, amount);
+        }, customerIdArg, amountArg);
+
+        return repaymentCommand;
+    }
+}

dotnet/scalardb-cluster-sample/Commands/RepaymentCommand.cs

@@ -0,0 +1,14 @@
+using System.CommandLine;
+using ScalarDbClusterSample.Commands;
+
+var rootCommand = new RootCommand("Sample application for ScalarDB Cluster .NET Client SDK")
+                  {
+                      LoadInitialDataCommand.Create(),
+                      GetCustomerInfoCommand.Create(),
+                      GetOrderCommand.Create(),
+                      GetOrdersCommand.Create(),
+                      PlaceOrderCommand.Create(),
+                      RepaymentCommand.Create()
+                  };
+
+await rootCommand.InvokeAsync(args);