Invocação de Web API em DDD

using System.Threading.Tasks;

using WebApiClient.Poc.Core.Interfaces;
using WebApiClient.Poc.Core.Entities;
using WebApiClient.PoC.HttpClientServices.Inventory;
using WebApiClient.PoC.HttpClientServices;

namespace WebApiClient.Poc.Console
{
    class Program
    {
        static void Main(string[] args)
        {
            RunAsync("19072000408").GetAwaiter().GetResult();
        }

        private static async Task RunAsync(string authorCode)
        {
            IAuthorInventoryService _inventoryService = new AuthorInventoryService(new HttpClientWrapper<Author>());
            await _inventoryService.GetInventoryAsync(authorCode);
        }
    }
}

Pressupostos

Adição de documentação XML ao controller

private string[] lista
        {
            get
            {
                if (System.Web.HttpContext.Current.Application["lista"] == null)
                {
                    System.Web.HttpContext.Current.Application["lista"] = new string[] { "value1", "value2" };
                }
                return
                    (string[])System.Web.HttpContext.Current.Application["lista"];
            }
        }

        /// <summary>
        /// Retrieves the list of values
        /// </summary>
        /// <returns></returns>
        public IEnumerable<string> Get()
        {
            return lista;
        }
        /// <summary>
        /// Retrieves one value from the list of values
        /// </summary>
        /// <param name="id">The id of the item to be retrieved</param>
        /// <returns></returns>
        public string Get(int id)
        {
            return lista[id];
        }
        /// <summary>
        /// Insert a new value in the list
        /// </summary>
        /// <param name="value">New value to be inserted</param>
        public void Post([FromBody]string value)
        {
        }
        /// <summary>
        /// Change a single value in the list
        /// </summary>
        /// <param name="id">The id of the value to be changed</param>
        /// <param name="value">The new value</param>
        public void Put(int id, [FromBody]string value)
        {
            lista[id] = value;
        }
        /// <summary>
        /// Delete an item from the list
        /// </summary>
        /// <param name="id">id of the item to be deleted</param>
        public void Delete(int id)
        {

        }

<url base>/api/values

["value1","value2"]

Integração do Swagger no projecto

PM> Install-Package Swashbuckle.Net45 -Version 5.2.1

Configuração da documentação XML

Configuração do SwashBuckle

c.IncludeXmlComments(GetXmlCommentsPath());

protected static string GetXmlCommentsPath()
          {
              return System.String.Format(@"{0}\bin\myWebApi.xml", 
                  System.AppDomain.CurrentDomain.BaseDirectory);
          }

Visualização da página de documentação Swagger

<url base>/Swagger/ui/index

Lista de operações da classe ValueController.cs

Especificação da interface da acção Get da API REST

Bootstrap Slider

1. PostgreSQL on Linux.
2. Ruby and Rails.
3. JavaScript, HTML5, CSS, PHP and Python.
4. RESTful Implementations.
5. Multi-tenancy by design, reducing infrastructure.
6. 3rd Party Cost of Goods.
7. Encryption front and back, to meet NIST and DOD FIPS 140-2 at onset.
8. 3rd Party Cryptographic Module Validation Program (CMVP) layer
9. Open Platform, supporting adaptive design, allowing for zero footprint.

1. Cloud Pub/Sub - evento Pub/Sub assíncrono
2. Cloud Storage - notificações de alterações de um objecto
3. HTTP Invocation - invocação síncrona por HTTP
4. Debug/Direct Invocation - utilização da CLI Command Line Interface para desenvolver/depurar as Cloud Functions

The function can access any other cloud resources that have appropriate Node (JavaScript) client libraries or RESTful APIs. If you use the gcloud-node client libraries you're automatically authenticated with the default project credentials, so you don't have to worry about generating or storing auth keys etc.
The function has full access to the internet so you can call out to any 3rd party API, however you'll have to maintain your own auth keys etc for these external services.

fonte: strongloop.com

var http = require('http');
http.createServer(function (req, res) {
  res.writeHead(200, {'Content-Type': 'text/plain'});
  res.end('Estou ao serviço\n');
}).listen(1337, '127.0.0.1');
console.log('Server running at http://127.0.0.1:1337/');

Arquitectura REST

Desenvolvimento MEAN Stack

As principais razões para escolher Node.js para API REST

1. A framework Node.js disponibiliza uma série de módulos para a criação de qualquer tipo de API REST de forma efectiva. A arquitectura orientada a eventos e a API I/O não-bloqueante são eficazes o suficiente para construir aplicações rápidas e escaláveis.
2. O NPM (Node Package Manager) é o gestor de módulos do Node.js através do qual são instalados pacotes Node.js a partir da internet e geridas as dependências de forma automática. Está para o Node.js como o Nuget está para o .Net. O sítio web npm.org apresenta as bibliotecas disponíveis. Esta gestão é feita a partir de uma ferramenta CLI (Command Line Interface).
3. Por forma a munir o Node.js duma estrutura HTTP para programar a API REST há que instalar o módulo Express executando o comando
   

   npm install express

   
   a partir do directório raíz do Node.js com privilégios de administração.
4. O módulo Mongoose tem a função de um ORM (Object Relational Mapper) à semelhança da Entity Framework, apesar das bases de dados NoSQL não requererem qualquer esquema. Trata-se de uma ferramenta de modulação de objectos MongoDB desenhada para ambientes assíncronos que faz a ligação entre o MongoDB e o Node.js. Comando npm:

   npm install mongoose

5. O Node.js integra autenticação baseada em tokens (Token Based Authentication) na API REST que, primeiro autentica e autoriza os utlizadores para, então, lhes dar acesso às funcionalidades da aplicação web. Este processo de confirmação de utilizadores garante que a aplicação é segura.
6. Antes de usar a API na aplicação cliente, o serviço RESTful pode ser testado usando cURL. Trata-se de uma ferramenta e biblioteca de linha de comando de código aberto para a transferência de dados por URL. Pode até emular um navegador: Scripting HTTP Requests Using Curl.

• Instalação de Node.js e gestão de módulos
• Instalação de MongoDB e utilização da shell
• Construção de um sítio web com Node.js
• Outra aplicação de Node.js