Rocket.Libraries.DataModeling 1.1.0-beta04

Rocket.Libraries.DataModeling

Do a lot of data formatting for presentation. Don't pepper your code in random places with formatting statements. Instead, use this library to decorate your class properties with the desired final format.

Sounds vague? Read on, it is quite straightforward once you've seen the code examples.

Quick Start

1. Installation

Install the package from nuget

2. Configure your dotnet app

1. Include in your startup.cs file.

using Rocket.Libraries.DataModeling.Configuration;

2. Register services auth library in your ConfigureServices method.

public  void  ConfigureServices (IServiceCollection services)

{

//This registers all the various services of the Modeling Library for DI.
//We'll see these services as we move along.
services.SetupRocketDataModeling ();

//Register other services

}

3. Defining Properties To Be Formatted

If you have a class that contains properties that'll later on be output in a user-friendly format. Simply mark the properties with appropriate attributes.

namespace Example
{
		public class OrderLineItem
		{
			[FormatAsNumber (decimalPlacesCount: 2,formatSpecifier:'C',customCultureInfoName:"en-KE")]
			public  decimal Price { get; set; }

			[FormatAsDate(dateFormat:"dd/MM/yyyy",customCultureInfoName:"en-KE")]
			public  DateTime Dated { get; set; }
			
			public decimal Quantity { get; set; }
		}
}

4. Getting Formatted Values

Below is an example class that is using the library and the class above to get formatted value

	namespace Example
	{
		public class ExampleOfFormatting
		{
			private readonly Rocket.Libraries.DataModeling.Formatting autoFormatter;
			
			//Access the IEventQueue interface via DI.
			public ExampleOfFormatting(Rocket.Libraries.DataModeling.Formatting autoFormatter)
			{
				this.autoFormatter = autoFormatter;
			}

			public void DoFormatting()
			{
				var orderLineItem = new Example.OrderLineItem
				{
					Price = 5000,
					Dated = new DateTime(2022,02,08)
				};
				
				var formattedOrderLineItem = autoFormatter.GetSingleFormatted(orderLineItem);
			}

		}
	}

Above call returns a new object, which besides the original properties and values of the unformatted object, includes two new properties; Price_Formatted && Dated_Formatted which correspond to the decorated properties respectively.

You'll notice that there IS NOT a Quantity_Formatted property. This is because we did not place any formatting attributes on the Quantity property.

4.1 Points of Note on Formatted Object

1. The newly created object that contains your formatted data, also contains all of the original properties, including their data.
2. All new properties generated with formatted data are suffixed by _Formatted. Be careful not to name any of your own properties in a manner that would cause name collisions once your object is run through the formatter.
3. The object created is a dynamic object, so its type is distinct from that of your original unformatted object.