Perubahan dalam mengurai URI Amazon S3 dari versi 1 ke versi 2 - AWS SDK for Java 2.x
Perubahan tingkat tinggiPerubahan API

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Perubahan dalam mengurai URI Amazon S3 dari versi 1 ke versi 2

Topik ini merinci perubahan dalam mengurai URI Amazon S3 dari versi 1 (v1) ke versi 2 (v2.).

Perubahan tingkat tinggi

Untuk mulai mengurai URI S3 di v1, Anda membuat instance AmazonS3URI dengan menggunakan konstruktor. Di v2 Anda memanggil parseUri() instanceS3Utilities, untuk mengembalikan fileS3URI.

Perubahan v1 v2

Ketergantungan 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.21.212</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
<dependencies>
    <dependency>
        <groupId>software.amazon.awssdk</groupId>
        <artifactId>s3</artifactId>
    </dependency>
</dependencies>
Nama paket com.amazonaws.services.s3 software.amazon.awssdk.services.s3
Nama kelas AmazonS3URI S3URI

1 Versi terbaru. 2 Versi terbaru.

Perubahan API

Perilaku v1 v2
Mengurai URI S3. 
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);
Ambil nama bucket dari URI S3. 
String bucket = s3Uri.getBucket();
 
Optional<String> bucket = s3Uri.bucket();
Ambil kuncinya. 
String key = s3Uri.getKey();
 
Optional<String> key = s3Uri.key();
Ambil kembali wilayah tersebut. 
String region = s3Uri.getRegion();
 
Optional<Region> region = s3Uri.region();

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

Ambil kembali apakah URI S3 adalah gaya jalur.

 
boolean isPathStyle = s3Uri.isPathStyle();
 
boolean isPathStyle = s3Uri.isPathStyle();
Ambil ID versi. 
String versionId = s3Uri.getVersionId();
 
Optional<String> versionId = 
    s3Uri.firstMatchingRawQueryParameter("versionId");
Ambil parameter kueri. N/A 
Map<String, List<String>> queryParams =
    s3Uri.rawQueryParameters();

Perubahan perilaku

Pengkodean URL

v1 menyediakan opsi untuk meneruskan bendera untuk menentukan apakah URI harus dikodekan URL. Nilai default-nya adalah true.

Di v2, pengkodean URL tidak didukung. Jika Anda bekerja dengan kunci objek atau parameter kueri yang memiliki karakter cadangan atau tidak aman, Anda harus menyandikannya dengan URL. Misalnya Anda perlu mengganti spasi putih " " dengan. %20