七牛直传文件

官方 API 地址: https://developer.qiniu.com/kodo/sdk/1283/javascript

由于七牛提供了 JavaScript 上传的插件,本文将采用该插件实现七牛直传。
1. 获取七牛上传凭证
  • 与阿里云OSS直传不同的是,七牛只需要获取一个 token 即可(本质是一样的)。

  • 获取需要后端的配合,提供一个接口。

  • 要注意获取和保存的时机,根据过期时间记录相关 sessionStorage 比较好,既能减少请求的次数,又能保证上传时凭证有效。

  • 获取 token 流程:

(1)发送获取 token 请求 --> (2)得到 token 并本地保存,用于之后的直传 --> (3)带着 token 参数向七牛发送请求,直传图片 --> (4) 上传成功,七牛会返回相应的图片地址(这个地址后续需要按照一定规则传给后端)

  • 获取 token 示例
/**
    * 获取七牛图片上传 token (进入相关页面预先请求)
    * @returns {Promise.<T>}
*/
const getUploadToken = () => {
    http.post('getUploadToken').then(res => {
        if (res.code === 200) {
            this.isPull = false;
            const expireTime = 30 * 60 * 1000; // 过期时间,单位毫秒(ms)
            sessionStorage.setItem('uploadToken', res.data.upload_token);
            sessionStorage.setItem('uploadTokenExpireTime', new Date().getTime() + expireTime); // 设置 token 过期时间
            sessionStorage.setItem('imgURL', res.data.image_url); // 暂存图片地址
        } else {
            // 错误统一处理函数
            this.errorHandler(res);
        }
    }).catch(() => {
        console.log('error');
    });
}

2. 图片处理
  • 这里即将使用的 qiniu.min.js 也包含了图片裁剪、缩放、旋转等功能。有兴趣的可以看下这个文档:七牛 - 图片高级处理

这里介绍一下自己实现图片的简单处理。

(1) 压缩图片在 iOS 上存在一个旋转的问题,需要先做处理,这里引入了 exif-js

import Exif from 'exif-js'

(2)图片旋转

/**
 *  iOS 旋转图片
 * @param img  图片
 * @param direction 旋转方向
 * @param canvas 画布
 */
const rotateImg = (img, direction, canvas) => {
    // 最小与最大旋转方向,图片旋转4次后回到原方向
    const min_step = 0;
    const max_step = 3;
    if (img === null) return;
    // img 的高度和宽度不能在 img 元素隐藏后获取,否则会出错
    let height = img.height;
    let width = img.width;
    let step = 2;
    if (step === null) {
        step = min_step;
    }
    if (direction === 'right') {
        step++;
        // 旋转到原位置,即超过最大值
        step > max_step && (step = min_step);
    } else {
        step--;
        step < min_step && (step = max_step);
    }
    // 旋转角度以弧度值为参数
    let degree = step * 90 * Math.PI / 180;
    let ctx = canvas.getContext('2d');
    switch (step) {
        case 0:
            canvas.width = width;
            canvas.height = height;
            ctx.drawImage(img, 0, 0);
            break;
        case 1:
            canvas.width = height;
            canvas.height = width;
            ctx.rotate(degree);
            ctx.drawImage(img, 0, -height);
            break;
        case 2:
            canvas.width = width;
            canvas.height = height;
            ctx.rotate(degree);
            ctx.drawImage(img, -width, -height);
            break;
        case 3:
            canvas.width = height;
            canvas.height = width;
            ctx.rotate(degree);
            ctx.drawImage(img, -width, 0);
            break;
    }
}

(3)图片压缩

/*
 * canvas 压缩图片
 * @param img 图片
 * @param Orientation 旋转参数
 * @returns ndata 压缩后的数据
*/
const compress = (img, Orientation) => {
    let canvas = document.createElement("canvas");
    let ctx = canvas.getContext('2d');
    //瓦片canvas
    let tCanvas = document.createElement("canvas");
    let tctx = tCanvas.getContext("2d");
    let initSize = img.src.length;
    let width = img.width;
    let height = img.height;
    let time = new Date().getTime();
    // 如果图片大于四百万像素,计算压缩比并将大小压至400万以下
    let ratio;
    if ((ratio = width * height / 4000000) > 1) {
        console.log("大于400万像素");
        ratio = Math.sqrt(ratio);
        width /= ratio;
        height /= ratio;
    } else {
        ratio = 1;
    }
    canvas.width = width;
    canvas.height = height;
    // 铺底色
    ctx.fillStyle = "#fff";
    ctx.fillRect(0, 0, canvas.width, canvas.height);
    // 如果图片像素大于100万则使用瓦片绘制
    let count;
    if ((count = width * height / 1000000) > 1) {
        console.log("超过100W像素");
        count = ~~(Math.sqrt(count) + 1); //计算要分成多少块瓦片
        // 计算每块瓦片的宽和高
        let nw = ~~(width / count);
        let nh = ~~(height / count);
        tCanvas.width = nw;
        tCanvas.height = nh;
        for (let i = 0; i < count; i++) {
            for (let j = 0; j < count; j++) {
                tctx.drawImage(img, i * nw * ratio, j * nh * ratio, nw * ratio, nh * ratio, 0, 0, nw, nh);
                ctx.drawImage(tCanvas, i * nw, j * nh, nw, nh);
            }
        }
    } else {
        ctx.drawImage(img, 0, 0, width, height);
    }
    // 修复ios上传图片的时候 被旋转的问题
    if (Orientation != '' && Orientation != 1) {
        switch (Orientation) {
            case 6: // 需要顺时针(向左)90度旋转
                this.rotateImg(img, 'left', canvas);
                break;
            case 8: // 需要逆时针(向右)90度旋转
                this.rotateImg(img, 'right', canvas);
                break;
            case 3: // 需要180度旋转
                this.rotateImg(img, 'right', canvas);//转两次
                this.rotateImg(img, 'right', canvas);
                break;
        }
    }
    // 进行最小压缩
    let ndata = canvas.toDataURL('image/jpeg', 0.1);
    console.log('压缩前:' + initSize);
    console.log('压缩后:' + ndata.length);
    console.log('压缩率:' + ~~(100 * (initSize - ndata.length) / initSize) + "%");
    tCanvas.width = tCanvas.height = canvas.width = canvas.height = 0;
    console.log('使用时间:' + (new Date().getTime() - time) + 'ms');
    return ndata;
}

