| Paquete | air.desktop |
| Clase | public class URLFilePromise |
| Herencia | URLFilePromise  EventDispatcher Object |
| Implementa | IFilePromise |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.0 |
La clase URLFilePromise implementa la interfaz IFilePromise usando objetos URLStream y URLRequest como origen de datos. La aplicación proporciona compatibilidad de arrastrar y colocar para los archivos que se pueden recuperar mediante HTTP o los otros protocolos admitidos por la clase URLStream.
Para crear una promesa de archivo URL:
- Construya e inicialice uno o más objetos URLFilePromise.
- Añada objetos URLFilePromise a un conjunto.
- Añada el conjunto a un nuevo objeto Clipboard utilizando el formato ClipboardFormat
FILE_PROMISE_LIST. - Como respuesta a un gesto del usuario, llame al método
startDrag()de NativeDragManager y transfiera el objeto Clipboard que contiene el conjunto de promesas de archivo.
Cuando el usuario finalice la operación de arrastre, el motor de ejecución descargará los datos de cada promesa de archivo. Se accede a los datos en la URL especificada por la propiedad request del objeto URLFilePromise y se guardan en el archivo especificado en la propiedad relativePath. El archivo se guarda con respecto a la ubicación de destino. Por consiguiente, si la ruta relativa es foo/bar.txt, y el archivo promesa se coloca en un directorio llamado home, la ubicación del archivo creado es: home/foo/bar.txt. Si se produce un error, el archivo no se crea.
Para poder admitir orígenes de datos que no están accesibles a través de la clase URLStream, implemente la interfaz IFilePromise.
Nota: el motor de ejecución de AIR llama a los métodos open(), close() y reportError() de IFilePromise automáticamente. Nunca se debe llamar a estos métodos desde la lógica de la aplicación. De forma similar, los eventos open, progress, complete y close distribuidos mediante este objeto URLFilePromise se suministran principalmente por motivos de depuración. No es necesario que su aplicación responda a estos eventos.
Esta clase está incluida en el archivo aircore.swc. Adobe® Flash™ Builder carga esta clase automáticamente al crear un proyecto para Adobe® AIR™. El SDK de Adobe® Flex™ también contiene este archivo aircore.swc, que se debe incluir al compilar la aplicación si se utiliza el SDK de Flex.
Para utilizar el paquete air.desktop en Adobe® Flash® Professional (CS4 o posterior):
- Seleccione el comando Archivo > Configuración de publicación.
- En el panel Flash, haga clic en el botón Configuración de Seleccionar ruta de biblioteca de ActionScript 3.0.
- Haga clic en el botón Navegar hasta el archivo SWC. En la carpeta de instalación de Adobe Flash Professional, navegue hasta Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc.
- Haga clic en el botón Aceptar.
- Añada la siguiente sentencia
importal código ActionScript 3.0:import air.desktop.*;
Elementos de API relacionados
Clase Clipboard
Clase ClipboardFormats
Clase NativeDragManager
Clase URLStream
Clase URLRequest
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
 | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| isAsync : Boolean [solo lectura]
