欢乐颂第一季免费阅读,好看的言情小说

新聞中心

這里有您想知道的互聯(lián)網(wǎng)營銷解決方案

SpringBoot+Vue文件上傳，如何攜帶令牌信息？

1.傳統(tǒng)方案

我們先來看看，基于 session 認證，文件上傳要怎么做。

在 Vue.js 中，如果網(wǎng)絡(luò)請求使用 axios ，并且使用了 ElementUI 庫，那么一般來說，文件上傳有兩種不同的實現(xiàn)方案：

通過 Ajax 實現(xiàn)文件上傳
通過 ElementUI 里邊的 Upload 組件實現(xiàn)文件上傳

兩種方案，各有優(yōu)缺點，我們分別來看。

1.1 準備工作

首先我們需要一點點準備工作，就是在后端提供一個文件上傳接口，這是一個普通的 Spring Boot 項目，如下：

SimpleDateFormat sdf = new SimpleDateFormat("/yyyy/MM/dd/");
@PostMapping("/import")
public RespBean importData(MultipartFile file, HttpServletRequest req) throws IOException {
    String format = sdf.format(new Date());
    String realPath = req.getServletContext().getRealPath("/upload") + format;
    File folder = new File(realPath);
    if (!folder.exists()) {
        folder.mkdirs();
    }
    String oldName = file.getOriginalFilename();
    String newName = UUID.randomUUID().toString() + oldName.substring(oldName.lastIndexOf("."));
    file.transferTo(new File(folder,newName));
    String url = req.getScheme() + "://" + req.getServerName() + ":" + req.getServerPort() + "/upload" + format + newName;
    System.out.println(url);
    return RespBean.ok("上傳成功!");
}

這里的文件上傳比較簡單，上傳的文件按照日期進行歸類，使用 UUID 給文件重命名。

這里為了簡化代碼，我省略掉了異常捕獲，上傳結(jié)果直接返回成功，后端代碼大伙可根據(jù)自己的實際情況自行修改。

1.2 Ajax 上傳

在 Vue 中，通過 Ajax 實現(xiàn)文件上傳，方案和傳統(tǒng) Ajax 實現(xiàn)文件上傳基本上是一致的，唯一不同的是查找元素的方式。


導入數(shù)據(jù)

在這里，首先提供一個文件導入 input 組件，再來一個導入按鈕，在導入按鈕的事件中來完成導入的邏輯。

importData() {
  let myfile = this.$refs.myfile;
  let files = myfile.files;
  let file = files[0];
  var formData = new FormData();
  formData.append("file", file);
  this.uploadFileRequest("/system/basic/jl/import",formData).then(resp=>{
    if (resp) {
      console.log(resp);
    }
  })
}

關(guān)于這段上傳核心邏輯，解釋如下：

首先利用 Vue 中的 $refs 查找到存放文件的元素。
type 為 file 的 input 元素內(nèi)部有一個 files 數(shù)組，里邊存放了所有選擇的 file，由于文件上傳時，文件可以多選，因此這里拿到的 files 對象是一個數(shù)組。
從 files 對象中，獲取自己要上傳的文件，由于這里是單選，所以其實就是數(shù)組中的第一項。
構(gòu)造一個 FormData ，用來存放上傳的數(shù)據(jù),FormData 不可以像 Java 中的 StringBuffer 使用鏈式配置。
構(gòu)造好 FromData 后，就可以直接上傳數(shù)據(jù)了，F(xiàn)ormData 就是要上傳的數(shù)據(jù)。
文件上傳注意兩點，1. 請求方法為 post，2. 設(shè)置 Content-Type 為 multipart/form-data 。

這種文件上傳方式，實際上就是傳統(tǒng)的 Ajax 上傳文件，和大家常見的 jQuery 中寫法不同的是，這里元素查找的方式不一樣(實際上元素查找也可以按照JavaScript 中原本的寫法來實現(xiàn))，其他寫法一模一樣。這種方式是一個通用的方式，和使用哪一種前端框架無關(guān)。最后再和大家來看下封裝的上傳方法：

