【保姆|轻松拿下】java整合亚马逊oss（S3）

前言

        最近在写一个项目，得用到亚马逊的oss也叫S3，其实方式和国内的阿里和七牛云方式一样，但如果是外国的项目的话用S3会好一些，找了很久没有找到一个非常详细的教程，那么这里直接出一个保姆级的教程，那么话不多说直接上教程

1.去亚马逊注册一个账号

https://eu-north-1.signin.aws.amazon.com/

 链接放在这里了，自行注册一个账号

2.创建一个桶

注册完账号后进来应该是一个这样界面

在这块地方搜索s3

接下来就可以看到页面，下面的列表就是桶的列表，刚创建是没有桶的，接下来我们点击创建桶

这个地方取个自己的桶的名字就行，不要乱取哦，代码里面还用的到，可以取一个和自己或者项目有关的名字。下面的选择存储桶暂时不用管，这个的意思是可以拿你已经创建过的桶来当模板快速创建桶，这里我们不管它。

接下来看情况，如果创建这个oss是为了当属于自己的网盘使用的话那就要阻止所有公开访问，如果是用来当项目里面图片存放的空间，那么就把这个复选框取消掉。接下来的东西都不用管啦，直接创建就可以了。

这个版本控制就是可以记录上传进来的所有文件的操作，比如更新和删除桶都是能记录下来的，可以找回误删或者误更新的文件，这里我用不到，就不开了

3.更新桶策略

用来保存自己的资源的可以跳过这一步

虽然刚刚已经取消勾选了，但实际上我们还是不能通过链接访问上传的资源，可以自己上传一个文件然后通过链接打开测试一下，

接下来要设置桶的策略

{
    "Version": "2012-10-17",
    "Id": "Policy1723098683101",
    "Statement": [
        {
            "Sid": "Stmt1723098677008",
            "Effect": "Allow",
            "Principal": "*",
            "Action": "s3:GetObject",
            "Resource": "你的桶的arn/*"
        }
    ]
}

桶的arn可以在桶的属性里面找到

把它复制一下换成你自己的arn就可以了，设置的位置就在属性旁边的权限，往下滑可以看到一个存储桶策略，把上面一串json粘贴进去就可以了，然后在测试一下上传文件看看能不能通过链接打开

4.获取秘钥

点击右上角个人的账号

接着点击安全凭证

进入后往下滑，找到创建访问秘钥,这里我已经创建过了，所以你们自己跟着提示创一下。

之后就可以获得到了AccessKeyId以及AccessKeySercet,注意AccessKeySercet,只会出现一次，生成后请保管好，不要泄漏或者弄丢

5.通过代码上传文件

到这一步就很简单了

首先引入aws文件上传所需要的依赖

<!-- 亚马逊oss -->
<dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-s3</artifactId>
    <version>1.12.156</version>
</dependency>

直接上代码 

@ApiOperation("亚马逊oss文件上传")
	@PostMapping("/awsUpload")
	public Result uploadOss(MultipartFile file) throws Exception {
		String bucketName ="你的桶名";
        String region = "你的地区"

		// 创建AWS凭证
		BasicAWSCredentials awsCreds = new BasicAWSCredentials("AccessKeyId","AccessKeySecret");

		// 创建S3客户端
		AmazonS3 s3Client = AmazonS3ClientBuilder.standard()
				.withRegion(region) // 设置区域
				.withCredentials(new AWSStaticCredentialsProvider(awsCreds))
				.build();

		try {


			String key = S3ToolUtils.generateRandomString()+"."+StringToolUtil.getFileExtension(file.getOriginalFilename());;
			PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, key, file.getInputStream(), null);
			PutObjectResult putObjectResult = s3Client.putObject(putObjectRequest);

			Date expiration = new Date(System.currentTimeMillis() + (60 * 60 * 1000));

			// 创建预签名URL请求
			GeneratePresignedUrlRequest generatePresignedUrlRequest =
					new GeneratePresignedUrlRequest(bucketName, key)
							.withMethod(HttpMethod.GET)
							.withExpiration(expiration);

			// 获取预签名URL
			URL url = s3Client.generatePresignedUrl(generatePresignedUrlRequest);

			return Result.success("File uploaded successfully. ETag: " + url.toString(), HttpStatus.OK);
		} catch (Exception e) {
			return Result.success("Error uploading the file to S3.", HttpStatus.INTERNAL_SERVER_ERROR);
		}

6.这其中的几个参数说明一下

AccessKeyId：官网获得

AccessKeySercet：官网获得

bucketName：创建的桶的名字，直接复制过来

region :创建时所选择的地区，这个就是地区 把我框起来的复制进去就可以

7.方法补充

其中有两个对于字符串的方法是我自己写的，一个是生成随机字符串，一个是取出文件后缀的方法。这边也一同附上，可以自己创建一个工具类后直接使用

 public static String generateRandomString() {
        String uuid = java.util.UUID.randomUUID().toString().replace("-", "").toUpperCase();
        // 截取前32位
        uuid = uuid.substring(0, 32);

        return uuid;
    }

 public static String getFileExtension(String fileName) {
        int lastDotIndex = fileName.lastIndexOf('.');

        // 如果没有找到点或者点位于字符串的开始位置，则认为没有扩展名
        if (lastDotIndex == -1 || lastDotIndex == 0) {
            return "";
        }

        // 返回点之后的部分
        return fileName.substring(lastDotIndex + 1);
    }

8.结尾

到此java通过S3实现上传文件的功能结束，如果对你有用的话可以点个赞支持一下