Amazon S3 URI를 버전 1에서 버전 2로 파싱할 때의 변경 사항 - AWS SDK for Java 2.x
높은 수준의 변경 사항API 변경

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon S3 URI를 버전 1에서 버전 2로 파싱할 때의 변경 사항

이 주제에서는 Amazon S3 URI를 버전 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.21.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");
쿼리 파라미터를 검색합니다. N/A 
Map<String, List<String>> queryParams =
    s3Uri.rawQueryParameters();

동작 변경 사항

URL 인코딩

v1은 URI를 URL로 인코딩해야 하는지 여부를 지정하는 플래그를 전달하는 옵션을 제공합니다. 기본 값은 true입니다.

v2에서는 URL 인코딩이 지원되지 않습니다. 예약된 문자 또는 안전하지 않은 문자가 있는 개체 키 또는 쿼리 매개 변수를 사용하는 경우 해당 문자를 URL로 인코딩해야 합니다. 예를 들어 공백을 " " 로 바꿔야 합니다. %20