export const uploadFileRequest = (url, params) => {
  return axios({
    method: 'post',
    url: `${base}${url}`,
    data: params,
    headers: {
      'Content-Type': 'multipart/form-data'
    }
  });
}

經(jīng)過這幾步的配置后，前端就算上傳完成了，可以進行文件上傳了。

1.3 使用 el-upload 組件

如果使用 el-upload ，則需要引入 ElementUI，所以一般建議，如果使用了 ElementUI 做 UI 控件的話，則可以考慮使用 el-upload 組件來實現(xiàn)文件上傳，如果沒有使用 ElementUI 的話，則不建議使用 el-upload 組件，至于其他的 UI 控件，各自都有自己的文件上傳組件，具體使用可以參考各自文檔。

  style="display: inline"
  :show-file-list="false"
  :on-success="onSuccess"
  :on-error="onError"
  :before-upload="beforeUpload"
  action="/system/basic/jl/import">
  {{btnText}}

show-file-list 表示是否展示上傳文件列表，默認為true，這里設(shè)置為不展示。
before-upload 表示上傳之前的回調(diào)，可以在該方法中，做一些準備工作，例如展示一個進度條給用戶。
on-success 和 on-error 分別表示上傳成功和失敗時候的回調(diào)，可以在這兩個方法中，給用戶一個相應(yīng)的提示，如果有進度條，還需要在這兩個方法中關(guān)閉進度條。
action 指文件上傳地址。
上傳按鈕的點擊狀態(tài)和圖標都設(shè)置為變量，在文件上傳過程中，修改上傳按鈕的點擊狀態(tài)為不可點擊，同時修改圖標為一個正在加載的圖標 loading。
上傳的文本也設(shè)為變量，默認上傳 button 的文本是數(shù)據(jù)導入，當開始上傳后，將找個 button 上的文本修改為正在導入。

相應(yīng)的回調(diào)如下：

onSuccess(response, file, fileList) {
  this.enabledUploadBtn = true;
  this.uploadBtnIcon = 'el-icon-upload2';
  this.btnText = '數(shù)據(jù)導入';
},
onError(err, file, fileList) {
  this.enabledUploadBtn = true;
  this.uploadBtnIcon = 'el-icon-upload2';
  this.btnText = '數(shù)據(jù)導入';
},
beforeUpload(file) {
  this.enabledUploadBtn = false;
  this.uploadBtnIcon = 'el-icon-loading';
  this.btnText = '正在導入';
}

在文件開始上傳時，修改上傳按鈕為不可點擊，同時修改上傳按鈕的圖標和文本。

文件上傳成功或者失敗時，修改上傳按鈕的狀態(tài)為可以點擊，同時恢復上傳按鈕的圖標和文本。

上傳效果圖如下：

使用 el-upload 做文件上傳，松哥之前也錄過一個視頻，小伙伴們可以參考(本視頻節(jié)選自松哥自制的 Spring Boot+Vue+微人事系列視頻教程)：

1.4 兩種方式比較

兩種上傳方式各有優(yōu)缺點：

第一種方式最大的優(yōu)勢是通用，一招鮮吃遍天，到哪里都能用，但是對于上傳過程的監(jiān)控，進度條的展示等等邏輯都需要自己來實現(xiàn)。
第二種方式不夠通用，因為它是 ElementUI 中的組件，得引入 ElementUI 才能使用，不過這種方式很明顯有需多比較方便的回調(diào)，可以實現(xiàn)非常方便的處理常見的各種上傳問題。
常規(guī)的上傳需求第二種方式可以滿足，但是如果要對上傳的方法進行定制，則還是建議使用第一種上傳方案。

2.手動傳遞令牌

