正文

LoopBackJS 之 文件上传下载——使用loopback-component-storage

IP云
IP云V管理员/6 阅读
08/03
提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

参考链接：

http://loopback.io/doc/en/lb2/Storage-component.html#creating-a-storage-component-data-source

http://stackoverflow.com/questions/37238414/validate-and-rename-image-file-from-loopback-component-storage?noredirect=1

http://stackoverflow.com/questions/27743424/strongloop-file-upload-inside-model?noredirect=1

一、简介：

（翻译自官方文档的Overview） :)

使用LoopBack storage组件可以很容易的从云存储以及本地文件系统下载或者是上传文件。

在云提供商（包括Amazon、Rackspace、Openstack、Azuer）中该组件提供了Nodejs和REST API 来管理二进制内容，

你可以像使用Loopback data source（比如数据库）一样来使用该存储组件，和其他数据源一样，该组件支持create，read，

update，delete（CRUD）操作，而且也提供了同样的Loopback和REST API。

注意：该组件目前没有提供“开箱即用”的元数据（metadata）管理。

二、安装

安装存储组件和安装普通的Node包一样

npm install --save loopback-component-storage

 

三、容器（Containers）和文件（files）

该存储组件将内容组织成 容器（containers）和 文件（files）。容器内存有文件集合，并且每个文件属于单个容器（container）

容器 将文件分组，类似于目录或者是文件夹。每个容器 定义了对象的命名空间并且使用唯一的名字来区分，通常是在用户账户内。

注意：容器内不能有子容器。

文件 储存数据，例如文档或者是图像。每个文件总是在且仅仅在一个容器 内。在容器内部，每个文件拥有唯一的名字。在不同容器

里的文件可以有相同的名字。（这也就意味着，如果之前容器内已经有了同名文件，后上传的文件会覆盖之前的文件。 文章最后会讲如何处理此问题。）

接下来就是正式的操作过程了。 - -

四、 新建存储组件数据源

$ slc loopback:datasource
[?] Enter the data-source name: storage
[?] Select the connector for myfile: other
[?] Enter the connector name without the loopback-connector- prefix: loopback-component-storage
[?] Install storage (Y/n)

这样我们就创建好了一个名为“storage”的数据源了，然后我们编辑  /server/datasources.json 文件，手动添加此数据源需要的配置。

这里我们以本地文件系统为例。

"storage": {
"name": "storage",
"connector": "loopback-component-storage",
"provider": "filesystem",
"root": "./server/storage"
}

其中“root”参数为存储文件的根目录，此处root参数表示 项目根目录下server文件夹内的storage文件夹。

创建好数据源后还需要model来进行容器（container）的操作，下一步：创建model 取名为container

五、新建容器 model

$ slc loopback:model
? Enter the model name: Container
? Select the data-source to attach Container to: storage (loopback-component-st
orage)
? Select model's base class Model
? Expose Container via the REST API? Yes
? Custom plural form (used to build REST URL):
? Common model or server only? common
Let's add some Container properties now.Enter an empty property name when done.
? Property name:$

这是生成的model json文件内容：

{
"name": "Container",
"base": "Model",
"properties": {},
"validations": [],
"relations": {},
"acls": [],
"methods": {}
}

注意：这里base class必须选择为Model，因为此数据源并不是数据库。

当然，我们除了要实现文件的上传和下载外，还需要记录下文件的相关信息，我们还要创建一个model来实现这

部分的逻辑。

下一步：创建文件模型，取名为File。File模型的 property可以选择自己感兴趣的信息，比如

文件类型，文件名称，文件url。

五、新建文件model

$:slc loopback:model
? Enter the model name: StorageFile
? Select the data-source to attach file to: db
? Select model's base class：PersistedModel
? Expose file via the REST API? Yes
? Custom plural form (used to build REST URL):
? Common model or server only? common Let's add some file properties now. Enter an empty property name when done.
? Property name: type
invoke loopback:property
? Property type: string
? Required? No
? Default value[leave blank for none]: Let's add another file property. Enter an empty property name when done.
? Property name: name
invoke loopback:property
? Property type: string
? Required? No
? Default value[leave blank for none]:
Let's add another file property.
Enter an empty property name when done.
? Property name: url
invoke loopback:property
? Property type: string
? Required? No
? Default value[leave blank for none]:
Let's add another file property. Enter an empty property name when done.
? Property name:

