ASP.NET MVC 6: Implementando uma aplica��o b�sica

A Microsoft vem trabalhando desde o in�cio de 2014 em atualizaç�es do ASP.NET e do Visual Studio. Em Fevereiro/2015 foi disponibilizado o Visual Studio 2015 CTP 6, nova vers�o da IDE de desenvolvimento que conta com total suporte para a implementaç�o de aplicaç�es baseadas no ASP.NET 5 (inicialmente chamado de �ASP.NET vNext�).

No que se refere ao ASP.NET 5, a nova vers�o desta plataforma passou por mudanças bem significativas:

Existe agora a possibilidade de construç�o de soluç�es multiplaforma. Al�m de Windows, tais aplicaç�es tamb�m poder�o ser executadas a partir de sistemas Mac ou Linux;
O namespace System.Web deixou de existir, com os recursos b�sicos de desenvolvimento Web passando por uma completa reformulaç�o. Muitas destas modificaç�es levam em consideraç�o a forte tend�ncia de migraç�o de aplicaç�es para ambientes de cloud computing;
Um novo modelo de programaç�o Web unificado chamado MVC 6 ser� a base para a implementaç�o de projetos MVC e/ou Web API;
H� a possibilidade de hospedagem ainda no IIS ou, at� mesmo, de implementaç�o de um processo pr�prio que cuide disto.
A geraç�o de projetos sob a forma de dlls deu lugar a m�dulos que seguem os padr�es de pacotes do utilit�rio Nuget.

Este artigo tem por meta demonstrar a novas caracter�sticas do MVC 6. Dentre os recursos a serem abordados est�o:

O novo modelo para manipulaç�o de itens de configuraç�o em projetos ASP.NET 5;
A integraç�o com ferramentas para gerenciamento de pacotes client-side, como Bower, Grunt e npm no novo Visual Studio;

Um novo mecanismo nativo para injeç�o de depend�ncias;

Os View Components, estruturas que substituem no novo MVC as antigas Partial Views;
As Tag Helpers, que representam uma alternativa nova e simplificada ao uso de HTML Helpers.

A fim de cumprir tal objetivo ser� constru�da uma aplicaç�o Web de exemplo no Visual Studio 2015 CTP 6, com os detalhes de implementaç�o desta �ltima estando descritos nas pr�ximas seç�es.

h3>Exemplo de implementaç�o de uma aplicaç�o MVC 6

Procurando demonstrar algumas das novidades disponibilizadas com o ASP.NET 5 ser� criada uma nova soluç�o que faz uso dos seguintes recursos:

O Microsoft Visual Studio 2015 CTP 5 como IDE de desenvolvimento;
O .NET Framework 4.6;
O framework ASP.NET 5 para a criaç�o de uma aplicaç�o MVC 6;
O plugin jQuery Open Weather.

O exemplo apresentado a seguir consistir� na construç�o de um site para consulta � temperatura de algumas cidades num determinado instante. Para isto ser� implementado uma aplicaç�o MVC chamada �TesteVS2015MVC�, a qual ir� se conectar a um serviço de climatologia conhecido como Open Weather. O projeto TesteVS2015MVC ser� do tipo �ASP.NET Web Application�, sendo gerado a partir da seleç�o do template �ASP.NET 5 Preview Starter Web�, conforme a Figura 1.

Figura 1. Selecionando o template ASP.NET 5 Preview Starter Web no Visual Studio 2015

Na Figura 2 � poss�vel visualizar a estruturaç�o do projeto TesteVS2015MVC, com os diferentes arquivos gerados logo ap�s a criaç�o do mesmo.

Figura 2. Estrutura inicial do projeto TesteVS2015MVC

As pr�ximas seç�es descrevem os diferentes ajustes e implementaç�es que ser�o efetuados, de forma a detalhar as novidades e modificaç�es na maneira como aplicaç�es ASP.NET s�o concebidas.

Definindo os itens de configuraç�o e o acesso aos mesmos

