后端（springBoot）
- 思路：
1、实现图片上传接口，利用图片工具类将图片上传至服务器或者本地
2、实现图片删除接口，利用图片工具类对已上传至服务器或者本地的图片删除
3、实现数据库修改接口，修改数据库中图片访问路径url - 图片工具类
//图片上传，支持多张图片
public static List<String> upload(List<MultipartFile> files, String path) throws IOException {
List<String> msgs = new ArrayList<>();
if (files.size() < 1) {
msgs.add("file_empty");
return msgs;
}
for (MultipartFile file : files) {
String filename = file.getOriginalFilename();
assert filename != null;
String type = filename.contains(".") ? filename.substring(filename.lastIndexOf(".")) : null;
//以uid重新命名避免重复
//拼接文件路径，方便前端接收
String filepath = path + UUID.randomUUID() + type;
File filesPath = new File(path);
if (!filesPath.exists()) {
filesPath.mkdir();
}
BufferedOutputStream out = null;
try {
//输入图片字节流
out = new BufferedOutputStream(new FileOutputStream(new File(filepath)));
out.write(file.getBytes());
msgs.add(filepath);
} catch (Exception e) {
e.printStackTrace();
} finally {
if(out != null){
out.flush();
out.close();
}
}
}
return msgs;
}
//文件删除
public static boolean deleteFiles(String filePath){
boolean flag = false;
//根据路径创建文件对象
File file = new File(filePath);
//路径是个文件且不为空时删除文件
if(file.isFile() && file.exists()){
flag = file.delete();
}
//删除失败时，返回false
return flag;
}
- 图片上传接口
@PostMapping("/image")
public AjaxResult uploadImage(@RequestParam(value = "file") List<MultipartFile> file) {
List<String> imagePath;
String path = "此处为需要上传的服务器或本地路径url";
// 调用图片上传工具类
try{
imagePath = UploadFile.upload(file,path);
} catch (IOException e){
return AjaxResult.error("图片传输异常" + e);
}
if(imagePath.get(0).equals("file_empty")) {
return AjaxResult.error("图片为空");
}
return AjaxResult.success(imagePath);
}
- 图片删除接口
@DeleteMapping("/deleteFile/{fileName}")
public AjaxResult deleteFile(@PathVariable String fileName){
String type = fileName.contains(".") ? fileName.substring(fileName.lastIndexOf(".")) : null;
String filePath;
assert type != null;
if(type.equals(".png") || type.equals(".jpeg") || type.equals(".jpg")){
filePath = "上传图片的服务器或本地路径url" + fileName;
}
else{
return AjaxResult.error("文件类型不支持");
}
boolean b = UploadFile.deleteFiles(filePath);
if(!b){
return AjaxResult.error();
}
return AjaxResult.success();
}
- 实体类修改接口
此接口根据实际业务需求，实现可以修改包括图片url在内的数据库update代码，使用string接收url即可
@PutMapping("/update")
public AjaxResult update(@RequestBody Entity entity){
return toAjax(service.update(entity));
}
前端（Vue+ElementUI）
- 思路
1、表单中点击上传图片
2、利用上传文件之前的钩子进行文件类型以及大小校验
3、利用上传图片成功钩子将图片信息保存在fileList中，方便后续功能使用
4、利用文件状态改变钩子将文件存储url添加到表单中
5、利用文件删除钩子移除图片，需要同时删除后台图片、fileList中图片信息、表单信息
6、利用文件超出个数限制时的钩子做图片上传数量限制提示
7、图片回显需要在点击修改按钮后进行赋值，回显属性需要数组类型 - 图片上传类
data() {
return {
// 图片上传类
ImgUpload: {
// 图片上传url
uploadURL: "上传接口url",
// 图片列表
fileList: [],
// 图片回显列表
re_fileList: [],
// 图片上传请求头
uploadHeaders: {
"tk" : getToken()},
}
}
}
- 图片上传组件
<el-upload
:action = "imgUpload.uploadURL"
:limit = "Number(1)"
:file-list = "imgUpload.re_fileList"
:headers = "imgUpload.uploadHeaders"
:before-upload = "imgHandleBefore"
:on-success = "imgHandleSuccess"
:on-change = "imgUploadStateChange"
:on-remove = "imgHandleRemove"
:on-exceed = "imgHandleExceed"
:auto-upload = "true"
list-type = "picture"
ref = "imgUpload"
accept = "image/jpeg,image/png,image/jpg">
<el-button size="small" type="primary">点击上传</el-button>
<div slot="tip" class="el-upload__tip">只能上传一张jpg/jpeg/png图片，且不超过5Mb</div>
</el-upload>
- 图片上传前校验
imgHandleBefore(file){
const isLt5M = file.size / 1024 / 1024 < 5;
const typeArr = ['image/png', 'image/jpeg', 'image/jpg'];
const isJPG = typeArr.indexOf(file.type) !== -1;
// 文件格式校验
if (!isJPG) {
this.$message.error('只能上传jpg/jpeg/png图片');
return false;
}
// 文件大小校验
if (!isLt5M) {
this.$message.error('上传图片大小不能超过5MB!');
return false;
}
return isLt5M && isJPG;
}
- 图片上传成功钩子
imgHandleSuccess(response){
if(response.code !== 200){
this.$message.error("图片上传失败！");
return;
}
// 得到一个图片信息对象 临时路径
const picInfo = {
pic: response.data };
// 将图片信息对象，push到fileList数组中
this.imgUpload.fileList.push(picInfo);
}
- 图片状态改变钩子
imgUploadStateChange(){
// 拼接图片访问url到表单中（仅上传一张，上传多张时需要逗号拼接）
if(this.imgUpload.fileList.length !== 0){
this.form.image = this.imgUpload.fileList[0].pic;
}
}
- 图片删除钩子
imgHandleRemove(file){
// 由于上传前校验钩子return false时会调用文件删除钩子，删除前先做判断，若上传成功才可删除
if(file && file.status === 'success'){
// 0、获取将要删除图片的临时路径以及文件名称
let filePath = "";
if(file.response !== undefined){
filePath = file.response.data[0];
}else {
filePath = file.url;
}
let imageName = filePath.substring(filePath.lastIndexOf("\\") + 1);
// 1、删除单张后台图片，deleteFile为后台删除图片接口
deleteFile(imageName).then(response => {
if(response.code !== 200){
this.$message.error("删除后台图片失败");
return;
}
this.$message.success("删除图片成功");
});
// 2、调用splice方法，移除图片信息
this.imgUpload.fileList.splice(0,1);
// 3、同时表单置空
this.form.image = "";
}
}
- POI图片上传超出数量警告
poiImgHandleExceed(){
this.$message.warning("超过图片上传数量！");
}
- 所有图片文件列表以及回显列表置空
// 点击修改按钮和新增按钮时先调用此删除进行清空图片列表
resetImgList(){
this.imgUpload.fileList = [];
this.imgUpload.re_fileList = [];
}
- 修改按钮中进行图片回显
/** 修改数据函数 */
handleUpdate(){
// 表单置空
this.reset();
// 图片列表以及回显列表清空
this.resetImgList();
this.submitLoading = false;
this.open = true;
this.title = "";
// POI图片回显，response.data.imagee是根据后台查出来的单条数据
selectDataById(id).then(response=>{
this.form = response.data;
// 若是多张图片根据逗号拆分
let urlStr = response.data.image.split(",");
urlStr.forEach(item => {
let obj = {
};
obj.url = item;
this.imgUpload.re_fileList.push(obj);
});
});
}
- 表单取消按钮
cancel() {
// 由于图片自动上传，若有已上传图片需要先删除再取消，否则后台会留存图片
if(this.imgUpload.fileList.length > 0){
this.$alert('请先移除已上传图片', '警告',{
confirmButtonText: "确定",
type: "warning"
})
return;
}
// 对话框关闭
this.open = false;
// 表单清空
this.reset();
}
至此完成整个前端后端图片上传流程，若有不足之处，或更好的建议欢迎评论区讨论。