BSerializer

• BSerializer is an attempt of making and understanding serializers in the process.

• BSerializer is made using .NET Standard 2.0 so this should be usable for most C# projects.

Features implemented so far

• Support for recursive reference

• Auto-generated comments (with plans to make them custom)

• Caching optimization

Examples:

for the next examples we will use this C# class to demonstrate the serializations result:

namespace ConsoleUI.Model
{
    public class Person
    {
        public int Id { get; set; }
        public string FirstName { get; set; }
        public string LastName { get; set; }
        public string Address { get; set; }
        public Person Parent { get; set; }
    }
}

Serialization output

• One instance example

{
	<ConsoleUI.Model.Person,0>
	# Id #
	0,
	# FirstName #
	Will,
	# LastName #
	Smith,
	# Address #
	Some place,
	# Parent #
	{
		<ConsoleUI.Model.Person,1>
		# Id #
		1,
		# FirstName #
		John,
		# LastName #
		Doe,
		# Address #
		Some other place,
		# Parent #
		null
	}
}

the parts surrounded by # are considered comment in the example above , the comments are auto-generated using the class's property names.

With the auto-generated comments turned off , the result would look like this :

{
	<ConsoleUI.Model.Person,0>
	0,
	Will,
	Smith,
	Some place,
	{
		<ConsoleUI.Model.Person,1>
		1,
		John,
		Doe,
		Some other place,
		null
	}
}

• List example

[
	<System.Collections.Generic.List`1[[ConsoleUI.Model.IPerson, ConsoleUI, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]] , 0>

	# [0] #
	{
		<ConsoleUI.Model.Person , 1>
		# Id #
		0,
		# FirstName #
		Will,
		# LastName #
		Smith,
		# Address #
		Some place,
		# Parent #
		{
			<ConsoleUI.Model.Person , 2>
			# Id #
			1,
			# FirstName #
			John,
			# LastName #
			Doe,
			# Address #
			Some other place,
			# Parent #
			null
		}
	},

	# [1] #
	{
		<ConsoleUI.Model.Person , 2>
	}
]

As you can see , with the auto-generated comments , a small comment indicating the index of the element is added above every elment of the list

Notice how the value of the second element of the list only contains the metadata part , that's because it's the same instance (reference) as the 'Parent' field of the first element , this helps with many aspects :

• smaller deserialization output.
• keeping the same reference on deserialization instead of duplicating the same instance twice or more.
• The ability to do recursive references without worrying about output being stuck in a loop on deserialization.
• Dictionary example

[
	<System.Collections.Generic.Dictionary`2[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e],[ConsoleUI.Model.Person, ConsoleUI, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]],0>

	# [0] #
	{
		# key #
		128,
		# value #
		{
			<ConsoleUI.Model.Person,1>
			# Id #
			1,
			# FirstName #
			John,
			# LastName #
			Doe,
			# Address #
			Some other place,
			# Parent #
			{
				<ConsoleUI.Model.Person,1>
			},
			# age #
			34
		}
	},	

	# [1] #
	{
		# key #
		88,
		# value #
		{
			<ConsoleUI.Model.Person,1>
		}
	}
]