| Objek langsung yang dapat dilanjutkan | Tidak Didukung |
### Objek hasil
| Kelas V1 | Kelas V2 | Status migrasi |
| --- | --- | --- |
| CopyResult | CompletedCopy | Didukung |
| UploadResult | CompletedUpload | Didukung |
### Objek konfigurasi
| Kelas V1 | Kelas V2 | Status migrasi |
| --- | --- | --- |
| TransferManagerConfiguration | MultipartConfiguration(di klien Amazon S3) | Didukung |
| TransferProgress | TransferProgress \$1 TransferProgressSnapshot | Didukung |
| KeyFilter | DownloadFilter | Didukung |
### Objek yang tidak didukung
| Kelas V1 | V2 alternatif | Status migrasi |
| --- | --- | --- |
| PauseStatus | Tidak didukung | Tidak Didukung |
| UploadContext | Tidak didukung | Tidak Didukung |
| ObjectCannedAclProvider | PutObjectRequest.builder().acl() | Tidak Didukung |
| ObjectMetadataProvider | PutObjectRequest.builder().metadata() | Tidak Didukung |
| ObjectTaggingProvider | PutObjectRequest.builder().tagging() | Tidak Didukung |
| PresignedUrlDownload | Tidak didukung | Tidak Didukung |
## TransferManagerBuilder migrasi konfigurasi
### Perubahan konfigurasi
Perubahan konfigurasi yang perlu Anda atur untuk manajer transfer v2 bergantung pada klien S3 mana yang Anda gunakan. Anda memiliki pilihan klien S3 AWS berbasis CRT atau klien async S3 berbasis Java standar. Untuk informasi tentang perbedaan, lihat [Klien S3 di AWS SDK for Java 2.x](examples-s3.md#s3-clients) topiknya.
------
#### [ Use the AWS CRT-based S3 client ]
****
| Pengaturan | v1 | v2 - Transfer Manager menggunakan klien AWS S3 berbasis CRT |
| --- | --- | --- |
| (dapatkan pembangun) | TransferManagerBuilder tmBuilder =
TransferManagerBuilder.standard();
| S3TransferManager.Builder tmBuilder =
S3TransferManager.builder();
|
| Klien S3 | tmBuilder.withS3Client(...);
tmBuilder.setS3Client(...);
| tmBuilder.s3Client(...);
|
| Pelaksana | tmBuilder.withExecutorFactory(...);
tmBuilder.setExecutorFactory(...);
| tmBuilder.executor(...);
|
| Shutdown thread pool | tmBuilder.withShutDownThreadPools(...);
tmBuilder.setShutdownThreadPools(...);
| Tidak didukung. Pelaksana yang disediakan tidak akan dimatikan saat S3TransferManager ditutup |
| Ukuran bagian unggahan minimum | tmBuilder.withMinimumUploadPartSize(...);
tmBuilder.setMinimumUploadPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
minimumPartSizeInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Ambang batas unggahan multipart | tmBuilder.withMultipartUploadThreshold(...);
tmBuilder.setMultipartUploadThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
thresholdInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Ukuran bagian salinan minimum | tmBuilder.withMultipartCopyPartSize(...);
tmBuilder.setMultipartCopyPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
minimumPartSizeInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Ambang batas salinan multipart | tmBuilder.withMultipartCopyThreshold(...);
tmBuilder.setMultipartCopyThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
thresholdInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Nonaktifkan unduhan paralel | tmBuilder.withDisableParallelDownloads(...);
tmBuilder.setDisableParallelDownloads(...);
| Nonaktifkan unduhan paralel dengan meneruskan klien S3 berbasis Java standar dengan multipart dinonaktifkan (default) ke manajer transfer.S3AsyncClient s3 =
S3AsyncClient.builder().build();
tmBuilder.s3Client(s3);
|
| Selalu hitung multipart md5 | tmBuilder.withAlwaysCalculateMultipartMd5(...);
tmBuilder.setAlwaysCalculateMultipartMd5(...);
| Tidak didukung. |
------
#### [ Use Java-based S3 async client ]
****
| Pengaturan | v1 | v2 - Transfer Manager menggunakan klien async S3 berbasis Java |
| --- | --- | --- |
| (dapatkan pembangun) | TransferManagerBuilder tmBuilder =
TransferManagerBuilder.standard();
| S3TransferManager.Builder tmBuilder =
S3TransferManager.builder();
|
| Klien S3 | tmBuilder.withS3Client(...);
tmBuilder.setS3Client(...);
| tmBuilder.s3Client(...);
|
| Pelaksana | tmBuilder.withExecutorFactory(...);
tmBuilder.setExecutorFactory(...);
| tmBuilder.executor(...);
|
| Shutdown thread pool | tmBuilder.withShutDownThreadPools(...);
tmBuilder.setShutdownThreadPools(...);
| Tidak didukung. Pelaksana yang disediakan tidak akan dimatikan saat S3TransferManager ditutup |
| Ukuran bagian unggahan minimum | tmBuilder.withMinimumUploadPartSize(...);
tmBuilder.setMinimumUploadPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.minimumPartSizeInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Ambang batas unggahan multipart | tmBuilder.withMultipartUploadThreshold(...);
tmBuilder.setMultipartUploadThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.thresholdInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Ukuran bagian salinan minimum | tmBuilder.withMultipartCopyPartSize(...);
tmBuilder.setMultipartCopyPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.minimumPartSizeInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Ambang batas salinan multipart | tmBuilder.withMultipartCopyThreshold(...);
tmBuilder.setMultipartCopyThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.thresholdInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Nonaktifkan unduhan paralel | tmBuilder.withDisableParallelDownloads(...);
tmBuilder.setDisableParallelDownloads(...);
| Nonaktifkan unduhan paralel dengan meneruskan klien S3 berbasis Java standar dengan multipart dinonaktifkan (default) ke manajer transfer.S3AsyncClient s3 =
S3AsyncClient.builder().build();
tmBuilder.s3Client(s3);
|
| Selalu hitung multipart md5 | tmBuilder.withAlwaysCalculateMultipartMd5(...);
tmBuilder.setAlwaysCalculateMultipartMd5(...);
| Tidak didukung. |
------
## Perubahan perilaku
### Operasi asinkron
**V1 (pemblokiran):**
```
Upload upload = transferManager.upload("amzn-s3-demo-bucket", "key", file);
upload.waitForCompletion(); // Blocks until complete
```
**V2 (asinkron):**
```
FileUpload upload = transferManager.uploadFile(UploadFileRequest.builder()
.putObjectRequest(PutObjectRequest.builder()
.bucket("amzn-s3-demo-bucket")
.key("key")
.build())
.source(file)
.build());
CompletedFileUpload result = upload.completionFuture().join(); // Blocks until complete
// Or handle asynchronously:
upload.completionFuture().thenAccept(result -> {
System.out.println("Upload completed: " + result.response().eTag());
});
```
### Penanganan kesalahan
**V1:** Transfer direktori gagal sepenuhnya jika ada sub-permintaan yang gagal.
**V2:** Transfer direktori berhasil diselesaikan bahkan jika beberapa sub-permintaan gagal. Periksa kesalahan secara eksplisit:
```
DirectoryUpload directoryUpload = transferManager.uploadDirectory(request);
CompletedDirectoryUpload result = directoryUpload.completionFuture().join();
// Check for failed transfers
if (!result.failedTransfers().isEmpty()) {
System.out.println("Some uploads failed:");
result.failedTransfers().forEach(failed ->
System.out.println("Failed: " + failed.exception().getMessage()));
}
```
### Unduhan paralel melalui pengambilan rentang byte
Ketika fitur transfer paralel otomatis diaktifkan di SDK v2, Manajer Transfer S3 menggunakan [pengambilan rentang byte untuk mengambil](https://docs.aws.amazon.com/AmazonS3/latest/userguide/optimizing-performance-guidelines.html#optimizing-performance-guidelines-get-range) bagian tertentu dari objek secara paralel (unduhan multibagian). Cara objek diunduh dengan v2 tidak tergantung pada bagaimana objek awalnya diunggah. Semua unduhan dapat memperoleh manfaat dari throughput dan konkurensi yang tinggi.
Sebaliknya, dengan Transfer Manager v1, penting bagaimana objek awalnya diunggah. Manajer Transfer v1 mengambil bagian-bagian objek dengan cara yang sama seperti bagian-bagian yang diunggah. Jika objek awalnya diunggah sebagai objek tunggal, Manajer Transfer v1 tidak dapat mempercepat proses pengunduhan dengan menggunakan sub-permintaan.
# Perubahan dalam mengurai Amazon URIs S3 dari versi 1 ke versi 2
Topik ini merinci perubahan dalam mengurai Amazon URIs 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()` instance`S3Utilities`, untuk mengembalikan file`S3URI`.
****
| Ubah | v1 | v2 |
| --- | --- | --- |
| Ketergantungan Maven |
com.amazonaws
aws-java-sdk-bom
1.12.5871
pom
import
com.amazonaws
s3
|
software.amazon.awssdk
bom
2.27.212
pom
import
software.amazon.awssdk
s3
|
| Nama paket | com.amazonaws.services.s3 | software.amazon.awssdk.services.s3 |
| Nama kelas | [AmazonS3URI](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/AmazonS3URI.html) | [S3URI](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3Uri.html) |
1 [Versi terbaru](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Versi terbaru](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## 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 bucket = s3Uri.bucket();
|
| Ambil kuncinya. | String key = s3Uri.getKey();
| Optional key = s3Uri.key();
|
| Ambil kembali wilayah tersebut. | String region = s3Uri.getRegion();
| Optional 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 versionId =
s3Uri.firstMatchingRawQueryParameter("versionId");
|
| Ambil parameter kueri. | N/A | Map> 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`
# Perubahan pada API Pemberitahuan Acara S3 dari versi 1 ke versi 2
Topik ini merinci perubahan dalam S3 Event Notifications API dari versi 1.x (v1) ke versi 2 .x (v2) dari. AWS SDK untuk Java
## Perubahan tingkat tinggi
### Perubahan struktural
V1 menggunakan kelas internal statis untuk `EventNotificationRecord` tipe dan atributnya, sedangkan v2 menggunakan kelas publik terpisah untuk `EventNotificationRecord` tipe.
### Perubahan konvensi penamaan
*Di v1, nama kelas atribut menyertakan akhiran *Entity*, sedangkan v2 menghilangkan akhiran ini untuk penamaan yang lebih sederhana: misalnya, EventData, bukan. *eventDataEntity**
## Perubahan dependensi, paket, dan nama kelas
Di v1, kelas API Pemberitahuan Acara S3 diimpor secara transitif bersama dengan modul S3 (ArtifactID). `aws-java-sdk-s3` Namun, di v2, Anda perlu menambahkan ketergantungan pada `s3-event-notifications` artefak.
****
| Ubah | v1 | v2 |
| --- | --- | --- |
| Ketergantungan Maven |
com.amazonaws
aws-java-sdk-bom
1.X.X
pom
import
com.amazonaws
aws-java-sdk-s3
|
software.amazon.awssdk
bom
2.X.X1
pom
import
software.amazon.awssdk
s3-event-notifications
|
| Nama paket | com.amazonaws.services.s3.event | software.amazon.awssdk.eventnotifications.s3.model |
| Nama kelas | [S3 EventNotification](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.html) [S3 .S3 EventNotification EventNotificationRecord](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.S3EventNotificationRecord.html) [S3EventNotification. GlacierEventDataEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.GlacierEventDataEntity.html) [S3EventNotification. IntelligentTieringEventDataEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.IntelligentTieringEventDataEntity.html) [S3EventNotification. LifecycleEventDataEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.LifecycleEventDataEntity.html) [S3EventNotification. ReplicationEventDataEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.ReplicationEventDataEntity.html) [S3EventNotification. RequestParametersEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.RequestParametersEntity.html) [S3EventNotification. ResponseElementsEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.ResponseElementsEntity.html) [S3EventNotification. RestoreEventDataEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.RestoreEventDataEntity.html) [S3 .S3 EventNotification BucketEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.S3BucketEntity.html) [S3 EventNotification .S3Entitas](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.S3Entity.html) [S3 .S3 EventNotification ObjectEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.S3ObjectEntity.html) [S3EventNotification. TransitionEventDataEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.TransitionEventDataEntity.html) [S3EventNotification. UserIdentityEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.UserIdentityEntity.html) | [S3 EventNotification](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/S3EventNotification.html) [S3 EventNotificationRecord](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/S3EventNotificationRecord.html) [GlacierEventData](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/GlacierEventData.html) [IntelligentTieringEventData](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/IntelligentTieringEventData.html) [LifecycleEventData](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/LifecycleEventData.html) [ReplicationEventData](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/ReplicationEventData.html) [RequestParameters](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/RequestParameters.html) [ResponseElements](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/ResponseElements.html) [RestoreEventData](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/RestoreEventData.html) [S3Bucket](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/S3Bucket.html) [S3](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/S3.html) [S3Objek](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/S3Object.html) [TransitionEventData](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/TransitionEventData.html) [UserIdentity](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/UserIdentity.html) |
1 [Versi terbaru](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Perubahan API
### JSON ke `S3EventNotification` dan mundur
| Kasus penggunaan | v1 | v2 |
| --- | --- | --- |
| Buat S3EventNotification dari JSON String | S3EventNotification notification =
S3EventNotification.parseJson(message.body());
| S3EventNotification notification =
S3EventNotification.fromJson(message.body());
|
| Konversi S3EventNotification ke JSON String | String json = notification.toJson();
| String json = notification.toJson();
|
### Atribut akses `S3EventNotification`
| Kasus penggunaan | v1 | v2 |
| --- | --- | --- |
| Mengambil catatan dari notifikasi | List records =
notifcation.getRecords();
| List records =
notification.getRecords();
|
| Mengambil catatan dari daftar catatan | S3EventNotification.S3EventNotificationRecord record =
records.stream().findAny().get();
| S3EventNotificationRecord record =
records.stream().findAny().get();
|
| Ambil data peristiwa Glacier | S3EventNotification.GlacierEventDataEntity glacierEventData =
record.getGlacierEventData();
| GlacierEventData glacierEventData =
record.getGlacierEventData();
|
| Mengambil data peristiwa pemulihan dari peristiwa Glacier | S3EventNotification.RestoreEventDataEntity restoreEventData =
glacierEventData.getRestoreEventDataEntity();
| RestoreEventData restoreEventData =
glacierEventData.getRestoreEventData();
|
| Ambil parameter permintaan | S3EventNotification.RequestParametersEntity requestParameters =
record.getRequestParameters();
| RequestParameters requestParameters =
record.getRequestParameters();
|
| Ambil data acara Intelligent Tiering | S3EventNotification.IntelligentTieringEventDataEntity tieringEventData =
record.getIntelligentTieringEventData();
| IntelligentTieringEventData intelligentTieringEventData =
record.getIntelligentTieringEventData();
|
| Mengambil data peristiwa lifecyle | S3EventNotification.LifecycleEventDataEntity lifecycleEventData =
record.getLifecycleEventData();
| LifecycleEventData lifecycleEventData =
record.getLifecycleEventData();
|
| Ambil nama acara sebagai enum | S3Event eventNameAsEnum = record.getEventNameAsEnum();
| //getEventNameAsEnum does not exist; use 'getEventName()'
String eventName = record.getEventName();
|
| Ambil data peristiwa replikasi | S3EventNotification.ReplicationEventDataEntity replicationEntity =
record.getReplicationEventDataEntity();
| ReplicationEventData replicationEventData =
record.getReplicationEventData();
|
| Ambil bucket S3 dan informasi objek | S3EventNotification.S3Entity s3 = record.getS3();
| S3 s3 = record.getS3();
|
| Mengambil informasi identitas pengguna | S3EventNotification.UserIdentityEntity userIdentity =
record.getUserIdentity();
| UserIdentity userIdentity =
record.getUserIdentity();
|
| Ambil elemen respons | S3EventNotification.ResponseElementsEntity responseElements =
record.getResponseElements();
| ResponseElements responseElements =
record.getResponseElements();
|
## Migrasi versi `aws-lambda-java-events` pustaka
Jika Anda menggunakan [aws-lambda-java-events](https://github.com/aws/aws-lambda-java-libs/tree/main/aws-lambda-java-events)untuk bekerja dengan peristiwa pemberitahuan S3 dalam fungsi Lambda, kami sarankan Anda meningkatkan ke versi 3.xx terbaru. Versi terbaru menghilangkan semua dependensi pada AWS SDK untuk Java 1.x dari API pemberitahuan acara S3.
Untuk informasi selengkapnya tentang perbedaan dalam menangani notifikasi peristiwa S3 antara `aws-lambda-java-events` pustaka dan SDK for Java 2.x, lihat. [Proses Acara S3 di Lambda dengan Perpustakaan Java: dan AWS SDK for Java 2.x `aws-lambda-java-events`](examples-s3-event-notifications.md#s3-event-notif-processing-options)
# Perubahan file profil
AWS SDK for Java 2.x Mem-parsing definisi profil `~/.aws/config` dan `~/.aws/credentials` untuk lebih dekat meniru cara AWS CLI mem-parsing file.
SDK for Java 2.x:
+ Menyelesaikan `~/` atau `~` diikuti oleh pemisah jalur default sistem file di awal jalur dengan memeriksa, secara berurutan,, `$USERPROFILE` (hanya Windows)`$HOME`,`$HOMEDRIVE`, `$HOMEPATH` (hanya Windows), dan kemudian properti sistem. `user.home`
+ Mencari variabel `AWS_SHARED_CREDENTIALS_FILE` lingkungan alih-alih`AWS_CREDENTIAL_PROFILES_FILE`.
+ Diam-diam menjatuhkan definisi profil dalam file konfigurasi tanpa kata `profile` di awal nama profil.
+ Secara diam-diam menjatuhkan definisi profil yang tidak terdiri dari karakter alfanumerik, garis bawah atau tanda hubung (setelah `profile` kata utama dihapus untuk file konfigurasi).
+ Menggabungkan pengaturan definisi profil yang digandakan dalam file yang sama.
+ Menggabungkan pengaturan definisi profil yang digandakan dalam file konfigurasi dan kredensyal.
+ TIDAK menggabungkan pengaturan jika keduanya `[profile foo]` dan `[foo]` ditemukan dalam file yang sama.
+ Menggunakan pengaturan di `[profile foo]` jika `[foo]` keduanya `[profile foo]` dan ditemukan di file konfigurasi.
+ Menggunakan nilai pengaturan duplikat terakhir dalam file dan profil yang sama.
+ Mengenali keduanya `;` dan `#` untuk mendefinisikan komentar.
+ Mengenali `;` dan `#` dalam definisi profil untuk mendefinisikan komentar, bahkan jika karakter berdekatan dengan braket penutup.
+ Mengenali `;` dan `#` mendefinisikan komentar hanya dalam menetapkan nilai hanya jika mereka didahului oleh spasi putih.
+ Mengenali `;` dan `#` dan semua konten berikut dalam menetapkan nilai jika tidak didahului oleh spasi putih.
+ Mempertimbangkan kredensyal berbasis peran sebagai kredensyal prioritas tertinggi. SDK 2.x selalu menggunakan kredensyal berbasis peran jika pengguna menentukan properti. `role_arn`
+ Mempertimbangkan kredensyal berbasis sesi sebagai kredensyal. second-highest-priority SDK 2.x selalu menggunakan kredensyal berbasis sesi jika kredensyal berbasis peran tidak digunakan dan pengguna menentukan properti dan. `aws_access_key_id` `aws_session_token`
+ Menggunakan kredensyal dasar jika kredensyal berbasis peran dan sesi tidak digunakan dan pengguna menentukan properti. `aws_access_key_id`
# Variabel lingkungan dan properti sistem berubah
| 1.x Variabel Lingkungan | 1.x Properti Sistem | 2.x Variabel Lingkungan | 2.x Properti Sistem |
| --- | --- | --- | --- |
| AWS\$1ACCESS\$1KEY\$1IDAWS\$1ACCESS\$1KEY | aws.accessKeyId | AWS\$1ACCESS\$1KEY\$1ID | aws.accessKeyId |
| AWS\$1SECRET\$1KEYAWS\$1SECRET\$1ACCESS\$1KEY | aws.secretKey | AWS\$1SECRET\$1ACCESS\$1KEY | aws.secretAccessKey |
| AWS\$1SESSION\$1TOKEN | aws.sessionToken | AWS\$1SESSION\$1TOKEN | aws.sessionToken |
| AWS\$1REGION | aws.region | AWS\$1REGION | aws.region |
| AWS\$1CONFIG\$1FILE | | AWS\$1CONFIG\$1FILE | aws.configFile |
| AWS\$1CREDENTIAL\$1PROFILES\$1FILE | | AWS\$1SHARED\$1CREDENTIALS\$1FILE | aws.sharedCredentialsFile |
| AWS\$1PROFILE | aws.profile | AWS\$1PROFILE | aws.profile |
| AWS\$1EC2\$1METADATA\$1DISABLED | com.amazonaws.sdk.disableEc2Metadata | AWS\$1EC2\$1METADATA\$1DISABLED | aws.disableEc2Metadata |
| | com.amazonaws.sdk.ec2MetadataServiceEndpointOverride | AWS\$1EC2\$1METADATA\$1SERVICE\$1ENDPOINT | aws.ec2MetadataServiceEndpoint |
| AWS\$1CONTAINER\$1CREDENTIALS\$1RELATIVE\$1URI | | AWS\$1CONTAINER\$1CREDENTIALS\$1RELATIVE\$1URI | aws.containerCredentialsPath |
| AWS\$1CONTAINER\$1CREDENTIALS\$1FULL\$1URI | | AWS\$1CONTAINER\$1CREDENTIALS\$1FULL\$1URI | aws.containerCredentialsFullUri |
| AWS\$1CONTAINER\$1AUTHORIZATION\$1TOKEN | | AWS\$1CONTAINER\$1AUTHORIZATION\$1TOKEN | aws.containerAuthorizationToken |
| AWS\$1CBOR\$1DISABLED | com.amazonaws.sdk.disableCbor | CBOR\$1ENABLED | aws.cborEnabled |
| AWS\$1ION\$1BINARY\$1DISABLE | com.amazonaws.sdk.disableIonBinary | BINARY\$1ION\$1ENABLED | aws.binaryIonEnabled |
| AWS\$1EXECUTION\$1ENV | | AWS\$1EXECUTION\$1ENV | aws.executionEnvironment |
| | com.amazonaws.sdk.disableCertChecking | Tidak didukung ([fitur Permintaan](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Tidak didukung ([fitur Permintaan](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.sdk.enableDefaultMetrics | [Tidak didukung](https://github.com/aws/aws-sdk-java-v2/issues/23) | [Tidak didukung](https://github.com/aws/aws-sdk-java-v2/issues/23) |
| | com.amazonaws.sdk.enableThrottledRetry | [Tidak didukung](https://github.com/aws/aws-sdk-java-v2/issues/645) | [Tidak didukung](https://github.com/aws/aws-sdk-java-v2/issues/645) |
| | com.amazonaws.regions.RegionUtils.fileOverride | Tidak didukung ([fitur Permintaan](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Tidak didukung ([fitur Permintaan](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.regions.RegionUtils.disableRemote | Tidak didukung ([fitur Permintaan](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Tidak didukung ([fitur Permintaan](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.services.s3.disableImplicitGlobalClients | Tidak didukung ([fitur Permintaan](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Tidak didukung ([fitur Permintaan](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.sdk.enableInRegionOptimizedMode | Tidak didukung ([fitur Permintaan](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Tidak didukung ([fitur Permintaan](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
# Perubahan Pelayan dari versi 1 ke versi 2
Topik ini merinci perubahan fungsionalitas Pelayan dari versi 1 (v1) ke versi 2 (v2).
Tabel berikut menunjukkan perbedaan untuk pelayan DynamoDB secara khusus. Pelayan untuk layanan lain mengikuti pola yang sama.
## Perubahan tingkat tinggi
Kelas pelayan berada dalam artefak Maven yang sama dengan layanan.
| Perubahan | v1 | v2 |
| --- | --- | --- |
| Ketergantungan Maven |
com.amazonaws
aws-java-sdk-bom
1.12.6801
pom
import
com.amazonaws
dynamodb
|
software.amazon.awssdk
bom
2.27.102
pom
import
software.amazon.awssdk
dynamodb
|
| Nama paket | com.amazonaws.services.dynamodbv2.waiters | software.amazon.awssdk.services.dynamodb.waiters |
| Nama kelas | `[AmazonDynamoDBWaiters](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/waiters/AmazonDynamoDBWaiters.html)` | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sdk-for-java/latest/developer-guide/migration-waiters.html) |
1 [Versi terbaru](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Versi terbaru](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Perubahan API
| Perubahan | v1 | v2 |
| --- | --- | --- |
| Buat pelayan | AmazonDynamoDB client = AmazonDynamoDBClientBuilder
.standard().build();
AmazonDynamoDBWaiters waiter = client.waiters();
| Sinkron:DynamoDbClient client = DynamoDbClient.create();
DynamoDbWaiter waiter = client.waiter();
Asinkron:DynamoDbAsyncClient asyncClient =
DynamoDbAsyncClient.create();
DynamoDbAsyncWaiter waiter = asyncClient.waiter();
|
| Tunggu sampai ada tabel | Sinkron:waiter.tableExists()
.run(new WaiterParameters<>(
new DescribeTableRequest(tableName)));
Asinkron:waiter.tableExists()
.runAsync(new WaiterParameters()
.withRequest(new DescribeTableRequest(tableName)),
new WaiterHandler() {
@Override
public void onWaitSuccess(
AmazonWebServiceRequest amazonWebServiceRequest) {
System.out.println("Table creation succeeded");
}
@Override
public void onWaitFailure(Exception e) {
e.printStackTrace();
}
}).get();
| Sinkron: WaiterResponse waiterResponse =
waiter.waitUntilTableExists(
r -> r.tableName("myTable"));
waiterResponse.matched().response()
.ifPresent(System.out::println);
Asinkron: waiter.waitUntilTableExists(r -> r.tableName(tableName))
.whenComplete((r, t) -> {
if (t != null) {
t.printStackTrace();
} else {
System.out.println(
"Table creation succeeded");
}
}).join();
|
## Perubahan konfigurasi
| Perubahan | v1 | v2 |
| --- | --- | --- |
| Strategi Polling (upaya maksimal dan penundaan tetap) | MaxAttemptsRetryStrategy maxAttemptsRetryStrategy =
new MaxAttemptsRetryStrategy(10);
FixedDelayStrategy fixedDelayStrategy =
new FixedDelayStrategy(3);
PollingStrategy pollingStrategy =
new PollingStrategy(maxAttemptsRetryStrategy,
fixedDelayStrategy);
waiter.tableExists().run(
new WaiterParameters<>(
new DescribeTableRequest(tableName)),
pollingStrategy);
|
FixedDelayBackoffStrategy fixedDelayBackoffStrategy =
FixedDelayBackoffStrategy
.create(Duration.ofSeconds(3));
waiter.waitUntilTableExists(r -> r.tableName(tableName),
c -> c.maxAttempts(10)
.backoffStrategy(fixedDelayBackoffStrategy));
|
# Perubahan utilitas metadata EC2 dari versi 1 ke versi 2
Topik ini merinci perubahan utilitas metadata SDK for Java Amazon Elastic Compute Cloud (EC2) dari versi 1 (v1) ke versi 2 (v2).
## Perubahan tingkat tinggi
****
| Ubah | v1 | v2 |
| --- | --- | --- |
| Ketergantungan Maven |
com.amazonaws
aws-java-sdk-bom
1.12.5871
pom
import
com.amazonaws
aws-java-sdk-core
|
software.amazon.awssdk
bom
2.27.212
pom
import
software.amazon.awssdk
imds
software.amazon.awssdk
apache-client3
|
| Nama paket | com.amazonaws.util | software.amazon.awssdk.imds |
| Pendekatan instantiasi | Gunakan metode utilitas statis; tidak ada instantiasi: String localHostName =
EC2MetadataUtils.getLocalHostName();
| Gunakan metode pabrik statis: Ec2MetadataClient client = Ec2MetadataClient.create();
Atau gunakan pendekatan pembangun: Ec2MetadataClient client = Ec2MetadataClient.builder()
.endpointMode(EndpointMode.IPV6)
.build();
|
| Jenis klien | Hanya metode utilitas sinkron: EC2MetadataUtils | Sinkron: `Ec2MetadataClient` Asinkron: `Ec2MetadataAsyncClient` |
1 [Versi terbaru](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Versi terbaru](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
3 Perhatikan deklarasi `apache-client` modul untuk v2. V2 dari utilitas metadata EC2 memerlukan implementasi `SdkHttpClient` antarmuka untuk klien metadata sinkron, atau antarmuka untuk klien metadata `SdkAsyncHttpClient` asinkron. [Konfigurasikan klien HTTP di AWS SDK for Java 2.x](http-configuration.md)Bagian ini menunjukkan daftar klien HTTP yang dapat Anda gunakan.
### Meminta metadata
Di v1, Anda menggunakan metode statis yang tidak menerima parameter untuk meminta metadata untuk sumber daya EC2. Sebaliknya, Anda perlu menentukan jalur ke sumber daya EC2 sebagai parameter di v2. Tabel berikut menunjukkan pendekatan yang berbeda.
****
| v1 | v2 |
| --- | --- |
| String userMetaData = EC2MetadataUtils.getUserData();
| Ec2MetadataClient client = Ec2MetadataClient.create();
Ec2MetadataResponse response =
client.get("/latest/user-data");
String userMetaData =
response.asString();
|
Lihat [kategori metadata instance](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/instancedata-data-categories.html) untuk menemukan jalur yang perlu Anda berikan untuk meminta sepotong metadata.
**catatan**
Ketika Anda menggunakan klien metadata instance di v2, Anda harus bertujuan untuk menggunakan klien yang sama untuk semua permintaan untuk mengambil metadata.
## Perubahan perilaku
### Data JSON
Pada EC2, Layanan Metadata Instance (IMDS) yang berjalan secara lokal mengembalikan beberapa metadata sebagai string berformat JSON. Salah satu contohnya adalah metadata dinamis dari dokumen [identitas instance](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/instance-identity-documents.html).
API v1 berisi metode terpisah untuk setiap bagian metadata identitas instance, sedangkan API v2 secara langsung mengembalikan string JSON. Untuk bekerja dengan string JSON, Anda dapat menggunakan [Document API](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/core/document/package-summary.html) untuk mengurai respons dan menavigasi struktur JSON.
Tabel berikut membandingkan bagaimana Anda mengambil metadata dari dokumen identitas instance di v1 dan v2.
****
| Kasus penggunaan | v1 | v2 |
| --- | --- | --- |
| Ambil Wilayah | InstanceInfo instanceInfo =
EC2MetadataUtils.getInstanceInfo();
String region = instanceInfo.getRegion();
| Ec2MetadataResponse response =
client.get("/latest/dynamic/instance-identity/document");
Document instanceInfo = response.asDocument();
String region = instanceInfo.asMap().get("region").asString();
|
| Ambil id instance | InstanceInfo instanceInfo =
EC2MetadataUtils.getInstanceInfo();
String instanceId = instanceInfo.instanceId;
| Ec2MetadataResponse response =
client.get("/latest/dynamic/instance-identity/document");
Document instanceInfo = response.asDocument();
String instanceId = instanceInfo.asMap().get("instanceId").asString();
|
| Ambil jenis instance | InstanceInfo instanceInfo =
EC2MetadataUtils.getInstanceInfo();
String instanceType = instanceInfo.instanceType();
| Ec2MetadataResponse response =
client.get("/latest/dynamic/instance-identity/document");
Document instanceInfo = response.asDocument();
String instanceType = instanceInfo.asMap().get("instanceType").asString();
|
### Perbedaan resolusi titik akhir
Tabel berikut menunjukkan lokasi yang diperiksa SDK untuk menyelesaikan titik akhir IMDS. Lokasi tercantum dalam prioritas menurun.
****
| v1 | v2 |
| --- | --- |
| Properti sistem: com.amazonaws.sdk.ec2MetadataServiceEndpointOverride | Metode konfigurasi pembangun klien: endpoint(...) |
| Variabel lingkungan: AWS\$1EC2\$1METADATA\$1SERVICE\$1ENDPOINT | Properti sistem: aws.ec2MetadataServiceEndpoint |
| Nilai Default: http://169.254.169.254 | File konfigurasi: \$1.aws/config dengan pengaturan ec2\$1metadata\$1service\$1endpoint |
| | Nilai yang terkait dengan diselesaikan endpoint-mode |
| | Nilai default: http://169.254.169.254 |
### Resolusi titik akhir di v2
Saat Anda secara eksplisit menetapkan titik akhir dengan menggunakan pembuat, nilai titik akhir tersebut diprioritaskan di atas semua pengaturan lainnya. Ketika kode berikut dijalankan, properti `aws.ec2MetadataServiceEndpoint` sistem dan `ec2_metadata_service_endpoint` pengaturan file konfigurasi diabaikan jika ada.
```
Ec2MetadataClient client = Ec2MetadataClient
.builder()
.endpoint(URI.create("endpoint.to.use"))
.build();
```
#### Modus titik akhir
Dengan v2, Anda dapat menentukan mode titik akhir untuk mengonfigurasi klien metadata agar menggunakan nilai titik akhir default untuk atau. IPv4 IPv6 Mode titik akhir tidak tersedia untuk v1. Nilai default yang digunakan untuk IPv4 adalah `http://169.254.169.254` dan `http://[fd00:ec2::254]` untuk IPv6.
Tabel berikut menunjukkan berbagai cara yang dapat Anda atur mode endpoint dalam urutan prioritas menurun.
****
| | | Kemungkinan nilai |
| --- | --- | --- |
| Metode konfigurasi pembangun klien: endpointMode(...) | Ec2MetadataClient client = Ec2MetadataClient
.builder()
.endpointMode(EndpointMode.IPV4)
.build();
| EndpointMode.IPV4, EndpointMode.IPV6 |
| Properti sistem | aws.ec2MetadataServiceEndpointMode | IPv4, IPv6 (kasus tidak masalah) |
| Berkas Config: \$1.aws/config | Setelan ec2\$1metadata\$1service\$1endpoint | IPv4, IPv6 (kasus tidak masalah) |
| Tidak ditentukan dengan cara sebelumnya | IPv4 digunakan | |
#### Bagaimana SDK menyelesaikan `endpoint` atau di v2 `endpoint-mode`
1. SDK menggunakan nilai yang Anda tetapkan dalam kode pada pembuat klien dan mengabaikan pengaturan eksternal apa pun. Karena SDK melempar pengecualian jika keduanya `endpoint` dan `endpointMode` dipanggil pada pembuat klien, SDK menggunakan nilai titik akhir dari metode mana pun yang Anda gunakan.
1. Jika Anda tidak menetapkan nilai dalam kode, SDK melihat ke konfigurasi eksternal—pertama untuk properti sistem dan kemudian untuk pengaturan dalam file konfigurasi.
1. SDK pertama-tama memeriksa nilai titik akhir. Jika nilai ditemukan, itu digunakan.
1. Jika SDK masih belum menemukan nilai, SDK akan mencari pengaturan mode titik akhir.
1. Terakhir, jika SDK tidak menemukan pengaturan eksternal dan Anda belum mengonfigurasi klien metadata dalam kode, SDK menggunakan nilai. IPv4 `http://169.254.169.254`
### IMDSv2
Amazon EC2 mendefinisikan dua pendekatan untuk mengakses metadata instans:
+ Layanan Metadata Instance Versi 1 (IMDSv1) — Pendekatan permintaan/respons
+ Layanan Metadata Instance Versi 2 (IMDSv2) — Pendekatan berorientasi sesi
Tabel berikut membandingkan bagaimana Java SDKs bekerja dengan IMDS.
****
| v1 | v2 |
| --- | --- |
| IMDSv2 digunakan secara default | Selalu menggunakan IMDSv2 |
| Mencoba mengambil token sesi untuk setiap permintaan dan kembali IMDSv1 jika gagal mengambil token sesi | Menyimpan token sesi dalam cache internal yang digunakan kembali untuk beberapa permintaan |
SDK for Java 2.x IMDSv2 hanya mendukung dan tidak kembali ke. IMDSv1
## Perbedaan konfigurasi
Tabel berikut mencantumkan opsi konfigurasi yang berbeda.
****
| Konfigurasi | v1 | v2 |
| --- | --- | --- |
| Percobaan ulang | Konfigurasi tidak tersedia | Dapat dikonfigurasi melalui metode pembangun retryPolicy(...) |
| HTTP | Batas waktu koneksi dapat dikonfigurasi melalui variabel AWS\$1METADATA\$1SERVICE\$1TIMEOUT lingkungan. Defaultnya adalah 1 detik. | Konfigurasi tersedia dengan meneruskan klien HTTP ke metode pembangunhttpClient(...). Batas waktu koneksi default untuk klien HTTP adalah 2 detik. |
### Contoh konfigurasi HTTP v2
Contoh berikut menunjukkan bagaimana Anda dapat mengkonfigurasi klien metadata. Contoh ini mengkonfigurasi batas waktu koneksi dan menggunakan klien HTTP Apache.
```
SdkHttpClient httpClient = ApacheHttpClient.builder()
.connectionTimeout(Duration.ofSeconds(1))
.build();
Ec2MetadataClient imdsClient = Ec2MetadataClient.builder()
.httpClient(httpClient)
.build();
```
# Perubahan di Amazon CloudFront presigning dari versi 1 ke versi 2
Topik ini merinci perubahan di Amazon CloudFront dari versi 1 (v1) ke versi 2 (v2).
## Perubahan tingkat tinggi
****
| Ubah | v1 | v2 |
| --- | --- | --- |
| Ketergantungan Maven |
com.amazonaws
aws-java-sdk-bom
1.12.5871
pom
import
com.amazonaws
cloudfront
|
software.amazon.awssdk
bom
2.27.212
pom
import
software.amazon.awssdk
cloudfront
|
| Nama paket | com.amazonaws.services.cloudfront | software.amazon.awssdk.services.cloudfront |
| Nama kelas | [CloudFrontUrlSigner](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloudfront/CloudFrontUrlSigner.html) [CloudFrontCookieSigner](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloudfront/CloudFrontCookieSigner.html) | [CloudFrontUtilities](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/cloudfront/CloudFrontUtilities.html) [SignedUrl](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/cloudfront/url/SignedUrl.html) [CannedSignerRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/cloudfront/model/CannedSignerRequest.html) [CustomSignerRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/cloudfront/model/CustomSignerRequest.html) |
1 [Versi terbaru](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Versi terbaru](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Perubahan API
| Perilaku | v1 | v2 |
| --- | --- | --- |
| Bangun permintaan kalengan | Argumen diteruskan langsung ke API. | CannedSignerRequest cannedRequest =
CannedSignerRequest.builder()
.resourceUrl(resourceUrl)
.privateKey(privateKey)
.keyPairId(keyPairId)
.expirationDate(expirationDate)
.build();
|
| Membangun permintaan kustom | Argumen diteruskan langsung ke API. | CustomSignerRequest customRequest =
CustomSignerRequest.builder()
.resourceUrl(resourceUrl)
.resourceUrlPattern(resourceUrlPattern)
.privateKey(keyFile)
.keyPairId(keyPairId)
.expirationDate(expirationDate)
.activeDate(activeDate)
.ipRange(ipRange)
.build();
|
| Hasilkan URL yang ditandatangani (kalengan) | String signedUrl =
CloudFrontUrlSigner.getSignedURLWithCannedPolicy(
resourceUrl, keyPairId, privateKey, expirationDate);
| CloudFrontUtilities cloudFrontUtilities =
CloudFrontUtilities.create();
SignedUrl signedUrl =
cloudFrontUtilities.getSignedUrlWithCannedPolicy(cannedRequest);
String url = signedUrl.url();
|
| Hasilkan cookie yang ditandatangani (kustom) | CookiesForCustomPolicy cookies =
CloudFrontCookieSigner.getCookiesForCustomPolicy(
resourceUrl, privateKey, keyPairId, expirationDate,
activeDate, ipRange);
| CloudFrontUtilities cloudFrontUtilities =
CloudFrontUtilities.create();
CookiesForCustomPolicy cookies =
cloudFrontUtilities.getCookiesForCustomPolicy(customRequest);
|
### Header cookie yang difaktorkan ulang di v2
Di Java v1, Java SDK memberikan header cookie sebagai file. `Map.Entry`
```
Map.Entry signatureMap = cookies.getSignature();
String signatureKey = signatureMap.getKey(); // "CloudFront-Signature"
String signatureValue = signatureMap.getValue(); // "[SIGNATURE_VALUE]"
```
Java v2 SDK memberikan seluruh header sebagai satu. `String`
```
String signatureHeaderValue = cookies.signatureHeaderValue(); // "CloudFront-Signature=[SIGNATURE_VALUE]"
```
# Perubahan API Pembuat Kebijakan IAM dari versi 1 ke versi 2
Topik ini merinci perubahan API Pembuat Kebijakan IAM dari versi 1 (v1) ke versi 2 (v2).
## Perubahan tingkat tinggi
****
| Ubah | v1 | v2 |
| --- | --- | --- |
| Ketergantungan Maven |
com.amazonaws
aws-java-sdk-bom
1.12.5871
pom
import
com.amazonaws
aws-java-sdk-core
|
software.amazon.awssdk
bom
2.27.212
pom
import
software.amazon.awssdk
iam-policy-builder
|
| Nama paket | com.amazonaws.auth.policy | software.amazon.awssdk.policybuilder.iam |
| Nama kelas | [Kebijakan](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Policy.html) [Pernyataan](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Statement.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sdk-for-java/latest/developer-guide/migration-iam-policy-builder.html) | [IamPolicy](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamPolicy.html) [IamStatement](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamStatement.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sdk-for-java/latest/developer-guide/migration-iam-policy-builder.html) |
1 [Versi terbaru](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Versi terbaru](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Perubahan API
****
| Pengaturan | v1 | v2 |
| --- | --- | --- |
| Membuat instantiasi kebijakan | Policy policy = new Policy();
| IamPolicy.Builder policyBuilder = IamPolicy.builder();
...
IamPolicy policy = policyBuilder.build();
|
| Tetapkan id | policy.withtId(...);
policy.setId(...);
| policyBuilder.id(...);
|
| Tetapkan versi | N/A - menggunakan versi default 2012-10-17 | policyBuilder.version(...);
|
| Buat pernyataan | Statement statement =
new Statement(Effect.Allow)
.withActions(...)
.withConditions(...)
.withId(...)
.withPrincipals(...)
.withResources(...);
| IamStatement statement =
IamStatement.builder()
.effect(IamEffect.ALLOW)
.actions(...)
.notActions(...)
.conditions(...)
.sid(...)
.principals(...)
.notPrincipals(...)
.resources(...)
.notResources(...)
.build()
|
| Tetapkan pernyataan | policy.withStatements(statement);
policy.setStatements(statement);
| policyBuilder.addStatement(statement);
|
## Perbedaan dalam membangun pernyataan
### Tindakan
#### v1
SDK v1 memiliki [`enum`tipe](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Action.html) untuk tindakan layanan yang mewakili `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_action.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_action.html)` elemen dalam pernyataan kebijakan. `enum`Jenis berikut adalah beberapa contoh.
+ `[IdentityManagementActions](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/actions/IdentityManagementActions.html)`
+ `[DynamoDBv2Actions](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/actions/DynamoDBv2Actions.html)`
+ `[SQSActions](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/actions/SQSActions.html)`
Contoh berikut menunjukkan `SendMessage` konstanta untuk`SQSActions`.
```
Action action = SQSActions.SendMessage;
```
Anda tidak dapat menentukan `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notaction.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notaction.html)` elemen ke pernyataan di v1.
#### v2
Di v2, [IamAction](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamAction.html)antarmuka mewakili semua tindakan. Untuk menentukan elemen [tindakan khusus layanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_action.html), berikan string ke `create` metode seperti yang ditunjukkan pada kode berikut.
```
IamAction action = IamAction.create("sqs:SendMessage");
```
Anda dapat menentukan `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notaction.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notaction.html)` untuk pernyataan dengan v2 seperti yang ditunjukkan dalam kode berikut.
```
IamAction action = IamAction.create("sqs:SendMessage");
IamStatement.builder().addNotAction(action);
```
### Ketentuan
#### v1
Untuk merepresentasikan kondisi pernyataan, SDK v1 menggunakan subclass dari. [https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Condition.html](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Condition.html)
+ [ArnCondition](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/conditions/ArnCondition.html)
+ [BooleanCondition](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/conditions/BooleanCondition.html)
+ [DateCondition](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/conditions/DateCondition.html)
+ [IpAddressCondition](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/conditions/IpAddressCondition.html)
+ [NumericCondition](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/conditions/NumericCondition.html)
+ [ StringCondition ](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/conditions/StringCondition.html)
Setiap `Condition` subkelas mendefinisikan `enum` tipe perbandingan untuk membantu menentukan kondisi. Misalnya, berikut ini menunjukkan [perbandingan string](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_String) *tidak suka* untuk suatu kondisi.
```
Condition condition = new StringCondition(StringComparisonType.StringNotLike, "key", "value");
```
#### v2
Di v2, Anda membuat kondisi untuk pernyataan kebijakan dengan menggunakan `[IamCondition](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamCondition.html)` dan menyediakan`[IamConditionOperator](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamConditionOperator.html)`, yang berisi `enums` untuk semua jenis.
```
IamCondition condition = IamCondition.create(IamConditionOperator.STRING_NOT_LIKE, "key", "value");
```
### Sumber daya
#### v1
`[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_resource.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_resource.html)`Elemen pernyataan kebijakan diwakili oleh `[Resource](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Resource.html)` kelas SDK. Anda menyediakan ARN sebagai string di konstruktor. Subkelas berikut menyediakan konstruktor kenyamanan.
+ [S3 BucketResource](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/resources/S3BucketResource.html)
+ [S3 ObjectResource](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/resources/S3ObjectResource.html)
+ [SQSQueueSumber Daya](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/resources/SQSQueueResource.html)
Di v1, Anda dapat menentukan `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notresource.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notresource.html)` elemen untuk a `[Resource](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Resource.html)` dengan memanggil `withIsNotType` metode seperti yang ditunjukkan dalam pernyataan berikut.
```
Resource resource = new Resource("arn:aws:s3:::amzn-s3-demo-bucket").withIsNotType(true);
```
#### v2
Di v2, Anda membuat `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_resource.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_resource.html)` elemen dengan meneruskan ARN ke metode. `IamResource.create`
```
IamResource resource = IamResource.create("arn:aws:s3:::amzn-s3-demo-bucket");
```
Sebuah `[IamResource](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamResource.html)` dapat diatur sebagai *[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notresource.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notresource.html)*elemen seperti yang ditunjukkan dalam cuplikan berikut.
```
IamResource resource = IamResource.create("arn:aws:s3:::amzn-s3-demo-bucket");
IamStatement.builder().addNotResource(resource);
```
`IamResource.ALL`mewakili semua sumber daya.
### Pengguna utama
#### v1
SDK v1 menawarkan `[Principal](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Principal.html)` kelas-kelas berikut untuk mewakili jenis prinsipal yang mencakup semua anggota:
+ `AllUsers`
+ `AllServices`
+ `AllWebProviders`
+ `All`
Anda tidak dapat menambahkan `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notprincipal.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notprincipal.html)` elemen ke pernyataan.
#### v2
Dalam v2, `IamPrincipal.ALL` mewakili semua prinsip:
Untuk mewakili semua anggota dalam jenis kepala sekolah lainnya, gunakan `[IamPrincipalType](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamPrincipalType.html)` kelas saat Anda membuat file. `IamPrincipal`
+ `IamPrincipal.create(IamPrincipalType.AWS,"*")`untuk semua pengguna.
+ `IamPrincipal.create(IamPrincipalType.SERVICE,"*")`untuk semua layanan.
+ `IamPrincipal.create(IamPrincipalType.FEDERATED,"*")`untuk semua penyedia web.
+ `IamPrincipal.create(IamPrincipalType.CANONICAL_USER,"*")`untuk semua pengguna kanonik.
Anda dapat menggunakan `addNotPrincipal` metode untuk mewakili `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notprincipal.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notprincipal.html)` elemen ketika Anda membuat pernyataan kebijakan seperti yang ditunjukkan dalam pernyataan berikut.
```
IamPrincipal principal = IamPrincipal.create(IamPrincipalType.AWS, "arn:aws:iam::444455556666:root");
IamStatement.builder().addNotPrincipal(principal);
```
# Perubahan dalam bekerja dengan DynamoDB dari versi 1 ke versi 2 AWS SDK untuk Java
**Topics**
+ [DynamoDB memetakan perbedaan API antara versi 1 dan versi 2 AWS SDK untuk Java](ddb-mapping.md)
+ [Perbedaan API dokumen antara versi 1 dan versi 2 AWS SDK untuk Java](dynamodb-mapping-document-api.md)
+ [Migrasi perpustakaan enkripsi](ddb-encryption-lib-migrate.md)
# DynamoDB memetakan perbedaan API antara versi 1 dan versi 2 AWS SDK untuk Java
APIs Pemetaan DynamoDB berubah secara signifikan antara versi 1 dan versi 2. AWS SDK untuk Java Di versi 1, Anda menggunakan `DynamoDBMapper` untuk bekerja dengan Java POJOs. Di versi 2, Anda menggunakan nama metode `DynamoDbEnhancedClient` yang diperbarui, opsi definisi skema yang disempurnakan, dan keamanan tipe yang ditingkatkan.
Perbedaan utama meliputi:
+ Nama metode baru (seperti `getItem` bukan`load`)
+ Pembuatan skema tabel eksplisit
+ Dukungan bawaan untuk operasi sinkron dan asinkron
+ Perubahan cara string dan konfigurasi kosong ditangani
Bagian ini mencakup perubahan API pemetaan, perbedaan anotasi, pembaruan konfigurasi, dan panduan migrasi untuk membantu Anda bertransisi dari v1 `DynamoDBMapper` ke v2. `DynamoDbEnhancedClient`
**Contents**
+ [Perubahan tingkat tinggi dalam pemetaan pustaka dari versi 1 ke versi 2 SDK for Java](dynamodb-mapping-high-level.md)
+ [Perbedaan ketergantungan impor](dynamodb-mapping-high-level.md#dynamodb-mapping-deps)
+ [Perubahan dalam APIs pemetaan DynamoDB antara versi 1 dan versi 2 dari SDK for Java](dynamodb-mapping-api-changes.md)
+ [Buat klien](dynamodb-mapping-api-changes.md#dynamodb-mapping-api-changes-client)
+ [Menetapkan pemetaan ke tabel/indeks DynamoDB](dynamodb-mapping-api-changes.md#dynamodb-mapping-api-changes-mapping)
+ [Operasi tabel](dynamodb-mapping-api-changes.md#dynamodb-mapping-api-changes-tobleops)
+ [Kelas peta dan properti](dynamodb-mapping-api-changes.md#dynamodb-mapping-schemas)
+ [Anotasi kacang](dynamodb-mapping-api-changes.md#dynamodb-mapping-schemas-annos)
+ [V2 anotasi tambahan](dynamodb-mapping-api-changes.md#dynamodb-mapping-schemas-annos-v2-addnl)
+ [Konfigurasi](dynamodb-mapping-api-changes.md#dynamodb-mapping-configuration)
+ [Konfigurasi per operasi](dynamodb-mapping-api-changes.md#dynamodb-mapping-configuration-per-op)
+ [Kondisional](dynamodb-mapping-api-changes.md#dynamodb-mapping-conditionals)
+ [Jenis konversi](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv)
+ [Konverter default](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv-defaults)
+ [Menetapkan konverter kustom untuk atribut](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv-anno)
+ [Tambahkan pabrik atau penyedia konverter tipe](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv-factory)
+ [String menangani perbedaan antara versi 1 dan versi 2 dari SDK for Java](dynamodb-migration-string-handling.md)
+ [Perbedaan penguncian optimis antara versi 1 dan versi 2 dari SDK for Java](dynamodb-migrate-optimstic-locking.md)
+ [Perbedaan setter yang lancar antara versi 1 dan versi 2 dari SDK for Java](dynamodb-migrate-fluent-setters.md)
# Perubahan tingkat tinggi dalam pemetaan pustaka dari versi 1 ke versi 2 SDK for Java
Nama-nama klien pemetaan di setiap pustaka berbeda di V1 dan V2:
+ V1 - Dinamo DBMapper
+ V2 - Klien yang Ditingkatkan DynamoDB
Anda berinteraksi dengan dua pustaka dengan cara yang hampir sama: Anda membuat instance mapper/client dan kemudian memasok POJO Java untuk membaca dan menulis item ini ke APIs tabel DynamoDB. Kedua pustaka juga menawarkan anotasi untuk kelas POJO untuk mengarahkan bagaimana klien menangani POJO.
Perbedaan penting saat Anda pindah ke V2 meliputi:
+ V2 dan V1 menggunakan nama metode yang berbeda untuk operasi DynamoDB tingkat rendah. Contoh:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sdk-for-java/latest/developer-guide/dynamodb-mapping-high-level.html)
+ V2 menawarkan beberapa cara untuk menentukan skema tabel dan memetakan POJOs ke tabel. Anda dapat memilih dari penggunaan anotasi atau skema yang dihasilkan dari kode menggunakan pembangun. V2 juga menawarkan versi skema yang dapat berubah dan tidak dapat diubah.
+ Dengan V2, Anda secara khusus membuat skema tabel sebagai salah satu langkah pertama, sedangkan di V1, skema tabel disimpulkan dari kelas beranotasi sesuai kebutuhan.
+ V2 menyertakan [klien Document API](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/document/EnhancedDocument.html) dalam API klien yang disempurnakan, sedangkan V1 menggunakan [API terpisah](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/DynamoDB.html).
+ Semua APIs tersedia dalam versi sinkron dan asinkron di V2.
Lihat bagian [pemetaan DynamoDB](dynamodb-enhanced-client.md) dalam panduan ini untuk informasi lebih rinci tentang klien yang disempurnakan V2.
## Perbedaan ketergantungan impor
| V1 | V2 |
| --- | --- |
|
com.amazonaws
aws-java-sdk-bom
1.X.X
pom
import
com.amazonaws
aws-java-sdk-dynamodb
|
software.amazon.awssdk
bom
2.X.X*
pom
import
software.amazon.awssdk
dynamodb-enhanced
|
\$1 [Versi terbaru](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
Di V1, dependensi tunggal mencakup API DynamoDB tingkat rendah dan mapping/document API, sedangkan di V2, Anda menggunakan `dynamodb-enhanced` dependensi artefak untuk mengakses API. mapping/document `dynamodb-enhanced`Modul ini berisi ketergantungan transitif pada modul tingkat rendah`dynamodb`.
# Perubahan dalam APIs pemetaan DynamoDB antara versi 1 dan versi 2 dari SDK for Java
## Buat klien
****
| Kasus penggunaan | V1 | V2 |
| --- | --- | --- |
| Instantiasi normal | AmazonDynamoDB standardClient = AmazonDynamoDBClientBuilder.standard()
.withCredentials(credentialsProvider)
.withRegion(Regions.US_EAST_1)
.build();
DynamoDBMapper mapper = new DynamoDBMapper(standardClient);
| DynamoDbClient standardClient = DynamoDbClient.builder()
.credentialsProvider(ProfileCredentialsProvider.create())
.region(Region.US_EAST_1)
.build();
DynamoDbEnhancedClient enhancedClient = DynamoDbEnhancedClient.builder()
.dynamoDbClient(standardClient)
.build();
|
| Instantiasi minimal | AmazonDynamoDB standardClient = AmazonDynamoDBClientBuilder.standard();
DynamoDBMapper mapper = new DynamoDBMapper(standardClient);
| DynamoDbEnhancedClient enhancedClient = DynamoDbEnhancedClient.create();
|
| Dengan trafo atribut\$1 | DynamoDBMapper mapper = new DynamoDBMapper(standardClient,
attributeTransformerInstance);
| DynamoDbEnhancedClient enhancedClient = DynamoDbEnhancedClient.builder()
.dynamoDbClient(standardClient)
.extensions(extensionAInstance, extensionBInstance)
.build();
|
\$1 Ekstensi di V2 kira-kira sesuai dengan atribut transformer di V1. [Gunakan ekstensi untuk menyesuaikan operasi DynamoDB Enhanced Client](ddb-en-client-extensions.md)Bagian ini berisi informasi lebih lanjut tentang ekstensi di V2.
## Menetapkan pemetaan ke tabel/indeks DynamoDB
Di V1, Anda menentukan nama tabel DynamoDB melalui anotasi kacang. Dalam V2, metode pabrik,`table()`, menghasilkan instance `DynamoDbTable` yang mewakili tabel DynamoDB jarak jauh. Parameter pertama dari `table()` metode ini adalah nama tabel DynamoDB.
****
| Kasus penggunaan | V1 | V2 |
| --- | --- | --- |
| Memetakan kelas Java POJO ke tabel DynamoDB | @DynamoDBTable(tableName ="Customer")
public class Customer {
...
}
| DynamoDbTable customerTable = enhancedClient.table("Customer",
TableSchema.fromBean(Customer.class));
|
| Peta ke indeks sekunder DynamoDB | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) Bagian dalam DynamoDB Developer Guide yang [membahas metode `query` V1 menunjukkan contoh](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBMapper.Methods.html#DynamoDBMapper.Methods.query) lengkap. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) [Gunakan indeks sekunder](ddb-en-client-use-secindex.md)Bagian dalam panduan ini memberikan informasi lebih lanjut. |
## Operasi tabel
Bagian ini menjelaskan operasi APIs yang berbeda antara V1 dan V2 untuk sebagian besar kasus penggunaan standar.
Di V2, semua operasi yang melibatkan satu tabel dipanggil pada `DynamoDbTable` instance, bukan pada klien yang disempurnakan. Klien yang disempurnakan berisi metode yang dapat menargetkan beberapa tabel.
Dalam tabel bernama *operasi Tabel* di bawah ini, contoh POJO disebut sebagai `item` atau sebagai tipe tertentu seperti`customer1`. Untuk contoh V2 instance bernama, `table` adalah hasil dari pemanggilan sebelumnya `enhancedClient.table()` yang mengembalikan referensi ke `DynamoDbTable` instance.
Perhatikan bahwa sebagian besar operasi V2 dapat dipanggil dengan pola konsumen yang lancar bahkan ketika tidak ditampilkan. Misalnya,
```
Customer customer = table.getItem(r → r.key(key));
or
Customer customer = table.getItem(r → r.key(k -> k.partitionValue("id").sortValue("email")))
```
Untuk operasi V1, *operasi Tabel* (di bawah) berisi beberapa formulir yang umum digunakan dan tidak semua formulir yang kelebihan beban. Misalnya, `load()` metode ini memiliki kelebihan beban berikut:
```
mapper.load(Customer.class, hashKey)
mapper.load(Customer.class, hashKey, rangeKey)
mapper.load(Customer.class, hashKey, config)
mapper.load(Customer.class, hashKey, rangeKey, config)
mapper.load(item)
mapper.load(item, config)
```
*Operasi tabel* (di bawah) menunjukkan bentuk yang umum digunakan:
```
mapper.load(item)
mapper.load(item, config)
```
**Operasi tabel**
| Kasus penggunaan | V1 | V2 |
| --- | --- | --- |
| Tulis POJO Java ke tabel DynamoDB **Operasi DynamoDB**:, `PutItem` `UpdateItem` | mapper.save(item)
mapper.save(item, config)
mapper.save(item, saveExpression, config)
Dalam V1, `DynamoDBMapperConfig.SaveBehavior` dan anotasi menentukan metode DynamoDB tingkat rendah mana yang akan dipanggil. Secara umum, `UpdateItem` disebut kecuali saat menggunakan `SaveBehavior.CLOBBER` dan`SaveBehavior.PUT`. Kunci yang dihasilkan secara otomatis adalah kasus penggunaan khusus, dan kadang-kadang keduanya `PutItem` dan `UpdateItem` digunakan. | table.putItem(putItemRequest)
table.putItem(item)
table.putItemWithResponse(item) //Returns metadata.
updateItem(updateItemRequest)
table.updateItem(item)
table.updateItemWithResponse(item) //Returns metadata.
|
| Membaca item dari tabel DynamoDB ke POJO Java **Operasi DynamoDB:** `GetItem` | mapper.load(item)
mapper.load(item, config)
| table.getItem(getItemRequest)
table.getItem(item)
table.getItem(key)
table.getItemWithResponse(key) //Returns POJO with metadata.
|
| Menghapus item dari tabel DynamoDB **Operasi DynamoDB:** `DeleteItem` | mapper.delete(item, deleteExpression, config)
| table.deleteItem(deleteItemRequest)
table.deleteItem(item)
table.deleteItem(key)
|
| Kueri tabel DynamoDB atau indeks sekunder dan kembalikan daftar paginasi **Operasi DynamoDB:** `Query` | mapper.query(Customer.class, queryExpression)
mapper.query(Customer.class, queryExpression,
mapperConfig)
| table.query(queryRequest)
table.query(queryConditional)
Gunakan yang dikembalikan `PageIterable.stream()` (pemuatan lambat) untuk respons sinkronisasi dan `PagePublisher.subscribe()` untuk respons asinkron |
| Kueri tabel DynamoDB atau indeks sekunder dan kembalikan daftar **Operasi DynamoDB:** `Query` | mapper.queryPage(Customer.class, queryExpression)
mapper.queryPage(Customer.class, queryExpression,
mapperConfig)
| table.query(queryRequest)
table.query(queryConditional)
Gunakan yang dikembalikan `PageIterable.items()` (pemuatan lambat) untuk respons sinkronisasi dan `PagePublisher.items.subscribe()` untuk respons asinkron |
| Memindai tabel DynamoDB atau indeks sekunder dan mengembalikan daftar paginasi **Operasi DynamoDB:** `Scan` | mapper.scan(Customer.class, scanExpression)
mapper.scan(Customer.class, scanExpression,
mapperConfig)
| table.scan()
table.scan(scanRequest)
Gunakan yang dikembalikan `PageIterable.stream()` (pemuatan lambat) untuk respons sinkronisasi dan `PagePublisher.subscribe()` untuk respons asinkron |
| Pindai tabel DynamoDB atau indeks sekunder dan kembalikan daftar **Operasi DynamoDB:** `Scan` | mapper.scanPage(Customer.class, scanExpression)
mapper.scanPage(Customer.class, scanExpression,
mapperConfig)
| table.scan()
table.scan(scanRequest)
Gunakan yang dikembalikan `PageIterable.items()` (pemuatan lambat) untuk respons sinkronisasi dan `PagePublisher.items.subscribe()` untuk respons asinkron |
| Baca beberapa item dari beberapa tabel dalam satu batch **Operasi DynamoDB:** `BatchGetItem` | mapper.batchLoad(Arrays.asList(customer1,
customer2,
book1))
mapper.batchLoad(itemsToGet)
// itemsToGet: Map, List>
| enhancedClient.batchGetItem(batchGetItemRequest)
enhancedClient.batchGetItem(r -> r.readBatches(
ReadBatch.builder(Record1.class)
.mappedTableResource(mappedTable1)
.addGetItem(i -> i.key(k -> k.partitionValue(0)))
.build(),
ReadBatch.builder(Record2.class)
.mappedTableResource(mappedTable2)
.addGetItem(i -> i.key(k -> k.partitionValue(0)))
.build()))
// Iterate over pages with lazy loading or over all items
from the same table.
|
| Tulis beberapa item ke beberapa tabel dalam satu batch **Operasi DynamoDB:** `BatchWriteItem` | mapper.batchSave(Arrays.asList(customer1,
customer2,
book1))
| enhancedClient.batchWriteItem(batchWriteItemRequest)
enhancedClient.batchWriteItem(r -> r.writeBatches(
WriteBatch.builder(Record1.class)
.mappedTableResource(mappedTable1)
.addPutItem(item1)
.build(),
WriteBatch.builder(Record2.class)
.mappedTableResource(mappedTable2)
.addPutItem(item2)
.build()))
|
| Hapus beberapa item dari beberapa tabel dalam satu batch **Operasi DynamoDB:** `BatchWriteItem` | mapper.batchDelete(Arrays.asList(customer1,
customer2,
book1))
| enhancedClient.batchWriteItem(r -> r.writeBatches(
WriteBatch.builder(Record1.class)
.mappedTableResource(mappedTable1)
.addDeleteItem(item1key)
.build(),
WriteBatch.builder(Record2.class)
.mappedTableResource(mappedTable2)
.addDeleteItem(item2key)
.build()))
|
| Tulis/hapus beberapa item dalam satu batch **Operasi DynamoDB:** `BatchWriteItem` | mapper.batchWrite(Arrays.asList(customer1, book1),
Arrays.asList(customer2))
| enhancedClient.batchWriteItem(r -> r.writeBatches(
WriteBatch.builder(Record1.class)
.mappedTableResource(mappedTable1)
.addPutItem(item1)
.build(),
WriteBatch.builder(Record2.class)
.mappedTableResource(mappedTable2)
.addDeleteItem(item2key)
.build()))
|
| Lakukan penulisan transaksional **Operasi DynamoDB:** `TransactWriteItems` | mapper.transactionWrite(transactionWriteRequest)
| enhancedClient.transactWriteItems(transasctWriteItemsRequest)
|
| Lakukan pembacaan transaksional **Operasi DynamoDB:** `TransactGetItems` | mapper.transactionLoad(transactionLoadRequest)
| enhancedClient.transactGetItems(transactGetItemsRequest)
|
| Dapatkan hitungan item yang cocok dari kueri **Operasi DynamoDB**: dengan `Query` `Select.COUNT` | mapper.count(Customer.class, queryExpression)
| // Get the count from query results.
PageIterable pageIterable =
customerTable.query(QueryEnhancedRequest.builder()
.queryConditional(queryConditional)
.select(Select.COUNT)
.build());
Iterator> iterator = pageIterable.iterator();
Page page = iterator.next();
int count = page.count();
// For a more concise approach, you can chain the method calls:
int count = customerTable.query(QueryEnhancedRequest.builder()
.queryConditional(queryConditional)
.select(Select.COUNT)
.build())
.iterator().next().count();
|
| Dapatkan hitungan item yang cocok dari pemindaian **Operasi DynamoDB**: dengan `Scan` `Select.COUNT` | mapper.count(Customer.class, scanExpression)
| // Get the count from scan results.
PageIterable pageIterable =
customerTable.scan(ScanEnhancedRequest.builder()
.filterExpression(filterExpression)
.select(Select.COUNT)
.build());
Iterator> iterator = pageIterable.iterator();
Page page = iterator.next();
int count = page.count();
// For a more concise approach, you can chain the method calls:
int count = customerTable.scan(ScanEnhancedRequest.builder()
.filterExpression(filterExpression)
.select(Select.COUNT)
.build())
.iterator().next().count();
|
| Buat tabel di DynamoDB sesuai dengan kelas POJO **Operasi DynamoDB:** `CreateTable` | mapper.generateCreateTableRequest(Customer.class)
Pernyataan sebelumnya menghasilkan permintaan tabel buat tingkat rendah; pengguna harus memanggil klien `createTable` DynamoDB. | table.createTable(createTableRequest)
table.createTable(r -> r.provisionedThroughput(defaultThroughput())
.globalSecondaryIndices(
EnhancedGlobalSecondaryIndex.builder()
.indexName("gsi_1")
.projection(p -> p.projectionType(ProjectionType.ALL))
.provisionedThroughput(defaultThroughput())
.build()));
|
| Lakukan pemindaian paralel di DynamoDB **Operasi `Scan` DynamoDB**: dengan dan parameter `Segment` `TotalSegments` | mapper.parallelScan(Customer.class,
scanExpression,
numTotalSegments)
| Pengguna diminta untuk menangani thread pekerja dan memanggil `scan` untuk setiap segmen: table.scan(r -> r.segment(0).totalSegments(5))
|
| Integrasikan Amazon S3 dengan DynamoDB untuk menyimpan tautan S3 cerdas | mapper.createS3Link(bucket, key)
mapper.getS3ClientCache()
| Tidak didukung karena memasangkan Amazon S3 dan DynamoDB. |
## Kelas peta dan properti
Di V1 dan V2, Anda memetakan kelas ke tabel menggunakan anotasi gaya kacang. V2 juga menawarkan [cara lain untuk mendefinisikan skema](ddb-en-client-adv-features.md#ddb-en-client-adv-features-schm-overview) untuk kasus penggunaan tertentu, seperti bekerja dengan kelas yang tidak dapat diubah.
### Anotasi kacang
Tabel berikut menunjukkan anotasi kacang setara untuk kasus penggunaan tertentu yang digunakan dalam V1 dan V2. Skenario `Customer` kelas digunakan untuk mengilustrasikan parameter.
Anotasi — serta kelas dan pencacahan — di V2 ikuti konvensi kasus unta dan gunakan '', bukan 'DynamoDB'. DynamoDb
| Kasus penggunaan | V1 | V2 |
| --- | --- | --- |
| Petakan kelas ke tabel | @DynamoDBTable (tableName ="CustomerTable")
| @DynamoDbBean
@DynamoDbBean(converterProviders = {...})
Nama tabel didefinisikan saat memanggil DynamoDbEnhancedClient\$1table() metode. |
| Menunjuk anggota kelas sebagai atribut tabel | @DynamoDBAttribute(attributeName = "customerName")
| @DynamoDbAttribute("customerName") |
| Menunjuk anggota kelas adalah kunci hash/partition | @DynamoDBHashKey
| @DynamoDbPartitionKey
|
| Menunjuk anggota kelas adalah kunci range/sort | @DynamoDBRangeKey
| @DynamoDbSortKey
|
| Menunjuk anggota kelas adalah kunci hash/partisi indeks sekunder | @DynamoDBIndexHashKey
| @DynamoDbSecondaryPartitionKey
|
| Menunjuk anggota kelas adalah kunci rentang/sortir indeks sekunder | @DynamoDBIndexRangeKey
| @DynamoDbSecondarySortKey
|
| Abaikan anggota kelas ini saat memetakan ke tabel | @DynamoDBIgnore
| @DynamoDbIgnore
|
| Tentukan anggota kelas sebagai atribut kunci UUID yang dibuat secara otomatis | @DynamoDBAutoGeneratedKey
| @DynamoDbAutoGeneratedUuid
Ekstensi yang menyediakan ini tidak dimuat secara default; Anda harus menambahkan ekstensi ke pembuat klien. |
| Tentukan anggota kelas sebagai atribut stempel waktu yang dibuat secara otomatis | @DynamoDBAutoGeneratedTimestamp
| @DynamoDbAutoGeneratedTimestampAttribute
Ekstensi yang menyediakan ini tidak dimuat secara default; Anda harus menambahkan ekstensi ke pembuat klien. |
| Menunjuk anggota kelas sebagai atribut versi auto-incremented | @DynamoDBVersionAttribute
| @DynamoDbVersionAttribute
Ekstensi yang menyediakan ini dimuat secara otomatis. |
| Menunjuk anggota kelas sebagai membutuhkan konversi kustom | @DynamoDBTypeConverted
| @DynamoDbConvertedBy
|
| Menunjuk anggota kelas untuk disimpan sebagai jenis atribut yang berbeda | @DynamoDBTyped()
| Gunakan `AttributeConverter` implementasi. V2 menyediakan banyak konverter bawaan untuk tipe Java umum. Anda juga dapat menerapkan kebiasaan Anda sendiri `AttributeConverter` atau`AttributeConverterProvider`. Lihat [Konversi atribut kontrol](ddb-en-client-adv-features-conversion.md) di panduan ini. |
| Tentukan kelas yang dapat diserialisasikan ke dokumen DynamoDB (dokumen gaya JSON) atau sub-dokumen | @DynamoDBDocument
| Gunakan API Dokumen yang Ditingkatkan. Lihat sumber daya berikut:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) |
### V2 anotasi tambahan
| Kasus penggunaan | V1 | V2 |
| --- | --- | --- |
| Menunjuk anggota kelas untuk tidak disimpan sebagai atribut NULL jika nilai Java adalah null | N/A | @DynamoDbIgnoreNulls
|
| Menunjuk anggota kelas untuk menjadi objek kosong jika semua atribut adalah null | N/A | @DynamoDbPreserveEmptyObject
|
| Tentukan tindakan pembaruan khusus untuk anggota kelas | N/A | @DynamoDbUpdateBehavior
|
| Tentukan kelas yang tidak dapat diubah | N/A | @DynamoDbImmutable
|
| Menunjuk anggota kelas sebagai atribut counter auto-incremented | N/A | @DynamoDbAtomicCounter
Ekstensi yang menyediakan fungsi ini dimuat secara otomatis. |
## Konfigurasi
Di V1, Anda biasanya mengontrol perilaku tertentu dengan menggunakan instance dari. `DynamoDBMapperConfig` Anda dapat menyediakan objek konfigurasi baik ketika Anda membuat mapper atau ketika Anda membuat permintaan. Dalam V2, konfigurasi khusus untuk objek permintaan untuk operasi.
| Kasus penggunaan | V1 | Default di V1 | V2 |
| --- | --- | --- | --- |
| | DynamoDBMapperConfig.builder()
| | |
| Strategi load/write coba lagi Batch | .withBatchLoadRetryStrategy(loadRetryStrategy)
.withBatchWriteRetryStrategy(writeRetryStrategy)
| coba lagi item yang gagal | Konfigurasikan strategi coba lagi pada yang mendasarinyaDynamoDBClient. Lihat [Konfigurasikan perilaku coba lagi di AWS SDK for Java 2.x](retry-strategy.md) di panduan ini. |
| Bacaan yang konsisten | .withConsistentReads(CONSISTENT)
| EVENTUAL | Secara default, pembacaan konsisten salah untuk operasi baca. Ganti dengan .consistentRead(true) objek permintaan. |
| Skema konversi dengan set marshallers/unmarshallers | .withConversionSchema(conversionSchema)
Implementasi statis memberikan kompatibilitas mundur dengan versi yang lebih lama. | V2\$1COMPATIBLE | Tidak berlaku. Ini adalah fitur lama yang mengacu pada bagaimana versi awal DynamoDB (V1) menyimpan tipe data, dan perilaku ini tidak akan dipertahankan di klien yang disempurnakan. Contoh perilaku di DynamoDB V1 adalah menyimpan boolean sebagai Number, bukan sebagai Boolean. |
| Nama tabel | .withObjectTableNameResolver()
.withTableNameOverride()
.withTableNameResolver()
Implementasi statis memberikan kompatibilitas mundur dengan versi yang lebih lama | gunakan anotasi atau tebakan dari kelas | Nama tabel didefinisikan saat memanggil `DynamoDbEnhancedClient#table()` metode. |
| Strategi beban pagination | .withPaginationLoadingStrategy(strategy)
Pilihannya adalah: LAZY\$1`LOADING`,, `EAGER_LOADING` atau `ITERATION_ONLY` | LAZY\$1LOADING | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) |
| Minta pengumpulan metrik | .withRequestMetricCollector(collector)
| null | Gunakan metricPublisher() ClientOverrideConfiguration saat membangun klien DynamoDB standar. |
| Simpan perilaku | .withSaveBehavior(SaveBehavior.CLOBBER)
Pilihannya adalah `UPDATE``CLOBBER`,,`PUT`,`APPEND_SET`, atau`UPDATE_SKIP_NULL_ATTRIBUTES`. | UPDATE | Di V2, Anda menelepon `putItem()` atau `updateItem()` secara eksplisit. `CLOBBER or PUT`: Tindakan yang sesuai di v 2 memanggil`putItem()`. Tidak ada `CLOBBER` konfigurasi khusus. `UPDATE`: Sesuai dengan `updateItem()` `UPDATE_SKIP_NULL_ATTRIBUTES`: Sesuai dengan`updateItem()`. Kontrol perilaku pembaruan dengan setelan permintaan `ignoreNulls` dan anotasi/tag`DynamoDbUpdateBehavior`. `APPEND_SET`: Tidak didukung |
| Jenis konverter pabrik | .withTypeConverterFactory(typeConverterFactory)
| konverter tipe standar | Atur kacang dengan menggunakan @DynamoDbBean(converterProviders = {ConverterProvider.class,
DefaultAttributeConverterProvider.class}) |
### Konfigurasi per operasi
Di V1, beberapa operasi, seperti`query()`, sangat dapat dikonfigurasi melalui objek “ekspresi” yang dikirimkan ke operasi. Contoh:
```
DynamoDBQueryExpression emailBwQueryExpr = new DynamoDBQueryExpression()
.withRangeKeyCondition("Email",
new Condition()
.withComparisonOperator(ComparisonOperator.BEGINS_WITH)
.withAttributeValueList(
new AttributeValue().withS("my")));
mapper.query(Customer.class, emailBwQueryExpr);
```
Di V2, alih-alih menggunakan objek konfigurasi, Anda menetapkan parameter pada objek permintaan dengan menggunakan pembuat. Contoh:
```
QueryEnhancedRequest emailBw = QueryEnhancedRequest.builder()
.queryConditional(QueryConditional
.sortBeginsWith(kb -> kb
.sortValue("my"))).build();
customerTable.query(emailBw);
```
## Kondisional
Dalam V2, ekspresi kondisional dan penyaringan diekspresikan menggunakan `Expression` objek, yang merangkum kondisi dan pemetaan nama dan filter.
| Kasus penggunaan | Operasi | V1 | V2 |
| --- | --- | --- | --- |
| Kondisi atribut yang diharapkan | save (), delete (), query (), scan () | new DynamoDBSaveExpression()
.withExpected(Collections.singletonMap(
"otherAttribute", new ExpectedAttributeValue(false)))
.withConditionalOperator(ConditionalOperator.AND);
| Usang; gunakan sebagai gantinya. ConditionExpression |
| Ekspresi kondisi | hapus () | deleteExpression.setConditionExpression("zipcode = :zipcode")
deleteExpression.setExpressionAttributeValues(...)
| Expression conditionExpression =
Expression.builder()
.expression("#key = :value OR #key1 = :value1")
.putExpressionName("#key", "attribute")
.putExpressionName("#key1", "attribute3")
.putExpressionValue(":value", AttributeValues.stringValue("wrong"))
.putExpressionValue(":value1", AttributeValues.stringValue("three"))
.build();
DeleteItemEnhancedRequest request = DeleteItemEnhancedRequest.builder()
.conditionExpression(conditionExpression).build();
|
| Ekspresi filter | query (), scan () | scanExpression
.withFilterExpression("#statename = :state")
.withExpressionAttributeValues(attributeValueMapBuilder.build())
.withExpressionAttributeNames(attributeNameMapBuilder.build())
| Map values = singletonMap(":key", stringValue("value"));
Expression filterExpression =
Expression.builder()
.expression("name = :key")
.expressionValues(values)
.build();
QueryEnhancedRequest request = QueryEnhancedRequest.builder()
.filterExpression(filterExpression).build();
|
| Ekspresi kondisi untuk kueri | kueri () | queryExpression.withKeyConditionExpression()
| QueryConditional keyEqual = QueryConditional.keyEqualTo(b -> b
.partitionValue("movie01"));
QueryEnhancedRequest tableQuery = QueryEnhancedRequest.builder()
.queryConditional(keyEqual)
.build();
|
## Jenis konversi
### Konverter default
Di V2, SDK menyediakan satu set konverter default untuk semua tipe umum. Anda dapat mengubah konverter tipe baik di tingkat penyedia keseluruhan maupun untuk satu atribut. Anda dapat menemukan daftar konverter yang tersedia di referensi [AttributeConverter](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/AttributeConverter.html)API.
### Menetapkan konverter kustom untuk atribut
Di V1, Anda dapat membuat anotasi metode pengambil dengan `@DynamoDBTypeConverted` untuk menentukan kelas yang mengkonversi antara tipe atribut Java dan tipe atribut DynamoDB. Misalnya, `CurrencyFormatConverter` yang mengkonversi antara `Currency` tipe Java dan DynamoDB String dapat diterapkan seperti yang ditunjukkan pada cuplikan berikut.
```
@DynamoDBTypeConverted(converter = CurrencyFormatConverter.class)
public Currency getCurrency() { return currency; }
```
Setara V2 dari cuplikan sebelumnya ditunjukkan di bawah ini.
```
@DynamoDbConvertedBy(CurrencyFormatConverter.class)
public Currency getCurrency() { return currency; }
```
**catatan**
Di V1, Anda dapat menerapkan anotasi ke atribut itu sendiri, tipe atau anotasi yang ditentukan pengguna, V2 mendukung penerapan anotasi hanya ke pengambil.
### Tambahkan pabrik atau penyedia konverter tipe
Di V1, Anda dapat menyediakan set konverter tipe Anda sendiri, atau mengganti tipe yang Anda pedulikan dengan menambahkan pabrik konverter tipe ke konfigurasi. Pabrik konverter tipe meluas`DynamoDBTypeConverterFactory`, dan penggantian dilakukan dengan mendapatkan referensi ke set default dan memperluasnya. Cuplikan berikut menunjukkan cara melakukan ini.
```
DynamoDBTypeConverterFactory typeConverterFactory =
DynamoDBTypeConverterFactory.standard().override()
.with(String.class, CustomBoolean.class, new DynamoDBTypeConverter() {
@Override
public String convert(CustomBoolean bool) {
return String.valueOf(bool.getValue());
}
@Override
public CustomBoolean unconvert(String string) {
return new CustomBoolean(Boolean.valueOf(string));
}}).build();
DynamoDBMapperConfig config =
DynamoDBMapperConfig.builder()
.withTypeConverterFactory(typeConverterFactory)
.build();
DynamoDBMapper mapperWithTypeConverterFactory = new DynamoDBMapper(dynamo, config);
```
V2 menyediakan fungsionalitas serupa melalui `@DynamoDbBean` anotasi. Anda dapat memberikan satu `AttributeConverterProvider` atau satu rantai pesanan `AttributeConverterProvider` s. Perhatikan bahwa jika Anda menyediakan rantai penyedia konverter atribut Anda sendiri, Anda akan mengganti penyedia konverter default dan harus memasukkannya ke dalam rantai untuk menggunakan konverter atributnya.
```
@DynamoDbBean(converterProviders = {
ConverterProvider1.class,
ConverterProvider2.class,
DefaultAttributeConverterProvider.class})
public class Customer {
...
}
```
Bagian tentang [konversi atribut](ddb-en-client-adv-features-conversion.md#ddb-en-client-adv-features-conversion-example) dalam panduan ini berisi contoh lengkap untuk V2.
# String menangani perbedaan antara versi 1 dan versi 2 dari SDK for Java
V1 dan V2 menangani string kosong secara berbeda saat mengirim data ke DynamoDB:
+ **V1**: Mengkonversi string kosong ke nilai null sebelum mengirim ke DynamoDB (menghasilkan tidak ada atribut)
+ **V2**: Mengirim string kosong sebagai nilai string kosong aktual ke DynamoDB
**penting**
Setelah bermigrasi ke V2, jika Anda tidak ingin string kosong disimpan di DynamoDB, Anda harus menerapkan konverter khusus. Tanpa konverter khusus, V2 menyimpan string kosong sebagai atribut string kosong yang sebenarnya di item DynamoDB Anda, yang berbeda dari perilaku V1 menghilangkan atribut ini sepenuhnya.
**Example konverter khusus untuk V2 yang mengubah atribut string kosong menjadi null**
```
/**
* Custom converter that maintains V1 behavior by converting empty strings to null values
* when writing to DynamoDB, ensuring compatibility with existing data. No attribute will be saved to DynamoDB.
*/
public class NullifyEmptyStringConverter implements AttributeConverter {
@Override
public AttributeValue transformFrom(String value) {
if (value == null || value.isEmpty()) {
return AttributeValue.builder().nul(true).build();
}
return AttributeValue.builder().s(value).build();
}
@Override
public String transformTo(AttributeValue attributeValue) {
if (attributeValue.nul()) {
return null;
}
return attributeValue.s();
}
@Override
public EnhancedType type() {
return EnhancedType.of(String.class);
}
@Override
public AttributeValueType attributeValueType() {
return AttributeValueType.S;
}
}
// V2 usage:
@DynamoDbBean
public class Customer {
private String name;
@DynamoDbConvertedBy(NullifyEmptyStringConverter.class)
public String getName() {
return name;
}
}
```
# Perbedaan penguncian optimis antara versi 1 dan versi 2 dari SDK for Java
Baik V1 dan V2 menerapkan penguncian optimis dengan anotasi atribut yang menandai satu properti di kelas kacang Anda untuk menyimpan nomor versi.
**Perbedaan perilaku penguncian yang optimis**
| | V1 | V2 |
| --- | --- | --- |
| Anotasi kelas kacang | @DynamoDBVersionAttribute | @DynamoDbVersionAttribute(perhatikan bahwa V2 menggunakan huruf kecil “b”) |
| Simpan awal | Atribut nomor versi disetel ke 1. | Nilai awal untuk atribut versi ditetapkan dengan`@DynamoDbVersionAttribute(startAt = X)`. Nilai default-nya adalah 0. |
| Perbarui | Atribut nomor versi bertambah 1 jika pemeriksaan bersyarat memverifikasi bahwa nomor versi objek yang diperbarui cocok dengan nomor dalam database. | Atribut nomor versi bertambah jika pemeriksaan bersyarat memverifikasi bahwa nomor versi objek yang diperbarui cocok dengan nomor dalam database. Atribut nomor versi ditambah dengan `incrementBy` opsi yang ditetapkan dengan`@DynamoDbVersionAttribute(incrementBy = X)`. Nilai default adalah 1. |
| Delete | DynamoDBMappermenambahkan pemeriksaan bersyarat bahwa nomor versi objek yang dihapus cocok dengan nomor versi dalam database. | V2 tidak tidak secara otomatis menambahkan kondisi untuk operasi penghapusan. Anda harus menambahkan ekspresi kondisi secara manual jika Anda ingin mengontrol perilaku hapus. Dalam contoh berikut `recordVersion` adalah atribut versi kacang. // 1. Read the item and get its current version.
Customer item = customerTable.getItem(Key.builder().partitionValue("someId").build());
AttributeValue currentVersion = item.getRecordVersion();
// 2. Create conditional delete with the `currentVersion` value.
DeleteItemEnhancedRequest deleteItemRequest =
DeleteItemEnhancedRequest.builder()
.key(KEY)
.conditionExpression(Expression.builder()
.expression("recordVersion = :current_version_value")
.putExpressionValue(":current_version_value", currentVersion)
.build()).build();
customerTable.deleteItem(deleteItemRequest);
|
| Tulis Transaksional dengan Pemeriksaan Kondisi | Anda tidak dapat menggunakan kelas kacang yang dianotasi dengan @DynamoDBVersionAttribute metode. addConditionCheck | Anda dapat menggunakan kelas kacang dengan @DynamoDbVersionAttribute anotasi dalam metode addConditionCheck pembangun untuk transactWriteItems permintaan. |
| Nonaktifkan | Nonaktifkan penguncian optimis dengan mengubah nilai DynamoDBMapperConfig.SaveBehavior enumerasi dari ke. UPDATE CLOBBER | Jangan gunakan `@DynamoDbVersionAttribute` anotasi. |
# Perbedaan setter yang lancar antara versi 1 dan versi 2 dari SDK for Java
Anda dapat menggunakan POJOs dengan penyetel yang lancar di API pemetaan DynamoDB untuk V1 dan dengan V2 sejak versi 2.30.29.
Misalnya, POJO berikut mengembalikan `Customer` instance dari `setName` metode:
```
// V1
@DynamoDBTable(tableName ="Customer")
public class Customer{
private String name;
// Other attributes and methods not shown.
public Customer setName(String name){
this.name = name;
return this;
}
}
```
Namun, jika Anda menggunakan versi V2 sebelum 2.30.29, `setName` mengembalikan `Customer` instance dengan `name` nilai. `null`
```
// V2 prior to version 2.30.29.
@DynamoDbBean
public class Customer{
private String name;
// Other attributes and methods not shown.
public Customer setName(String name){
this.name = name;
return this; // Bug: returns this instance with a `name` value of `null`.
}
}
```
```
// Available in V2 since version 2.30.29.
@DynamoDbBean
public class Customer{
private String name;
// Other attributes and methods not shown.
public Customer setName(String name){
this.name = name;
return this; // Returns this instance for method chaining with the `name` value set.
}
}
```
# Perbedaan API dokumen antara versi 1 dan versi 2 AWS SDK untuk Java
Document API mendukung bekerja dengan dokumen bergaya JSON sebagai item tunggal dalam tabel DynamoDB. V1 Document API memiliki API yang sesuai di V2, tetapi alih-alih menggunakan klien terpisah untuk API dokumen seperti pada V1, V2 menggabungkan fitur API dokumen dalam klien yang disempurnakan DynamoDB.
Di V1, [https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Item.html](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Item.html)kelas mewakili catatan tidak terstruktur dari tabel DynamoDB. Dalam V2, catatan tidak terstruktur diwakili oleh instance [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/document/EnhancedDocument.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/document/EnhancedDocument.html)kelas. Perhatikan bahwa kunci primer didefinisikan dalam skema tabel untuk V2, dan pada item itu sendiri di V1.
Tabel di bawah ini membandingkan perbedaan antara Dokumen APIs di V1 dan V2.
| Kasus penggunaan | V1 | V2 |
| --- |--- |--- |
| Buat klien dokumen | AmazonDynamoDB client = ... //Create a client.
DynamoDB documentClient = new DynamoDB(client);
| // The V2 Document API uses the same DynamoDbEnhancedClient
// that is used for mapping POJOs.
DynamoDbClient standardClient = ... //Create a standard client.
DynamoDbEnhancedClient enhancedClient = ... // Create an enhanced client.
|
| Referensi tabel | Table documentTable = docClient.documentClient("Person"); | DynamoDbTable documentTable = enhancedClient.table("Person",
TableSchema.documentSchemaBuilder()
.addIndexPartitionKey(TableMetadata.primaryIndexName(),"id", AttributeValueType.S)
.attributeConverterProviders(AttributeConverterProvider.defaultProvider())
.build());
|
| **Work with semi-structured data** |
| --- |
| Put item | Item item = new Item()
.withPrimaryKey("id", 50)
.withString("firstName", "Shirley");
PutItemOutcome outcome = documentTable.putItem(item);
| EnhancedDocument personDocument = EnhancedDocument.builder()
.putNumber("id", 50)
.putString("firstName", "Shirley")
.build();
documentTable.putItem(personDocument);
|
| Get item | GetItemOutcome outcome = documentTable.getItemOutcome( "id", 50);
Item personDocFromDb = outcome.getItem();
String firstName = personDocFromDb.getString("firstName");
| EnhancedDocument personDocFromDb = documentTable
.getItem(Key.builder()
.partitionValue(50)
.build());
String firstName = personDocFromDb.getString("firstName");
|
| **Work with JSON items** |
| --- |
| Mengkonversi struktur JSON untuk menggunakannya dengan Document API | // The 'jsonPerson' identifier is a JSON string.
Item item = new Item().fromJSON(jsonPerson);
| // The 'jsonPerson' identifier is a JSON string.
EnhancedDocument document = EnhancedDocument.builder()
.json(jsonPerson).build());
|
| Masukan JSON | documentTable.putItem(item)
| documentTable.putItem(document);
|
| Baca JSON | GetItemOutcome outcome = //Get item.
String jsonPerson = outcome.getItem().toJSON();
| String jsonPerson = documentTable.getItem(Key.builder()
.partitionValue(50).build())
.fromJson();
|
## Referensi API dan panduan untuk dokumen APIs
| | V1 | V2 |
| --- | --- | --- |
| Referensi API | [Referensi API](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/package-summary.html) | [Referensi API](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/document/package-summary.html) |
| Panduan dokumentasi | [Panduan Pengembang Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/JavaDocumentAPIItemCRUD.html) | [API Dokumen yang Ditingkatkan](ddb-en-client-doc-api.md) (panduan ini) |
# V1 Xpec API ke V2 Expressions API
Expression Specification (Xspec) API yang tersedia di V1 yang membantu membuat ekspresi untuk bekerja dengan data berorientasi dokumen tidak tersedia di V2. V2 menggunakan Expression API, yang bekerja dengan data berorientasi dokumen dan object-to-item data yang dipetakan.
****
| | V1 | V2 |
| --- | --- | --- |
| Nama API | Spesifikasi Ekspresi (Xspec) API | Ekspresi API |
| Bekerja dengan | [Metode kelas [Tabel](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Table.html) API Dokumen seperti [UpdateItem](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Table.html#updateItem-java.lang.String-java.lang.Object-com.amazonaws.services.dynamodbv2.xspec.UpdateItemExpressionSpec-) dan scan](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Table.html#scan-com.amazonaws.services.dynamodbv2.xspec.ScanExpressionSpec-) | Kedua APIs DynamoDB Enhanced Client: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sdk-for-java/latest/developer-guide/ddb-v1-xspec-migrate.html) Untuk kedua jenis APIs, setelah Anda memperoleh [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/DynamoDbTable.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/DynamoDbTable.html)instance: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sdk-for-java/latest/developer-guide/ddb-v1-xspec-migrate.html) Anda menggunakan ekspresi dalam `DynamoDbTable` metode saat Anda membuat objek permintaan. Misalnya dalam `filterExpression` metode [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/model/QueryEnhancedRequest.Builder.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/model/QueryEnhancedRequest.Builder.html) |
| Sumber daya | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sdk-for-java/latest/developer-guide/ddb-v1-xspec-migrate.html) | [Informasi ekspresi](ddb-en-client-expressions.md) dalam Panduan Pengembang Java ini |
# Migrasi perpustakaan enkripsi
Untuk informasi tentang memigrasi pustaka enkripsi agar DynamoDB berfungsi dengan V2 dari Java SDK, lihat Panduan Pengembang Klien Enkripsi Amazon [DynamoDB](https://docs.aws.amazon.com/database-encryption-sdk/latest/devguide/ddb-java-migrate.html).
# Perubahan dalam batch permintaan Amazon SQS otomatis dari versi 1 ke versi 2
Topik ini merinci perubahan dalam pengelompokan permintaan otomatis untuk Amazon SQS antara versi 1 dan versi 2. AWS SDK untuk Java
## Perubahan tingkat tinggi
AWS SDK untuk Java 1.x melakukan buffering sisi klien menggunakan `[AmazonSQSBufferedAsyncClient](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/sqs/buffered/AmazonSQSBufferedAsyncClient.html)` kelas terpisah yang memerlukan inisialisasi eksplisit untuk pengelompokan permintaan.
AWS SDK for Java 2.x Menyederhanakan dan meningkatkan fungsionalitas buffering dengan. `[SqsAsyncBatchManager](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/sqs/batchmanager/SqsAsyncBatchManager.html)` Implementasi antarmuka ini menyediakan kemampuan batching permintaan otomatis yang terintegrasi langsung dengan standar`[SqsAsyncClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/sqs/SqsAsyncClient.html)`. Untuk mempelajari tentang v2`SqsAsyncBatchManager`, lihat [Gunakan batching permintaan otomatis untuk Amazon SQS dengan AWS SDK for Java 2.x](sqs-auto-batch.md) topik di panduan ini.
| Ubah | v1 | v2 |
| --- | --- | --- |
| Ketergantungan Maven |
com.amazonaws
aws-java-sdk-bom
1.12.7821
pom
import
com.amazonaws
aws-java-sdk-sqs
|
software.amazon.awssdk
bom
2.31.152
pom
import
software.amazon.awssdk
sqs
|
| Nama Package | com.amazonaws.services.sqs.buffered | software.amazon.awssdk.services.sqs.batchmanager |
| Nama kelas | `[AmazonSQSBufferedAsyncClient](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/sqs/buffered/AmazonSQSBufferedAsyncClient.html)` | [SqsAsyncBatchManager](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/sqs/batchmanager/SqsAsyncBatchManager.html) |
1 [Versi terbaru](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Versi terbaru](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Menggunakan batching permintaan SQS otomatis
| Ubah | v1 | v2 |
| --- | --- | --- |
| Buat pengelola batch | AmazonSQSAsync sqsAsync = new AmazonSQSAsyncClient();
AmazonSQSAsync bufferedSqs = new
AmazonSQSBufferedAsyncClient(sqsAsync);
| SqsAsyncClient asyncClient = SqsAsyncClient.create();
SqsAsyncBatchManager sqsAsyncBatchManager =
asyncClient.batchManager();
|
| Buat pengelola batch dengan konfigurasi khusus | AmazonSQSAsync sqsAsync = new AmazonSQSAsyncClient();
QueueBufferConfig queueBufferConfig = new QueueBufferConfig()
.withMaxBatchOpenMs(200)
.withMaxBatchSize(10)
.withMinReceiveWaitTimeMs(1000)
.withVisibilityTimeoutSeconds(20)
.withReceiveMessageAttributeNames(messageAttributeValues);
AmazonSQSAsync bufferedSqs =
new AmazonSQSBufferedAsyncClient(sqsAsync, queueBufferConfig);
| BatchOverrideConfiguration batchOverrideConfiguration =
BatchOverrideConfiguration.builder()
.sendRequestFrequency(Duration.ofMillis(200))
.maxBatchSize(10)
.receiveMessageMinWaitDuration(Duration.ofMillis(1000))
.receiveMessageVisibilityTimeout(Duration.ofSeconds(20))
.receiveMessageSystemAttributeNames(messageSystemAttributeNames)
.receiveMessageAttributeNames(messageAttributeValues)
.build();
SqsAsyncBatchManager sqsAsyncBatchManager = SqsAsyncBatchManager.builder()
.overrideConfiguration(batchOverrideConfiguration)
.client(SqsAsyncClient.create())
.scheduledExecutor(Executors.newScheduledThreadPool(8))
.build();
|
| Kirim pesan | Future sendResultFuture =
bufferedSqs.sendMessageAsync(new SendMessageRequest()
.withQueueUrl(queueUrl)
.withMessageBody(body));
| CompletableFuture sendCompletableFuture =
sqsAsyncBatchManager.sendMessage(
SendMessageRequest.builder()
.queueUrl(queueUrl)
.messageBody(body)
.build());
|
| Hapus pesan | Future deletResultFuture =
bufferedSqs.deleteMessageAsync(new DeleteMessageRequest()
.withQueueUrl(queueUrl));
| CompletableFuture deleteResultCompletableFuture
= sqsAsyncBatchManager.deleteMessage(
DeleteMessageRequest.builder()
.queueUrl(queueUrl)
.build());
|
| Ubah visibilitas pesan | Future changeVisibilityResultFuture =
bufferedSqs.changeMessageVisibilityAsync
(new ChangeMessageVisibilityRequest()
.withQueueUrl(queueUrl)
.withVisibilityTimeout(20));
| CompletableFuture changeResponseCompletableFuture
= sqsAsyncBatchManager.changeMessageVisibility(
ChangeMessageVisibilityRequest.builder()
.queueUrl(queueUrl)
.visibilityTimeout(20)
.build());
|
| Menerima pesan | ReceiveMessageResult receiveResult =
bufferedSqs.receiveMessage(
new ReceiveMessageRequest()
.withQueueUrl(queueUrl));
| CompletableFuture
responseCompletableFuture = sqsAsyncBatchManager.receiveMessage(
ReceiveMessageRequest.builder()
.queueUrl(queueUrl)
.build());
|
## Perbedaan tipe pengembalian asinkron
| Ubah | v1 | v2 |
| --- | --- | --- |
| Jenis pengembalian | Future | CompletableFuture |
| Mekanisme panggilan balik | Membutuhkan AsyncHandler dengan onError metode onSuccess dan terpisah | Penggunaan CompletableFuture APIs yang disediakan oleh JDK, sepertiwhenComplete(),, thenCompose() thenApply() |
| Penanganan pengecualian | Menggunakan AsyncHandler\$1onError() metode | Penggunaan CompletableFuture APIs yang disediakan oleh JDK, seperti,exceptionally(), handle() atau whenComplete() |
| Pembatalan | Dukungan dasar melalui Future.cancel() | Membatalkan induk CompletableFuture secara otomatis membatalkan semua futures dependen dalam rantai |
## Perbedaan penanganan penyelesaian asinkron
| Ubah | v1 | v2 |
| --- | --- | --- |
| Implementasi penangan respons | Future future = bufferedSqs.receiveMessageAsync(
receiveRequest,
new AsyncHandler() {
@Override
public void onSuccess(ReceiveMessageRequest request,
ReceiveMessageResult result) {
List messages = result.getMessages();
System.out.println("Received " + messages.size() + " messages");
for (Message message : messages) {
System.out.println("Message ID: " + message.getMessageId());
System.out.println("Body: " + message.getBody());
}
}
@Override
public void onError(Exception e) {
System.err.println("Error receiving messages: " + e.getMessage());
e.printStackTrace();
}
}
);
| CompletableFuture completableFuture = sqsAsyncBatchManager
.receiveMessage(ReceiveMessageRequest.builder()
.queueUrl(queueUrl).build())
.whenComplete((receiveMessageResponse, throwable) -> {
if (throwable != null) {
System.err.println("Error receiving messages: " + throwable.getMessage());
throwable.printStackTrace();
} else {
List messages = receiveMessageResponse.messages();
System.out.println("Received " + messages.size() + " messages");
for (Message message : messages) {
System.out.println("Message ID: " + message.messageId());
System.out.println("Body: " + message.body());
}
}
});
|
## Parameter konfigurasi kunci
****
| Parameter | v1 | v2 |
| --- | --- | --- |
| Ukuran batch maksimum | maxBatchSize(default 10 permintaan per batch) | maxBatchSize(default 10 permintaan per batch) |
| Waktu tunggu Batch | maxBatchOpenMs(default 200 ms) | sendRequestFrequency(default 200 ms) |
| Batas waktu visibilitas | visibilityTimeoutSeconds(-1 untuk antrian default) | receiveMessageVisibilityTimeout(antrian default) |
| Waktu tunggu minimum | longPollWaitTimeoutSeconds(20-an kapan longPoll itu benar) | receiveMessageMinWaitDuration(default 50 ms) |
| Atribut pesan | Atur menggunakan ReceiveMessageRequest | receiveMessageAttributeNames(tidak ada secara default) |
| Atribut sistem | Atur menggunakan ReceiveMessageRequest | receiveMessageSystemAttributeNames(tidak ada secara default) |
| Pemungutan suara panjang | longPoll(default benar) | Tidak didukung untuk menghindari koneksi terbuka menunggu sampai server mengirim pesan |
| Waktu tunggu maksimal untuk polling panjang | longPollWaitTimeoutSeconds(default 20-an) | Tidak didukung untuk menghindari koneksi terbuka menunggu sampai server mengirim pesan |
| Jumlah maksimum batch penerimaan yang diambil sebelumnya yang disimpan di sisi klien | maxDoneReceiveBatches(10 batch) | Tidak didukung karena ditangani secara internal |
| Jumlah maksimum batch keluar aktif yang diproses secara bersamaan | maxInflightOutboundBatches(default 5 batch) | Tidak didukung karena ditangani secara internal |
| Jumlah maksimum batch penerima aktif yang diproses secara bersamaan | maxInflightReceiveBatches(default 10 batch) | Tidak didukung karena ditangani secara internal |
# Gunakan SDK for Java 1.x dan 2.x side-by-side
Anda dapat menggunakan kedua versi AWS SDK untuk Java dalam proyek Anda.
Berikut ini menunjukkan contoh `pom.xml` file untuk proyek yang menggunakan Amazon S3 dari versi 1.x dan DynamoDB dari versi 2.27.21.
**Example Contoh POM**
Contoh ini menunjukkan entri `pom.xml` file untuk proyek yang menggunakan versi 1.x dan 2.x SDK.
```
com.amazonaws
aws-java-sdk-bom
1.12.1
pom
import
software.amazon.awssdk
bom
2.27.21
pom
import
com.amazonaws
aws-java-sdk-s3
software.amazon.awssdk
dynamodb
```