You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ld...@apache.org on 2014/07/07 21:27:30 UTC
git commit:
CB-6127lisa7cordova-plugin-consolecordova-plugin-file-transfer documentation
translation: cordova-plugin-file-transfer
Repository: cordova-plugin-file-transfer
Updated Branches:
refs/heads/master 9035d7956 -> 04d45bab3
CB-6127lisa7cordova-plugin-consolecordova-plugin-file-transfer documentation translation: cordova-plugin-file-transfer
Project: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/commit/04d45bab
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/tree/04d45bab
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/diff/04d45bab
Branch: refs/heads/master
Commit: 04d45bab345122a34d79b9c09c730955404f493f
Parents: 9035d79
Author: Lisa Seacat DeLuca <ld...@us.ibm.com>
Authored: Mon Jul 7 15:27:22 2014 -0400
Committer: Lisa Seacat DeLuca <ld...@us.ibm.com>
Committed: Mon Jul 7 15:27:22 2014 -0400
----------------------------------------------------------------------
doc/de/index.md | 12 ++-
doc/es/index.md | 12 ++-
doc/fr/index.md | 12 ++-
doc/it/index.md | 12 ++-
doc/ja/index.md | 12 ++-
doc/ko/index.md | 12 ++-
doc/ru/index.md | 283 +++++++++++++++++++++++++++++++++++++++++++++++++++
doc/zh/index.md | 12 ++-
8 files changed, 332 insertions(+), 35 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/04d45bab/doc/de/index.md
----------------------------------------------------------------------
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
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/04d45bab/doc/es/index.md
----------------------------------------------------------------------
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
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/04d45bab/doc/fr/index.md
----------------------------------------------------------------------
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
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/04d45bab/doc/it/index.md
----------------------------------------------------------------------
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
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/04d45bab/doc/ja/index.md
----------------------------------------------------------------------
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`
## 後方互換性をノートします。
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/04d45bab/doc/ko/index.md
----------------------------------------------------------------------
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`
## 이전 버전과 호환성 노트
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/04d45bab/doc/ru/index.md
----------------------------------------------------------------------
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 @@
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+# 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/<application UUID>/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
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/04d45bab/doc/zh/index.md
----------------------------------------------------------------------
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`
## 向後相容性注意到