XMLHttpRequest

XMLHttpRequest es un objeto Javascript que incorpora la misma funcionalidad que el objeto originalmente desarrollado por Microsoft. Nos da una forma sencilla de obtener datos de una url. Aunque el nombre pueda despistar, XMLHttpRequest puede ser usado para obtener cualquier tipo de dato, no sólo XML.
Requiere importarla previamente a su uso:
importClass ( "XMLHttpRequest" );
Si la clase la vamos a usar en un script de QML el nombre del objeto ha de ser VXMLHttpRequest.
Para el acceso mediante proxy, esta clase accederá a Internet con la configuración Proxy del sistema.
También podremos establecer una configuración diferente en caso de que lo necesitemos. En este caso, debemos configurar en el registro correspondiente a la rama del cliente una rama proxy, con los siguientes valores de cadena:
enabled: true para habilitar, false para deshabilitar la configuraicón.
hostName: Dominio o ip del proxy.
port: Puerto del proxy.
userName: Usuario del proxy.
password: Contraseña del proxy.
type: 0 = socket5, 1 = http
En Windows, por ejemplo en:
HKEY_CURRENT_USER\Software\Velneo\vClient\proxy
En Linux en:
/home/usuario/.config/Velneo/vClient.conf
En Mac en:
~/Library/Preferences/com.velneo.vclient.plist
Indice de propiedades​
Number errorCode​
Number readyState​
Variant response​
String responseText​
String responseType​
Number status​
String statusText​
Number timeout​
Indice de funciones
Constructor
XMLHttpRequest XMLHttpRequest()
Generales
void abort()
String getAllResponseHeaders()
String getResponseHeader( String name )
void open( String method, String url, bool async = true, String username = "", String password = "" )
void send( String data )
void send( VByteArray data )
void send()
void setRequestHeader( String name, String value )
bool setClientCertificate( String certificado, String key[, String password] )
Auxiliares
void processEvents()
void waitForRequestComplete()
Señales
onreadystatechange
ontimeout
Documentación de propiedades
errorCode
Retorna un entero indicando el error que se ha producido.
0 = No se ha producido ningún error.
1 = El servidor remoto rechazó la conexión (el servidor no está aceptando peticiones).
2 = El servidor remoto ha cerrado la conexión, antes de que la petición fuera recibida y procesada.
3 = El nombre del host remoto no se ha encontrado (hostname inválido).
4 = Ha expirado el tiempo máximo de conexión al servidor remoto (timeout).
5 = La operación se ha cancelado por una llamada a abort() o close() antes de que acabara.
6 = La comunicación SSL/TLS ha fallado y la comunicación encriptada no se puede establecer.
7 = La conexión fue interrumpida debido a una desconexión de la red, sin embargo el sistema se ha iniciado.
201 = El acceso al contenido remoto fue denegado (similar al error HTTP 401).
202 = La operación solicitada sobre el contenido remoto no está permitida.
203 = El contenido remoto no fue encontrado en el servidor (similar al error HTTP 404).
204 = El servidor remoto solicita autenticación para servir el contenido, pero las credenciales suministras no son correctas.
301 = No se puede procesar la petición porque el protocolo es desconocido.
302 = La operación solicitada es inválida para este protocolo.
99 = Un error desconocido relacionado con la red ha sido detectado.
299 = Un error desconocido relacionado con el contenido remoto ha sido detectado.
399 = Un error ha sido detectado en el protocolo (error de parseo, respuesta inválida o no esperada, etc).
readyState
Retorna un entero indicando el estado de la petición.
0 = UNSENT Todavía no se ha llamado a open().
1 = OPENED send() ha sido llamada.
2 = HEADERS_RECEIVED send() ha sido llamada, y tanto las cabeceras como el estado están disponibles.
3 = LOADING Descargando. La propiedad responseText contiene datos parciales
4 = DONE La operación se ha completado.
response
Retorna un arraybuffer, un objeto Javascript o una cadena, dependiendo del valor de responseType.
El tipo arraybuffer se trata como un VByteArray.
Contiene el cuerpo completo de la respuesta. Es nulo si la petición no pudo completarse o es incompleta.
responseText
Retorna una cadena conteniendo la cadena de respuesta retornada por el servidor HTTP.
A diferencia de la propiedad status, esta incluye el texto completo del mensaje de respuesta (por ejemplo "200 OK")
responseType
Puede retornar uno de los siguientes valores:
"" String (Valor por defecto)
"arraybuffer" VByteArray​
"json" Objeto javascript, parseado desde una cadena JSON retornada por el servidor.
status
Retorna el estado de la respuesta de la petición.
Esto es el código del resultado HTTP (por ejemplo, retorna 200 para una petición correcta)
statusText
Devuelve la cadena de respuesta. A diferencia de status, incluye el texto completo del mensaje de respuesta.
timeout
Representa el número de milisegundos que una petición puede tomar antes de ser automáticamente terminada.
Si no se especifica ningún valor, se define como valor por defecto 30 minutos.
Documentación de funciones
Constructor
XMLHttpRequest XMLHttpRequest()
Requiere importar previamente la clase:
importClass ( "XMLHttpRequest" );
Funciones generales
void abort()
Aborta la petición si ya ha sido enviada.
String getAllResponseHeaders()
Retorna todas las cabeceras de respuesta como una cadena, o vacío si no se han recibido.
String getResponseHeader( String name )
Retorna una cadena conteniendo el texto de la cabecera indicada en name, o vacío tanto si la respuesta no ha sido recibida o si la cabecera indicada no existe en la respuesta.
Parámetros:
name: Nombre de la cabecera.
void open( String method, String url, bool async = true, String username = "", String password = "" )
Inicia una petición
Parámetros:
method: El método HTTP a usar, tal como GET, POST, etc.
url: La url a la que se envía la petición.
async: Un valor booleano opcional, por defecto true, que indica si realizar o no la operación de forma asíncrona. Si este valor es falso, la función send() no retorna hasta que la respuesta es recibida. Si el valor es true, la notificación de que la transacción se ha completado se sabe usando la propiedad readyState (en este caso hay que mantener el proceso javascript abierto "entreteniendolo". Mirar ejemplo).
user: Valor opcional pasa usar en la autenticación. Por defecto es una cadena vacía. Usa el método de autenticación basado en URL.
password: Valor opcional pasa usar en la autenticación. Por defecto es una cadena vacía. Usa el método de autenticación basado en URL.
void send( String data )
Envía la petición. Si la petición es síncrona, no retorna hasta que llega la respuesta.
Parámetros:
data: cadena con los datos que son enviados con la petición. Es convertida a UTF8 antes del envio.
Si la petición es asíncrona, esta función retorna inmediatamente y hay que "entretener" al proceso javascript que la ha llamado hasta que llegue la respuesta (ver ejemplo).
void send( VByteArray data )
Envía la petición. Si la petición es síncrona, no retorna hasta que llega la respuesta.
Parámetros:
VByteArray data: VByteArray con los datos que son enviados con la petición. 
Si la petición es asíncrona, esta función retorna inmediatamente y hay que "entretener" al proceso javascript que la ha llamado hasta que llegue la respuesta (ver ejemplo).
void send()
Envía la petición.
Si la petición es síncrona, no retorna hasta que llega la respuesta. Si la petición es asíncrona, esta función retorna inmediatamente y hay que "entretener" al proceso javascript que la ha llamado hasta que llegue la respuesta (ver ejemplo).
void setRequestHeader( String name, String value )
Establece el valor de la cabecera en una petición HTTP. Se debe llamar a setRequestHeader() después de open() pero antes de send().
Parámetros:
name: Cadena con el nombre de la cabecera.
value: Valor de la cabecera.
Si esta función es llamada varias veces con la misma cabecera, los valores son mezclados en una sola cabecera.
bool setClientCertificate( String certificado, String key[, String password] )
Establece el certificado del cliente previamente a la llamada.
Parámetros:
certificado: cadena en formato PEM que contiene el certificado.
key: cadena que contiene la llave privada.
password (opcional): cadena que contiene la contraseña de la llave.
Esta función es funcional en Windows y en Linux pero no en Mac OS, dado que, al contrario que en Windows y Linux que usan Open SSL, Mac usa un sistema propio llamado Secure Transport SSL, y esta función del API no es funcional con dicho sistema.
Funciones auxiliares
void processEvents()
Procesa los eventos que haya en la cola de la aplicación. Debe usarse cuando realicemos una conexión asíncrona para permitir el proceso de los eventos durante el tiempo que dure.
void waitForRequestComplete()
Espera a que la petición se haya procesado. Hay que usar esta función obligatoriamente cuando se realice la petición desde tercer o cuarto plano (ver ejemplos).
Ejemplos
Obtener contenido de url de forma síncrona
1
importClass("XMLHttpRequest");
2
​
3
var url="https://velneo.es";
4
​
5
var xhr = new XMLHttpRequest();
6
xhr.open("GET", url, false);
7
xhr.send();
8
​
9
if ( (xhr.errorCode==0) && (xhr.status == 200) ) {
10
    alert(xhr.response);
11
}
Copied!
Obtener contenido de url de forma asíncrona
1
importClass("XMLHttpRequest");
2
​
3
var url="https://velneo.es";
4
​
5
var xhr = new XMLHttpRequest();
6
xhr.open("GET", url, true);
7
xhr.send();
8
​
9
// Al ser una llamada asíncrona, esperamos a que la petición termine. Esto es obligatorio si este código se ejecuta en tercer plano. Tenemos dos opciones para ello:
10
​
11
// Opcion 1: Hacemos uso de processEvents para poder mostrar o guardar información mientras esperamos
12
while(xhr.readyState != 4) { // 4: Done
13
    xhr.processEvents();
14
}
15
​
16
​
17
// Opcion 2: Hacemos uso de waitForRequestComplete(). Esa instrucción espera hasta que la conexión termine
18
xhr.waitForRequestComplete();
19
​
20
if ( (xhr.errorCode==0) && (xhr.status == 200) ) {
21
    alert(xhr.response);
22
}
Copied!
Obtener contenido de url de forma asíncrona a través de proxy
1
importClass("XMLHttpRequest");
2
​
3
// Datos para la conexión
4
var proxy = "http://127.0.0.1:8080/";
5
var senda = "helix/"
6
var host="www.perforce.com";
7
​
8
// Datos de autentificación del proxy
9
var datosAcceso = new VByteArray();
10
datosAcceso.setText('usuario:contraseña');
11
datosAcceso = datosAcceso.toBase64();
12
​
13
// Preparamos y enviamos
14
var xhr = new XMLHttpRequest();
15
xhr.open("GET", proxy + senda, true);
16
xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
17
xhr.setRequestHeader('Proxy-Authorization', 'Basic ' + datosAcceso.toLatin1String() );
18
xhr.setRequestHeader('Host', host );
19
xhr.send();
20
​
21
// Al ser una llamada asíncrona, esperamos a que la petición termine
22
while(xhr.readyState != 4) { // 4: Done
23
    theApp.processEvents();
24
}
25
​
26
// Mostramos el resultado
27
if ( (xhr.errorCode==0) && (xhr.status == 200) ) {
28
    alert( xhr.response );
29
}
Copied!
Obtener una imagen y convertirla a Base64 para guardarla en una tabla
1
importClass("XMLHttpRequest");
2
​
3
​
4
var url="http://velneo.es/wp-content/themes/pagelines-infovelneo/imagenes/logotipo-2.png";
5
​
6
var xhr = new XMLHttpRequest();
7
xhr.open("GET", url, false);
8
xhr.responseType = "arraybuffer";
9
xhr.send();
10
​
11
var respuesta="";
12
if (xhr.errorCode==0) {
13
    if (xhr.responseType=="arraybuffer") {
14
        // Obtenemos el array de respuesta
15
        var respuestaBA = new VByteArray();
16
        respuestaBA = xhr.response;
17
        respuesta = respuestaBA.toBase64().toLatin1String();
18
    } else
19
        respuesta = xhr.response;
20
}
Copied!
Petición incorrecta: obtener contenido de statusText
1
// Obtener contenido de statusText cuando haces una petición incorrecta
2
​
3
importClass("XMLHttpRequest");
4
​
5
var url="http://httpstat.us/400"
6
var xhr = new XMLHttpRequest();
7
xhr.open("GET", url, false);
8
xhr.send();
9
​
10
if ( (xhr.errorCode==0) && (xhr.status == 200) )
11
{
12
    if (xhr.responseType=="arraybuffer")
13
    {
14
        // Obtenemos el array de respuesta var respuestaBA = new VByteArray(); respuestaBA = xhr.response;
15
         respuesta = respuestaBA.toBase64().toLatin1String().substring(0,30);
16
    }
17
    else
18
        respuesta = xhr.response;
19
    alert("Elemento 1: " + xhr.statusText + " " + respuesta);
20
}
21
else
22
    alert("Status: " + xhr.status + "Status text: " + xhr.statusText + "Error: " + xhr.errorCode);
