上传文件到阿里云oss

文件上传，使用阿里云oss来做文件存储

step1：在application.yml文件中配置alioss的四个属性值

sky:
  alioss:
    endpoint: ${sky.alioss.endpoint}
    access-key-id: ${sky.alioss.access-key-id}
    access-key-secret: ${sky.alioss.access-key-secret}
    bucket-name: ${sky.alioss.bucket-name}

step2：创建一个AliOssProperties类，这个类的作用是将配置文件中的属性映射到Java对象中

@Component
@ConfigurationProperties(prefix = "sky.alioss")
@Data
public class AliOssProperties {

    private String endpoint;
    private String accessKeyId;
    private String accessKeySecret;
    private String bucketName;

}

step3：创建用来上传文件到阿里云oss的工具类AliOssUtil

@Data
@AllArgsConstructor
@Slf4j
public class AliOssUtil {

    private String endpoint;
    private String accessKeyId;
    private String accessKeySecret;
    private String bucketName;

    /**
     * 文件上传
     *
     * @param bytes
     * @param objectName
     * @return
     */
    public String upload(byte[] bytes, String objectName) {

        // 创建OSSClient实例。
        OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);

        try {
            // 创建PutObject请求。
            ossClient.putObject(bucketName, objectName, new ByteArrayInputStream(bytes));
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }

        //文件访问路径规则 https://BucketName.Endpoint/ObjectName
        StringBuilder stringBuilder = new StringBuilder("https://");
        stringBuilder
                .append(bucketName)
                .append(".")
                .append(endpoint)
                .append("/")
                .append(objectName);

        log.info("文件上传到:{}", stringBuilder.toString());

        return stringBuilder.toString();
    }
}

step4：创建一个阿里云oss配置类，用来生成AliOssUtil对象，并交由IOC容器管理

/**
 * 简介说明:阿里oss配置类，用来生成AliOssUtil对象，并交由IOC容器管理
 *
 * @author: 小鸥
 * @date: 2025/05/06 18:06:44
 * @version: 1.0
 */
@Configuration
@Slf4j
public class OssConfiguration {

    @Bean
    public AliOssUtil aliOssUtil(AliOssProperties aliOssProperties){
        log.info("初始化aliOssUtil对象");
        AliOssUtil aliOssUtil = new AliOssUtil(aliOssProperties.getEndpoint(),aliOssProperties.getAccessKeyId()
                                               ,aliOssProperties.getAccessKeySecret(),aliOssProperties.getBucketName());

        return aliOssUtil;
    }
}

step5：上传文件功能实现

/**
 * 简介说明:
 *
 * @author: 小鸥
 * @date: 2025/05/06 18:12:17
 * @version: 1.0
 */
@RestController
@Api(tags = "公共接口")
@Slf4j
@RequestMapping("/admin/common")
public class CommonController {

    @Autowired
    private AliOssUtil aliOssUtil;

    //使用阿里云oss文件上传功能
    @PostMapping("upload")
    @ApiOperation("文件上传")
    public Result upload(MultipartFile file) {
        String fileOriginalFilename = file.getOriginalFilename();//获取原始文件名
        log.info("文件上传，原始名称：{}",fileOriginalFilename);
        String fileLastName = fileOriginalFilename.substring(fileOriginalFilename.lastIndexOf("."));//获取文件名后缀 .jpg
        String url = null;
        try {
            String fileName = UUID.randomUUID().toString()+fileLastName;
            //1、调用AliOssUtil工具类的upload方法，实现文件上传
            url = aliOssUtil.upload(file.getBytes(),fileName);
        } catch (IOException e) {
            log.info("文件上传失败，异常信息：{}",e.getMessage());
            return Result.error("文件上传失败！");
        }

        //2、返回图片路径结果
        return Result.success(url);
    }
}