Objective
This tutorial will explain step by step explanation of how to use UNITY Framework in code. UNITY Framework is a framework of Microsoft to achieve Inversion of Control Design Pattern.
To know more about, what is Inversion of Control and Dependency Pattern design pattern read my previous article Click here.
Two very good articles on same topic by Mr ShivPrasad Koirala could be read at following links
Design pattern Inversion of Control and DI and IOC
How to use UNITY Container
Step 1
Download UNITY application block from Here
Step 2
Create New Project and Console application.
Step 3
Add reference to
Microsoft.Practices.Unity ,Microsoft.Practices.Unity.Configuration;
Step 4
Right click on project and add new item and then select interface. Give name of the interface as IPlayer.
Type below code in IPlayer.cs . This interface will registered as type to Unity Container.
IPlayer.cs
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
namespace UnityTesting
{
public
interface
IPlayer
{
string PlayerName
{
get;
set;
}
string TeamName
{
get;
set;
}
void DisplayDetails();
}
}
Step 5
Right click on project and add new class. Give name of the class as Player.cs
Note: Player class is implementing IPlayer interface.
Type below code in Player.cs.
Player.cs
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
namespace UnityTesting
{
public
class
Player:IPlayer
{
public Player()
{
}
string name;
string teamName;
public
string PlayerName
{
get
{
return name;
}
set
{
name = value;
}
}
public
string TeamName
{
get
{
return teamName;
}
set
{
teamName = value;
}
}
public
void DisplayDetails()
{
Console.WriteLine(“Player Name = \t” + name + ” \tPlayer Team Name = \t” + teamName);
//Console.WriteLine(p.PlayerName);
}
}
}
Step 6
Factory Class
: This is a class, which is responsible for
- Setting up the Unity Container. (Task A)
- Registering interface as a type to the container. (Task B)
- Returning instance of the registered type or Resolve an object by the type. ( Task C)
Add a new class in project by right clicking and give name of the class as Factory. Factory is name here; give any name as per desire.
In Factory.cs add namespaces
using Microsoft.Practices.Unity;
using Microsoft.Practices.Unity.Configuration;
Task A:
Set Up Container
To set up container, create instance of IUnityContainer class.
IUnityContainer _container = new
UnityContainer();
The above code will create an instance of container class.
Task B: Register interface as a type
- RegisterType method of container class is used to register a type into the container.
- At the appropriate time, the container will build an instance of the type which is specified.
- The lifetime of the object it builds will correspond to the life time specified in the parameters of the method.
- If lifetime is not specified then the type will registered for a transient lifetime, which means that a new instance will be created on each call to Resolve. ( It is method , which will be discussed later)
- This method is overloaded with 8 different parameters.
How to register a type?
_container.RegisterType(typeof(IPlayer), typof(Player));
Task C: Resolve an Object by the type
- To resolve an objcet by type , Resolve method will be used.
- To retrieve object instances from the container.
- When this method is used without specifying a value for the optional name property, the method returns the object registered with the default mapping.
- This method is overloaded with two types of arguments. One takes only type and other argument takes type as well as string name of the registered type.
How to resolve instance of registered type?
IPlayer obj = _container.Resolve<IPlayer>();
If exact return type of instance is known then that could be also applied like
Player obj1 = _container.Resolve<Player>();
Putting altogether the Factory class.
Factory.cs
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Microsoft.Practices.Unity;
using Microsoft.Practices.Unity.Configuration;
namespace UnityTesting
{
public
class
Factory
{
static
public
IPlayer CreateInstance()
{
IUnityContainer _container = new
UnityContainer();
_container.RegisterType(typeof(IPlayer), typeof(Player));
IPlayer obj = _container.Resolve<IPlayer>();
return obj;
}
}
}
Explanation:
CreateInstance() is a static method. This method will return instance of type registered to the container.
Step 7
Now solution explorer should look like as below
Step 8
Click on Program.cs and paste below code
Program.cs
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Microsoft.Practices.Unity;
using Microsoft.Practices.Unity.Configuration;
using System.Configuration;
namespace UnityTesting
{
class
Program
{
static
void Main(string[] args)
{
IPlayer obj = Factory.CreateInstance();
obj.PlayerName = ” Sachin Tendulkar “;
obj.TeamName = ” India “;
obj.DisplayDetails();
IPlayer obj1 = Factory.CreateInstance();
obj.PlayerName = ” Shane warne”;
obj.TeamName = ” Australia “;
obj.DisplayDetails();
Console.Read();
}
}
}
Explanation:
IPlayer obj = Factory.CreateInstance();
This code is used to create a instance if type Player using Unity Container.
obj.PlayerName = ” Sachin Tendulkar “;
obj.TeamName = ” India “;
obj.DisplayDetails();
Now properties and methods of class being called using instance of the class.
Here Each time calling Resolve method is returning an instance of registered type , because time line is variant and not specified.
Output
Conclusion
This article has explained , How yo use UNITY Container using the code .
Future scope
In next article, I shall explain how to
To register an existing object instance as an externally controlled instance
- To register an existing object as a singleton instance
Happy Coding .
Leave a Reply