Uma das mudanças significativas em projetos MVC 6 foi a substituiç�o do Web.config pelo arquivo config.json. Este �ltimo documento conta com declaraç�es de itens de configuraç�o no formato JSON, adotando um modelo mais flex�vel e que facilita a realizaç�o de customizaç�es nas definiç�es das quais uma aplicaç�o depende.

Na Listagem 1 est� o c�digo esperado para o arquivo config.json. Conforme � poss�vel observar, uma chave chamada �Teste� cont�m dois subn�veis formados pelas propriedades �Cidade1� e �Cidade2�. O conte�do destes dois �ltimos elementos servir� de base para as consultas ao serviço de climatologia Open Weather (no caso espec�fico deste exemplo, para as cidades de Seattle e Paris).

Listagem 1. Arquivo config.json


      {
          "Teste": {
              "Cidade1": "Seattle, US",
              "Cidade2": "Paris, FR"
          }
      }

O tipo ConfigurationManager deixou de existir, tendo sido substitu�do por uma implementaç�o derivada da interface IConfiguration (esta �ltima pertencente ao namespace Microsoft.Framework.ConfigurationModel).

Por mais que o arquivo config.json represente o default para projetos ASP.NET 5, as configuraç�es de uma aplicaç�o podem contar com outras origens. A definiç�o de quais arquivos com itens de configuraç�o ser�o utilizados por uma aplicaç�o acontece na classe Startup (um equivalente ao antigo Global.asax). Na Listagem 2 encontra-se a implementaç�o deste tipo:

A propriedade Configuration armazenar� uma inst�ncia de uma classe que deriva de IConfiguration;
J� no construtor do tipo Startup uma refer�ncia da classe Configuration (namespace Microsoft.Framework.ConfigurationModel) ser� criada e associada � propriedade de mesmo nome. Percebe-se ainda neste ponto o uso dos m�todos AddJsonFile (adicionando o conte�do do arquivo config.json �s configuraç�es dispon�veis) e AddEnvironmentVariables (para o acesso a vari�veis de ambiente). Outros arquivos .json de configuraç�o poderiam ser inclu�dos aqui opcionalmente, bem como arquivos com a extens�o .ini (atrav�s da operaç�o AddIniFile);
O m�todo ConfigureServices ser� empregado na configuraç�o do mecanismo de injeç�o de depend�ncias do ASP.NET MVC. Esta operaç�o recebe como par�metro uma refer�ncia do tipo IServiceCollection (namespace Microsoft.Framework.DependencyInjection), a qual ser� utilizada no mapeamento de depend�ncias entre tipos b�sicos (como interfaces) e as implementaç�es concretas correspondentes. No caso espec�fico do exemplo deste artigo, ser� necess�rio alterar o m�todo ConfigureServices, de maneira que a inst�ncia de IServiceCollection consiga mapear todas as ocorr�ncias de IConfiguration para a inst�ncia associada � propriedade Configuration. Quanto � chamada ao m�todo AddSingleton, este procedimento faz com que uma �nica de inst�ncia de IConfiguration seja utilizada na resoluç�o de todas as depend�ncias encontradas ao longo de uma aplicaç�o, constituindo assim um exemplo pr�tico de aplicaç�o do pattern Singleton.

� importante destacar ainda que o suporte � injeç�o de depend�ncias tamb�m foi remodelado no ASP.NET 5. Em vers�es anteriores, a opç�o por este tipo de pr�tica exigia o uso de um container DI como Unity, NInjectou Spring.NET, dentre outras alternativas poss�veis. Embora esta opç�o ainda esteja dispon�vel, a nova vers�o da tecnologia ASP.NET tamb�m oferece um mecanismo nativo para a injeç�o de depend�ncias.

Listagem 2. Classe Startup


      using System;
      using Microsoft.AspNet.Builder;
      using Microsoft.AspNet.Diagnostics;
      using Microsoft.AspNet.Diagnostics.Entity;
      using Microsoft.AspNet.Hosting;
      using Microsoft.AspNet.Identity;
      using Microsoft.Framework.ConfigurationModel;
      using Microsoft.Framework.DependencyInjection;
      using Microsoft.Framework.Logging;
      using Microsoft.Framework.Logging.Console;
      using TesteVS2015MVC.Models;
       
      namespace TesteVS2015MVC
      {
          public class Startup
          {
              public Startup(IHostingEnvironment env)
              {
                  Configuration = new Configuration()
                      .AddJsonFile("config.json")
                      .AddEnvironmentVariables();
              }
       
              public IConfiguration Configuration { get; set; }
       
              public void ConfigureServices(IServiceCollection services)
              {
                  services.AddSingleton<IConfiguration>(_ => Configuration);
       
                  ...
              }
       
              ...
          }
      }

