diff --git a/doc/de/index.md b/doc/de/index.md index b767161..d155cdc 100644 --- a/doc/de/index.md +++ b/doc/de/index.md @@ -192,7 +192,7 @@ A `FileUploadResult` -Objekt wird an den Erfolg-Rückruf des übergeben die `Fil uri, fileURL, function(entry) { - console.log("download complete: " + entry.fullPath); + console.log("download complete: " + entry.toURL()); }, function(error) { console.log("download error source " + error.source); @@ -252,12 +252,14 @@ A `FileTransferError` Objekt wird an eine Fehler-Callback übergeben, wenn ein F * **HTTP_STATUS**: HTTP-Statuscode. Dieses Attribut ist nur verfügbar, wenn ein Response-Code aus der HTTP-Verbindung eingeht. (Anzahl) +* **Ausnahme**: entweder e.getMessage oder e.toString (String) + ### Konstanten -* `FileTransferError.FILE_NOT_FOUND_ERR` -* `FileTransferError.INVALID_URL_ERR` -* `FileTransferError.CONNECTION_ERR` -* `FileTransferError.ABORT_ERR` +* 1 = `FileTransferError.FILE_NOT_FOUND_ERR` +* 2 = `FileTransferError.INVALID_URL_ERR` +* 3 = `FileTransferError.CONNECTION_ERR` +* 4 = `FileTransferError.ABORT_ERR` ## Hinweise rückwärts Kompatibilität diff --git a/doc/es/index.md b/doc/es/index.md index 4bb5e5d..fdf8e59 100644 --- a/doc/es/index.md +++ b/doc/es/index.md @@ -192,7 +192,7 @@ A `FileUploadResult` objeto se pasa a la devolución del éxito de la `FileTrans uri, fileURL, function(entry) { - console.log("download complete: " + entry.fullPath); + console.log("download complete: " + entry.toURL()); }, function(error) { console.log("download error source " + error.source); @@ -252,12 +252,14 @@ A `FileTransferError` objeto se pasa a un callback de error cuando se produce un * **HTTP_STATUS**: código de estado HTTP. Este atributo sólo está disponible cuando se recibe un código de respuesta de la conexión HTTP. (Número) +* **excepción**: cualquier e.getMessage o e.toString (String) + ### Constantes -* `FileTransferError.FILE_NOT_FOUND_ERR` -* `FileTransferError.INVALID_URL_ERR` -* `FileTransferError.CONNECTION_ERR` -* `FileTransferError.ABORT_ERR` +* 1 = `FileTransferError.FILE_NOT_FOUND_ERR` +* 2 = `FileTransferError.INVALID_URL_ERR` +* 3 = `FileTransferError.CONNECTION_ERR` +* 4 = `FileTransferError.ABORT_ERR` ## Al revés notas de compatibilidad diff --git a/doc/fr/index.md b/doc/fr/index.md index defdba7..c9abc6a 100644 --- a/doc/fr/index.md +++ b/doc/fr/index.md @@ -192,7 +192,7 @@ Un objet `FileUploadResult` est passé à la callback de succès de la méthode uri, fileURL, function(entry) { - console.log("download complete: " + entry.fullPath); + console.log("download complete: " + entry.toURL()); }, function(error) { console.log("download error source " + error.source); @@ -252,12 +252,14 @@ Un objet `FileTransferError` est passé à une callback d'erreur lorsqu'une erre * **http_status** : code d'état HTTP. Cet attribut n'est disponible que lorsqu'un code de réponse est fourni via la connexion HTTP. (Number) +* **exception**: soit e.getMessage ou e.toString (String) + ### Constantes -* `FileTransferError.FILE_NOT_FOUND_ERR` -* `FileTransferError.INVALID_URL_ERR` -* `FileTransferError.CONNECTION_ERR` -* `FileTransferError.ABORT_ERR` +* 1 = `FileTransferError.FILE_NOT_FOUND_ERR` +* 2 = `FileTransferError.INVALID_URL_ERR` +* 3 = `FileTransferError.CONNECTION_ERR` +* 4 = `FileTransferError.ABORT_ERR` ## Backwards Compatibility Notes diff --git a/doc/it/index.md b/doc/it/index.md index 89c32b4..ed74c91 100644 --- a/doc/it/index.md +++ b/doc/it/index.md @@ -192,7 +192,7 @@ A `FileUploadResult` oggetto viene passato al metodo di callback di successo il uri, fileURL, function(entry) { - console.log("download complete: " + entry.fullPath); + console.log("download complete: " + entry.toURL()); }, function(error) { console.log("download error source " + error.source); @@ -252,12 +252,14 @@ A `FileTransferError` oggetto viene passato a un callback di errore quando si ve * **http_status**: codice di stato HTTP. Questo attributo è disponibile solo quando viene ricevuto un codice di risposta della connessione HTTP. (Numero) +* **eccezione**: O e.getMessage o e.toString (String) + ### Costanti -* `FileTransferError.FILE_NOT_FOUND_ERR` -* `FileTransferError.INVALID_URL_ERR` -* `FileTransferError.CONNECTION_ERR` -* `FileTransferError.ABORT_ERR` +* 1 = `FileTransferError.FILE_NOT_FOUND_ERR` +* 2 = `FileTransferError.INVALID_URL_ERR` +* 3 = `FileTransferError.CONNECTION_ERR` +* 4 = `FileTransferError.ABORT_ERR` ## Note di compatibilità all'indietro diff --git a/doc/ja/index.md b/doc/ja/index.md index ef7883a..f979fff 100644 --- a/doc/ja/index.md +++ b/doc/ja/index.md @@ -192,7 +192,7 @@ A `FileUploadResult` オブジェクトの成功時のコールバックに渡 uri, fileURL, function(entry) { - console.log("download complete: " + entry.fullPath); + console.log("download complete: " + entry.toURL()); }, function(error) { console.log("download error source " + error.source); @@ -252,12 +252,14 @@ A `FileTransferError` オブジェクトは、エラーが発生エラー コー * **http_status**: HTTP ステータス コード。この属性は、HTTP 接続から応答コードを受信したときにのみ使用できます。(数) +* **例外**: どちらか e.getMessage または e.toString (文字列) + ### 定数 -* `FileTransferError.FILE_NOT_FOUND_ERR` -* `FileTransferError.INVALID_URL_ERR` -* `FileTransferError.CONNECTION_ERR` -* `FileTransferError.ABORT_ERR` +* 1 = `FileTransferError.FILE_NOT_FOUND_ERR` +* 2 = `FileTransferError.INVALID_URL_ERR` +* 3 = `FileTransferError.CONNECTION_ERR` +* 4 = `FileTransferError.ABORT_ERR` ## 後方互換性をノートします。 diff --git a/doc/ko/index.md b/doc/ko/index.md index 109cf80..55d8dcf 100644 --- a/doc/ko/index.md +++ b/doc/ko/index.md @@ -192,7 +192,7 @@ A `FileUploadResult` 개체의 성공 콜백에 전달 되는 `FileTransfer` 개 uri, fileURL, function(entry) { - console.log("download complete: " + entry.fullPath); + console.log("download complete: " + entry.toURL()); }, function(error) { console.log("download error source " + error.source); @@ -252,12 +252,14 @@ A `FileTransferError` 오류가 발생 하면 오류 콜백 개체 전달 됩니 * **http_status**: HTTP 상태 코드. 이 특성은 응답 코드를 HTTP 연결에서 수신에 사용할 수 있습니다. (수) +* **예외**: 어느 e.getMessage 또는 e.toString (문자열) + ### 상수 -* `FileTransferError.FILE_NOT_FOUND_ERR` -* `FileTransferError.INVALID_URL_ERR` -* `FileTransferError.CONNECTION_ERR` -* `FileTransferError.ABORT_ERR` +* 1 = `FileTransferError.FILE_NOT_FOUND_ERR` +* 2 = `FileTransferError.INVALID_URL_ERR` +* 3 = `FileTransferError.CONNECTION_ERR` +* 4 = `FileTransferError.ABORT_ERR` ## 이전 버전과 호환성 노트 diff --git a/doc/ru/index.md b/doc/ru/index.md new file mode 100644 index 0000000..8522365 --- /dev/null +++ b/doc/ru/index.md @@ -0,0 +1,283 @@ + + +# org.apache.cordova.file-transfer + +Этот плагин позволяет вам загружать и скачивать файлы. + +## Установка + + cordova plugin add org.apache.cordova.file-transfer + + +## Поддерживаемые платформы + +* Amazon Fire ОС +* Android +* BlackBerry 10 * +* iOS +* Windows Phone 7 и 8 * +* Windows 8 * + +* *Не поддерживают `onprogress` , ни `abort()` * + +# FileTransfer + +`FileTransfer`Объект предоставляет способ для загрузки файлов с помощью нескольких частей запроса POST HTTP и для загрузки файлов, а также. + +## Свойства + +* **OnProgress**: называется с `ProgressEvent` всякий раз, когда новый фрагмент данных передается. *(Функция)* + +## Методы + +* **добавлено**: отправляет файл на сервер. + +* **скачать**: Скачать файл с сервера. + +* **прервать**: прерывает передачу в прогресс. + +## загрузить + +**Параметры**: + +* **fileURL**: файловой системы URL-адрес, представляющий файл на устройстве. Для обратной совместимости, это также может быть полный путь к файлу на устройстве. (См. [обратной совместимости отмечает] ниже) + +* **сервер**: URL-адрес сервера, чтобы получить файл, как закодированные`encodeURI()`. + +* **successCallback**: обратного вызова, передаваемого `Metadata` объект. *(Функция)* + +* **errorCallback**: обратного вызова, который выполняется в случае получения ошибки `Metadata` . Вызываемый с `FileTransferError` объект. *(Функция)* + +* **trustAllHosts**: необязательный параметр, по умолчанию равен `false` . Если значение `true` , она принимает все сертификаты безопасности. Это полезно, поскольку Android отвергает самозаверяющие сертификаты. Не рекомендуется для использования в производстве. Поддерживается на Android и iOS. *(логическое значение)* + +* **опции**: необязательные параметры *(объект)*. Допустимые ключи: + + * **fileKey**: имя элемента form. По умолчанию `file` . (DOMString) + * **имя файла**: имя файла для использования при сохранении файла на сервере. По умолчанию `image.jpg` . (DOMString) + * **тип MIME**: тип mime данных для загрузки. По умолчанию `image/jpeg` . (DOMString) + * **params**: набор пар дополнительный ключ/значение для передачи в HTTP-запросе. (Объект) + * **chunkedMode**: следует ли загружать данные в фрагментах потоковом режиме. По умолчанию `true` . (Логическое значение) + * **заголовки**: Карта значений заголовок имя заголовка. Используйте массив для указания более одного значения. (Объект) + +### Пример + + // !! Assumes variable fileURL contains a valid URL to a text file on the device, + // for example, cdvfile://localhost/persistent/path/to/file.txt + + var win = function (r) { + console.log("Code = " + r.responseCode); + console.log("Response = " + r.response); + console.log("Sent = " + r.bytesSent); + } + + var fail = function (error) { + alert("An error has occurred: Code = " + error.code); + console.log("upload error source " + error.source); + console.log("upload error target " + error.target); + } + + var options = new FileUploadOptions(); + options.fileKey = "file"; + options.fileName = fileURL.substr(fileURL.lastIndexOf('/') + 1); + options.mimeType = "text/plain"; + + var params = {}; + params.value1 = "test"; + params.value2 = "param"; + + options.params = params; + + var ft = new FileTransfer(); + ft.upload(fileURL, encodeURI("http://some.server.com/upload.php"), win, fail, options); + + +### Пример с загружать заголовки и события Progress (Android и iOS только) + + function win(r) { + console.log("Code = " + r.responseCode); + console.log("Response = " + r.response); + console.log("Sent = " + r.bytesSent); + } + + function fail(error) { + alert("An error has occurred: Code = " + error.code); + console.log("upload error source " + error.source); + console.log("upload error target " + error.target); + } + + var uri = encodeURI("http://some.server.com/upload.php"); + + var options = new FileUploadOptions(); + options.fileKey="file"; + options.fileName=fileURL.substr(fileURL.lastIndexOf('/')+1); + options.mimeType="text/plain"; + + var headers={'headerParam':'headerValue'}; + + options.headers = headers; + + var ft = new FileTransfer(); + ft.onprogress = function(progressEvent) { + if (progressEvent.lengthComputable) { + loadingStatus.setPercentage(progressEvent.loaded / progressEvent.total); + } else { + loadingStatus.increment(); + } + }; + ft.upload(fileURL, uri, win, fail, options); + + +## FileUploadResult + +Объект `FileUploadResult` передается на успех обратного вызова метода `upload()` объекта `FileTransfer`. + +### Свойства + +* **bytesSent**: количество байт, отправленных на сервер как часть загрузки. (длинная) + +* **responseCode**: код ответа HTTP, возвращаемых сервером. (длинная) + +* **ответ**: ответ HTTP, возвращаемых сервером. (DOMString) + +* **заголовки**: заголовки ответов HTTP-сервером. (Объект) + + * В настоящее время поддерживается только для iOS. + +### iOS причуды + +* Не поддерживает `responseCode` или`bytesSent`. + +## Скачать + +**Параметры**: + +* **источник**: URL-адрес сервера для загрузки файла, как закодированные`encodeURI()`. + +* **Цель**: файловой системы URL-адрес, представляющий файл на устройстве. Для обратной совместимости, это также может быть полный путь к файлу на устройстве. (См. [обратной совместимости отмечает] ниже) + +* **successCallback**: обратного вызова, передаваемого `FileEntry` объект. *(Функция)* + +* **errorCallback**: обратного вызова, который выполняется, если возникает ошибка при получении `Metadata` . Вызываемый с `FileTransferError` объект. *(Функция)* + +* **trustAllHosts**: необязательный параметр, по умолчанию `false` . Если значение `true` , она принимает все сертификаты безопасности. Это полезно, потому что Android отвергает самозаверяющие сертификаты. Не рекомендуется для использования в производстве. Поддерживается на Android и iOS. *(логическое значение)* + +* **опции**: необязательные параметры, в настоящее время только поддерживает заголовки (например авторизации (базовая аутентификация) и т.д.). + +### Пример + + // !! Assumes variable fileURL contains a valid URL to a path on the device, + // for example, cdvfile://localhost/persistent/path/to/downloads/ + + var fileTransfer = new FileTransfer(); + var uri = encodeURI("http://some.server.com/download.php"); + + fileTransfer.download( + uri, + fileURL, + function(entry) { + console.log("download complete: " + entry.toURL()); + }, + function(error) { + console.log("download error source " + error.source); + console.log("download error target " + error.target); + console.log("upload error code" + error.code); + }, + false, + { + headers: { + "Authorization": "Basic dGVzdHVzZXJuYW1lOnRlc3RwYXNzd29yZA==" + } + } + ); + + +## прервать + +Прерывает передачу в прогресс. Onerror обратного вызова передается объект FileTransferError, который имеет код ошибки FileTransferError.ABORT_ERR. + +### Пример + + // !! Assumes variable fileURL contains a valid URL to a text file on the device, + // for example, cdvfile://localhost/persistent/path/to/file.txt + + var win = function(r) { + console.log("Should not be called."); + } + + var fail = function(error) { + // error.code == FileTransferError.ABORT_ERR + alert("An error has occurred: Code = " + error.code); + console.log("upload error source " + error.source); + console.log("upload error target " + error.target); + } + + var options = new FileUploadOptions(); + options.fileKey="file"; + options.fileName="myphoto.jpg"; + options.mimeType="image/jpeg"; + + var ft = new FileTransfer(); + ft.upload(fileURL, encodeURI("http://some.server.com/upload.php"), win, fail, options); + ft.abort(); + + +## FileTransferError + +A `FileTransferError` объект передается при ошибке обратного вызова при возникновении ошибки. + +### Свойства + +* **код**: один из кодов стандартных ошибок, перечисленные ниже. (Число) + +* **источник**: URL-адрес источника. (Строка) + +* **Цель**: URL-адрес к целевому объекту. (Строка) + +* **http_status**: код состояния HTTP. Этот атрибут доступен только при код ответа от HTTP-соединения. (Число) + +* **исключение**: либо e.getMessage или e.toString (строка) + +### Константы + +* 1 = `FileTransferError.FILE_NOT_FOUND_ERR` +* 2 = `FileTransferError.INVALID_URL_ERR` +* 3 = `FileTransferError.CONNECTION_ERR` +* 4 = `FileTransferError.ABORT_ERR` + +## Обратной совместимости отмечает + +Предыдущие версии этого плагина будет принимать только устройства Абсолют файлам как источник для закачки, или как целевых для загрузок. Обычно эти пути бы формы + + /var/mobile/Applications//Documents/path/to/file (iOS) + /storage/emulated/0/path/to/file (Android) + + +Для обратной совместимости, по-прежнему принимаются эти пути, и если ваше приложение зарегистрировано пути как в постоянное хранилище, то они могут продолжать использоваться. + +Эти пути ранее были видны в `fullPath` свойства `FileEntry` и `DirectoryEntry` объекты, возвращаемые файл плагина. Новые версии файла плагина, однако, не подвергать эти пути в JavaScript. + +Если вы переходите на новый (1.0.0 или новее) версию файла и вы ранее использовали `entry.fullPath` в качестве аргументов `download()` или `upload()` , то вам необходимо будет изменить код для использования файловой системы URL вместо. + +`FileEntry.toURL()`и `DirectoryEntry.toURL()` возвращает URL-адрес формы файловой системы + + cdvfile://localhost/persistent/path/to/file + + +которые могут быть использованы вместо абсолютного пути в обоих `download()` и `upload()` методы. \ No newline at end of file diff --git a/doc/zh/index.md b/doc/zh/index.md index 36a3b15..0a277d9 100644 --- a/doc/zh/index.md +++ b/doc/zh/index.md @@ -192,7 +192,7 @@ A `FileUploadResult` 物件傳遞給成功回檔的 `FileTransfer` 物件的 `up uri, fileURL, function(entry) { - console.log("download complete: " + entry.fullPath); + console.log("download complete: " + entry.toURL()); }, function(error) { console.log("download error source " + error.source); @@ -252,12 +252,14 @@ A `FileTransferError` 物件傳遞到錯誤回檔時出現錯誤。 * **HTTP_status**： HTTP 狀態碼。從 HTTP 連接收到一個回應代碼時，此屬性才可用。（人數） +* **例外**： 要麼 e.getMessage 或 e.toString （字串） + ### 常量 -* `FileTransferError.FILE_NOT_FOUND_ERR` -* `FileTransferError.INVALID_URL_ERR` -* `FileTransferError.CONNECTION_ERR` -* `FileTransferError.ABORT_ERR` +* 1 = `FileTransferError.FILE_NOT_FOUND_ERR` +* 2 = `FileTransferError.INVALID_URL_ERR` +* 3 = `FileTransferError.CONNECTION_ERR` +* 4 = `FileTransferError.ABORT_ERR` ## 向後相容性注意到