RizeDb 2.0.0-beta3

RizeDb

RizeDb has a object-oriented implementation that allows for the storing, indexing and retrieving of objects. objects are not stored into tables and require very little structure.

RizeDb's object store requires no schema and object values can change types without requiring the database to update all existing data.

Primer

The first step to creating a object store is simply to instantiate the objectStore object with a stream.

using(var stream = new MemoryStream())
{
   using(var objectStore = new RizeDb.ObjectStore(stream))
   {
      //Code goes here
   }
}

Once your object store is created, create POCO classes.

public class Order
{
    public long Id { get; set; } //This is the only required field
    public string Number { get; set; }
    public DateTime Date { get; set; }
    public List<OrderItem> OrderItems = { get; set; }
}

public class OrderItems
{
    public string ItemName { get; set; }
    public decimal Price { get; set; }
    public int Quantity { get; set; }
}

Now that your POCO classes are created, instantiate and fill an Order object with data.

var order = new Order()
{
    Numer = "1001",
    Date = DateTime.Now,
    OrderItems = new List<OrderItem>();
}

order.OrderItems.Add(new OrderItem()
{
    ItemName = "Sun Glasses",
    Price = 19.99,
    Quantity = 1
});

order.OrderItems.Add(new OrderItem()
{
    ItemName = "Flashlight",
    Price = 10.50,
    Quantity = 4
});

Once your order is ready to be stored simply add it to a object collection.

objectStore.Store("Orders", order);

This will store the order object and its' items as one object into a collection named "Orders". If the collection "Orders" does not already exist it will be created. Now that the order object has been stored into a collection it will have a unique value assigned to the Id property of order. This The Id value is what will be used to retrieve, update or delete the order in the future.

Retrieving your object is as simple as requesting it by Id.

var order = objectStore.Retrieve<order>("Orders", 1 /*Assuming the object Id is 1*/);

The retrieve method will create an Order object and its' OrderItem objects and populate them with the exact same data that was stored.

You can also lookup objects by values.

var orders = objectStore.Retrieve<order>("Orders", o => o.Number == "1001");

This call to the Retrieve method will create an IEnumerable object containing all Orders objects with the Number "1001".

You can also search by child object values.

var orders = objectStore.Retrieve<order>("Orders", o => o.OrderItems.Any(i => i.ItemName == "Flashlight"/);

Again you will get an IEnumerable object containing all orders that have an order item with the ItemName of "Flashlight".

You can even use a different object to retrieve data.

public class OrderHeader
{
    public long Id { get; set; }
    public string Number { get; set; }
}

var orderHeader = objectStore.Retrieve<OrderHeader>("Orders", 1 /*Assuming the object Id is 1*/);

This call will create and return an OrderHeader object with the Number property set to "1001".

And finally you can change the type of the property and the values will still get set as long as they are compatible.

public class OrderHeader2
{
    public long Id { get; set; }
    public int Number { get; set; } //<-- This was changed to an Int32
}

var orderHeader2 = objectStore.Retrieve<OrderHeader2>("Orders", 1 /*Assuming the object Id is 1*/);

Now the newly create OrderHeader2 will have an integer value for the Number property set to 1001. Changing types will work for most types, but some are not compatible and will either be null or default when the object is retrieved.

Visit vizeotech.com for full documentation.

vizeotech@outlook.com