miércoles, 2 de septiembre de 2015

Componente WEB

El componente Web que permite peticiones HTTP GET y POST. Las respuestas pueden ser entregadas como un parámetro de texto al evento GotText o guardar en un archivo con el nombre del archivo entregado como parámetro al evento GotFile. Los archivos pueden ser los tipos que no son de texto, como imágenes o archivos de sonido.

Propiedades

AllowCookies
Whether the cookies from a response should be saved and used in subsequent requests. Las cookies sólo se admiten en la versión Android 2.3 o superior.

RequestHeaders
Permite añadir campos a la cabeceradel paquete utilizando dos elementos de una lista. El primer elemento de la lista reperesta el nombre del campo y el segundo elemento el valor de dicho campo.

Si queremos añadir varias campos:

ResponseFileName
El nombre del archivo donde se debe guardar la respuesta a una petición Get. Si SaveResponse es verdadera y ResponseFileName está vacío, entonces se generará un nuevo nombre de archivo. 

SaveResponse
Si está a True, la respuesta a la petición Get es almacenada en un fichero. 

Url
La dirección URL de la solicitud Web.

Eventos

GotFile(text url, number responseCode, text responseType, text fileName)
Evento que indica que una solicitud ha terminado cuando se ha solicitado un fichero. Si el código de respuesta es 200 quiere decir que la cosa fue bien.

GotText(text url, number responseCode, text responseType, text responseContent)
Evento que indica que una solicitud ha terminado cuando se ha solicitado una página web. Si el código de respuesta es 200 quiere decir que la cosa fue bien (podríamos emplearlo como control de la operación mediante un bloque ifelse). La respuesta es un texto plano con el código de la página web. 

Métodos

text BuildRequestData(list list)
Convierte una lista de sublistas de dos elementos, que representan pares nombre-valor, a una cadena con formato como application / x-www-form-urlencoded tipo de medio, adecuado para pasar a PostText.

ClearCookies()
Borra todas las cookies de este componente Web. 

Delete()
Realiza una solicitud DELETE HTTP utilizando la propiedad Url y recupera la respuesta.

Si la propiedad SaveResponse es cierto, la respuesta se guardará en un archivo y el evento GotFile se activará. La propiedad ResponseFileName se puede utilizar para especificar el nombre del archivo.

Si la propiedad SaveResponse es falsa, se activará el evento GotText. 

Get()
Realiza una petición HTTP GET mediante la propiedad Url y recupera la respuesta.

Si la propiedad SaveResponse es cierto, la respuesta se guardará en un archivo y el evento GotFile se activará. La propiedad ResponseFileName se puede utilizar para especificar el nombre del archivo.

Si la propiedad SaveResponse es falsa, se activará el evento GotText.

text HtmlTextDecode(text htmlText)
Decodifica el valor de texto HTML dado. Entidades de caracteres HTML como & amp ;, & lt ;, & gt ;, & apos ;, y & quot; se cambian a &, <,>, ', y ". Entidades como & # xhhhh y & # nnnn se cambian a los caracteres adecuados. 

any JsonTextDecode(text jsonText)
Decodifica el JSON valor codificado dada para producir un valor AppInventor correspondiente. Una lista JSON [x, y, z] decodifica a una lista (xyz), un objeto JSON con nombre de A y B de valor, (indicado como A: B entre llaves) decodifica a una lista ((AB)), que es, una lista que contiene la lista de dos elementos (AB). 

PostFile(text path)
Realiza una solicitud HTTP POST mediante la propiedad Url y datos desde el archivo especificado.

Si la propiedad SaveResponse es cierto, la respuesta se guardará en un archivo y el evento GotFile se activará. La propiedad ResponseFileName se puede utilizar para especificar el nombre del archivo.

Si la propiedad SaveResponse es falsa, se activará el evento GotText. 

PostText(text text)
Realiza una solicitud HTTP POST mediante la propiedad del URL y el texto especificado.

Los caracteres del texto se codifican utilizando codificación UTF-8.

Si la propiedad SaveResponse es cierto, la respuesta se guardará en un archivo y el evento GotFile se activará. La propiedad responseFileName se puede utilizar para especificar el nombre del archivo.

Si la propiedad SaveResponse es falsa, se activará el evento GotText. 

PostTextWithEncoding(text text, text encoding)
Realiza una solicitud HTTP POST mediante la propiedad del URL y el texto especificado.

Los caracteres del texto se codifican utilizando la codificación dada.

Si la propiedad SaveResponse es cierto, la respuesta se guardará en un archivo y el evento GotFile se activará. La propiedad ResponseFileName se puede utilizar para especificar el nombre del archivo.

Si la propiedad SaveResponse es falsa, se activará el evento GotText. 

PutFile(text path)
Realiza una petición HTTP PUT utilizando la propiedad Url y datos desde el archivo especificado.

Si la propiedad SaveResponse es cierto, la respuesta se guardará en un archivo y el evento GotFile se activará. La propiedad ResponseFileName se puede utilizar para especificar el nombre del archivo.

Si la propiedad SaveResponse es falsa, se activará el evento GotText. 

PutText(text text)
Realiza una petición HTTP PUT utilizando la propiedad del URL y el texto especificado.

Los caracteres del texto se codifican utilizando codificación UTF-8.

Si la propiedad SaveResponse es cierto, la respuesta se guardará en un archivo y el evento GotFile se activará. La propiedad responseFileName se puede utilizar para especificar el nombre del archivo.

Si la propiedad SaveResponse es falsa, se activará el evento GotText. 

PutTextWithEncoding(text text, text encoding)
Realiza una petición HTTP PUT utilizando la propiedad del URL y el texto especificado.

Los caracteres del texto se codifican utilizando la codificación dada.

Si la propiedad SaveResponse es cierto, la respuesta se guardará en un archivo y el evento GotFile se activará. La propiedad ResponseFileName se puede utilizar para especificar el nombre del archivo.

Si la propiedad SaveResponse es falsa, se activará el evento GotText. 

text UriEncode(text text)
Codifica el valor de texto dada de manera que pueda ser utilizado en una URL. 

any XMLTextDecode(text XmlText)
Decodifica la cadena XML determinado para producir una estructura de lista. Consulte la documentación de App Inventor en "Otros temas, notas y detalles" para obtener información. 

Fuentes: 
Nota: La traduccion ha sido realizada por google trabslator. Iré actualizando la página a medida que encuentre más información sobre este componente.

No hay comentarios:

Publicar un comentario

Nota: solo los miembros de este blog pueden publicar comentarios.