Nós queremos que os componentes de nossa aplicação sejam os mais independentes possíveis uns dos outros (além de efetuarmos testes e manutenção na aplicação de forma mais fácil), sendo que numa situação ideal, um componente não deveria saber da existência de outro, apenas terem uma ligação fraca uns com os outros (loose coupling) através do uso de [Interfaces].
Por exemplo, se criarmos duas classes com a necessidade de ligação fraca entre elas, a criação de uma interface nos ajuda neste sentido:
public class PasswordResetHelper {
public void ResetPassword() {
IEmailSender mySender = new MyEmailSender();
//...call interface methods to configure e-mail details...
mySender.SendEmail();
}
}
Mas como você deve ter notado no código acima, ainda temos um problema!...não existe um recurso padrão do C# para implementarmos o uso da interface [IEmailSender] sem a criação de uma instância da classe [MyEmailSender].
Portanto, mesmo usando uma Interface, ainda temos uma ligação de qualquer maneira...
Existe uma solução para isto? Sim, e se chama DI - Dependency Injection!
Uma forma rápida para melhorar o código acima seria a criação de um [construtor] e nele passaríamos a implementação da interface somente para a classe [PasswordResetHelper]
public class PasswordResetHelper {
private IEmailSender emailSender;
public PasswordResetHelper(IEmailSender emailSenderParam) {
emailSender = emailSenderParam;
}
public void ResetPassword() {
// ...call interface methods to configure e-mail details...
emailSender.SendEmail();
}
}
Com isto conseguimos quebrar a dependência entre as classes [PasswordResetHelper] e [MyEmailSender]. O que acabamos de fazer se chama [Constructor Injection].
Agora, para melhorarmos ainda mais nosso projeto MVC, podemos e devemos utilizar ferramentas sólidas para o tratamento de [DI]. Para tanto, existem algumas no mercado, como a Unit da Microsoft e NInject, a qual será usada neste artigo.
Criando as Classes de Controle
Vamos criar um novo projeto no Visual Studio, clicando em Novo -> Projeto -> [ASP.NET MVC 4 Web Application] Template e selecione a opção [Empty] para criar o projeto sem conteúdo. Dê o nome para o projeto de [EssentialTools].
A seguir, adicione a seguinte classe na pasta Models do projeto, com o nome Product.cs:
namespace EssentialTools.Models {
public class Product {
public int ProductID { get; set; }
public string Name { get; set; }
public string Description { get; set; }
public decimal Price { get; set; }
public string Category { set; get; }
}
}
Também adicione na pasta Models uma classe para efetuar um cálculo na coleção de produtos, com o nome [LinqValueCalculator]
using System.Collections.Generic;
using System.Linq;
namespace EssentialTools.Models {
public class LinqValueCalculator {
public decimal ValueProducts(IEnumerable<Product> products) {
return products.Sum(p => p.Price);
}
}
}
Agora crie a outra classe (ShoppingCart) que se relaciona com a criada anteriormente
using System.Collections.Generic;
namespace EssentialTools.Models {
public class ShoppingCart {
private LinqValueCalculator calc;
public ShoppingCart(LinqValueCalculator calcParam) {
calc = calcParam;
}
public IEnumerable<Product> Products { get; set; }
public decimal CalculateProductTotal() {
return calc.ValueProducts(Products);
}
}
}
Adicionando um Controller
Adicione um controller na pasta Controllers chamado HomeController e altere o seu conteúdo para o proposto abaixo
using EssentialTools.Models;
using System.Web.Mvc;
using System.Linq;
namespace EssentialTools.Controllers {
public class HomeController : Controller {
private Product[] products = {
new Product {Name = "Kayak", Category = "Watersports", Price = 275M},
new Product {Name = "Lifejacket", Category = "Watersports", Price = 48.95M},
new Product {Name = "Soccer ball", Category = "Soccer", Price = 19.50M},
new Product {Name = "Corner flag", Category = "Soccer", Price = 34.95M}
};
public ActionResult Index() {
LinqValueCalculator calc = new LinqValueCalculator();
ShoppingCart cart = new ShoppingCart(calc) { Products = products };
decimal totalValue = cart.CalculateProductTotal();
return View(totalValue);
}
}
}
Note que estamos usando este controller para testar nossas classes [LinqValueCalculator] e [ShoppingCart]
Adicionando uma View
Adicione uma View para visualizar o resultado do controler. Clique com o botão direito na ação Index da HomeController e selecione [Add View] e crie uma View chamada [Index], modificando o conteúdo conforme o proposto abaixo
@model decimal
@{
Layout = null;
}
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Value</title>
</head>
<body>
<div>
Total value is $@Model
</div>
</body>
</html>
Neste ponto, execute a aplicação e veja se tudo está rodando corretamente, apresentando a tela abaixo
Usando Ninject
Até o momento criamos duas classes com acoplamento forte (tightly-coupled), na qual ShoppingCart está ligada a classe LinqValueCalculator, e a HomeController ligada as duas. Pensando na manutenção disto em um projeto real podemos imaginar que será complicado, pois, por exemplo, se alterarmos o uso da classe [LinqValueCalculator] por outra, teremos que trocar a referência desta classe no projeto.
Vamos então aplicar primeiramente a Interface, que resolve parte do processo de acoplagem. Crie uma classe chamada [IValueCalculator] na pasta [Models] com o seguinte conteúdo:
using System.Collections.Generic;
namespace EssentialTools.Models {
public interface IValueCalculator {
decimal ValueProducts(IEnumerable<Product> products);
}
}
Com isto podemos agora implementar esta interface na classe [LinqValueCalculator]
using System.Collections.Generic;
using System.Linq;
namespace EssentialTools.Models {
public class LinqValueCalculator: IValueCalculator {
public decimal ValueProducts(IEnumerable<Product> products) {
return products.Sum(p => p.Price);
}
}
}
Com isto quebramos a ligação forte entre as classes ShoppingCart e LinqValueCalculator
using System.Collections.Generic;
namespace EssentialTools.Models {
public class ShoppingCart {
private IValueCalculator calc;
public ShoppingCart(IValueCalculator calcParam) {
calc = calcParam;
}
public IEnumerable<Product> Products { get; set; }
public decimal CalculateProductTotal() {
return calc.ValueProducts(Products);
}
}
}
Fizemos progresso, porém o C# ainda requer que implementemos a classe [LinqValueCalculator] na nossa HomeController, o que é ruim pois ainda estaremos ligando fortemente as classes
...
public ActionResult Index() {
IValueCalculator calc = new LinqValueCalculator();
ShoppingCart cart = new ShoppingCart(calc) { Products = products };
decimal totalValue = cart.CalculateProductTotal();
return View(totalValue);
}
...
Para desacoplar de uma vez este processo usaremos então Ninject mantendo também nossa HomeController somente com a implementação de uma Interface
Adicionando Ninject no Visual Studio
A forma mais fácil é o uso do recurso integrado ao VS, o NuGet, abrindo primeiro seu projeto, depois selecionando o menu Tools - > NuGet Package Manager -> Manage NuGet Packages for Solution
Na opção [Online] do Nuget, busque pela palavra [ninject]. Clique no botão install para adicionar as bibliotecas do Ninject no seu projeto. Podemos agora utilizar este recurso em nossa HomeController, conforme mostrado abaixo
using EssentialTools.Models;
using System.Web.Mvc;
using System.Linq;
using Ninject;
namespace EssentialTools.Controllers {
public class HomeController : Controller {
private Product[] products = {
new Product {Name = "Kayak", Category = "Watersports", Price = 275M},
new Product {Name = "Lifejacket", Category = "Watersports", Price = 48.95M},
new Product {Name = "Soccer ball", Category = "Soccer", Price = 19.50M},
new Product {Name = "Corner flag", Category = "Soccer", Price = 34.95M}
};
public ActionResult Index() {
IKernel ninjectKernel = new StandardKernel();
ninjectKernel.Bind<IValueCalculator>().To<LinqValueCalculator>();
IValueCalculator calc = ninjectKernel.Get<IValueCalculator>();
ShoppingCart cart = new ShoppingCart(calc) { Products = products };
decimal totalValue = cart.CalculateProductTotal();
return View(totalValue);
}
}
}
O primeiro estágio é o preparo para uso do Ninject, através da instância da classe [StandardKernel]. Com isto conseguimos criar um relacionamento entre as interfaces em nossa aplicação e as classes de implementação que nós queremos trabalhar. Você notou isto quando foi executado o passo descrito abaixo
...
ninjectKernel.Bind<IValueCalculator>().To<LinqValueCalculator>();
...
E como passo final o uso do Ninject para obter a implementação da Interface que queremos
...
IValueCalculator calc = ninjectKernel.Get<IValueCalculator>();
...
a este ponto você pode se perguntar, eu ainda possuo uma ligação forte entre meu Controller e a classe [LinqValueCalculator]...e é verdade. Porém, fácil de resolver pois podemos atuar no [core] do MVC adicionando o Kernel do Ninject no processo interno do MVC, de forma a desacoplar de uma vez por todas nossas classes da HomeController.
Criando um Dependency Resolver
Este recurso é interessante pois vamos adicionar nossas resoluções de classes x interfaces, no [core] do MVC, criando uma classe [resolver] que será instanciada na inicialização do projeto, por configurá-la no arquivo [Global.asax.cs] do projeto. Como passo final, alteramos nossa HomeController para usar somente a interface que desejamos. Veja todos estes passos em sequência:
1 - Adicione uma nova pasta chamada [Infrastructure] no projeto e crie uma classe chamada [NinjectDependencyResolver] com o conteúdo abaixo:
using System;
using System.Collections.Generic;
using System.Web.Mvc;
using Ninject;
using Ninject.Parameters;
using Ninject.Syntax;
using System.Configuration;
using EssentialTools.Models;
namespace EssentialTools.Infrastructure {
public class NinjectDependencyResolver : IDependencyResolver {
private IKernel kernel;
public NinjectDependencyResolver() {
kernel = new StandardKernel();
AddBindings();
}
public object GetService(Type serviceType) {
return kernel.TryGet(serviceType);
}
public IEnumerable<object> GetServices(Type serviceType) {
return kernel.GetAll(serviceType);
}
private void AddBindings() {
kernel.Bind<IValueCalculator>().To<LinqValueCalculator>();
}
}
}
2 - Registre a classe Dependency Resolver no Global.asax.cs (no método Application_Start)
using EssentialTools.Infrastructure;
using System.Web.Http;
using System.Web.Mvc;
using System.Web.Routing;
namespace EssentialTools {
public class MvcApplication : System.Web.HttpApplication {
protected void Application_Start() {
AreaRegistration.RegisterAllAreas();
DependencyResolver.SetResolver(new NinjectDependencyResolver());
WebApiConfig.Register(GlobalConfiguration.Configuration);
FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters);
RouteConfig.RegisterRoutes(RouteTable.Routes);
}
}
}
3 - Refatore sua HomeController
using EssentialTools.Models;
using System.Web.Mvc;
using System.Linq;
namespace EssentialTools.Controllers {
public class HomeController : Controller {
private Product[] products = {
new Product {Name = "Kayak", Category = "Watersports", Price = 275M},
new Product {Name = "Lifejacket", Category = "Watersports", Price = 48.95M},
new Product {Name = "Soccer ball", Category = "Soccer", Price = 19.50M},
new Product {Name = "Corner flag", Category = "Soccer", Price = 34.95M}
};
private IValueCalculator calc;
public HomeController(IValueCalculator calcParam) {
calc = calcParam;
}
public ActionResult Index() {
ShoppingCart cart = new ShoppingCart(calc) { Products = products };
decimal totalValue = cart.CalculateProductTotal();
return View(totalValue);
}
}
}
That's it!!
Ref: Pro ASP.NET MVC 4 - 4th Edition - Adam Freeman, aPress
