1.最外层代码:
let downLoadFile = new class {
……
}
export {
downLoadFile
}
暴露实例化的工具类,在使用工具类时,不需要再实例化。
2.类内封装代码:
2.1 构造函数
个人习惯,觉得用constructor定义构造函数更有语义,不喜欢的也可以按照ES6推荐的简易写法。
构造函数中定义了一些使用率高的变量,便于在各个方法中调用。例如:_baseUrl(后端环境地址),_savePath(保存文件地址)等等
2.2 setConfig函数
个性化参数设置函数,代码如下:
setConfig(param){
// 为整个类设置个性化参数
this.handleType=param.handleType
return this
}
目前只是在里面设置了handleType参数,handleType——用以控制操作类型为分享还是打开,对应参数“share”,“open”。
return this:返回对象本身。便于链式语法调用类内其他方法,例:
this.$util.downLoadFile.setConfig({
handleType: 'open'
}).download(param)
2.3 文件下载方法实现
下载方法包含:
1.download:主要方法,判断传入的参数param是否是数组,根据参数类型做不同处理,并调用方法uniDownload。
if (param.fileArr && param.fileArr.length > 0) {
// 传入的是文件参数是数组
for (let i = 0; i < param.fileArr.length; i++) {
let fName = param.fileArr[i].name ? param.fileArr[i].name : ''
res = await this.uniDownload(this._baseUrl + param.fileArr[i].url, fName)
}
} else {
// 传入的文件参数是json
let downUrl = this._downloadUrl + '?id=' + param.id + '&type=' + param.type
res = await this.uniDownload(downUrl, param.fileName)
}
2.uniDownload:主要功能是封装uniapp提供的API:uni.downloadFile
downloadTask = uni.downloadFile({
url: downUrl,
success: (res) => {
if (res.statusCode === 200) {
console.log('下载成功');
}
if (me._platform == 'plus') {
me.handleFile_APP(res.tempFilePath, fileName)
} else if (me._platform == 'mp' || me._platform == 'weixin') {
me.handleFile_WEIXIN(res.tempFilePath, fileName)
}
}
});
3.handleFile_APP:APP平台下,创建项目定义的文件夹,并将文件保存。代码过于久远,我已经忘了各api的详细用法,具体参考decloud官网plus用法。
4.handleFile_WEIXIN:微信小程序平台下,创建项目定义的文件夹,并将文件保存。这里的API调用的是uniapp,可能可以适配更多平台。
5.isSaved:判断文件是否保存
6.openFile:打开文件。
7.shareFile:分享文件。调用了第三方原生插件,具体方法可参考官网对requireNativePlugin的介绍。
8.deleteFile:删除文件。
3. 调用示例:
把downloadFile.js在util文件中引入,调用时语法如下:
this.$util.downLoadFile.setConfig({
handleType: 'open'
}).download(param)
通过调用可以看出,setConfig方法就像一个过滤函数,可以为downloadFile工具类设置一些默认参数,如果要把此工具做的更通用,可以将下载地址、文档保存地址等参数都放到setConfig中维护,实现参数可配置需求。这个方法是为了增强整个工具的可拓展性。
思考:有没有一种更优雅的方式,而不是为每个方法增加“return this”,实现把可能有联系的一些方法优化成链式调用。