Configurando o uso da biblioteca Open Weather

Nesta seç�o ser� demonstrada a utilizaç�o conjunta das ferramentas Bower, Grunt e npm, a fim de incluir os arquivos necess�rios para uso da biblioteca Open Weather ao projeto de testes. � importante ressaltar que no Visual Studio 2015 a manipulaç�o de pacotes client-side (como bibliotecas de scripts e arquivos CSS) ficou a cargo destas soluç�es, com a pr�pria IDE dispondo de funcionalidades que suportam a integraç�o com tais gerenciadores.

Um primeiro ajuste dever� ser realizado no arquivo bower.json, o qual cont�m as depend�ncias de pacotes client-side controladas por meio da ferramenta Bower.

A inclus�o de novos packages no arquivo bower.json � facilitada graças ao suporte oferecido pelo IntelliSense. Acessando dados de um reposit�rio que cont�m os plugins suportados pelo Bower, este recurso ir� listar os diversos pacotes dispon�veis, assim como as vers�es mais recentes dos mesmos (Figura 3).

Na seç�o exportsOverride do arquivo bower.json ser� necess�rio especificar ainda quais arquivos do plugin Open Weather ser�o carregados dentro da pasta wwwroot (al�m dos scripts, esta biblioteca tamb�m disponibiliza folhas de estilo CSS e imagens para a exibiç�o de informaç�es clim�ticas).

Na Listagem 3 encontram-se todas as mudanças realizadas no arquivo bower.json; outras depend�ncias como o Bootstrap e jQuery j� haviam sido inclu�das anteriormente, durante a criaç�o do projeto TesteVS2015MVC. O uso do s�mbolo �~� (til) antecedendo o n�mero de vers�o do plugin Open Weather (1.2.0) indica a utilizaç�o de qualquer patch igual ou superior a 0 (considerando as vers�es 1.2 desta biblioteca).

Figura 3. O suporte do IntelliSense para a ediç�o do arquivo bower.json

Listagem 3. Arquivo bower.json


      {
          "name": "WebApplication",
          "private": true,
          "dependencies": {
              "bootstrap": "3.0.0",
              "jquery": "1.10.2",
              "jquery-validation": "1.11.1",
              "jquery-validation-unobtrusive": "3.2.2",
              "hammer.js": "2.0.4",
              "bootstrap-touch-carousel": "0.8.0",
              "open-weather": "~1.2.0"
          },
          "exportsOverride": {
              "bootstrap": {
                  "js": "dist/js/*.*",
                  "css": "dist/css/*.*",
                  "fonts": "dist/fonts/*.*"
              },
              "bootstrap-touch-carousel": {
                  "js": "dist/js/*.*",
                  "css": "dist/css/*.*"
              },
              "jquery": {
                  "": "jquery.{js,min.js,min.map}"
              },
              "jquery-validation": {
                  "": "jquery.validate.js"
              },
              "jquery-validation-unobtrusive": {
                  "": "jquery.validate.unobtrusive.{js,min.js}"
              },
              "hammer": {
                  "": "hammer.{js,min.js}"
              },
              "open-weather": {
                  "js": "src/openWeather.js",
                  "css": "src/css/*.*",
                  "img": "src/img/"
              }
          }
      }

Verificando a estrutura do projeto TesteVS2015MVC dentro do Solution Explorer, ser� poss�vel constatar que o plugin Open Weather ainda n�o foi instalado (Figura 4). A inclus�o dos arquivos da biblioteca Open Weather � aplicaç�o de exemplo acontecer� atrav�s da funcionalidade Task Runner Explorer, conforme detalhado mais adiante.

