HTTP SET OPTION
HTTP SET OPTION ( opção ; valor )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| opção | Integer | → | Código da opção a definir |
| valor | Integer | → | Valor da opção |
Compatibilidade
Esse comando é mantido apenas por motivos de compatibilidade. Agora é recomendável usar 4D.HTTPRequest class.
Descrição
O comando HTTP SET OPTION permite definir diferentes opções utilizadas durante a próxima solicitação disparada pelos comandos HTTP Get ou HTTP Request. Você pode chamar este comando quantas vezes como opções a definir.
Nota: as opções definidas são locais ao processo atual. Para componentes, são locais ao componente em execução.
Passe no parâmetro opção o número da opção a definir e no parâmetro valor o novo valor desta opção. Pode utilizar para o parâmetro opção uma das seguintes constantes, que se encontram no tema HTTP Client:
| Constante | Tipo | Valor | Comentário |
|---|---|---|---|
| HTTP client log | Inteiro longo | 7 | value = uma das constantes abaixo: HTTP disable log: HTTP client debug log é desativado (padrão normal) HTTP enable log with all body parts: HTTP client debug log é ativado com partes do corpo em resposta e petição HTTP enable log with request body: HTTP client debug log é ativado com partes do corpo apenas por petição HTTP enable log with response body: HTTP client debug log é ativado com partes do corpo apenas por resposta HTTP enable log without body: HTTP client debug log é ativado sem partes do corpo (tamanho do corpo é fornecido neste caso) Permite obter ou estabelecer o estado arquivo de histórico da petição do cliente HTTP. Quando ativado, este arquivo chamado "4DHTTPClientLog_nn.txt", é armazenado na pasta "Logs" da aplicação (nn é o número de arquivo). É útil para depurar problemas com petições de cliente HTTP. Registra cada petição em modo raw. Petições inteiras, incluindo cabeçalhos, são armazenadas: partes do corpo também podem ser registradas, para saber mais veja Description of log files. |
| HTTP compression | Inteiro longo | 6 | valor = 0 (não comprimir) ou 1 (comprimir). Por defeito: 0 Esta opção ativa ou desativa o mecanismo de compreensão das petições entre o cliente e o servidor, para acelerar os intercâmbios. Quando este mecanismo está ativo, o cliente HTTP utiliza a compreensão deflate ou GZIP em função da resposta do servidor. |
| HTTP display auth dial | Inteiro longo | 4 | valor = 0 (não mostrar o diálogo) ou 1 (mostrar o diálogo). Por defeito: 0 Esta opção controla a visualização da caixa de diálogo de autenticação ao executar o comando HTTP Get ou HTTP Request. Por defeito, este comando não provoca a visualização da caixa de diálogo, normalmente deve utilizar o comando HTTP AUTHENTICATE. Entretanto, se deseja que apareça uma caixa de diálogo de autenticação do usuário para que introduza seu nome de usuário e senha, passe 1 em valor. A caixa de diálogo aparece somente se a solicitação requer autenticação. |
| HTTP follow redirect | Inteiro longo | 2 | valor = 0 (não aceita redirecionamentos) o 1 (aceita redirecionamentos). Valor por defeito = 2 |
| HTTP max redirect | Inteiro longo | 3 | valor = número máximo de redirecionamentos aceitos Valor por defeito = 2 |
| HTTP reset auth settings | Inteiro longo | 5 | valor = 0 (não apagar a informação) ou 1 (apagar). Por defeito: 0 Esta opção permite indicar a 4D memorizar a informação de autenticação do usuário (nome de usuário, senha, método, etc.) Com a finalidade de voltar a usar-los mais a frente. Por defeito, esta informação é apagada depois de cada execução do comando HTTP Get ou HTTP Request. Passe 0 em valor para memorizar-los e para apagar-los. Tenha em conta que quando passa 0, a informação é conservada durante a seção, mas não é guardada. |
| HTTP timeout | Inteiro longo | 1 | valor = timeout da solicitação do cliente, expressada em segundos. O time out é o tempo de espera do cliente HTTP no caso de não haver resposta por parte do servidor. Ao final deste período, o cliente fecha a seção, e o pedido é perdido. Por defeito, este tempo é de 120 segundos. Pode ser mudado em função de características específicas (estado da rede, características da aplicação, etc). |
Não importa a ordem das opções de chamada. Se a mesma opção é definida mais de uma vez, apenas uma é considera o valor da última chamada.