Post - Método

Descripción general

 

 

Tarea

El método Post inicia el método HTTP para enviar los datos que se procesarán al recurso especificado.

Descripción funcional

El encabezado predeterminado de la petición HTTP se crea mediante las entradas i_sHost (obligatoria) y i_sResource. Si es necesario añadir otra información al encabezado, esta deberá transmitirse a través de la entrada i_anyAdditionalHeader. Los datos asignados a esta entrada no se comprueban. En la entrada i_anyResponseBuffer, deberá asignar un búfer con un tamaño suficiente para almacenar la respuesta entera que se reciba del servidor.

Las entradas i_anyContent e i_udiContentLength especifican el contenido que se enviará.

El valor de retorno del método es de tipo BOOL e indica si la ejecución del método fue correcta (TRUE) o no (FALSE). Si el valor de retorno es FALSE, evalúe los resultados de diagnóstico del método. Los errores que indiquen estos resultados no necesitan un restablecimiento. La propiedad State debe utilizarse para obtener el estado de procesamiento.

Solo se permitirá invocar el método Post en el estado Connected.

Ejemplo de implementación

En el siguiente ejemplo, se muestra el aspecto de una petición HTTP tras la llamada del método Post.

Llamada de método:

sAdditionalHeader := 'Content-Type: application/json$r$nConnection: Keep-Alive';
sContent := 'This is the content!';

fbHTTP.Post(    i_sRessource:= 'example',
                i_sHost:= 'se.com',
                i_anyAdditionalHeader:= sAdditionalHeader,
                i_anyContent:= sContent,
                i_udiContentLength:= 20,
                i_anyResponseBuffer:= sResponse);

Petición HTTP resultante:

POST /example HTTP/1.1
Host: se.com
Content-Length: 20
Content-Type: application/json
Connection: Keep-Alive

This is the content!

Transición de estado del cliente

NOTA: Si se realizan modificaciones online mientras el bloque de funciones procesa una petición Post, la ejecución se cancelará para evitar una posible infracción de acceso provocada por el procesamiento de direcciones de puntero erróneas.

Interfaz