VResponse

VResponse es un objeto javascript que representa una respuesta para una petición realizada a través de web a Velneo vModApache.

theResponse se crea automáticamente para cada petición realizada, y permite acceder a la respuesta para definirla.

Con ayuda de la clase VRequest, podremos obtener la información de la petición.

De esta forma podemos gestionar de forma dinámica las peticiones web en un servidor Apache con Velneo vModApache.

Indice de funciones

De cabecera

String header( String szHeader )

Array headerKeys()

void setHeader( String szHeader, String szValue )

De contenido

String contentType()

void setContentType( String szContentType )

De cuerpo

String body()

VByteArray rawBody()

void setBody( String szBody )

void setRawBody( VByteArray body )

De estado

void setStatus( Number nStatus )

Number status()

Documentación de funciones

Funciones de cabecera

Devuelve el valor de una cabecera cuyo nombre indicamos como parámetro.

Parámetros:

  • szHeader: cadena con el nombre de la cabecera.

Array headerKeys()

Devuelve un array de cadenas con el nombre de las cabeceras obtenidas de la respuesta.

void setHeader( String szHeader, String szValue )

Establece un valor para la cabecera que indicamos como parámetro.

Parámetros:

  • szHeader: cadena con el nombre de la cabecera cuyo valor vamos a establecer.

  • szValor: cadena con el valor para la cabecera.

Funciones de contenido

String contentType()

Devuelve tipo de contenido de la respuesta.

void setContentType( String szContentType )

Establece para la respuesta el tipo de contenido que indicamos como parámetro.

Parámetros:

  • szContentType: cadena con el tipo de parámetro que definimos para la respuesta.

Funciones de cuerpo

String body()

Devuelve el contenido del cuerpo de la respuesta.

VByteArray rawBody()

Devuelve el contenido del cuerpo en formato binario, es decir, un VByteArray.

void setBody( String szBody )

Establece el cuerpo de la respuesta con la cadena que indicamos como parámetro.

Parámetros:

  • szBody: cadena para definir el contenido del cuerpo de la respuesta.

void setRawBody( VByteArray body )

Establece el cuerpo de la respuesta con contenido del objeto de la clase VByteArray que indicamos como parámetro.

Parámetros:

  • body: objeto de la clase VByteArray que incluye el binario que queremos establecer como cuerpo del envío.

Funciones de estado

void setStatus( Number nStatus )

Establece el estado de la respuesta con el valor que indicamos como parámetro.

Parámetros:

  • nStatus: entero que define el estado de la respuesta.

Cuando se le pasa a Apache un status distinto del 200 es Apache quien decide qué mensaje devolver. En el enlace siguiente encontrarás los códigos de estado y lo que Apache devuelve:

https://ci.apache.org/projects/httpd/trunk/doxygen/group__HTTP__Status.html

Si quieres configurar respuestas personalizadas, además de pasar el status, hay que configurarlo también en Apache, según se indica en el siguiente enlace:

https://httpd.apache.org/docs/2.4/es/custom-error.html

Number status()

Devuelve el valor del estado de la respuesta.

Ejemplo

Ejemplo de manejo de binarios

// Creamos el objeto de la clase VByteArray para recibir el cuerpo binario
var baBody= new VByteArray;

// Obtenemos el cuerpo binario
baBody = theRequest.rawBody();

// Procesamos lo obtenido
var length = baBody.length;
var firstChar = baBody[0];

Última actualización