前提:有腾讯云服务器并开通cos对象存储
-
创建cos存储桶(访问权限需要设置为共有读私有写,这样到时上传的文件才可以通过链接访问)
-
创建cos对象存储访问密钥拿到secretId和secretKey
注意创建的密钥一定要保存好后期是无法再次次查看的
-
在项目中添加腾讯云cos坐标
JavaScript
<!-- 腾讯云cos坐标-->
<dependency>
<groupId>com.qcloud</groupId>
<artifactId>cos_api</artifactId>
<version>5.6.155</version>
</dependency>
</dependencies>
- 创建文件上传工具类UploadUtil.java
JavaScript
package org.example.utils;
import com.qcloud.cos.COSClient;
import com.qcloud.cos.ClientConfig;
import com.qcloud.cos.auth.BasicCOSCredentials;
import com.qcloud.cos.auth.COSCredentials;
import com.qcloud.cos.http.HttpProtocol;
import com.qcloud.cos.model.PutObjectRequest;
import com.qcloud.cos.model.PutObjectResult;
import com.qcloud.cos.region.Region;
import java.io.File;
public class UploadUtil {
/**
* 该函数用于上传指定文件至腾讯云对象存储服务(COS),并返回上传后文件的HTTP访问链接。
*
* @param secretId 用户的SecretId,用于身份验证,建议使用具有最小权限的子账号密钥。
* @param secretKey 用户的SecretKey,与SecretId配合使用进行身份验证,同样建议使用子账号密钥。
* @param bucketName 存储桶名称,指定文件将上传到的存储桶。
* @param regionName 存储桶所在地域的简称,参考腾讯云官方文档获取有效地区名称。
* @param file 待上传的本地文件对象。
* @param fileName 文件上传到COS后的对象键,即文件路径。
*
* @return 返回一个字符串类型的URL,表示上传成功后文件在COS中的访问地址。
*
* @throws IllegalArgumentException 如果输入的参数不合法或上传过程中出现异常,则可能会抛出异常。
*
* 注意:此函数依赖于腾讯云COS Java SDK,需要预先初始化相关配置并设置好用户凭证信息。
*/
public static String uploadFileToCos(String secretId, String secretKey, String bucketName, String regionName, File file, String fileName) {
// 1 初始化用户身份信息(secretId, secretKey)。
COSCredentials cred = new BasicCOSCredentials(secretId, secretKey);
// 2 设置 bucket 的地域, COS 地域的简称请参见 https://cloud.tencent.com/document/product/436/6224
Region region = new Region(regionName);
ClientConfig clientConfig = new ClientConfig(region);
// 这里建议设置使用 https 协议
// 从 5.6.54 版本开始,默认使用了 https
clientConfig.setHttpProtocol(HttpProtocol.https);
// 3 生成 cos 客户端。
COSClient cosClient = new COSClient(cred, clientConfig);
// 指定文件上传到 COS 上的路径,即对象键。例如对象键为 folder/picture.jpg,则表示将文件 picture.jpg 上传到 folder 路径下
PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, fileName, file);
PutObjectResult putObjectResult = cosClient.putObject(putObjectRequest);
return "https://"+bucketName+".cos."+regionName+".myqcloud.com/"+fileName;
}
/**
* 该函数用于校验文件类型是否合法。
*
* @param fileType 文件类型。
*
* @return 是否通过格式校验
*/
public static boolean isValidFileType(String fileType) {
// 定义允许的文件类型列表
String[] allowedFileTypes = { "jpg", "jpeg", "png", "gif", "mp4" };
for (String allowedType : allowedFileTypes) {
if (allowedType.equalsIgnoreCase(fileType)) {
return true;
}
}
return false;
}
}
- 实现接口
JavaScript
package org.example.controller;
import jakarta.servlet.ServletOutputStream;
import jakarta.servlet.http.HttpServletResponse;
import org.example.pojo.Result;
import org.example.utils.UploadUtil;
import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.net.URLEncoder;
import java.util.UUID;
/**
* 文件处理接口
*/
@RestController
public class FileUploadController {
private static final String ACCESS_KEY_ID = "XXX";//密钥secretId
private static final String ACCESS_KEY_SECRET = "XXX";//密钥secretKey
private static final String REGION = "XXX";//存储桶所在区域
private static final String BUCKET_NAME = "XXX";//存储桶名称
/**
*上传文件到腾讯云cos
*/
@PostMapping("/uploadToCos")
public Result<String> uploadToCos(MultipartFile file) throws IOException {
//判断文件是否为空
if (file == null || file.isEmpty()) {
return Result.error("文件不能为空");
}
//获取上传文件名
String originalFilename = file.getOriginalFilename();
String fileType = originalFilename.substring(originalFilename.lastIndexOf(".") + 1);
// 对文件类型进行检查
if (!UploadUtil.isValidFileType(fileType)) {
return Result.error("不支持的文件类型");
}
//保证文件名唯一 防止文件覆盖
String fileName = UUID.randomUUID().toString() + originalFilename.substring(originalFilename.lastIndexOf("."));
//MultipartFile转换为file
File tempFile = File.createTempFile(fileName, null);
try {
file.transferTo(tempFile);
//上传到腾讯云
String url = UploadUtil.uploadFileToCos(ACCESS_KEY_ID, ACCESS_KEY_SECRET, BUCKET_NAME, REGION, tempFile, fileName);
//返回前端文件地址
return Result.success(url);
} catch (IOException e) {
// 处理异常,如记录日志,返回错误信息等
e.printStackTrace();
return Result.error("文件上传失败");
} finally {
// 删除临时文件
tempFile.delete();
}
}
}
-
上传超过后可以在存储桶中看到自己上传的文件