基本介紹
術(shù)語(yǔ)介紹
-
Bucket（存儲(chǔ)空間）：用于存儲(chǔ)對(duì)象的容器，所有對(duì)象都屬于某個(gè)存儲(chǔ)空間中，一般是一個(gè)項(xiàng)目創(chuàng)建一個(gè)Bucket來專門存儲(chǔ)該項(xiàng)目的文件 -
Object（對(duì)象）：可以理解為文件，對(duì)象在Bucket內(nèi)部由唯一的Key來標(biāo)識(shí) -
Region（地域）：選擇數(shù)據(jù)所存放的物理地址，如北京 -
Endpoint（訪問域名）：對(duì)外服務(wù)的訪問域名，不同Region的域名不同，通過內(nèi)網(wǎng)和外網(wǎng)訪問相同Region的域名也不同 -
AccessKey（訪問密鑰）：簡(jiǎn)稱AK，指的是身份驗(yàn)證中使用的AccessKeyId和AccessKeySecret
圖片上傳方式介紹
普通上傳
描述：用戶現(xiàn)在客戶端將文件上傳到應(yīng)用所部署的服務(wù)器，然后服務(wù)器再將文件上傳到OSS中，OSS存儲(chǔ)文件之后，返回文件地址給應(yīng)用服務(wù)器，應(yīng)用服務(wù)器接著將文件地址存儲(chǔ)到數(shù)據(jù)庫(kù)中。后續(xù)需要訪問文件，直接從數(shù)據(jù)庫(kù)中查詢出訪問地址，然后直接訪問即可。缺點(diǎn)：需要將文件上傳至應(yīng)用服務(wù)器，消耗應(yīng)用服務(wù)器的資源，應(yīng)用服務(wù)器壓力大
用戶直傳
描述：直接將OSS的相關(guān)密鑰存儲(chǔ)到j(luò)s中，直接使用js方法上傳文件，用戶直接在客戶端就將文件上傳到OSS缺點(diǎn)：不安全，密鑰容易被獲取，不法分子可能會(huì)惡意刷流量，沒辦法限流
應(yīng)用服務(wù)器簽名后直傳
描述：客戶端向應(yīng)用服務(wù)器獲取簽名，然后憑借簽名直接將文件上傳到OSS優(yōu)點(diǎn)：安全，且節(jié)省應(yīng)用服務(wù)器性能
OSS對(duì)象存儲(chǔ)后端實(shí)現(xiàn)
maven
<dependency>
<groupId>com.aliyun.oss</groupId>
<artifactId>aliyun-sdk-oss</artifactId>
<version> 3.10.2</version>
</dependency>
配置文件
oss.accessKeyId=你的accessKeyId
oss.accessKeySecret=你的accessKeySecret
oss.endpoint=你的域名
oss.bucketName=你的存儲(chǔ)空間
配置類
用來加載配置文件里面的配置，創(chuàng)建OSS對(duì)象并創(chuàng)建Bean
package com.shm.config;
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class OSSConfig {
@Value("${oss.endpoint}")
private String endpoint;
@Value("${oss.accessKeyId}")
private String accessKeyId;
@Value("${oss.accessKeySecret}")
private String accessKeySecret;
@Bean
public OSS ossClient() {
return new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
}
}
Service
【接口】
package com.shm.service;
import com.ruoyi.common.core.domain.AjaxResult;
import org.springframework.stereotype.Service;
public interface OssService {
/**
* 獲取簽名
* @return
*/
public AjaxResult getPolicy();
}
【實(shí)現(xiàn)類】
package com.shm.service.impl;
import com.aliyun.oss.OSS;
import com.aliyun.oss.common.utils.BinaryUtil;
import com.aliyun.oss.model.MatchMode;
import com.aliyun.oss.model.PolicyConditions;
import com.ruoyi.common.core.domain.AjaxResult;
import com.shm.service.OssService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service;
import org.springframework.web.multipart.MultipartFile;
import java.io.IOException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.LinkedHashMap;
import java.util.Map;
@Service
public class OssServiceImpl implements OssService {
@Autowired
private OSS ossClient;
@Value("${oss.bucketName}")
private String bucketName;
@Value("${oss.endpoint}")
private String endpoint;
@Value("${oss.accessKeyId}")
private String accessId;
@Override
public AjaxResult getPolicy() {
// 拼接出Host地址
String host = "https://" + bucketName + "." + endpoint;
Map<String, String> respMap = null;
try {
/// 設(shè)置過期時(shí)間
// 秒數(shù)，這里設(shè)置10秒就過期
long expireTime = 10;
long expireEndTime = System.currentTimeMillis() + expireTime * 1000;
Date expiration = new Date(expireEndTime);
/// 指定請(qǐng)求的條件
PolicyConditions policyConditions = new PolicyConditions();
// 設(shè)置內(nèi)容長(zhǎng)度允許的字節(jié)數(shù)，最大是1048576000個(gè)字節(jié)，1MB=1048576個(gè)字節(jié)，這里限制最大是100MB
policyConditions.addConditionItem(PolicyConditions.COND_CONTENT_LENGTH_RANGE, 0, 104857600);
// 限制上傳文件的前綴
// 設(shè)置文件夾，這里按照日期分文件夾
String dir = new SimpleDateFormat("yyyy-MM-dd").format(new Date()) + "/";
policyConditions.addConditionItem(MatchMode.StartWith, PolicyConditions.COND_KEY, dir);
/// 生成policy
String postPolicy = ossClient.generatePostPolicy(expiration, policyConditions);
byte[] binaryData = postPolicy.getBytes("utf-8");
String encodedPolicy = BinaryUtil.toBase64String(binaryData);
String postSignature = ossClient.calculatePostSignature(postPolicy);
respMap = new LinkedHashMap<String, String>();
respMap.put("accessId", accessId);
respMap.put("policy", encodedPolicy);
respMap.put("signature", postSignature);
respMap.put("dir", dir);
respMap.put("host", host);
respMap.put("expire", String.valueOf(expireEndTime / 1000));
} catch (Exception e) {
System.out.println(e.getMessage());
}
return AjaxResult.success("獲取憑證成功", respMap);
}
}
Controller
package com.shm.controller;
import com.ruoyi.common.core.domain.AjaxResult;
import com.shm.service.OssService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.security.access.prepost.PreAuthorize;
import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/thirdParty/oss")
@Api("OssController")
public class OssController {
@Autowired
private OssService ossService;
@ApiOperation("獲取OSS憑證")
@GetMapping("/policy")
@PreAuthorize("@ss.hasPermi('thirdParty:oss:policy')")
public AjaxResult policy() {
return ossService.getPolicy();
}
}
圖片上傳前端
圖片上傳組件
該組件基于若依管理系統(tǒng)前端項(xiàng)目所提供的圖片上傳組件修改，原組件采用直傳方式，改動(dòng)后采用簽名后直傳的方式
<template>
<div class="component-upload-image">
<el-upload
multiple
:action="uploadImgUrl"
:data="dataObj"
list-type="picture-card"
:on-success="handleUploadSuccess"
:before-upload="handleBeforeUpload"
:limit="limit"
:on-error="handleUploadError"
:on-exceed="handleExceed"
ref="imageUpload"
:before-remove="handleDelete"
:show-file-list="true"
:headers="headers"
:file-list="fileList"
:on-preview="handlePictureCardPreview"
:class="{ hide: fileList.length >= limit }"
>
<el-icon class="avatar-uploader-icon">
<plus/>
</el-icon>
</el-upload>
<!-- 上傳提示 -->
<div class="el-upload__tip" v-if="showTip">
請(qǐng)上傳
<template v-if="fileSize">
大小不超過 <b style="color: #f56c6c">{{ fileSize }}MB</b>
</template>
<template v-if="fileType">
格式為 <b style="color: #f56c6c">{{ fileType.join("/") }}</b>
</template>
的文件
</div>
<el-dialog
v-model="dialogVisible"
title="預(yù)覽"
width="800px"
append-to-body
>
<img
:src="dialogImageUrl"
style="display: block; max-width: 100%; margin: 0 auto"
/>
</el-dialog>
</div>
</template>
<script setup>
import {getToken} from "@/utils/auth";
import ossApi from '@/api/thirdParty/oss'
import uuidApi from '@/utils/uuid'
const props = defineProps({
modelValue: [String, Object, Array],
// 圖片數(shù)量限制
limit: {
type: Number,
default: 5,
},
// 大小限制(MB)
fileSize: {
type: Number,
default: 5,
},
// 文件類型, 例如['png', 'jpg', 'jpeg']
fileType: {
type: Array,
default: () => ["png", "jpg", "jpeg"],
},
// 是否顯示提示
isShowTip: {
type: Boolean,
default: true
},
});
const {proxy} = getCurrentInstance();
const emit = defineEmits();
const number = ref(0);
const uploadList = ref([]);
const dialogImageUrl = ref("");
const dialogVisible = ref(false);
const baseUrl = import.meta.env.VITE_APP_BASE_API;
const uploadImgUrl = ref(import.meta.env.VITE_APP_OSS_PATH); // 上傳的圖片服務(wù)器地址
const headers = ref({Authorization: "Bearer " + getToken()});
const fileList = ref([]);
const showTip = computed(
() => props.isShowTip && (props.fileType || props.fileSize)
);
let dataObj = {
policy: '',
signature: '',
key: '',
OSSAccessKeyId: '',
dir: '',
host: ''
};
watch(() => props.modelValue, val => {
if (val) {
// 首先將值轉(zhuǎn)為數(shù)組
const list = Array.isArray(val) ? val : props.modelValue.split(",");
console.log("list:" + JSON.stringify(list));
// 然后將數(shù)組轉(zhuǎn)為對(duì)象數(shù)組
fileList.value = list.map(item => {
if (typeof item === "string") {
item = {url: item};
}
return item;
});
console.log("fileList:" + JSON.stringify(fileList));
} else {
fileList.value = [];
return [];
}
}, {deep: true, immediate: true});
// 上傳前l(fā)oading加載
function handleBeforeUpload(file) {
let isImg = false;
if (props.fileType.length) {
let fileExtension = "";
if (file.name.lastIndexOf(".") > -1) {
fileExtension = file.name.slice(file.name.lastIndexOf(".") + 1);
}
isImg = props.fileType.some(type => {
if (file.type.indexOf(type) > -1) return true;
if (fileExtension && fileExtension.indexOf(type) > -1) return true;
return false;
});
} else {
isImg = file.type.indexOf("image") > -1;
}
if (!isImg) {
proxy.$modal.msgError(
`文件格式不正確, 請(qǐng)上傳${props.fileType.join("/")}圖片格式文件!`
);
return false;
}
if (props.fileSize) {
const isLt = file.size / 1024 / 1024 < props.fileSize;
if (!isLt) {
proxy.$modal.msgError(`上傳頭像圖片大小不能超過 ${props.fileSize} MB!`);
return false;
}
}
//獲取OSS簽名
return new Promise((resolve, reject) => {
ossApi.getPolicy()
.then((response) => {
console.log('policy response:' + JSON.stringify(response))
// debugger;
dataObj.policy = response.data.policy
dataObj.signature = response.data.signature
dataObj.OSSAccessKeyId = response.data.accessId
dataObj.key = response.data.dir + uuidApi.getUUID() + '_${filename}'
dataObj.dir = response.data.dir
dataObj.host = response.data.host
console.log('獲取policy成功')
// console.log('dataObj:' + JSON.stringify(dataObj))
// console.log("uploadImgUrl:" + import.meta.env.VITE_APP_OSS_PATH)
proxy.$modal.loading("正在上傳圖片，請(qǐng)稍候...");
number.value++;
resolve(true)
})
.catch((err) => {
console.log('獲取policy失敗')
reject(false)
})
})
}
// 文件個(gè)數(shù)超出
function handleExceed() {
proxy.$modal.msgError(`上傳文件數(shù)量不能超過 ${props.limit} 個(gè)!`);
}
// 上傳成功回調(diào)
function handleUploadSuccess(res, file) {
console.log("handleUploadSuccess，" + JSON.stringify(res) + JSON.stringify(file))
uploadList.value.push({
name: file.name, url: dataObj.host +
'/' +
dataObj.key.replace('${filename}', file.name)
});
console.log("上傳成功")
uploadedSuccessfully();
}
// 刪除圖片
function handleDelete(file) {
const findex = fileList.value.map(f => f.name).indexOf(file.name);
if (findex > -1 && uploadList.value.length === number.value) {
fileList.value.splice(findex, 1);
let urlList = getUrlList(fileList);
emit("update:modelValue", urlList);
return false;
}
}
// 上傳結(jié)束處理
function uploadedSuccessfully() {
console.log("number.value:" + number.value);
if (number.value > 0 && uploadList.value.length === number.value) {
//將新上傳的圖片添加到fileList
for (let i = 0; i < uploadList.value.length; i++) {
fileList.value.push(uploadList.value[i]);
}
//將所有圖片的url拿出來，形成一個(gè)集合
let urlList = getUrlList(fileList);
uploadList.value = [];
number.value = 0;
emit("update:modelValue", urlList);
proxy.$modal.closeLoading();
}
}
// 上傳失敗
function handleUploadError() {
proxy.$modal.msgError("上傳圖片失敗");
proxy.$modal.closeLoading();
}
// 預(yù)覽
function handlePictureCardPreview(file) {
dialogImageUrl.value = file.url;
dialogVisible.value = true;
}
function getUrlList(fileList) {
let urlList = [];
for (let i = 0; i < fileList.value.length; i++) {
urlList.push(fileList.value[i].url);
}
return urlList;
}
</script>
<style scoped lang="scss">
// .el-upload--picture-card 控制加號(hào)部分
:deep(.hide .el-upload--picture-card) {
display: none;
}
</style>
下面的代碼即去配置文件中讀取圖片上傳地址，我使用讀取配置的方式主要是為了方便部署時(shí)的環(huán)境切換，也可以直接寫在組件里面，打包部署時(shí)修改會(huì)繁瑣一點(diǎn)，也會(huì)容易遺忘
const uploadImgUrl = ref(import.meta.env.VITE_APP_OSS_PATH); // 上傳的圖片服務(wù)器地址
下面的代碼的作用是將值同步給組件v-model所綁定的變量中
emit("update:modelValue", urlList);
api
【OSS請(qǐng)求API】
import request from '@/utils/request'
/*
菜單管理相關(guān)的API請(qǐng)求函數(shù)
*/
const api_name = '/thirdParty/oss'
export default {
getPolicy(data) {
return request({
url: `${api_name}/policy`,
method: "get",
params: data
})
},
}
【oss生成API】
/**
* 獲取uuid
*/
export default {
getUUID() {
return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
return (c === 'x' ? (Math.random() * 16 | 0) : ('r&0x3' | '0x8')).toString(16)
})
}
}
使用UUID的作用主要是：用戶上傳的圖片名稱可能一樣，但是圖片內(nèi)容不同，在名稱前面添加UUID可以避免文件名沖突，如下圖
頁(yè)面使用組件
使用，通過v-model綁定變量，值的形式是url數(shù)組。limit="1"的作用是限制只能上傳一張圖片
<imageUpload v-model="form.logo" limit="1"></imageUpload>
查看組件的代碼，limit fileSize fileType isShowTip這個(gè)值都是可以設(shè)置的，具體的含義請(qǐng)查看下圖
組件效果
這個(gè)組件的功能還是比較完善的，具體效果可以查看下面的效果圖
【上傳圖片之前】
【上傳圖片成功后】
【上傳成功的圖片可以預(yù)覽和刪除】文章來源：http://www.zghlxwxcb.cn/news/detail-595140.html
【預(yù)覽效果】
【上傳多個(gè)圖片的效果】
文章來源地址http://www.zghlxwxcb.cn/news/detail-595140.html
到了這里，關(guān)于OSS對(duì)象存儲(chǔ)后端實(shí)現(xiàn)+Vue實(shí)現(xiàn)圖片上傳【基于若依管理系統(tǒng)開發(fā)】的文章就介紹完了。如果您還想了解更多內(nèi)容，請(qǐng)?jiān)谟疑辖撬阉鱐OY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！
