Amazon S3 URIs をバージョン 1 からバージョン 2 に解析する際の変更 - AWS SDK for Java 2.x
高レベル変更API の変更

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon S3 URIs をバージョン 1 からバージョン 2 に解析する際の変更

このトピックでは、Amazon S3 URIs をバージョン 1 (v1) からバージョン 2 (v2) に解析する際の変更について詳しく説明します。

高レベル変更

v1 で S3 URI の解析を開始するには、コンストラクタを使用して をインスタンス化AmazonS3URIします。v2 ではS3Utilities、 のインスタンスparseUri()で を呼び出して を返しますS3URI。

変更 v1 v2

Maven の依存関係

 
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.amazonaws</groupId>
            <artifactId>aws-java-sdk-bom</artifactId>
            <version>1.12.5871</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
<dependencies>
    <dependency>  
        <groupId>com.amazonaws</groupId>
        <artifactId>s3</artifactId>
    </dependency>
</dependencies>
 
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>software.amazon.awssdk</groupId>
            <artifactId>bom</artifactId>
            <version>2.27.212</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
<dependencies>
    <dependency>
        <groupId>software.amazon.awssdk</groupId>
        <artifactId>s3</artifactId>
    </dependency>
</dependencies>
パッケージ名 com.amazonaws.services.s3 software.amazon.awssdk.services.s3
クラス名 AmazonS3URI S3URI

1 最新バージョン。 2 最新バージョン。

API の変更

行動 v1 v2
S3 URI を解析します。 
URI uri = URI.create( "https://s3.amazonaws.com");

AmazonS3Uri s3Uri = 
    new AmazonS3URI(uri, false);
 
S3Client s3Client = S3Client.create();
S3Utilities s3Utilities =
    s3Client.utilities();

S3Uri s3Uri =
    s3Utilities.parseUri(uri);
S3 URI からバケット名を取得します。 
String bucket = s3Uri.getBucket();
 
Optional<String> bucket = s3Uri.bucket();
キーを取得します。 
String key = s3Uri.getKey();
 
Optional<String> key = s3Uri.key();
リージョンを取得します。 
String region = s3Uri.getRegion();
 
Optional<Region> region = s3Uri.region();

String region;
if (s3Uri.region().isPresent()) {
    region = s3Uri.region().get().id();
}

S3 URI がパススタイルであるかどうかを取得します。

 
boolean isPathStyle = s3Uri.isPathStyle();
 
boolean isPathStyle = s3Uri.isPathStyle();
バージョン ID を取得します。 
String versionId = s3Uri.getVersionId();
 
Optional<String> versionId = 
    s3Uri.firstMatchingRawQueryParameter("versionId");
クエリパラメータを取得します。 該当なし 
Map<String, List<String>> queryParams =
    s3Uri.rawQueryParameters();

動作の変更

URL エンコーディング

v1 には、URI を URL エンコードするかどうかを指定するフラグを渡すオプションがあります。デフォルト値は true です。

v2 では、URL エンコーディングはサポートされていません。予約文字または安全でない文字を含むオブジェクトキーまたはクエリパラメータを使用する場合は、それらを URL エンコードする必要があります。たとえば、空白を " "に置き換える必要があります%20。