当前记录的都是在工作中自己遇到的问题,记录下来是希望再次遇到时,可以直接应用,不需要花费很多的时间查找资料,当然,以下的方法大部分都是参照网上已有的资源,只是略作整合,引用时根据自己的实际情况做一下扩展。
vue前端,上传按钮--> 上传选择对话框js
<el-button
size="mini"
type="text"
icon="el-icon-document-add"
@click="handleUpload()"
>上传
</el-button>
<el-dialog :title="Title" :visible.sync="open" width="600px" append-to-body
:close-on-click-modal=false>
<el-upload
ref="upload"
:limit="1"
:on-remove="handleRemove"
:on-error="onError"
:file-list="fileList"
:auto-upload="false"
:http-request="uploadFile"
action="https://jsonplaceholder.typicode.com/posts/"
class="upload-demo">
<el-button slot="trigger" size="small" type="primary">选取文件</el-button>
<el-button style="margin-left: 10px;" size="small" type="success" @click="submitUpload">上传到服务器</el-button>
<div slot="tip" class="el-upload__tip">支持上传 {{ strRebuild(fileType) }} 格式,且不超过 {{ fileSize }}M</div>
</el-upload>
</el-dialog>
js代码
import { lastSubstring, strRebuild } from '@/utils/strUtil'
import { message } from '@/utils/message'
export default {
data() {
return {
title: '',
open: false,
// 附件列表
fileList: [],
// 允许的文件类型,可依据实际需求增加格式
// fileType: ['xls', 'xlsx', 'pdf', 'doc', 'docx', 'txt', 'jpg', 'png', 'jpeg', 'zip'],
fileType: ['pdf', 'doc', 'zip'],
// 运行上传文件大小,单位 M
fileSize: 10,
}
},
methods{
handleUpload() {
this.title = 'XXXX'
this.open = true
},
// 清空表单
clear() {
// 清空附件
this.$refs.upload.clearFiles()
},
// 附件检查
// 检查附件是否属于可上传类型
// 检查附件是否超过限制大小
checkFile() {
var flag = true
var tip = ''
var files = this.$refs.upload.uploadFiles
files.forEach(item => {
// 文件过大
if (item.size > this.fileSize * 1024 * 1024) {
flag = false
tip = ' 文件超过' + this.fileSize + 'M'
}
// 文件类型不属于可上传的类型
if (!this.fileType.includes(lastSubstring(item.name, '.'))) {
flag = false
tip = ' 文件类型不可上传'
this.clientOpen = false
}
})
if (!flag) {
message('error', tip)
}
return flag
},
// 提交附件
submitUpload() {
if (this.checkFile()) {
console.log('上传附件...')
this.$refs.upload.submit()
} else {
console.log('取消上传')
}
},
// 自定义文件上传方法
uploadFile(file) {
// 把文件放入 FormData 进行提交
const name = 'XXXX'
const param = new FormData()
param.append('files', file.file)
//传递其他信息
param.append('name', name)
uploadFile(param).then(response => {
if (response.code === 200) {
this.open = false
this.msgSuccess('上传成功')
} else {
this.msgSuccess('上传失败')
this.open = false
}
})
},
// 移除附件
handleRemove(file, fileList) {
console.log('移除附件...')
},
// 附件上传失败,打印下失败原因
onError(err) {
message('error', '附件上传失败')
console.log(err)
},
// 字符串重组
strRebuild(str) {
return strRebuild(str)
}
},
工具类 JS
strUtil.js,创建js 文件
// 字符串相关工具类
// 数组根据分隔符重组为字符串
export function strRebuild(arr, split) {
if (arr === undefined || arr === null || !(arr instanceof Array) || arr.length === 0) {
return ''
}
if (split === undefined || split === null) {
split = ','
}
var str = ''
arr.forEach((v, i) => {
if (i === arr.length - 1) {
str = str + v
} else {
str = str + v + split
}
})
return str
}
// 截取最后一个特定字符后面的字符串
export function lastSubstring(str, split) {
if (str === undefined || str === null || split === undefined || split === null) {
return ''
}
return str.substring(str.lastIndexOf(split) + 1)
}
message.js,创建js 文件
import { Message } from 'element-ui'
// 提示封装 type 提示类型, msg 提示信息,duration 持续时间
export function message(type, msg, duration) {
Message({
message: msg || 'success',
type: type || 'success',
duration: duration || 5 * 1000
})
}
// 带删除键提示,duration 为 0 时,不会自动消失
// 提示封装 type 提示类型, msg 提示信息,duration 持续时间
export function messageShowClose(type, msg, duration) {
Message({
message: msg || 'success',
type: type || 'success',
duration: duration || 0,
showClose: true
})
}
API,接口的具体地址按实际情况来填写,内容可以不变,因为vue传的是param = new FormData()数据,所以在这里只要一个参数就可以了
export function uploadFile(file) {
return request({
url: '/uploadFile',
method: 'post',
headers: {
'Content-Type': 'multipart/form-data; charset=utf-8'
},
data:file,
})
}
后端接口
很多人参照网上的方法都会提示 MultipartFile.transferTo(dest) 这个错误,对这个错误我也不过多的解释,有兴趣的可以自己查阅,我以下代码给出最终的解决方案。
自定义保存路径
private String destfileDir = ".XXXXXX/XXX/XXX";//(根据实际情况而定)
/**
* 上传客户端文件并保存
* @param
* @return
*/
@PostMapping(value = "/uploadFile")
public AjaxResult uploadFile(@RequestParam("files") MultipartFile[] files, @RequestParam("name") String name) {
// 先设定一个放置上传文件的文件夹(该文件夹可以不存在,下面会判断创建)
TCertmanagerinfo tCertmanagerinfo = new TCertmanagerinfo();
for (MultipartFile file : files) {
// 判断文件是否有内容
if (file.isEmpty()) {
System.out.println("该文件无任何内容!!!");
}
// 获取附件原名(有的浏览器如chrome获取到的是最基本的含 后缀的文件名,如myImage.png)
// 获取附件原名(有的浏览器如ie获取到的是含整个路径的含后缀的文件名,如C:\\Users\\images\\myImage.png)
String fileName = file.getOriginalFilename();
// 如果是获取的含有路径的文件名,那么截取掉多余的,只剩下文件名和后缀名
if (fileName.indexOf("\\") > 0) {
int index = fileName.lastIndexOf("\\");
fileName = fileName.substring(index + 1);
}
// 判断单个文件大于1M
long fileSize = file.getSize();
if (fileSize > 1024 * 1024) {
System.out.println("文件大小为(单位字节):" + fileSize);
System.out.println("该文件大于1M");
}
// 当文件有后缀名时 自定义文件名name
if (fileName.indexOf(".") >= 0) {
// split()中放正则表达式; 转义字符"\\."代表 "."
String[] fileNameSplitArray = fileName.split("\\.");
// 加上random戳,防止附件重名覆盖原文件
// fileName = fileNameSplitArray[0] + (int) (Math.random() * 100000) + "." + fileNameSplitArray[1];
fileName = name+ "." + fileNameSplitArray[1];
}
// 当文件无后缀名时(如C盘下的hosts文件就没有后缀名)
if (fileName.indexOf(".") < 0) {
// 加上random戳,防止附件重名覆盖原文件
fileName = name;
}
// 根据文件的全路径名字(含路径、后缀),new一个File对象dest
File dest = new File(new File(destfileDir).getAbsolutePath() + "/" + fileName);
// 如果pathAll路径不存在,则创建相关该路径涉及的文件夹;
if (!dest.getParentFile().exists()) {
dest.getParentFile().mkdirs();
}
try {
// 将获取到的附件file,transferTo写入到指定的位置(即:创建dest时,指定的路径)
file.transferTo(dest);
} catch (IllegalStateException | IOException e) {
e.printStackTrace();
}
}
return AjaxResult.success();
}
这样上传附件功能就实现了,更多的操作可以依据实际情况添加自己的业务。