AWS SDK for Java의 1.x와 2.x 간 직렬화 차이점

파라미터 차이를 요청할 객체 나열

SDK for Java v1와 v2.x는 파라미터를 요청하기 위해 List 객체를 직렬화하는 방식이 다릅니다.

SDK for Java 1.x는 빈 목록을 직렬화하지 않는 반면, SDK for Java 2.x는 빈 목록을 빈 파라미터로 직렬화합니다.

예를 들어 SampleRequest를 받는 SampleOperation이 있는 서비스를 생각해 보겠습니다. SampleRequest는 다음 예시와 같이 두 개의 파라미터(문자열 유형 str1과 목록 유형 listParam)를 허용합니다.

예 1.x의 SampleOperation

SampleRequest v1Request = new SampleRequest()
    .withStr1("TestName");

sampleServiceV1Client.sampleOperation(v1Request);

와이어 레벨 로깅은 listParam 파라미터가 직렬화되지 않았음을 보여줍니다.

Action=SampleOperation&Version=2011-01-01&str1=TestName

예 2.x의 SampleOperation

sampleServiceV2Client.sampleOperation(b -> b
    .str1("TestName"));

와이어 레벨 로깅은 listParam 파라미터가 값 없이 직렬화되었음을 보여줍니다.

Action=SampleOperation&Version=2011-01-01&str1=TestName&listParam=

V1의 POJO와 V2의 빌더 비교

V1 SDK for Java는 변경 가능한 POJO 클래스를 사용하기 때문에 Jackson과 같은 직렬화 및 역직렬화 라이브러리는 모델 객체를 직접 사용할 수 있습니다.

반대로 V2 SDK for Java는 변경 불가능한 모델 객체를 사용합니다. 중간 빌더를 사용하여 역직렬화를 수행해야 합니다.

다음 예제에서는 Jackson ObjectMapper를 사용하여 V1 및 V2로 headBucket API 호출을 직렬화/역직렬화할 때의 차이점을 보여줍니다.

    public void sendRequest() throws IOException {
        final String bucketName = "amzn-s3-demo-bucket";
        final ObjectMapper mapper = new ObjectMapper();

        // V1 uses POJOs to serialize and deserialize.
        final AmazonS3 v1S3Client = AmazonS3ClientBuilder.defaultClient();
        HeadBucketResult resultV1 = v1S3Client.headBucket(
            new HeadBucketRequest(bucketName));

        String v1Serialized = mapper.writeValueAsString(resultV1);

        HeadBucketResult deserializedV1 = mapper.readValue(v1Serialized, HeadBucketResult.class);
        
        // V2 uses builders to serialize and deserialize.
        S3Client v2S3Client = S3Client.create();
        HeadBucketResponse v2Response = v2S3Client.headBucket(
            b -> b.bucket(bucketName));

        String v2Serialized = mapper.writeValueAsString(
            v2Response.toBuilder());

        HeadBucketResponse v2Deserialized = mapper.readValue(
            v2Serialized, HeadBucketResponse.serializableBuilderClass())
            .build();
    }