Pronto para desenvolver seu primeiro servidor LightREST?
Vamos começar!
Crie um novo projeto WinDev
Crie um novo projeto no WinDev (versões 25 e superiores).
Importe o componente externo
No Explorador do projeto, clique com o botão direito em "Componentes Externos" e selecione "Importar um componente externo a partir de um arquivo".
Selecione o arquivo LightREST.wdi
Selecione o arquivo LightREST.wdi (no local onde foi descompactado).
Confirme nas diversas telas de confirmação.
Verifique o componente importado
Expanda o elemento "Componente LightREST" no Explorador do projeto, o conteúdo deve aparecer:
Adicione o código de inicialização
No código de abertura do projeto, copie e cole este código que:
- Cria uma rota REST com a URL /ping e o método GET
- Inicia o servidor REST na porta 9000
- Implementa uma função pi_Ping() que vai gerar a resposta (nota: usamos aqui um procedimento interno por conveniência; em um projeto real, seria preferível uma coleção de procedimentos contendo as funções REST)
bStartOK é booleano
cErrMess é cadeia
oServer é lrServer
//Criação da rota /ping com o método REST GET
oServer:AddRoute("/ping", lrServer::MethodGET, pi_Ping)
//Determinação da interface e da porta de escuta
oServer:IPAndPort = "0.0.0.0:9000"
//Ativação do monitoramento: fornecerá os tempos de execução nos HEADERS do objeto lrResponse
oServer:Monitoring = Verdadeiro
ToastExibe("Iniciando o servidor LightREST")
//Vamos lá
(bStartOK, cErrMess) = oServer:Start()
SE NÃO bStartOK ENTÃO
Erro(cErrMess)
RETORNA
FIM
Info("Servidor LightREST iniciado.", "Clique em OK fechará o servidor.")
// Procedimento REST para a rota /ping
PROCEDIMENTO INTERNA pi_Ping(stRequest é lrRequest <útil>) : lrResponse
oResponse é lrResponse
oResponse:Body = "Pong "+HoraSis()
oResponse:ContentType = lrResponse::ContentTXT
oResponse:Status = lrResponse::StatusOK
RETORNA oResponse
FIM
Inicie o projeto WinDev
Inicie o projeto WinDev (na primeira execução, é possível que o Windows peça para confirmar a abertura da porta pela aplicação).
Teste seu servidor
Em um navegador de internet, acesse a URL:
http://127.0.0.1:9000/ping
O servidor LightREST deverá responder "Pong" + a hora do sistema:
Pong 03075396
Pronto!
Seu primeiro servidor LightREST está funcionando!
Para ir mais longe, consulte a documentação e estude o projeto WinDev® LightREST Tuto.
Vantagens da combinação WinDev e Web Services REST
O AGL WinDev oferece uma abordagem simplificada do desenvolvimento de software, permitindo aos desenvolvedores criar aplicações robustas e diversificadas com uma facilidade notável. Ao associar as funcionalidades do WinDev aos Web Services REST, podemos destacar várias vantagens:
Vantagens da utilização do AGL WinDev:
Produtividade aumentada
WinDev propõe uma interface intuitiva, funcionalidades de arrastar e soltar e uma biblioteca de componentes prontos para uso, o que acelera o processo de desenvolvimento e melhora a produtividade dos desenvolvedores.
Multiplataforma
Esta AGL permite o desenvolvimento de aplicações para diversos sistemas operacionais, oferecendo assim um alcance amplo para atingir um público variado.
Gerenciamento integrado de banco de dados
WinDev integra ferramentas para o gerenciamento de bancos de dados, simplificando assim a manipulação dos dados dentro das aplicações sem precisar recorrer a ferramentas externas.
Conectividade avançada
As capacidades de conectividade do WinDev permitem uma integração fácil com diversas fontes de dados externas.
Vantagens dos Web Services REST:
Interoperabilidade
Os Web Services REST utilizam protocolos padrão como HTTP, JSON e XML, favorecendo assim sua compatibilidade com múltiplas plataformas e linguagens.
Simplicidade e flexibilidade
Sua arquitetura simples baseada em requisições HTTP comuns (GET, POST, PUT, DELETE) os torna fáceis de entender, usar e implementar. Além disso, oferecem flexibilidade na manipulação dos dados.
Escalabilidade
Os Web Services REST são projetados para serem escaláveis, o que significa que podem facilmente se adaptar a cargas de trabalho maiores sem comprometer o desempenho.