Figura 4. Plugin Open Weather ainda n�o instalado

Para visualizar a janela Task Runner Explorer clicar com o bot�o direito do mouse sobre o arquivo gruntfile.js, acionando em seguida a opç�o de mesmo nome (Figura 5).

Figura 5. Acessando o Task Runner Explorer

Com a janela �Task Runner Explorer� ativa, clicar desta vez com o bot�o direito mouse sobre o item �bower� e selecionar a opç�o �Run� (Figura 6). As tarefas configuradas para a ferramenta Bower ser�o executadas (com base nas instruç�es definidas no arquivo gruntfile.js), com um prompt exibindo o resultado desta aç�o (Figura 7).

Figura 6. Executando as tarefas para a ferramenta Bower

Figura 7. Resultado da execuç�o das tarefas no Task Runner Explorer

Ao verificar novamente a estrutura do projeto TesteVS2015MVC, ser� poss�vel constatar que a instalaç�o do plugin Open Weather foi conclu�da com sucesso (Figura 8).

Figura 8. Plugin Open Weather j� instalado

Criando o View Component de informaç�es clim�ticas

Com o ASP.NET 5 n�o � mais poss�vel o uso de Partial Views. Um novo tipo de estrutura foi disponibilizado, de forma a substituir estes elementos: trata-se do recurso conhecido como View Component.

Assim como acontecia com as Partial Views em vers�es anteriores do framework MVC, os Views Components tamb�m foram projetados de forma a favorecer o reuso e possibilitar a inserç�o de conte�do em pontos espec�ficos das p�ginas de uma aplicaç�o. A diferença no MVC 6 est� na forma como estes componentes s�o definidos. Um View Component dispensa a codificaç�o de um novo Controller com uma Action associada ao processamento do item ou, mesmo, a alteraç�o de uma construç�o pr�-existente.

A implementaç�o de um novo View Component envolve:

A codificaç�o de uma nova classe, normalmente criada na pasta Components de um projeto MVC;
Uma nova View chamada Default.cshtml e localizada no caminho \Views\Shared\Components\<Nome do View Component>. Este arquivo tem por objetivo produzir o c�digo HTML equivalente � visualizaç�o do componente.

Na Figura 9 est� assinalada a organizaç�o esperada para a implementaç�o do View Component ClimaCidade. A ideia � que este componente sirva de base para a exibiç�o de informaç�es clim�ticas de uma cidade espec�fica.

Figura 9. Estrutura do View Component ClimaCidade

J� a Listagem 4 traz a definiç�o do View Component ClimaCidade (arquivo ClimaCidade.cs):

A classe ClimaCidadeComponent deriva do tipo b�sico ViewComponent (namespace Microsoft.AspNet.Mvc). Essa estrutura foi marcada ainda com o atributo ViewComponentAttribute (namespace Microsoft.AspNet.Mvc), em cujo construtor � indicado o nome/identificaç�o do View Component que se est� criando (no caso, �ClimaCidade�);
O m�todo Invoke devolve como resultado uma inst�ncia de IViewComponentResult (namespace Microsoft.AspNet.Mvc), a qual � gerada atrav�s de uma chamada � operaç�o View. Importante destacar ainda o uso do objeto ViewBag, no qual a propriedade ReferenciaCidade conter� a identificaç�o da localidade informada como par�metro ao se acionar o m�todo Invoke.

OBSERVAÇ�O: Por convenç�o, nomes de classes que representam atributos terminam com o sufixo Attribute. A utilizaç�o de express�es que envolvam um atributo vinculando o mesmo a uma estrutura de c�digo dispensa o uso de tal sufixo ao final do nome. Logo, ao se empregar o atributo ViewComponentAttribute, a classe marcada com essa construç�o estar� associada apenas a uma instruç�o com o valor �ViewComponent� (entre colchetes).

Listagem 4. Classe ClimaCidade


      using System;
      using Microsoft.AspNet.Mvc;
       
      namespace TesteVS2015MVC.Components
      {
          [ViewComponent(Name = "ClimaCidade")]
          public class ClimaCidadeComponent : ViewComponent
          {
              public IViewComponentResult Invoke(string referenciaCidade)
              {
                  ViewBag.ReferenciaCidade = referenciaCidade;
                  return View();
              }
          }
      }