Indica si los datos del recurso están disponibles asíncronamente. | URLFilePromise | ||
| relativePath : String
La ruta y el nombre de archivo del archivo creado, relativos al destino en que se va a colocar. | URLFilePromise | ||
| request : URLRequest
El objeto URLRequest que identifica el recurso que se va a copiar como resultado de la operación de arrastrar y colocar. | URLFilePromise | ||
| Método | Definido por | ||
|---|---|---|---|
Crea un objeto URLFilePromise. | URLFilePromise | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento. | EventDispatcher | |
Permite que el motor de ejecución de AIR cierre el origen de datos en el momento adecuado durante la operación de arrastrar y colocar. | URLFilePromise | ||
|
Distribuye un evento en el flujo del evento. | EventDispatcher | |
|
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | EventDispatcher | |
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
|
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | |
Permite que el motor de ejecución de AIR abra el origen de datos en el momento adecuado durante la operación de arrastrar y colocar. | URLFilePromise | ||
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
|
Elimina un detector del objeto EventDispatcher. | EventDispatcher | |
Permite que el motor de ejecución de AIR informe sobre los errores que se producen durante la operación de arrastrar y colocar. | URLFilePromise | ||
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
|
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | |
|
Devuelve la representación de cadena del objeto especificado. | Object | |
|
Devuelve el valor simple del objeto especificado. | Object | |
|
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. | EventDispatcher | |
| Evento | Resumen | Definido por | ||
|---|---|---|---|---|
| [evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos. | EventDispatcher | ||
| Se distribuye cuando se han descargado completamente los datos del el archivo. | URLFilePromise | |||
| [evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos. | EventDispatcher | ||
| Se distribuye para que las peticiones HTTP puedan informar sobre los encabezados de respuesta. | URLFilePromise | |||
| Se distribuye para que las peticiones HTTP informen sobre el código de estado de la petición. | URLFilePromise | |||
| Se distribuye cuando un error IOError impide la descarga del archivo. | URLFilePromise | |||
| Se distribuye cuando se abre la conexión URLStream subyacente. | URLFilePromise | |||
| Se distribuye cuando un bloque de datos está disponibles para su lectura en el flujo URLStream subyacente. | URLFilePromise | |||
| Se distribuye cuando un error de seguridad impide la descarga del archivo. | URLFilePromise | |||
isAsync | propiedad |
isAsync:Boolean [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.0 |
Indica si los datos del recurso están disponibles asíncronamente.
La propiedad isAsync de un objeto URLFilePrmise siempre es true ya que los flujos URL son esencialmente asíncronos.
Implementación
public function get isAsync():Boolean relativePath | propiedad |
relativePath:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.0 |
La ruta y el nombre de archivo del archivo creado, relativos al destino en que se va a colocar.
La ruta puede incluir subdirectorios que se resuelven en función de la ubicación en que se va a colocar. Se crean subdirectorios, si es necesario. Si se incluyen subdirectorios, utilice la constante File.separator para insertar el carácter separador de ruta correcto para el sistema operativo actual. Utilizar el acceso directo .. para navegar a un directorio principal no está permitido.
El nombre de archivo no tiene que coincidir necesariamente con el nombre de archivo del recurso remoto.
Implementación
public function get relativePath():String public function set relativePath(value:String):void request | propiedad |
request:URLRequest| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.0 |
El objeto URLRequest que identifica el recurso que se va a copiar como resultado de la operación de arrastrar y colocar.
Implementación
public function get request():URLRequest public function set request(value:URLRequest):void URLFilePromise | () | Información sobre |
public function URLFilePromise()| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.0 |
Crea un objeto URLFilePromise.
Debe definir las propiedades request y relativePath antes de utilizar este objeto URLFilePromise.
close | () | método |
public function close():void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.0 |
Permite que el motor de ejecución de AIR cierre el origen de datos en el momento adecuado durante la operación de arrastrar y colocar.
No llame a esta función en la lógica de la aplicación.
open | () | método |
public function open():IDataInput| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.0 |
Permite que el motor de ejecución de AIR abra el origen de datos en el momento adecuado durante la operación de arrastrar y colocar.
No llame a esta función en la lógica de la aplicación.
Valor devueltoIDataInput |
reportError | () | método |
public function reportError(e:ErrorEvent):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.0 |
Permite que el motor de ejecución de AIR informe sobre los errores que se producen durante la operación de arrastrar y colocar.
El objeto URLFilePromise redistribuye cualquier evento de error notificado. No llame a esta función en la lógica de la aplicación.
Parámetros
e:ErrorEvent |
complete | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.COMPLETE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.0 |
Se distribuye cuando se han descargado completamente los datos del el archivo.
Nota: el motor de ejecución de AIR utiliza este evento para gestionar el proceso de recuperación asíncrona de datos. Normalmente, no es necesario que la aplicación realice ninguna acción como respuesta a este evento.
La constanteEvent.COMPLETE define el valor de la propiedad type de un objeto de evento complete.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Objeto de red que ha terminado de cargarse. |
httpResponseStatus | Evento |
flash.events.HTTPStatusEventpropiedad HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.0 |
Se distribuye para que las peticiones HTTP puedan informar sobre los encabezados de respuesta.
Al contrario quehttpStatus, el evento httpResponseStatus se envía antes de cualquier dato de respuesta. Asimismo, el evento httpResponseStatus incluye valores para las propiedades responseHeaders y responseURL (que son undefined en un evento httpStatus). Tenga en cuenta que se enviará el evento httpResponseStatus (si existe) antes que (y además de) cualquier evento complete o error.
La constante HTTPStatusEvent.HTTP_RESPONSE_STATUS define el valor de la propiedad type de un objeto de evento httpResponseStatus.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
responseURL | URL desde la que se devolvió la respuesta. |
responseHeaders | Encabezados de respuesta devueltos por la respuesta como un conjunto de objeto URLRequestHeader. |
status | El código de estado HTTP que devuelve el servidor. |
redirected | Indica si la respuesta es el resultado de una redirección. |
target | El objeto de red que recibe el código de estado HTTP. |
httpStatus | Evento |
flash.events.HTTPStatusEventpropiedad HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_STATUS| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.0 |
Se distribuye para que las peticiones HTTP informen sobre el código de estado de la petición.
La constanteHTTPStatusEvent.HTTP_STATUS define el valor de la propiedad type de un objeto de evento httpStatus.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
status | El código de estado HTTP que devuelve el servidor. |
target | El objeto de red que recibe el código de estado HTTP. |
ioError | Evento |
flash.events.IOErrorEventpropiedad IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.0 |
Se distribuye cuando un error IOError impide la descarga del archivo.
Define el valor de la propiedadtype de un objeto de evento ioError.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
errorID | Un número de referencia asociado al error concreto (sólo AIR). |
target | El objeto de red en el que se produce el error de entrada/salida. |
text | Texto que se mostrará como mensaje de error. |
open | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.OPEN| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.0 |
Se distribuye cuando se abre la conexión URLStream subyacente.
Nota: el motor de ejecución de AIR utiliza este evento para gestionar el proceso de recuperación asíncrona de datos. Normalmente, no es necesario que la aplicación realice ninguna acción como respuesta a este evento.
La constanteEvent.OPEN define el valor de la propiedad type de un objeto de evento open.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Objeto de red que ha abierto una conexión. |
progress | Evento |
flash.events.ProgressEventpropiedad ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.0 |
Se distribuye cuando un bloque de datos está disponibles para su lectura en el flujo URLStream subyacente.
Nota: el motor de ejecución de AIR utiliza este evento para gestionar el proceso de recuperación asíncrona de datos. Normalmente, no es necesario que la aplicación realice ninguna acción como respuesta a este evento.
Define el valor de la propiedadtype de un objeto de evento progress.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
bytesLoaded | Número de elementos o bytes cargados en el momento en que el detector procesa el evento. |
bytesTotal | Número total de elementos o bytes que se cargarán en última instancia si el proceso de carga se realiza correctamente. |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto que informa sobre el progreso. |
securityError | Evento |
flash.events.SecurityErrorEventpropiedad SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.0 |
Se distribuye cuando un error de seguridad impide la descarga del archivo.
La constanteSecurityErrorEvent.SECURITY_ERROR define el valor de la propiedad type de un objeto de evento securityError.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto de red que informa sobre le error de seguridad. |
text | Texto que se mostrará como mensaje de error. |
Tue Jun 12 2018, 02:12 PM Z