Servir o design como mock
Uma vez definidos os seus modelos e as suas rotas, o Restorm sabe servir o seu design como um verdadeiro servidor mock. Você aponta a sua aplicação (ou um cliente) para ele e testa a forma como ela consome a API — antes mesmo de o back-end existir.
Iniciar o servidor
Section titled “Iniciar o servidor”Na secção Servidor, ative Servir este design, escolha uma
porta e inicie a escuta. Pode adicionar uma latência simulada para
imitar uma rede real, e ativar o modo com estado: os POST / PUT /
DELETE modificam então um armazenamento em memória (reinicializado no reinício).
O servidor recusa-se a arrancar enquanto o design apresentar problemas de validação — corrija-os primeiro.
As respostas servidas provêm primeiro dos seus exemplos nomeados, depois de um
conjunto de dados gerado automaticamente. O servidor expõe também um
/swagger.json.
Um design, todos os protocolos
Section titled “Um design, todos os protocolos”É o cerne do modo mock: HTTP é sempre servido, e cada outro protocolo ativa-se com um simples interruptor Servir também esta projeção. O Restorm projeta automaticamente as suas rotas — segundo o seu método, o seu caminho e os seus modelos — em cada protocolo:
| Protocolo | Projeção |
|---|---|
| HTTP | As suas rotas REST, tal como definidas. |
| GraphQL | Consultas e mutações correspondentes. |
| SOAP | Operações e envelopes. |
| OData | Conjuntos de entidades pesquisáveis. |
| gRPC | Métodos e mensagens. |
Um painel Projeções mostra, para uma rota dada, a sua assinatura em cada protocolo servido — «a mesma operação, tal como cada protocolo a expõe».
Seguir e forçar as respostas
Section titled “Seguir e forçar as respostas”Durante a execução, um painel indica o endereço de escuta e o número de chamadas servidas. Pode forçar uma resposta (um estado, um corpo preciso) numa rota para reproduzir um caso particular, e depois parar o servidor quando tiver terminado.