Copied!
Petición POST enviando un JSON y obteniendo un JSON
1
importClass("XMLHttpRequest");
2
​
3
var url="http://validate.jsontest.com";
4
var jsonAValidar = '{"Nombre": "Luis", "Edad": 43}';
5
​
6
var xhr = new XMLHttpRequest();
7
xhr.open("POST", url, true);
8
xhr.responseType = "json"; // Para que la respuesta sea un objeto Javascript Json
9
xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
10
xhr.send('json='+JSON.stringify(jsonAValidar));
11
​
12
​
13
// Al ser una llamada asíncrona, esperamos a que la petición termine
14
while(xhr.readyState != 4) { // 4: Done
15
    xhr.processEvents();
16
}
17
​
18
if ( (xhr.errorCode==0) && (xhr.status == 200) ) {
19
    alert(JSON.stringify(xhr.response));
20
}
Copied!
Petición POST enviando un fichero XML con firma de certificado de cliente
1
importClass("XMLHttpRequest");
2
importClass( "VFile" );
3
​
4
var fi = new VFile( "/home/usuario/Desarrollo/sii/factura_ejemplo_velneo_2.xml" );
5
var contenido = "";
6
if ( fi.open( VFile.OpenModeReadOnly ) )
7
    contenido = fi.readAll();    
