feat(File): add #setUploadHeader (#512)

Author: leeyeh

src/file.js

@@ -67,9 +67,9 @@ module.exports = function(AV) {
    * @param data {Array} The data for the file, as either:
    *     1. an Array of byte value Numbers, or
    *     2. an Object like { base64: "..." } with a base64-encoded String.
-   *     3. a File object selected with a file upload control. (3) only works
-   *        in Firefox 3.6+, Safari 6.0.2+, Chrome 7+, and IE 10+.
-   *     4.a Buffer object in Node.js runtime.
+   *     3. a Blob(File) selected with a file upload control.
+   *     4. a Buffer in Node.js runtime.
+   *     5. a Stream in Node.js runtime.
    *
    *        For example:<pre>
    * var fileUploadControl = $("#profilePhotoFileUpload")[0];
@@ -109,6 +109,7 @@ module.exports = function(AV) {
 
     this._extName = '';
     this._data = data;
+    this._uploadHeaders = {};
 
     if (process.env.CLIENT_PLATFORM === 'ReactNative' || process.env.CLIENT_PLATFORM === 'Weapp') {
       if (data && data.blob) {
@@ -333,6 +334,19 @@ module.exports = function(AV) {
       }
     },
 
+    /**
+     * Set a header for the upload request. 
+     * For more infomation, go to https://url.leanapp.cn/avfile-upload-headers
+     * 
+     * @param {String} key header key
+     * @param {String} value header value
+     * @return {AV.File} this
+     */
+    setUploadHeader(key, value) {
+      this._uploadHeaders[key] = value;
+      return this;
+    },
+
     /**
     * <p>Returns the file's metadata JSON object if no arguments is given.Returns the
     * metadata value if a key is given.Set metadata value if key and value are both given.</p>

src/uploader/cos.js

@@ -10,6 +10,7 @@ module.exports = function upload(uploadInfo, data, file, saveOptions = {}) {
 
   return new Promise((resolve, reject) => {
     const req = request('POST', uploadUrl)
+      .set(file._uploadHeaders)
       .field('fileContent', data)
       .field('op', 'upload');
     if (saveOptions.onprogress) {

src/uploader/qiniu.js

@@ -10,6 +10,7 @@ module.exports = function upload(uploadInfo, data, file, saveOptions = {}) {
   const uptoken = uploadInfo.token;
   return new Promise((resolve, reject) => {
     const req = request('POST', 'https://up.qbox.me')
+      .set(file._uploadHeaders)
       .field('file', data)
       .field('name', file.attributes.name)
       .field('key', file._qiniu_key)

src/uploader/s3.js

@@ -17,7 +17,10 @@ module.exports = function upload(uploadInfo, data, file, saveOptions = {}) {
   return new Promise((resolve, reject) => {
     // 海外节点，针对 S3 才会返回 upload_url
     const req = request('PUT', uploadInfo.upload_url)
-      .set('Content-Type', file.get('mime_type'))
+      .set(Object.assign({
+        'Content-Type': file.get('mime_type'),
+        'Cache-Control': 'public, max-age=31536000',
+      }, file._uploadHeaders));
     if (saveOptions.onprogress) {
       req.on('progress', saveOptions.onprogress);
     }

storage.d.ts

@@ -168,6 +168,7 @@ declare namespace AV {
         url(): string;
         save(options?: FileSaveOptions): Promise<File>;
         setACL(acl?: ACL): any;
+        setUploadHeader(key: string, value: string): File;
         size(): any;
         thumbnailURL(width: number, height: number): string;
         toFullJSON(): any;