微信小程序开发 -- 通过云函数下载任意文件

微信小程序开发 -- 通过云函数下载任意文件

1.云开发介绍

​ 微信小程序开发者众所周知，小程序开发拥有许多限制，当我还是一个菜鸟入门的时候，第一关就卡在了没有备案域名的HTTP请求上面，那时候云开发上线也没多久，使用的人也不是很多，我抱着尝试的态度去接触了云开发，发现了云开发的妙处。（自由）

blog：微信小程序HTTP访问链接解决方案

2.小程序文件下载限制

微信小程序除了对访问地址有限制之外，对于文件下载，也存在的限制，如下图所示，只有资源服务器A，在downloadFile域名白名单内且配置了SSL访问，即HTTPS才可以正常的下载资源。（闲的蛋疼，饱受诟病）

.png)

3.云函数下载任意文件设计

依然秉持着对云开发的信任，尝试使用云函数进行任意文件下载，设计思路如下图所示。

.png)

上图描述的两种通过云函数下载文件的方式

1. 云函数只作为一个数据中转节点，请求资源转化为Buffer直接返回给小程序端。
2. 云函数作为存储器，下载资源存储到云空间，并返回给小程序端fileID(置换下载地址)。

4.云函数实现方式

通过请求头配置实现请求资源文件返回Buffer。

const cloud = require('wx-server-sdk')

const request = require('request')

const fs = require('fs')

const path = require('path')

cloud.init({

  env: cloud.DYNAMIC_CURRENT_ENV

})

const db = cloud.database(); //初始化云数据库

exports.main = async (event, context) => {

  var url = event.url; //下载地址,应该由前端进行传递,而后云函数进行下载

  var type = event.type; //type:'dump'(转储) 'trans'(传递)

  var filename = event.filename;

  //文件名称需要自己进行上传,或者substring 截取url

  var options = {

    url: url,

    encoding: null,

    headers: {

      "content-type": "application/octet-stream",

    },

  };

  return new Promise(function (resolve, reject) {

    request(options, function (error, response, body) {

      if(type=='trans'){

          //中继

        resolve(body)

      }else{

          //转储

        resolve(

          cloud.uploadFile({

            cloudPath: 'tmp/'+filename,

            fileContent: body,

          })

        )

      }

    })

  })

}

5.中继下载方式（不推荐，适合小文件）

如果文件达到一定体积，会出现如下问题：

中继下载方式对文件的大小有限制，这是由于云函数返回限制决定的，很容易超出。但是对于一些几kb的文件，推荐使用这种方式，减少了转储所需要耗费的时间。

中继方式下载资源写法如下：

   var _filename = '美景.jpg';

   var _url = 'http://img.apisev.cn:8081/wechat/sk1.jpg';

    wx.cloud.callFunction({

      name:'transfile',

      data:{

        url:_url,

        filename:_filename,

        type:'trans'

      },

      success(res){

        console.log(res)

        const FileSystemManager = wx.getFileSystemManager();

        FileSystemManager.writeFile({

          filePath:wx.env.USER_DATA_PATH+"/"+_filename,

          data:res.result,

          encoding: 'binary',//编码方式，二进制

          success(tres){

            console.log(tres)

            //可以根据filePath 打开文件，此处以为图片举例

            var _filepath = wx.env.USER_DATA_PATH+"/"+_filename;

            wx.previewImage({

              urls: [_filepath],

            })

          },fail(tres){

            console.log(tres)

          }

        })

      },fail(res){

        console.log(res)

      }

    })

真机运行，可以成功预览资源图片。

6.转储下载方式（推荐）

首先在互联网资源随便找了一个图片资源地址，调用云函数。

var _filename = '美景.jpg';

var _url = 'https://n.sinaimg.cn/sinacn20106/212/w2048h1364/20190828/cded-icuacsa3953451.jpg';

wx.cloud.callFunction({

      name:'transfile',

      data:{

        url:_url,

        filename:_filename,

        type:'dump'

      },

      success(res){

        console.log(res)

      },fail(res){

        console.log(res)

      }

 })

返回内容如下：

图片成功被转存到云存储空间。

7.参考文档

[1] FileSystemManager.writeFile(Object object)