Na Listagem 5 encontra-se o conte�do do arquivo Default.cshtml, o qual representa a visualizaç�o em HTML gerada pelo View Component ClimaCidade:

Analisando melhor este conjunto de instruç�es, nota-se que tal tipo de estrutura (View Components) n�o difere em nada de uma View tradicional;
A chamada ao m�todo openWeather far� com que uma requisiç�o seja enviada ao serviço clim�tico Open Weather. As informaç�es retornadas ser�o ent�o utilizadas no preenchimento dos diferentes elementos do View Component, fazendo tamb�m uso para isto de recursos como imagens que comp�em o plugin adicionado anteriormente.

Listagem 5. Arquivo Default.cshtml (View Component ClimaCidade)


      <style type="text/css">
       
          .infoTemperatura
          {
              background-color: lightblue;
              padding-top: 30px;
              padding-bottom: 30px;
              width: 400px;
          }
          
          .legendaClima
          {
              font-size: 26pt;
              padding-top: 30px;
          }
       
      </style>
       
      <br />
       
      <div class="infoTemperatura">
       
          <img src="" class="icone-clima" alt="Weather Icon" />
       
          <p class="legendaClima">
              <strong>Localidade</b>
              <br /><span class="localidade"></span>
          </p>
       
          <p class="legendaClima">
              <strong>Temperatura</b>
              <br /><span class="temperatura"></span>
              (<span class="temperatura-minima"></span> -
              <span class="temperatura-maxima"></span>)
          </p>
       
          <p class="legendaClima">
              <strong>Umidade</b>
              <br /><span class="umidade"></span>
          </p>
       
      </div>
       
      <script src="~/lib/open-weather/js/openWeather.js"></script>
       
      <script>
       
            $('.temperatura').openWeather({
                  city: '@ViewBag.ReferenciaCidade',
                  minTemperatureTarget: '.temperatura-minima',
                  maxTemperatureTarget: '.temperatura-maxima',
                  humidityTarget: '.umidade',
                  placeTarget: '.localidade',
                  iconTarget: '.icone-clima',
                  customIcons: '/lib/open-weather/img/icons/weather/',
                  success: function () {
                      $('.infoTemperatura').show();
                  }
            });
       
      </script>

Ajustes na View _Layout.cshtml

A View _Layout.cshtml (localizada em \Views\Shared\) tamb�m precisar� ser alterada, a fim de que a refer�ncia para a biblioteca jQuery seja a primeira declaraç�o de scripts neste arquivo. Na Listagem 6 � poss�vel observar o c�digo esperado para este arquivo.

Listagem 6. View _Layout.cshtml


      <!DOCTYPE html>
      <html>
      <head>
          <meta charset="utf-8" />
          <meta name="viewport" content="width=device-width, initial-scale=1.0">
          <title>Exemplo de aplicaç�o criada no ASP.NET MVC 6</title>
       
          <script src="~/lib/jquery/jquery.js"></script>
          <link rel="stylesheet" href="~/lib/bootstrap/css/bootstrap.css" />
          <link rel="stylesheet" href="~/css/site.css" />
          <link rel="stylesheet" href="~/lib/bootstrap-touch-carousel/css/bootstrap-touch-carousel.css" />
      </head>
      <body>
          <div class="navbar navbar-inverse navbar-fixed-top">
              <div class="container">
                  <div class="navbar-header">
                      <button type="button" class="navbar-toggle" data-toggle="collapse"
                              data-target=".navbar-collapse">
                          <span class="icon-bar"></span>
                          <span class="icon-bar"></span>
                          <span class="icon-bar"></span>
                      </button>
                      @Html.ActionLink("TesteVS2015MVC", "Index", "Home",
                           new { area = "" }, new { @class = "navbar-brand" })
                  </div>
                  <div class="navbar-collapse collapse">
                      <ul class="nav navbar-nav">
                          <li>@Html.ActionLink("Home", "Index", "Home")</li>
                          <li>@Html.ActionLink("Sobre", "About", "Home")</li>
                          <li>@Html.ActionLink("Contato", "Contact", "Home")</li>
                      </ul>
                  </div>
              </div>
          </div>
          <div class="container body-content">
              @RenderBody()
              <hr />
              <footer>
                  <p>� 2015 - Renato Groffe</p>
              </footer>
          </div>
          <script src="~/lib/bootstrap/js/bootstrap.js"></script>
          <script src="~/lib/hammer.js/hammer.js"></script>
          <script src="~/lib/bootstrap-touch-carousel/js/bootstrap-touch-carousel.js"></script>
          @RenderSection("scripts", required: false)
      </body>
      </html>

