Tenho um projeto MVC e nele vou ter controles normais e controles fornecendo serviços via webservices (Controller
e ApiController
).
E não sei qual usar porque não sei qual é o melhor.
Stack Overflow em Português é um site de perguntas e respostas para programadores profissionais e entusiastas. Leva apenas um minuto para se inscrever.
Inscreva-se para participar desta comunidadeTenho um projeto MVC e nele vou ter controles normais e controles fornecendo serviços via webservices (Controller
e ApiController
).
E não sei qual usar porque não sei qual é o melhor.
Essa pergunta ficou datada, hoje nem dá pra questionar nada disso, quem incentivou a pessoa ficar na versão antiga induziu a pessoa a erro. Veja mais em O .NET Framework está morto?.
Se vai aprender agora, começar um projeto novo e não tem nada legado, aconselho usar o ASP.NET Core que é mais moderno. Esqueça estas classes do System.Web
, todo o modelo da tecnologia nova é mais adequada para o modelo web atual. A Microsoft aconselha fazer o mesmo e não evoluirá mais as versões antigas (ainda será suportado).
A versão legada é mais madura, claro, mas tem muita gente usando o Core sem problemas, até mesmo em produção. O resto é FUD. Avalie o que é melhor para você hoje e para o futuro.
Ainda que no momento desta resposta ele possa ter alguns pequenos problemas, estará 100% em breve, até porque a versão 1.0 final já está lançada. E faz tempo que a Microsoft parou de lançar as coisas repletas de problemas. Acompanhe o roadmap (o desenvolvimento da tecnologia levou 2 anos). Algumas pessoas tiveram problemas no passado. Mas estas coisas são transitórias. Fica aqui uma resposta que serve para daqui pra frente e não para o passado.
Nesta nova tecnologia não há distinção entre Controller
e ApiController
eliminando a confusão, só a primeira existe de forma mais flexível.
Ainda pode ver a classe na tecnologia mais nova e confirmar como é algo mais bem pensado e que há ganhos em começar por ele sempre que possível. Não vou entrar em detalhes das vantagens do ASP.NET Core porque não é o foco da pergunta. A desvantagem para quem não tem legado é transitória, e até questionável no momento atual. Cuidado com informações defasadas, é melhor confiar no que não é transitório.
Estas classes são abstratas, então a única forma de consumi-las é herdando delas. Ou você herda de uma ou de outra, dependendo de sua necessidade.
Lembrando que é possível criar controllers sem herdar destas classes, mas esta é a forma mais prática e comum.
Em casos mais complexos é possível herdar destas classes para uma outra classe abstrata sua que personaliza o controlador base para ser usado nos controladores concretos.
Claro que há projetos que valem a pena ficar na tecnologia mais antiga. Neste caso segue o motivo principal para escolher uma outra classe.
Segundo uma resposta no SOen com 193 votos positivos no momento que escrevo esta resposta, a Controller
é usada quando pretende gerar views e a ApiController
é usada quando só gerará uma resposta de dados serializados (JSON é o preferido) que não renderizará uma página.
Ainda que possa usar para alguma outra coisa, a ApiController
não foi feita para isto, a não ser, é claro, que os dados seja HTML para uma parte de uma página. Isto é reforçado pela página oficial da Microsoft. Assim como pode, até o ASP.Net MVC 5 não era ideal enviar dados para requisições diversas através da Controller
.
No ASP.Net antigo a ApiController
é usada pelo ASP.Net WebAPI para atender principalmente WebServices/RESTful API.
Exemplo usando o MVC terminando com a delegação para a visão concluir a ação:
public class MoviesController : Controller {
private MovieDBContext db = new MovieDBContext(); //pegar do model
// GET: /Movies/
public ActionResult Index() {
return View(db.Movies.ToList()); //note a delegação para a view
}
}
É possível ver o código fonte da classe abstrata.
Exemplo usando a WebAPI. Para fazer requisições aqui normalmente se usará AJAX ou alguma forma de requisição via HTTP em qualquer tipo de aplicação que deseje consumir seu webservice.
public class ProductsController : ApiController {
Product[] products = new Product[] {
new Product { Id = 1, Name = "Tomato Soup", Category = "Groceries", Price = 1 },
new Product { Id = 2, Name = "Yo-yo", Category = "Toys", Price = 3.75M },
new Product { Id = 3, Name = "Hammer", Category = "Hardware", Price = 16.99M }
};
public IEnumerable<Product> GetAllProducts() {
return products;
}
public IHttpActionResult GetProduct(int id) {
var product = products.FirstOrDefault((p) => p.Id == id);
if (product == null) {
return NotFound();
}
return Ok(product);
}
}
Coloquei no GitHub para referência futura.
Se estiver curioso de como é o código da classe abstrata, é possível ver seu fonte.
Não existe isso de "Qual é o melhor para usar?" Eles possuem finalidade diferente.
Se seu projeto for em Asp.NET MVC, não há necessidade de ApiController, da mesma forma que se for Web API, não há necessidade de ter MVC Controller.
Agora, se seu projeto usarem ambos, separe os dois. C#
não possui Herança múltipla, o que indica que seu Controller não "é para ser" os dois, tanto que suas finalidades são distintas.
Em resumo, Asp.Net MVC tem foco em retorno de Views
, em outras palavras, páginas para o Usuário, enquanto Web APItem foco em retorno de serviços REST, na maioria de seus casos, retornando JSON.
No Asp.NET Core isso mudou, e o mesmo controller pode retornar os dois. Porém, essa versão não está estável e está com alguns bugs, tanto que é utilizado somente por "entusiastas", e quem acompanha o Channel 9 da Microsoft sabe disso.
Qual a diferença entre
System.Web.Http
eSystem.Web.Mvc
?
Aqui estamos falando de namespaces, e que servem a propósitos diferentes.
A implementação de System.Web.Mvc
está aqui. A implementação de System.Web.Http
está aqui.
System.Web.Mvc
implementa, em grande parte, a arquitetura ASP.NET MVC, sendo o MVC5 a última versão deste padrão. Passa a ser descontinuada de novos lançamentos com o lançamento e estabilização do ASP.NET Core. Apenas bugs e algumas manutenções serão feitos, assim como no caso do Web Forms.
System.Web.Http
implementa, em grande parte, a arquitetura ASP.NET Web API, sendo a versão 2.2 a última deste padrão, também passando a ser descontinuada com o lançamento do ASP.NET Core, que tem por um dos objetivos unificar as arquiteturas.
Tenho um projeto MVC e nele vou ter controles normais e controles fornecendo serviços via webservices (
Controller
eApiController
).
Aqui temos alguns problemas. Web Services possuem seu próprio padrão de projeto (o ASP.NET Web Service, roteiro aqui). O que você quer fazer, pelo que eu entendi, é servir algum tipo de dado como um Web Service, mas usando ou um Controller MVC ou um Controller Web API.
E não sei qual usar porque não sei qual é o melhor.
Aqui vale a pena falar sobre as diferenças sobre o System.Web.Http.ApiController
e sobre o System.Web.Mvc.Controller
(que, acredito eu, seja afinal o objetivo da pergunta).
Antes, é importante dizer que ambos podem servir qualquer tipo de dados. A diferença é que o Controller
fará isso usando um ActionResult
(ou seja, uma classe abstrata que possui várias derivações, dependendo do que se quer servir), enquanto que o ApiController
usará um HttpResponseMessage
.
A implementação de Controller
sugere facilidades para trabalhar com HTML, JSON, requisições Ajax e tradicionais. Em resumo, os tradicionais sites de internet. Menos abrangente e mais especializado.
A implementação de ApiController
sugere facilidades para trabalhar com verbos HTTP (navegadores tradicionais normalmente implementam só GET
e POST
com alguns artifícios para implementar os demais), objetos serializados e arquitetura sem estados, ou seja, o uso de sessão é desestimulado (ainda que existam formas disso ser feito). Em resumo, feito para trabalhar com aplicativos de celular, integração com outros sites, repositório de informações e arquivos. Mais abrangente e menos especializado.
Considerando que a ideia é montar um serviço que funcione de forma semelhante a um Web Service, ApiController
é uma opção mais adequada (tanto para a Web API 2.2 quanto para o ASP.NET Core). Controller
também pode ser usado para produzir o mesmo resultado, mas exigirá um pouco mais de trabalho para compor e formatar o elemento serializado (como XML, JSON, YAML, BSON, etc.).
Ainda sobre Web API, a parte de Media Formatters pode ser bastante esclarecedora para sua implementação.