Criando Web Api com ASP.NET Core – Parte 1

Daremos inicio a série de artigos Criando Web Api com ASP.NET Core. Antes disso, o que você precisa saber sobre o ASP.NET Core:

  • Nova geração do ASP.NET
  • Desenvolvido pela Microsoft e pela Comunidade
  • Open-source
  • Cross-Plataform
  • Modular

Para saber mais, acesse o site da fundação .NET Foundation

Para iniciar o projeto é necessário ter instalado o .NET Core e o Visual Studio 2015 com Update 3 ou mais recente. Caso não tenha instalado, leia o artigo Instalando o .NET Core será necessário baixar e instalar para prosseguir.

Abra o seu Visual Studio e crie um novo projeto. Clique no menu File > New > Project e escolha a opção Visual C# > .NET Core > ASP.NET Core Web Application (.NET Core) e defina um nome para o seu projeto. No meu caso será AspNetCoreWebApi:

Na próxima janela, defina o template para o tipo Empty.

Adicione as seguintes referências clicando com botão direito na Solutions e abrindo Manage Nuget Packages:

  • Newtonsoft.Json
  • Microsoft.AspNetCore.StaticFiles
  • Microsoft.AspNetCore.Mvc.Core
  • Microsoft.AspNetCore.Mvc

Outras referências dependentes serão inclusas automaticamente.

Agora iremos configurar a API alterando o Startup.cs.


public void ConfigureServices(IServiceCollection services)
{
// Adiciona o MVC a coleção de serviços
services.AddMvc();
}

public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
{
loggerFactory.AddConsole();

if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}

// Parte importante que configura o MVC
app.UseMvc();
}

Feito a configuração, já é possível adicionar um Controller e os métodos necessários. Na solutions, inclua uma nova pasta chamada Controllers e dentro dela iremos adicionar um novo controller com o nome de DefaultController.

Com a classe DefaultController criada, é necessário fazer com que ele herde da classe Controller. Atribua o using de Microsoft.AspNetCore.Mvc e defina a herança da classe Controller:


using Microsoft.AspNetCore.Mvc;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace AspNetCoreWebApiEmpty.Controllers
{
   public class DefaultController : Controller
   {

   }
}

Configure a rota da nossa web api:


[Route("api/[controller]")]

Criaremos dois métodos para o exemplo, um irá ser para operação GET e outro para operação POST e já definiremos a rota pela qual irá responder:


[HttpGet, Route("get")]
public IActionResult Get()
{
	var model_exemplo = new
	{
		success = true
	};

	return Ok(model_exemplo);
}

[HttpPost, Route("post")]
public IActionResult Post([FromBody] object valor)
{
	var model_exemplo = new
	{
		success = true,
		value = valor
	};

	return Ok(model_exemplo);
}

Ao executar, nossa api irá responder pelos seguintes link:

GET: http://[servidor]:[porta]/api/default/get

POST: http://[servidor]:[porta]/api/default/post

Nesse artigo você pode ter uma breve introdução sobre o ASP.NET Core e como cria-lo de forma simples.

Faça download do projeto: Criando Web Api com ASP.NET Core - Parte 1.

Abraço e até os próximos artigos!

Deixe uma resposta

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *