对象存储S3访问姿势

S3支持三种资源访问方式:

  1. Path Style URL

  2. Virtual-hosted Style URL

  3. 自定义域名

本质上,对象存储使用bucket,key来唯一标识一个对象,所以只要你告诉对象存储服务端这两个东西,那么理论上就能定位到这个数据。以上三种方式,总归都是为了获取到(bucket,object_key)。

1.Path Style URL

在Path Style URL中,bucket的名字紧跟在domain之后,成为URL path的一部分。

http://s3endpoint/BUCKET

比如,如果有一个photo.jpg存放在region为us-west-2,bucket为images的bucket中。可以用以下方式来访问:

http://s3-us-west-2.amazonaws.com/images/photo.jpg

重点:

  • 所有用户请求Host相同(旁白:在鱼龙混杂的互联网环境下,这种方式有个坑,思考下?)

  • bucket和key在URL里面:/ {bucket} / {key}

2.Virtual-Hosted Style URL

在Virtual-Hosted Style URL 中,bucket的名称成了subdomain:

http://BUCKET.s3endpoint

比如,如果有一个photo.jpg存放在region为us-west-2,bucket为images的bucket中。可以用以下方式来访问:

http://images.s3-us-west-2.amazonaws.com/photo.jpg

推荐使用Virtual-Hosted Style的访问方式。因为这个可以提高访问性能,少一跳。

重点:

  • bucket取自host一部分

  • 通过泛域名解析到公有云厂商服务器上

3.自定义域名

这个是初学者最难理解的一种访问方式。先说一个具体的例子,如果你要使用自定义域名下载访问对象,怎么操作?

  1. 首先,用户需要自己搞定一个能用的域名,并且把这个域名cname到你需要访问的S3 endpoint;

  2. 其次,用户在厂商提供的对象存储的管理界面上配置绑定这个域名到某个bucket;(旁白:这个只是存储一个map映射:域名到bucket的映射)

准备好了前面两个步骤,你就可以用自定义域名来访问资源:

// 注意:这里不需要指定bucket,只需要指定对象keyhttp://${自定义域名}.com/photo.jpg

解释下这两个步骤的作用:

  • 第一个步骤:用户负责S3请求发到S3的服务器上,用户负责这个路径的连通

  • 第二个步骤:对象存储服务端 会创建一个map,负责解析这个域名到bucket的映射(旁白:对象存储服务器说,只要你请求发的过来,我就能找到这个域名对应的bucket)


AWS S3的厂商推荐使用的是Virtual-hosted style URL。提供这种方式访问的厂商,要能支持泛域名解析。其实对于公有云厂商,更愿意推荐你使用自定义域名的方式。为啥?可以思考下。

举个例子,如果用户使用的是Path Style访问,那么Host使用的就是厂商统一的域名,如果用户在云存储上放置了一些非法的内容,很有可能会连累存储厂商的自身域名被封,这样的影响是非常严重的,会导致整个存储服务挂掉,影响所有用户。

### Java 使用 S3Client 操作 Amazon S3 对象存储 #### 创建 S3 客户端实例 为了与 Amazon S3 进行交互,首先需要创建 `S3Client` 的实例。默认情况下会使用签名版本 4 (v4),即 `S3Signer.v4()` 来签署请求[^2]。 ```java import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3.S3Client; public class S3Example { public static void main(String[] args) { Region region = Region.US_EAST_1; // 设置区域 S3Client s3 = S3Client.builder() .region(region) .credentialsProvider(ProfileCredentialsProvider.create()) .build(); System.out.println("成功创建 S3 Client"); } } ``` #### 列出所有存储桶 通过调用 `listBuckets` 方法可以获取当前账户下的全部存储桶列表: ```java import software.amazon.awssdk.services.s3.model.Bucket; import java.util.List; // ... List<Bucket> buckets = s3.listBuckets().buckets(); for (Bucket bucket : buckets) { System.out.printf("%s\n", bucket.name()); } ``` #### 向存储桶上传文件 要向特定的存储桶上传对象(文件),可以通过 `putObject` 请求完成此操作。这里展示了一个简单的例子来说明如何实现这一点: ```java import software.amazon.awssdk.core.sync.RequestBody; import software.amazon.awssdk.services.s3.model.PutObjectRequest; //... String bucketName = "example-bucket"; String key = "myKey"; // 文件名或路径 PutObjectRequest putObReq = PutObjectRequest.builder() .bucket(bucketName) .key(key) .build(); s3.putObject(putObReq, RequestBody.fromFile(new File("/path/to/file"))); System.out.println("文件上传成功!"); ``` #### 下载文件到本地磁盘 下载指定键的对象至本地系统同样简单明了,只需利用 `getObject` API 并指定期望保存的位置即可: ```java import java.nio.file.Paths; //... GetObjectRequest getObjectRequest = GetObjectRequest.builder() .bucket(bucketName) .key(key) .build(); s3.getObject(getObjectRequest, Paths.get("/local/path/destination")); System.out.println("文件下载完毕!"); ``` #### 删除单个对象 当不再需要某个对象时,可通过其对应的键执行删除动作: ```java DeleteObjectRequest deleteObjectRequest = DeleteObjectRequest.builder() .bucket(bucketName) .key(keyToDelete) .build(); s3.deleteObject(deleteObjectRequest); System.out.println("删除成功!"); ``` 以上就是关于如何在 Java 中使用 `S3Client` 类库来进行基本 CRUD 操作的一些指导[^1]。
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

查里王

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值