Injeç�o de depend�ncias e estruturas para a visualizaç�o do clima em cidades

O acesso �s informaç�es clim�ticas das cidades indicadas no arquivo config.json aconter� atrav�s do Controller CidadeController. Essa estrutura pode ser criada por meio da janela Solution Explorer: clicar para isto com o bot�o direito do mouse sobre a pasta Controllers, selecionando em seguida no menu de atalho a opç�o �Add� e, finalmente, �New Item...�. Aparecer� ent�o a janela �Add New Item�; marcar o template �MVC Controller Class�, preenchendo o campo �Name� com o valor "CidadeController".

O pr�ximo passo ser� a realizaç�o de ajustes neste novo Controller (Listagem 7):

Um atributo privado baseado na interface IConfiguration (�_configuration�) precisar� ser declarado na definiç�o do tipo CidadeController, de forma a possibilitar o acesso aos itens de configuraç�o dentro deste Controller;
Um construtor tamb�m dever� ser implementado para a classe CidadeController. Ser� atrav�s dessa estrutura que o mecanismo de injeç�o de injeç�o de depend�ncias ir� resolver a depend�ncia para com IConfiguration (o construtor de CidadeController ser� invocado automaticamente pelo container DI);
Na Action Cidade1 � poss�vel observar que o valor de �Cidade1� (no caso, �Seattle, US�) est� sendo associado � propriedade ViewBag, atrav�s de uma chamada ao m�todo Get da inst�ncia associada ao atributo _configuration. O acesso a uma propriedade definida no arquivo config.json requer o uso do caracter �:� (dois pontos), de forma a separar cada n�vel que antecede a configuraç�o em quest�o;
J� a Action Cidade2 servir� de base para a exibiç�o dos dados da cidade de Paris, procedimento este a ser detalhado nas seç�es seguintes.

Listagem 7. Controller CidadeController


      using Microsoft.AspNet.Mvc;
      using Microsoft.Framework.ConfigurationModel;
       
      namespace TesteVS2015MVC.Controllers
      {
          public class CidadeController : Controller
          {
              private IConfiguration _configuration;
       
              public CidadeController(IConfiguration config)
              {
                  this._configuration = config;
              }
       
              public IActionResult Cidade1()
              {
                  ViewBag.Cidade1 = _configuration.Get("Teste:Cidade1");
                  return View();
              }
       
              public IActionResult Cidade2()
              {
                  return View();
              }
          }
      }

OBSERVAÇ�O: Mais adiante ser�o demonstradas as outras possibilidades de uso do mecanismo de injeç�o de depend�ncias do ASP.NET 5.

Para criar a View associada � Action Cidade1, criar dentro da pasta �Views� uma nova subpasta chamada �Cidade� (como indicado na Figura 10). O arquivo Cidade1.cshtml ser� gerado neste local, por meio da utilizaç�o do template �MVC View Page�, como mostra a Figura 11.

Figura 10. Estruturas para a visualizaç�o de informaç�es clim�ticas

Figura 11. Criando a View Cidade1.cshtml

O c�digo que define a View Cidade1.cshtml est� na Listagem 8:

O View Component ClimaCidade ser� acionado atrav�s do m�todo Invoke do objeto Component, recebendo como par�metros o nome do componente, al�m do valor da cidade que est� associada � ViewBag. O HTML produzido ser� ent�o incorporado ao conte�do da View em quest�o;
O m�todo ActionLink do objeto Html ir� gerar ainda um link, para que um usu�rio seja capaz de retornar � tela inicial da aplicaç�o.