8
​
9
var certificadoFile = new VFile( "/home/usuario/Desarrollo/sii/velneo.pem" );
10
var contenidoCertificado = "";
11
if ( certificadoFile.open( VFile.OpenModeReadOnly ) )
12
    contenidoCertificado = certificadoFile.readAll();    
13
​
14
var keyFile = new VFile( "/home/usuario/Desarrollo/sii/velneo_key.pem" );
15
var keyCertificado = "";
16
if ( keyFile.open( VFile.OpenModeReadOnly ) )
17
    keyCertificado = keyFile.readAll();    
18
​
19
var url = "https://www7.aeat.es/wlpl/SSII-FACT/ws/fe/SiiFactFEV1SOAP";
20
​
21
var xhr = new XMLHttpRequest();
22
xhr.open("POST", url, true);
23
xhr.setClientCertificate(contenidoCertificado.toLatin1String(),keyCertificado.toLatin1String());
24
​
25
xhr.setRequestHeader('Content-Type: ', 'text/xml;charset=UTF-8');
26
xhr.send(contenido);
27
​
28
while(xhr.readyState != 4) 
29
{
30
    xhr.processEvents();
31
}
32
​
33
if ( (xhr.errorCode==0) && (xhr.status == 200) ) 
34
{
35
    alert(JSON.stringify(xhr.response));
36
}
Copied!
Petición con autenticación usando el método BASIC
1
importClass("XMLHttpRequest");
2
​
3
// Datos para la conexión
4
var server = "http://127.0.0.1:8080/";
5
var senda = "helix/"
6
​
7
// Datos de autentificación del proxy
8
var datosAcceso = new VByteArray();
9
datosAcceso.setText('usuario:contraseña');
10
datosAcceso = datosAcceso.toBase64();
11
​
12
// Preparamos y enviamos
13
var xhr = new XMLHttpRequest();
14
xhr.open("GET", server + senda, true);
15
xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
16
xhr.setRequestHeader('Authorization', 'Basic ' + datosAcceso.toLatin1String() );
17
xhr.send();
18
​
19
// Al ser una llamada asíncrona, esperamos a que la petición termine
20
while(xhr.readyState != 4) { // 4: Done
21
    theApp.processEvents();
22
}
23
​
24
// Mostramos el resultado
25
if ( (xhr.errorCode==0) && (xhr.status == 200) ) {
26
    alert( xhr.response );
27
}
Copied!

Widget

QML

Última actualización 3mo ago

Indice de propiedades​

Indice de funciones

Constructor

Generales

Auxiliares

Señales

Documentación de propiedades

errorCode

readyState

response

responseText

responseType

status

statusText

timeout

Documentación de funciones

Constructor

XMLHttpRequest XMLHttpRequest()

Funciones generales

void abort()

String getAllResponseHeaders()

String getResponseHeader( String name )

void open( String method, String url, bool async = true, String username = "", String password = "" )

void send( String data )

void send( VByteArray data )

void send()

void setRequestHeader( String name, String value )

bool setClientCertificate( String certificado, String key[, String password] )

Funciones auxiliares

void processEvents()

void waitForRequestComplete()

Ejemplos

Obtener contenido de url de forma síncrona

Obtener contenido de url de forma asíncrona

Obtener contenido de url de forma asíncrona a través de proxy

Obtener una imagen y convertirla a Base64 para guardarla en una tabla

Petición incorrecta: obtener contenido de statusText

Petición POST enviando un JSON y obteniendo un JSON

Petición POST enviando un fichero XML con firma de certificado de cliente

Petición con autenticación usando el método BASIC

Indice de propiedades