(4) 将 base64 图片编码转为 Blob 对象

/*
 * 将 base64 图片编码转为 Blob 对象
 * @dataURI 图片 base64 编码
 * @returns {Blob}
*/
const dataURItoBlob = (dataURI) => {
    let byteString = atob(dataURI.split(',')[1]);
    let mimeString = dataURI.split(',')[0].split(':')[1].split(';')[0];
    let ab = new ArrayBuffer(byteString.length);
    let ia = new Uint8Array(ab);
    for (let i = 0; i < byteString.length; i++) {
        ia[i] = byteString.charCodeAt(i);
    }
    return new Blob([ab], {type: mimeString});
}

3. 七牛上传方法

(1)引入七牛

import * as qiniu from 'qiniu-js'

(2)上传方法

 /**
 *  七牛上传
 *  @param base64String 文件信息(Blob 或 base64String)
 */
const qiniuUpload = (base64String) => {
     // 由于有些大图进行压缩后变成了 base64String,而小图没有经过处理仍是 Blob 对象,七牛接收的参数是 Blob 对象,故对字符串类型的参数进行转换
     let file;
     if (typeof base64String === 'string'){
         file = this.dataURItoBlob(base64String);
     } else {
         file = base64String;
     }
    // 七牛上传的方法
    // 第一个参数是文件对象(Blob),第二个参数是文件名称(这个名称不能相同,命名时候请加入时间搓,确保文件名称唯一),第三个参数是 token
    const observable = qiniu.upload(file, file.name, sessionStorage.getItem('uploadToken'), {
        fname: file.name,
        params: {},
        mimeType: [] || null
    }, {
         useCdnDomain: true, // cdn
         unique_names: false, // 唯一名称
         region: qiniu.region.z0 // 根据区域设置上传的域名
    });

    // 返回 Promise,在里面执行七牛直传
    return new Promise( (resolve, reject) => {
        const subscription = observable.subscribe({
            next (res) {
                // 上传的进度,可以获得总大小,已传大小,上传百分比进度
            },
            error (err) {
                console.log('失败');
                console.log(err);
            },
            complete (res) {
                // 成功后,回调操作
                console.log('上传成功');
                resolve({
                    base64String: base64String,
                    imgUrl: sessionStorage.getItem('imgURL')+'/'+ res.key
                });
            }
        });
    });
}

4. 前面所做的都是准备工作,真正触发上传的在这里
/*
 * 读文件(<input type="file"> 由 change 事件触发)
 * @param file 文件 Blob 对象,由 change 事件触发后传入该参数
 * @returns {Promise}
*/
const readFiles = (file) => {
    // 首先判断 token 是否过期
    async function getToken() {
        if (new Date().getTime() > sessionStorage.getItem('uploadTokenExpireTime')) {
            getUploadToken();
        }
    }

    return getToken().then(() => {
        let Orientation;
        let base64String = '';
        const reader = new FileReader(); // 创建 FileReader 对象 并调用 render 函数来完成渲染

        // 将图片将转成 base64 格式
        base64String = reader.readAsDataURL(file);
        // iOS 旋转问题
        Exif.getData(file, function () {
            Orientation = Exif.getTag(this, 'Orientation');
        });

        // 读取后压缩文件
        return new Promise(resolve => {
            reader.onloadend = function () {
                let result = this.result;
                let img = new Image();
                img.src = result;
                //判断图片是否大于100K,是就直接上传,反之压缩图片
                if (this.result.length <= (100 * 1024)) {
                    resolve(qiniuUpload(result));
                } else {
                    img.onload = function () {
                        let data = that.compress(img, Orientation);
                        resolve(that.qiniuUpload(data));
                    }
                }
            };
        });
    });
}

在低版本浏览器使用上存在一定的兼容问题;

上面的方法使用了 es6 语法;

上面的方法不能搬来直接使用,需要做一点小改动。

5. 使用 readFile 后会返回七牛的回调数据,在 readFile().then(res => {...}) 写相应操作即可

推荐阅读更多精彩内容