SDK for Java의 버전 1에서 버전 2로의 매핑 라이브러리에 대한 개괄적인 변경 사항 - AWS SDK for Java 2.x

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

SDK for Java의 버전 1에서 버전 2로의 매핑 라이브러리에 대한 개괄적인 변경 사항

각 라이브러리의 매핑 클라이언트 이름은 V1과 V2에서 다릅니다.

  • V1 - DynamoDBMapper

  • V2 - DynamoDB 향상된 클라이언트

두 라이브러리와 거의 동일한 방식으로 상호 작용합니다. 즉, 매퍼/클라이언트를 인스턴스화한 다음 이러한 항목을 읽고 DynamoDB 테이블에 쓰는 API에 Java POJO를 제공합니다. 또한 두 라이브러리 모두 POJO 클래스에 대한 주석을 제공하여 클라이언트가 POJO를 처리하는 방법을 지시합니다.

V2로 이전할 때 눈에 띄는 차이점은 다음과 같습니다.

  • V2와 V1은 하위 수준 DynamoDB 작업에 서로 다른 메서드 이름을 사용합니다. 예:

    V1 V2
    로드 getItem
    저장 putItem
    batchLoad batchGetItem
  • V2는 테이블 스키마를 정의하고 POJO 테이블에 매핑하는 다양한 방법을 제공합니다. 빌더를 사용하여 코드에서 생성된 스키마 또는 주석 사용 중에서 선택할 수 있습니다. 또한 V2는 변경 및 변경 불가능한 버전의 스키마를 제공합니다.

  • V2에서는 특히 첫 번째 단계 중 하나로 테이블 스키마를 만드는 반면, V1에서는 필요에 따라 주석이 달린 클래스에서 테이블 스키마를 추론합니다.

  • V2는 향상된 클라이언트 API에 문서 API 클라이언트를 포함하는 반면, V1은 별도의 API를 사용합니다.

  • 모든 API는 V2의 동기식 및 비동기식 버전에서 사용할 수 있습니다.

V2 향상된 클라이언트에 대한 자세한 내용은 이 가이드의 DynamoDB 매핑 섹션을 참조하세요.

종속성 차이 가져오기

V1 V2
<dependencyManagement> <dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk-bom</artifactId> <version>1.X.X</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk-dynamodb</artifactId> </dependency> </dependencies>
<dependencyManagement> <dependencies> <dependency> <groupId>software.amazon.awssdk</groupId> <artifactId>bom</artifactId> <version>2.X.X*</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <dependencies> <dependency> <groupId>software.amazon.awssdk</groupId> <artifactId>dynamodb-enhanced</artifactId> </dependency> </dependencies>

* 최신 버전.

V1에서는 단일 종속성에 하위 수준 DynamoDB API와 매핑/문서 API가 모두 포함되는 반면, V2에서는 dynamodb-enhanced 아티팩트 종속성을 사용하여 매핑/문서 API에 액세스합니다. dynamodb-enhanced 모듈에는 하위 수준 dynamodb 모듈에 대한 전이적 종속성이 포함되어 있습니다.