Histórico da Página
| Composition Setup |
|---|
import.css=/download/attachments/327912/newLayout.css |
...
| Pagetitle |
|---|
...
|
...
|
Permite
...
emular um Client HTTP através de uma função
| Inclusão de trecho | ||||||
|---|---|---|---|---|---|---|
|
Essa função viabiliza a passagem de parâmetros adicionais via URL, aguardando por um tempo determinado (time-out)
...
pela
...
resposta
...
do
...
servidor
...
solicitado.
Sintaxe
| Bloco de código |
|---|
HTTPQuote( < |
...
cUrl >, < |
...
cMethod >, [ cGETParms ], [ cPOSTParms ], [ nTimeOut ], [ aHeadStr ], [ @cHeaderRet ] ) |
...
Parâmetros
...
| Nome | Tipo | Descrição | Obrigatório |
|---|
...
| cUrl |
...
| caractere |
...
| Corresponde ao endereço HTTP, juntamente com a pasta e o documento solicitados. | X |
| cMethod |
...
| caractere | Define o HTTP Method que será utilizado, permitindo outros além de POST/GET. | X |
| cGETParms |
...
| caractere |
...
| Corresponde ao endereço HTTP, juntamente com a pasta e o documento solicitados. | |
| cPOSTParms |
...
| caractere |
...
| Corresponde à StringList de parâmetros a serem enviados ao servidor HTTP através do pacote HTTP. Caso não especificado, este parâmetro é considerado vazio ("") | |
| nTimeOut |
...
| numérico |
...
| Especificamos o tempo em segundos (máximo) de inatividade permitido durante a recepção do documento. Caso não especificado, o valor padrão assumido é 120 segundos (2 minutos). | |
| aHeadStr |
...
| array | Permite |
...
| especificar um array com strings a serem acrescentadas ao Header da requisição HTTP a ser realizada. | |
| cHeaderRet |
...
| caractere | Retorna através de referência o header de resposta HTTP enviado pelo servidor requisitado. Variável deve ser declarada antes da chamada da função. |
...
Retorno
| Nome | Tipo | Descrição |
|---|---|---|
| cResponse | caractere | Retorna a string |
...
| correspondendo ao documento solicitado. |
Observações
- Na passagem de parâmetros GET e POST, deve-se observar ao formato da string a ser passada como parâmetros, pois a mesma segue o formato URI (Uniform Resource Identifiers) : Query Component.
- Caso não seja retornado o documento antes do término do Time-out especificado na chamada da função
...
- , ou caso não seja possível localizar o servidor, seja por falha de resolução de DNS
...
- ou por erro de sintaxe ao especificar a URL, a função retornará Nulo (NIL).
- Caso não seja possível o acesso ao documento, como por exemplo o documento não exista, será retornado uma string
...
- HTML com a mensagem de erro
...
- enviada pelo servidor correspondente.
- Quando utilizamos a função HTTPQuote(), podemos especificar um Content-Type diferenciado para o conteúdo postado. Caso não seja especificado um Content-Type, alguns servidores tratam a informação postada como sendo um dado do tipo 'application/x-www-form-url', seria o equivalente a um formulário HTML postado via Browser
...
- . Outros servidores poderão não reconhecer tal informação postada dessa forma. Para especificar que o conteúdo postado deve ser tratado como um POST de formulário HTTP, devemos passar no parâmetro aHeadStr, um elemento contendo 'Content-Type: application/x-www-form-url'.
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas