O web service REST do AdvPL não utiliza as seções HTTP e WebServices utilizadas para o configurar o modelo SOAP.
...
Observação |
---|
O protocoloco HTTP do REST não atende a outros tipos de requisições como o HTTP do SOAP (que também atende arquivos estáticos, APW e APL) |
...
Para habilitar o HTTP para REST criar a seção abaixo no appserver.ini:
[HTTPV11]
Enable=1 ; (Obrigatório) indica se o HTTP está habilitado
Sockets=HTTPREST ; (Obrigatório) seções com configuração de porta e URL (pelo menos uma seção)
...
Sockets=HTTPREST
Parametro | Descrição | Obrigatório |
---|---|---|
Enable | Indica se o HTTP esta habilitado | x |
Sockets | Seções com configuração de porta e URL (pelo menos uma seção) | x |
A chave Sockets referencia a(s) seção(ões) com a configuração de porta e URL que a mesma ira atender, permitindo que o Application Server seja configurado com mais de uma porta HTTP do REST:
Sockets=HTTPREST,HTTPREST2
...
...
Exemplo de configuração de uma seção Sockets:
[HTTPREST]
Port=8080 ; (Obrigatório) porta HTTP
IPsBind= ; (Opcional) indica os IPs que serão atendidos por essa porta, se não informado atenderá qualquer IP / DNS associado ao servidor
URIs=HTTPURI ; (Obrigatório)
SECURITY=1 ; (Obrigatório) indica se a autenticação de requisição esta habilitada
IPsBind=
URIs=HTTPURI
Security=1
Parametro | Descrição | Obrigatório |
---|---|---|
Port | Porta HTTP | x |
IPsBind | Indica os IPs que serão atendidos por essa porta, se não informado atenderá qualquer IP / DNS associado ao servidor | |
URIs | Seções com configuração de URL e ambiente (pelo menos uma seção) | x |
Security | Indica se a autenticação de requisição esta habilitada | x |
Observação |
---|
O HTTP do REST verifica existência do campo Authorization no HEADER da requisição (para OAUTH e BASIC), porém a autorização é realizada pelo framework do produto que esta utilizando o protocolo |
...
A chave URIs referencia a(s) seção(ões) com a configuração da URL que a porta irá atender, permite também que seja configurado com mais de uma URL:
URIs=HTTPURI,HTTPURI2
...
Exemplo de configuração de uma seção URIs:
[HTTPURI]
URL=/rest ; (Obrigatório) indica o endereço que será atendido, nesse exemplo
PrepareIn=
Instances=1,1
Parametro | Descrição | Obrigatório |
---|---|---|
URL | Indica o endereço que será atendido Nesse exemplo http://localhost:8080/rest |
...
x | ||
Preparein | Informações para preparação do ambiente das working threads | |
Instances | Configuração de inicialização de working threads | x |
Observaçoes |
---|
A preparação de ambiente da chave PrepareIn é realizada pelo framework do produto que esta utilizando o protocolo |
A chave Instances é configurada como no HTTP do SOAP, confira a documentação em Instances |