對于上面不同的文件上傳方式，手動上傳令牌也有不同的方案，松哥來和大家挨個介紹。我這里服務(wù)端認證是 OAuth2+JWT 的方式，所以接下來令牌傳遞主要是按照 OAuth2 的格式來傳遞令牌，其實都是修改請求頭，只要這種方式會了，其他方式也就會了。

關(guān)于 OAuth2，如果小伙伴們還不熟悉，可以看看松哥之前寫的系列教程：OAuth2系列

2.1 Ajax 傳遞令牌

Ajax 傳遞令牌實際上是非常容易的，我們只需要稍微修改請求頭即可。我給大家舉一個簡單例子。

如果你用的 axios 來做網(wǎng)絡(luò)請求，那么按照如下方式添加請求頭即可(或者在請求攔截器中統(tǒng)一添加)：

export const uploadFileRequest = (url, params) => {
  return axios({
    method: 'post',
    url: `${base}${url}`,
    data: params,
    headers: {
      'Content-Type': 'multipart/form-data',
      'Authorization': 'Bearer ' + token
    }
  });
}

如果你用了 jQuery 的話，那么按照如下方式添加請求頭即可：

$("#btnClick").click(function () {
        var formData = new FormData();
        formData.append("file", $("#userface")[0].files[0]);
        $.ajax({
            url: '/fileupload',
            type: 'post',
            headers: {
                'Authorization': 'Bearer ' + token
            },
            data: formData,
            processData: false,
            contentType: false,
            success: function (msg) {
                alert(msg);
            }
        });
    });

無非就是修改請求頭，只要是自己發(fā)送請求的，請求頭都是可以自由定制的，無論你用 jQuery 還是 axios 還是原生的 XMLHttpRequest。

2.2 el-upload 處理令牌

如果使用了 el-upload，我們就得在人家框架里邊玩了，得符合框架要求，這雖然多了一些掣肘，但是也不是不能實現(xiàn)，松哥這里和大家介紹兩種方案。

2.2.1 方案一

方案一是我目前采用的方案，因為 el-upload 支持定制請求頭，這就好辦了：

  ref="upload"
  class="upload-container"
  :data="category"
  :multiple="false"
  :limit="1"
  :headers="myHeaders"
  :auto-upload="false"
  :on-success="onSuccess"
  :on-error="onError"
  :file-list="fileList"
  action="/appmanager/app/categories/"
>
  選擇圖標

選擇圖標

其中，:headers="myHeaders" 就是我定制的請求頭，然后在 data 中定義該變量即可：

data() {
  return {
    myHeaders: { Authorization: 'Bearer ' + getToken() }
  }
},

2.2.2 方案二

方案二則是利用 el-upload 的 before-upload 鉤子函數(shù)，開發(fā)者可以在這個鉤子函數(shù)中自己手動上傳，上傳完成之后，返回一個 false，這時 el-upload 就會停止它自己的上傳邏輯。這種方式我看到有別的小伙伴在用，所以給大家一個簡單的案例參考下：


beforeUpload (file) {
    //參考上面的 ajax 或者 axios 上傳文件
    return false
}

這里有幾個細節(jié)大家需要注意下：

el-upload 的 action 屬性隨意給一個值，使之不報錯，因為真正的上傳地址我們將在 beforeUpload 方法中給出。
beforeUpload 方法的上傳邏輯跟我們第一小節(jié)介紹的一致，我就不重復寫了，注意上傳的文件對象是 file.raw。
beforeUpload 方法最終返回 false，終止 el-upload 自己的上傳邏輯。

3.小結(jié)

好了，和小伙伴們介紹了幾種文件上傳時候的令牌傳遞方式，不知道大家有沒有 GET 到呢?

新聞標題：SpringBoot+Vue文件上傳，如何攜帶令牌信息？
網(wǎng)站路徑：http://m.fisionsoft.com.cn/article/dpsioso.html