플러그인 문서: <doc/index.md>
이 플러그인을 사용 하면 업로드 및 다운로드 파일 수 있습니다.
이 플러그인 글로벌 FileTransfer, FileUploadOptions 생성자를 정의합니다.
전역 범위에서 그들은 제공 되지 않습니다 때까지 deviceready 이벤트 후.
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
console.log(FileTransfer);
}
cordova plugin add cordova-plugin-file-transfer
** Onprogress 도 abort() 를 지원 하지 않습니다*
*** Onprogress 를 지원 하지 않습니다*
FileTransfer 개체는 HTTP 다중 파트 POST 또는 PUT 요청을 사용 하 여 파일을 업로드 하 고 또한 파일을 다운로드 하는 방법을 제공 합니다.
ProgressEvent 새로운 양의 데이터를 전송 하는 때마다. (기능)업로드: 파일을 서버에 보냅니다.
다운로드: 서버에서 파일을 다운로드 합니다.
중단: 진행 중인 전송 중단.
매개 변수:
fileURL: 장치에 파일을 나타내는 파일 시스템 URL. 에 대 한 이전 버전과 호환성을이 수도 장치에 있는 파일의 전체 경로 수. (참조 [거꾸로 호환성 노트] 아래)
서버: 인코딩 파일 수신 서버의 URLencodeURI().
successCallback: FileUploadResult 개체를 전달 하는 콜백. (기능)
errorCallback: FileUploadResult 검색에 오류가 발생 하면 실행 되는 콜백. FileTransferError 개체와 함께 호출 됩니다. (기능)
옵션: 선택적 매개 변수 (개체). 유효한 키:
file . (DOMString)image.jpg . (DOMString)넣어 또는 게시물-사용 하도록 HTTP 메서드. 게시물 기본값입니다. (DOMString)이미지/jpeg의 기본값입니다. (DOMString)true입니다. (부울)게시물기본값입니다. (DOMString)trustAllHosts: 선택적 매개 변수는 기본적으로 false . 만약 설정 true , 그것은 모든 보안 인증서를 허용 합니다. 이 안 드 로이드 자체 서명 된 보안 인증서를 거부 하기 때문에 유용 합니다. 프로덕션 환경에서 사용 권장 되지 않습니다. 안 드 로이드와 iOS에서 지원. (부울)
// !! 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);
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 개체 FileTransfer 개체의 원래 방법의 성공 콜백에 전달 됩니다.
bytesSent: 업로드의 일부로 서버에 보낸 바이트 수. (긴)
responseCode: 서버에서 반환 된 HTTP 응답 코드. (긴)
response: 서버에서 반환 되는 HTTP 응답. (DOMString)
headers: 서버에서 HTTP 응답 헤더. (개체)
responseCode 또는bytesSent.매개 변수:
source: URL로 인코딩된 파일, 다운로드 서버encodeURI().
target: 장치에 파일을 나타내는 파일 시스템 url. 에 대 한 이전 버전과 호환성을이 수도 장치에 있는 파일의 전체 경로 수. (참조 [거꾸로 호환성 노트] 아래)
successCallback: 콜백 전달 되는 FileEntry 개체. (기능)
errorCallback: FileEntry를 검색할 때 오류가 발생 하면 실행 되는 콜백. FileTransferError 개체와 함께 호출 됩니다. (기능)
trustAllHosts: 선택적 매개 변수는 기본적으로 false . 만약 설정 true , 그것은 모든 보안 인증서를 허용 합니다. 안 드 로이드 자체 서명 된 보안 인증서를 거부 하기 때문에 유용 합니다. 프로덕션 환경에서 사용 권장 되지 않습니다. 안 드 로이드와 iOS에서 지원. (부울)
options: 선택적 매개 변수를 현재 지 원하는 머리글만 (예: 인증 (기본 인증), 등).
// !! 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=="
}
}
);
if-수정-이후 헤더를 다운로드 하는 방법.진행 중인 전송을 중단합니다. onerror 콜백 FileTransferError.ABORT_ERR의 오류 코드는 FileTransferError 개체를 전달 합니다.
// !! 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 개체 오류가 발생 하면 오류 콜백에 전달 됩니다.
code: 미리 정의 된 오류 코드 중 하나가 아래에 나열 된. (수)
source: 소스 URL. (문자열)
target: 대상 URL. (문자열)
http_status: HTTP 상태 코드. 이 특성은 응답 코드를 HTTP 연결에서 수신에 사용할 수 있습니다. (수)
body 응답 본문입니다. 이 특성은 HTTP 연결에서 응답을 받을 때에 사용할 수 있습니다. (문자열)
exception: 어느 e.getMessage 또는 e.toString (문자열)
FileTransferError.FILE_NOT_FOUND_ERRFileTransferError.INVALID_URL_ERRFileTransferError.CONNECTION_ERRFileTransferError.ABORT_ERRFileTransferError.NOT_MODIFIED_ERR이 플러그인의 이전 버전만 업로드에 대 한 소스 또는 다운로드에 대 한 대상 장치 절대 파일 경로 받아들일 것 이다. 이러한 경로 일반적으로 폼의 것
/var/mobile/Applications/<application UUID>/Documents/path/to/file (iOS) /storage/emulated/0/path/to/file (Android)
대 한 뒤 호환성, 이러한 경로 여전히 허용, 그리고 응용 프로그램이 영구 저장소에서 이와 같은 경로 기록 했다, 그때 그들은 계속할 수 있다면 사용할 수.
이러한 경로 FileEntry 및 파일 플러그인에 의해 반환 된 DirectoryEntry 개체의 fullPath 속성에 노출 되었던. 그러나 파일 플러그인의,, 더 이상 새로운 버전 자바 스크립트이 경로 노출.
새로 업그레이드 하는 경우 (1.0.0 이상) 버전의 파일, 및 이전 사용 하 고 entry.fullPath download() 또는 upload() 인수로 다음 대신 파일 시스템 Url을 사용 하 여 코드를 변경 해야 합니다.
폼의 파일 URL을 반환 하는 FileEntry.toURL() 및 DirectoryEntry.toURL()
cdvfile://localhost/persistent/path/to/file
어떤 download() 및 upload() 방법에서 절대 파일 경로 대신 사용할 수 있습니다.