这是生成的model json文件内容：

{
"name": "StorageFile",
"base": "PersistedModel",
"idInjection": true,
"options": {
"validateUpsert": true
},
"properties": {
"type": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
}
},
"validations": [],
"relations": {},
"acls": [],
"methods": {}
}

到此，我们需要的model就都创建完毕了。 :)

现在我们要把StorageFile model和 Container model联系在一起

在/common/models/storage-file.js 中添加代码var CONTAINERS_URL = '/api/containers/';

'use strict';var CONTAINER_URL = '/api/containers/';module.exports = function(StorageFile) {
StorageFile.upload = function(ctx, options, cb) {
options = options || {};
// 首先创建好目录 /server/storage/common
ctx.req.params.container = 'common';
/**
* ctx.req express request object
* ctx.result express response object
*/
StorageFile.app.models.Container.upload(ctx.req, ctx.result,
options, function(err, fileObj) {
if (err) {
return cb(null, {
status: 'failed',
message: err.message,
});
} else {
// 此处 “file” 应当与表单中的 field name 相同
var fileInfoArr = fileObj.files.file;
var objs = [];
fileInfoArr.forEach(function(item) {
objs.push({
name: item.name,
type: item.type,
url: CONTAINER_URL + item.container +
'/download/' + item.name,
});
});
StorageFile.create(objs, function(err, instances) {
if (err) {
return cb(null, {
message: err.message,
});
} else {
cb(null, instances);
}
});
}
});
}; StorageFile.remoteMethod(
'upload', {
description: 'Upload a file or more files',
accepts: [
{arg: 'ctx', type: 'object', http: {source: 'context'}},
{arg: 'options', type: 'object', http: {source: 'query'}},
],
returns: {
arg: 'fileObject', type: 'object', root: true,
},
http: {verb: 'post'},
}
);
};

现在，我们可以通过 POST

/api/StorageFiles/upload

来上传文件了 （注意表单field名为file  与 上述代码中的浅绿色部分相对应， 当然你也可以用其他名字， 只要保证表单中上传文件的field名字 与代码中相对应。）

简单的一个文件上传表单（需要设置enctype 不要漏掉  input标签name值应当为“file”与代码中相对应，不要漏掉)

<!DOCTYPE>
<html>
<head>
<meta charset="utf-8">
<title>File upload</title>
</head>
<body>
<div>
<form role="form" action="/api/StorageFiles/upload",
method="POST" enctype="multipart/form-data">
<input type="file" name="file" multiple>
<button type="submit">Upload</button>
</form>
</div>
</body>
</html>

这是我上传文件成功后返回的数据：

{
"type": "application/msword",
"name": "测试报告（附件6）.DOC",
"url": "/api/containers/common/download/测试报告（附件6）.DOC",
"container": "common",
"id": 1
}

在实际的文件上传中会发现，当上传同名文件时，会发现后上传的文件会把之前服务器上存在的同名文件给覆盖掉。这种情况怎么解决呢？ 一种比较简单的实现方式是给文件加上时间戳。

还有，可能还需要限制上传文件的大小、类型，这种又如何实现呢？

只要在/server/datasources.local.js 中添加如下代码即可。

'use strict';var path = require('path');module.exports = {
storage: {
// 限定上传文件的类型
allowedContentTypes: ['application/msword', 'image/jpg',
'image/png', 'image/jpeg',
'image/tiff', 'application/pdf'], // 限定上传文件大小为50M
maxFileSize: 50 * 1024 * 1024, // 自定义文件名
getFilename: function(fileInfo) {
var fileName = fileInfo.name.replace(/\s+/g, '-').toLowerCase();
var fileObj = path.parse(fileName);
// 给文件名加上时间戳
return fileObj.name + Date.now() + fileObj.ext;
},
},
};

:) 这是添加代码后上传成功返回的数据：

{
"type": "application/msword",
"name": "项目安装部署指南-1480669801338.doc",
"url": "/api/containers/common/download/项目安装部署指南-1480669801338.doc",
"container": "common",
"id": 3
}

其中“url”参数值就是文件下载地址了。

最后附上 github上 本文代码地址：

https://github.com/dreamdevil00/loopback-file-upload