Diferença entre ApiController e Controller no ASP.NET MVC

Venho brincando com o ASP.NET MVC 4 beta e agora vejo dois tipos de controladores: ApiControllere Controller.

Estou um pouco confuso em que situações posso escolher um controlador em particular.

Por exemplo: se eu quiser retornar uma visualização, devo usar ApiControllerou o comum Controller? Estou ciente de que a API da Web do WCF agora está integrada ao MVC.

Como agora podemos usar os dois controladores, alguém pode apontar em quais situações o controlador correspondente será direcionado.

Use o Controller para renderizar suas visualizações normais. A ação ApiController retorna apenas dados serializados e enviados ao cliente.

aqui está o link

Citar:

Nota Se você trabalhou com o ASP.NET MVC, já está familiarizado com os controladores. Eles funcionam da mesma forma na Web API, mas os controladores da Web API derivam da classe ApiController em vez da classe Controller. A primeira grande diferença que você notará é que as ações nos controladores de API da Web não retornam visualizações, eles retornam dados.

Os ApiControllers são especializados em retornar dados. Por exemplo, eles cuidam da serialização transparente dos dados no formato solicitado pelo cliente. Além disso, eles seguem um esquema de roteamento diferente por padrão (como em: mapear URLs para ações), fornecendo uma API REST-ful por convenção.

Você provavelmente poderia fazer qualquer coisa usando um Controller em vez de um ApiController com a codificação manual (?). No final, os dois controladores se baseiam na base do ASP.NET. Mas ter uma API REST-ful é um requisito tão comum hoje em dia que a WebAPI foi criada para simplificar a implementação de uma API desse tipo.

É bastante simples decidir entre os dois: se você estiver escrevendo um aplicativo Web / Internet / Intranet baseado em HTML - talvez com uma chamada AJAX ocasional retornando json aqui e ali - fique com o MVC / Controller. Se você deseja fornecer uma interface orientada a dados / REST-ful a um sistema, acesse WebAPI. É possível combinar ambos, é claro, ter um ApiController para atender chamadas AJAX a partir de uma página do MVC.

Para dar um exemplo do mundo real: atualmente, estou trabalhando com um sistema ERP que fornece uma API REST-cheia para suas entidades. Para essa API, o WebAPI seria um bom candidato. Ao mesmo tempo, o sistema ERP fornece um aplicativo Web altamente AJAX-ified que você pode usar para criar consultas para a API REST-ful. O aplicativo da Web em si pode ser implementado como um aplicativo MVC, fazendo uso da WebAPI para buscar metadados, etc.

Qual você prefere escrever e manter?

ASP.NET MVC

public class TweetsController : Controller {
  // GET: /Tweets/
  [HttpGet]
  public ActionResult Index() {
    return Json(Twitter.GetTweets(), JsonRequestBehavior.AllowGet);
  }
}

API da Web do ASP.NET

public class TweetsController : ApiController {
  // GET: /Api/Tweets/
  public List<Tweet> Get() {
    return Twitter.GetTweets();
  }
}

Adoro o fato de o MVC6 do ASP.NET Core mesclar os dois padrões em um, porque muitas vezes preciso oferecer suporte aos dois mundos. Embora seja verdade que você pode ajustar qualquer MVC padrão Controller(e / ou desenvolver suas próprias ActionResultclasses) para agir e se comportar como um ApiController, pode ser muito difícil de manter e testar: além disso, ter métodos de Controladores retornando ActionResultmisturados com outros retornar dados brutos / serializados / IHttpActionResultpode ser muito confuso do ponto de vista do desenvolvedor, principalmente se você não estiver trabalhando sozinho e precisar levar outros desenvolvedores a acelerar essa abordagem híbrida.

A melhor técnica que eu vim até agora para minimizar esse problema em aplicativos da Web não-essenciais do ASP.NET é importar (e configurar corretamente) o pacote da API da Web no aplicativo da Web baseado em MVC, para que eu possa ter o melhor de ambos mundos: Controllerspara Views, ApiControllerspara dados.

Para fazer isso, você precisa fazer o seguinte:

• Instale os seguintes pacotes de API da Web usando o NuGet: Microsoft.AspNet.WebApi.Coree Microsoft.AspNet.WebApi.WebHost.
• Adicione um ou mais ApiControllers à sua /Controllers/pasta.
• Adicione o seguinte arquivo WebApiConfig.cs à sua /App_Config/pasta:

using System.Web.Http;

public static class WebApiConfig
{
    public static void Register(HttpConfiguration config)
    {
        // Web API routes
        config.MapHttpAttributeRoutes();

        config.Routes.MapHttpRoute(
            name: "DefaultApi",
            routeTemplate: "api/{controller}/{id}",
            defaults: new { id = RouteParameter.Optional }
        );
    }
}

Por fim, você precisará registrar a classe acima na sua Inicialização classe ( Startup.csou Global.asax.cs, dependendo se você estiver usando o modelo de inicialização OWIN ou não).

Startup.cs

 public void Configuration(IAppBuilder app)
 {
    // Register Web API routing support before anything else
    GlobalConfiguration.Configure(WebApiConfig.Register);

    // The rest of your file goes there
    // ...
    AreaRegistration.RegisterAllAreas();
    FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters);
    RouteConfig.RegisterRoutes(RouteTable.Routes);
    BundleConfig.RegisterBundles(BundleTable.Bundles);

    ConfigureAuth(app);
    // ...
}

Global.asax.cs

protected void Application_Start()
{
    // Register Web API routing support before anything else
    GlobalConfiguration.Configure(WebApiConfig.Register);

    // The rest of your file goes there
    // ...
    AreaRegistration.RegisterAllAreas();
    FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters);
    RouteConfig.RegisterRoutes(RouteTable.Routes);
    BundleConfig.RegisterBundles(BundleTable.Bundles);
    // ...
}

Essa abordagem - junto com seus prós e contras - é explicada mais detalhadamente neste post que escrevi no meu blog.

Todo método na API da Web retornará dados (JSON) sem serialização.

No entanto, para retornar dados JSON nos controladores MVC, definiremos o tipo de resultado da ação retornado como JsonResult e chamaremos o método Json em nosso objeto para garantir que ele seja empacotado em JSON.

A principal diferença é: Web API é um serviço para qualquer cliente, qualquer dispositivo e o MVC Controller serve apenas a seu cliente. O mesmo porque é a plataforma MVC.

É bastante simples decidir entre os dois: se você estiver escrevendo um aplicativo Web / Internet / Intranet baseado em HTML - talvez com uma chamada AJAX ocasional retornando json aqui e ali - fique com o MVC / Controller. Se você deseja fornecer uma interface orientada a dados / REST-ful a um sistema, acesse WebAPI. É possível combinar ambos, é claro, ter um ApiController para atender chamadas AJAX a partir de uma página do MVC. Basicamente, o controlador é usado para mvc e o api-controller é usado para Rest-API. Você pode usar ambos no mesmo programa que sua necessidade