Listagem 8. View Cidade1.cshtml (Controller CidadeController)


      <div >
          <center>
              @Component.Invoke("ClimaCidade", ViewBag.Cidade1)
              <br />
              @Html.ActionLink("Voltar", "Index", "Home")
          </center>
      </div>

Ativando o uso de Tag Helpers e mais injeç�o de depend�ncias

Outra das novidades do MVC 6 � a possibilidade de uso das Tag Helpers no lugar dos Html Helpers convencionais. Ao inv�s de exigir uma chamada a um m�todo auxiliar no c�digo de uma View, este recurso permite a obtenç�o do mesmo resultado a partir da utilizaç�o de uma sintaxe baseada em tags (em um modo similar �quele empregado com HTML padr�o).

At� o presente momento (in�cio de Março/2015) este novo mecanismo n�o se encontra ativo por default em projetos MVC 6. Diante disto, faz-se necess�ria a inclus�o de refer�ncias ao projeto �Microsoft.AspNet.Mvc.TagHelpers� em soluç�es que venham a depender deste �ltimo. Este procedimento deve ser efetuado atrav�s do utilit�rio NuGet, o qual pode ser acessado com o bot�o direito do mouse sobre o item References de um projeto (Figura 12).

Figura 12. Gerenciando as depend�ncias do projeto via NuGet

Na interface da ferramenta NuGet pesquisar por �Tag Helpers�. Selecionar o projeto Microsoft.AspNet.Mvc.TagHelpers (Figura 13), prosseguindo com a instalaç�o do mesmo. Ao t�rmino destes passos, ser� poss�vel constatar que a refer�ncia foi devidamente inclu�da na aplicaç�o de testes (Figura 14).

Figura 13. Gerenciando as depend�ncias do projeto via NuGet

Figura 14. Refer�ncia para uso de Tag Helpers j� inclu�da na aplicaç�o de testes

O arquivo _ViewStart.cshtml tamb�m dever� ser modificado, a fim de tornar poss�vel o uso de Tag Helpers nas Views do projeto TesteVS2015MVC. � o que demonstra a Listagem 9, na qual a diretiva @addtaghelper referencia o namespace Microsoft.AspNet.Mvc.TagHelpers. Tal ajuste far� com que muitas das funcionalidades dos Html Helpers que integram o framework MVC possam ser acionadas por meio de tags nas Views da aplicaç�o aqui apresentada.

Listagem 9. View _ViewStart.cshtml


      @using TesteVS2015MVC;
      @addtaghelper "Microsoft.AspNet.Mvc.TagHelpers"
      @{
          Layout = "/Views/Shared/_Layout.cshtml";
      }

Embora possuindo finalidade id�ntica � da View implementada na seç�o anterior, o conte�do do arquivo Cidade2.cshtml (Listagem 10) apresenta novos detalhes que ainda n�o foram abordados neste artigo. Tais diferenças t�m por objetivo demonstrar o uso do mecanismo de injeç�o de depend�ncias e de Tag Helpers em Views:

O c�digo se inicia com a cl�usula �@using� referenciando o namespace Microsoft.Framework.ConfigurationModel;
J� a cl�usula �@inject� ser� utilizada para resolver a depend�ncia representada pela vari�vel �config�, de forma que se associe a esta refer�ncia a inst�ncia do tipo IConfiguration gerada durante a inicializaç�o da aplicaç�o;
O View Component ClimaCidade tamb�m ser� acionado via m�todo Invoke, recebendo como par�metro o valor associado ao item �Cidade2� do arquivo de configuraç�es (e que � obtido a partir de uma chamada ao m�todo Get disponibilizado pelo objeto �config�);
A geraç�o de um link que redireciona o usu�rio para a p�gina inicial da aplicaç�o tamb�m acontecer� de uma outra maneira, dispensando assim a necessidade de se efetuar uma chamada ao m�todo ActionLink do objeto Html. Este novo exemplo faz uso de um Tag Helper, no qual foram indicados o Controller e a Action a serem executados (por meio do preenchimento dos atributos �asp-controller� e �asp-action�, respectivamente).

