Utilice el objeto FileTransfer para listar y transferir archivos entre el sistema del host y el cliente.
La API de transferencia de archivos de Host Access for the Cloud abstrae las convenciones de ruta de archivos utilizadas por diferentes implementaciones de archivos del host. Siga los formatos de ruta de sistema de archivos URL o Linux a la hora de formatear las rutas de archivo utilizadas por la API. Por ejemplo, /root/directory/file. Es importante observar todas las reglas específicas de los sistemas de host, como los caracteres permitidos o las longitudes de los nombres.
NOTA:Los navegadores imponen importantes restricciones de seguridad sobre la capacidad de Javascript para interactuar con los sistemas de archivos de los clientes.
Tabla 5-23 FileTransfer
|
Método |
|
|---|---|
|
getHostFileListing(remotePath) |
Solicitar un listado de archivos de host. Si remotePath se omite, se muestra un listado para el directorio de trabajo remoto actual. Parámetros {String} (opcional) Si se especifica, se obtiene un listado de archivos para la ruta remota especificada. Si no se especifica, se obtiene un listado de archivos para el directorio de trabajo remoto actual. Devuelve {Promise} Resuelve a una matriz de objetos HostFile contenidos en remoteName. Se rechaza si la ruta remota no se puede leer. |
|
sendFile(localFile, remoteName) |
Envía el archivo especificado al host. Parámetros {File} Objeto de archivo Javascript dirigido al archivo local a enviar. {String} Nombre completo de archivo remoto tal y como lo permite el sistema remoto (Unix, Windows, MVS, VAX). Devuelve {Promise} rellenada con un objeto HostFile que representa el éxito del envío del archivo. Se rechaza si se ha producido un error al enviar el archivo. |
|
getDownloadURL(remoteName) |
Construye un vínculo para descargar un archivo desde un sistema de host. Parámetros {String} Nombre completo de archivo remoto tal y como lo permite el sistema remoto (Unix, Windows, MVS, VAX). Devuelve {URL} que se puede utilizar para recuperar el archivo desde el servidor de sesión de Host Access for the Cloud. |
|
setTransferOptions(options) |
Establece las opciones de transferencia para la sesión FileTransfer actual. Las opciones de transferencia se aplican a todas las transferencias futuras cuando o bien se cierra la sesión, o bien ésta se sobrescribe con otra llamada a setTransferOptions. Parámetros {JSON} véase FileTransferOptions para los nombres y valores permitidos. Devuelve {Promise} rellenada cuando la llamada finaliza. Se rechaza si se ha producido un error al configurar las opciones. |
|
cancelar() |
Cancela la transferencia actual en curso. Devuelve {Promise} rellenada cuando la llamada finaliza. Se rechaza si se ha producido un error al cancelar la transferencia. |