文件操作Files
1.创建一个Parse.File
Parse.File让您可将应用程序文件存储在云中,否则对一般的Parse.Object来说会太大或太繁琐。最常见的用例是存储图像,但也可以将其用于文档、视频、音乐和任何其他二进制数据(最多10M)。
使用Parse.File很简单。有几种方法来创建文件。第一个是使用base64编码的String。
var base64 = "V29ya2luZyBhdCBQYXJzZSBpcyBncmVhdCE=";
var file = new Parse.File("myfile.txt", { base64: base64 });
或者,您可以从字节数组创建一个文件:
var bytes = [ 0xBE, 0xEF, 0xCA, 0xFE ];
var file = new Parse.File("myfile.txt", bytes);
Parse将根据文件扩展名自动检测您上传的文件类型,但也可以在第三个参数中指定Content-Type:
var file = new Parse.File("myfile.zzz", fileData, "image/png");
但是在HTML5应用中最常见的,是使用带有文件上传控件的html表单。在现代浏览器上,这很简单。创建一个文件输入标签,允许用户从本地驱动器中选择一个文件进行上传:
<input type="file" id="profilePhotoFileUpload">
然后,在点击处理程序或其他函数中,获取对该文件的引用:
var fileUploadControl = $("#profilePhotoFileUpload")[0];
if (fileUploadControl.files.length > 0) {
var file = fileUploadControl.files[0];
var name = "photo.jpg";
var parseFile = new Parse.File(name, file);
}
请注意,在这个例子中,我们给文件命名为photo.jpg。这里需要注意两点:
- 您不需要担心文件名冲突。每次上传都会获得唯一的标识符,因此上传多个名为photo.jpg的文件没有任何问题。
- 您必须在文件命名时指定一个文件扩展名。这使得Parse可以根据文件类型做相应的处理。因此,如果您正在存储PNG图像,请确保您的文件名以.png为后缀。
接下来,您将把文件保存到云端。与Parse.Object一样,您可以使用save方法的许多变体,具体取决于什么样的回调和错误处理适合您。
parseFile.save().then(function() {
// The file has been saved to Parse.
}, function(error) {
// The file either could not be read, or could not be saved to Parse.
});
最后,保存完成后,可以把Parse.File关联到一个Parse.Object,就像关联任何数据块一样:
var jobApplication = new Parse.Object("JobApplication");
jobApplication.set("applicantName", "Joe Smith");
jobApplication.set("applicantResumeFile", parseFile);
jobApplication.save();
2.检索文件内容
如何最优地检索文件内容取决于您应用程序的上下文。由于跨域请求问题,最好是让浏览器为您完成此工作。通常,这意味着将文件的URL渲染到DOM中。在这里,我们使用jQuery在页面上渲染上传的个人资料照片:
var profilePhoto = profile.get("photoFile");
$("profileImg")[0].src = profilePhoto.url();
如果要在Cloud Code中处理文件数据,可以使用我们的http网络库检索文件:
Parse.Cloud.httpRequest({ url: profilePhoto.url() }).then(function(response) {
// The file contents are in response.buffer.
});
您可以使用REST API删除对象引用的文件。您需要提供主密钥才能允许删除文件。
如果您应用程序中的任何对象都未引用您的文件,则无法通过REST API删除它们。您可以在应用的“设置”页面中请求清除未使用的文件。请记住,这样做可能会对那些依赖于通过其URL属性访问未被引用的文件的功能造成破坏。但是当前已经与对象关联的文件不会受到影响。