Listagem 10. View Cidade2.cshtml (Controller CidadeController)


      @using Microsoft.Framework.ConfigurationModel
      @inject IConfiguration config
       
      <div >
          <center>
              @Component.Invoke("ClimaCidade", config.Get("Teste:Cidade2"))
              <br />
              <a asp-controller="Home" asp-action="Index">Voltar</a>
          </center>
      </div>

Ajustes finais e �ltimas consideraç�es sobre injeç�o de depend�ncias

A classe HomeController tamb�m precisar� ser ajustada, sendo que na Listagem 11 est� o c�digo esperado para essa estrutura:

Este Controller conta com uma propriedade chamada �Configuration�, � qual ser� atribu�da uma inst�ncia do tipo IConfiguration via mecanismo de injeç�o de depend�ncias do ASP.NET 5. Para que isto aconteça a propriedade Configuration foi marcada com o atributo ActivateAttribute (namespace Microsoft.AspNet.Mvc);
A Action Index faz uso da propriedade Configuration, de maneira a associar o conte�do dos itens de configuraç�o �Cidade1� e �Cidade2� a propriedades do objeto ViewBag.

Listagem 11. Controller HomeController


      using Microsoft.AspNet.Mvc;
      using Microsoft.Framework.ConfigurationModel;
       
      namespace TesteVS2015MVC.Controllers
      {
          public class HomeController : Controller
          {
              [Activate]
              public IConfiguration Configuration { get; set; }
       
              public IActionResult Index()
              {
                  ViewBag.Cidade1 = Configuration.Get("Teste:Cidade1");
                  ViewBag.Cidade2 = Configuration.Get("Teste:Cidade2");
       
                  return View();
              }
       
              ...
       
          }
      }

Por fim, na Listagem 12 est� a implementaç�o da View Index. Al�m de consumir os valores atribu�dos ao objeto ViewBag em HomeController, este arquivo ainda faz uso de um Html Helper e de uma Tag View para a geraç�o dos links de visualizaç�o do clima nas cidades de Seattle e Paris.

Listagem 12. View Index.cshtml (Controller HomeController)


      @{
          string cidade1 = ViewBag.Cidade1;
      }
       
      <div class="jumbotron">
          <h1>ASP.NET 5</h1>
          <p class="lead">
              Exemplo de aplicaç�o constru�da com o
              framework ASP.NET MVC 6.
          </p>
      </div>
       
      <div >
          Consulta a informaç�es clim�ticas - selecione uma cidade:
          <ul>
              <li>
                  @Html.ActionLink(cidade1, "Cidade1", "Cidade")
              </li>
              <li>
                  <a asp-controller="Cidade" asp-action="Cidade2">
                      @ViewBag.Cidade2
                  </a>
              </li>
          </ul>
      </div>

Teste da aplicaç�o criada

Na Figura 15 � apresentada a tela inicial da aplicaç�o TesteVS2015MVC.

Figura 15. Tela inicial da aplicaç�o TesteASPNETvNext

Ao acionar o link �Seattle, US� ser�o exibidas as condiç�es clim�ticas para esta cidade como indicado na Figura 16. J� a visualizaç�o das informaç�es sobre Paris est� na Figura 17.

Figura 16. Informaç�es clim�ticas da cidade de Seattle<

Figura 17. Informaç�es clim�ticas da cidade de Paris

A intenç�o deste artigo foi demonstrar os novos recursos para a implementaç�o de aplicaç�es MVC no ASP.NET 5 a partir de um exemplo simples, mas que contemplasse as principais novidades desta plataforma Web.

Embora tenham ocorrido grandes mudanças, � ineg�vel que o conhecimento adquirido em vers�es anteriores do ASP.NET MVC ainda continuar� v�lido. H� mais de um ano a Microsoft vem trabalhando neste processo de reformulaç�o, sendo poss�vel pressupor que ainda em 2015 acontecer� o lançamento das novas vers�es j� estabilizadas do Visual Studio e da plataforma ASP.NET.