Júnior Oliveira

C Sharp; Delphi; ASP .NET; PHP; Javascript;

Introdução a Nancy

08 Nov 2015 csharp, nancy

Olá pessoal, hoje eu vou falar um pouco sobre Nancy.

O que é?

É um framework leve e simples para construção serviços HTTP usando tecnologia .Net e Mono, e fornece uma Domain Specific Language (DSL) para devolver uma resposta de forma simples.
Foi projetada para rodar em qualquer lugar, já que ela possui seus próprios objetos de solicitação e resposta.
Um dos conceitos fundamentais em Nancy são os hosts. Um host atua como um adaptador para um ambiente de hospedagem, permitindo assim que ela possa ser executada com as tecnologias existentes, como ASP.NET, WCF e Owin, ou integrado em qualquer aplicação.
Nancy é um projeto open source, hospedado no GitHub e está licenciado sob a MIT license.

Como instalar?

Você pode instalar via NuGet, segue a lista dos pacotes oficiais da Nancy.
Se você vai usar sobre ASP.NET por exemplo, você pode executar o comando abaixo no Package Manager Console do Visual Studio.

Install-Package Nancy.Hosting.Aspnet

Qual problema resolve?

  • Não precisa de muitas configurações, ela já vem com algumas definidas.
  • Para adicionar um novo módulo, geralmente é só implementar uma interface e ela já injeta para você via reflection.
  • Existem muitos módulos separados já criados, por exemplo, para trocar o IoC padrão é só instalar o novo e configurar no Boostrapper.

Com Nancy você precisa se preocupar mais em criar seu aplicativo do que ficar criando código de configuração.

Alguns exemplos

Agora vamos criar nosso primeiro exemplo.
No Visual Studio na tela de New Project, escolha a versão .NET Framework 4.5, depois crie um projeto ASP.NET Empty Web Application.
No Package Manager Console, rode o comando Install-Package Nancy.Hosting.Aspnet.
Agora crie uma classe com o código abaixo.

1 public class HomeModule : NancyModule
2 {
3     public HomeModule()
4     {
5         Get["/"] = _ => "I'm working...";
6     }
7 }

Agora se você rodar a aplicação irá imprimir no navegador.

I'm working...

Para receber uma informação passada na Query String é bem simples segue um exemplo abaixo.

 1 public class AccountsModule : NancyModule
 2 {
 3     public AccountsModule()
 4         : base("accounts")
 5     {
 6         Get["/{id}"] = parameters => GetById(parameters.id);
 7     }
 8 
 9     private Response GetById(int id)
10     {
11         var response = new
12         {
13             id,
14             name = "Júnior"
15         };
16 
17         return Response.AsJson(response);
18     }
19 }

Se você for ao navegador e digitar /accounts/25 ele irá imprimir o json abaixo.

{
  id: 25,
  name: "Júnior"
}

Recebendo os dados de uma requisição POST.
Note no código que eu usei o código this.Bind() para fazer o de para dos dados enviados para a minha classe AccountModel.
Depois eu apenas gerei um Id randômico e respondi o id fake gerado.

 1 public class AccountsModule : NancyModule
 2 {
 3     public AccountsModule()
 4         : base("accounts")
 5     {
 6         Get["/{id}"] = parameters => GetById(parameters.id);
 7         Post["/"] = _ => Create(this.Bind<AccountModel>());
 8     }
 9 
10     private Response GetById(int id)
11     {
12         var response = new
13         {
14             id,
15             name = "Júnior"
16         };
17 
18         return Response.AsJson(response);
19     }
20 
21     private Response Create(AccountModel model)
22     {
23         model.Id = new Random().Next(1, 100);
24 
25         var response = new
26         {
27             id = model.Id
28         };
29 
30         return Response.AsJson(response, HttpStatusCode.Created);
31     }
32 }
33 
34 public class AccountModel
35 {
36     public int Id { get; set; }
37 }

Devolvendo uma página HTML.
Para devolver uma página HTML, você precisa criar na raiz do projeto uma pasta chamada Views, e dentro dela, uma pasta com o nome igual a da sua rota.
No caso eu vou criar um módulo chamado DocModule e uma rota para doc, logo dentro da pasta Views eu vou criar uma pasta Doc e colocar o meu arquivo HTML lá dentro.
Abaixo o código para devolver o arquivo HTML para o navegador, note que o nome do arquivo que eu estou devolvendo é index.html, sendo assim, o nome do arquivo que eu vou criar precisa ser index.html também.

1 public class DocModules : NancyModule
2 {
3     public DocModules()
4         : base("doc")
5     {
6         Get["/"] = _ => View["index.html"];
7     }
8 }

Obrigado pela visita e até a próxima.