records = s3EventNotification.getRecords();
S3EventNotificationRecord record = records.stream().findFirst();
// Use getters on the record to access individual attributes.
String awsRegion = record.getAwsRegion();
String eventName = record.getEventName();
String eventSource = record.getEventSource();
}
}
```
In diesem Beispiel konvertiert die `fromJson` Methode die JSON-Zeichenfolge in ein `S3EventNotification` Objekt. Fehlende Felder in der JSON-Zeichenfolge führen zu `null` Werten in den entsprechenden Java-Objektfeldern, und alle zusätzlichen Felder in der JSON-Zeichenfolge werden ignoriert.
APIs Weitere Informationen zu einer Ereignisbenachrichtigung finden Sie in der API-Referenz für`[S3EventNotificationRecord](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/S3EventNotificationRecord.html)`.
#### Konvertiert eine `S3EventNotification` Instanz in eine JSON-Zeichenfolge
Verwenden Sie die Methode `toJson` (or`toJsonPretty`), um ein `S3EventNotification` Objekt in eine JSON-Zeichenfolge zu konvertieren, wie im folgenden Beispiel gezeigt.
```
import software.amazon.awssdk.eventnotifications.s3.model.S3EventNotification
public class S3EventNotificationExample {
...
void toJsonString(S3EventNotification event) {
String json = event.toJson();
String jsonPretty = event.toJsonPretty();
System.out.println("JSON: " + json);
System.out.println("Pretty JSON: " + jsonPretty);
}
}
```
Felder für`GlacierEventData`, `ReplicationEventData``IntelligentTieringEventData`, und `LifecycleEventData` sind aus dem JSON ausgeschlossen, falls sie es sind`null`. Andere `null` Felder werden als `null` serialisiert.
Im Folgenden wird eine Beispielausgabe der `toJsonPretty` Methode für ein S3-Objekt-Tagging-Ereignis gezeigt.
```
{
"Records" : [ {
"eventVersion" : "2.3",
"eventSource" : "aws:s3",
"awsRegion" : "us-east-1",
"eventTime" : "2024-07-19T20:09:18.551Z",
"eventName" : "ObjectTagging:Put",
"userIdentity" : {
"principalId" : "AWS:XXXXXXXXXXX"
},
"requestParameters" : {
"sourceIPAddress" : "XXX.XX.XX.XX"
},
"responseElements" : {
"x-amz-request-id" : "XXXXXXXXXXXX",
"x-amz-id-2" : "XXXXXXXXXXXXX"
},
"s3" : {
"s3SchemaVersion" : "1.0",
"configurationId" : "XXXXXXXXXXXXX",
"bucket" : {
"name" : "amzn-s3-demo-bucket",
"ownerIdentity" : {
"principalId" : "XXXXXXXXXXX"
},
"arn" : "arn:aws:s3:::XXXXXXXXXX"
},
"object" : {
"key" : "akey",
"size" : null,
"eTag" : "XXXXXXXXXX",
"versionId" : null,
"sequencer" : null
}
}
} ]
}
```
Ein [vollständiges Beispiel](https://github.com/awsdocs/aws-doc-sdk-examples/blob/75c3daadf750406156fc87fa30ee499a206b4a36/javav2/example_code/s3/src/main/java/com/example/s3/ProcessS3EventNotification.java#L117) ist verfügbar GitHub , das zeigt, wie die API verwendet wird, um mit Benachrichtigungen zu arbeiten, die von einer Amazon SQS SQS-Warteschlange empfangen wurden.
## S3-Ereignisse in Lambda mit Java-Bibliotheken verarbeiten: AWS SDK for Java 2.x und `aws-lambda-java-events`
Anstatt das SDK for Java 2.x zur Verarbeitung von Amazon S3 S3-Ereignisbenachrichtigungen in einer Lambda-Funktion zu verwenden, können Sie die `[aws-lambda-java-events](https://github.com/aws/aws-lambda-java-libs/tree/main/aws-lambda-java-events)` Bibliothek in Version 3.x.x verwenden. AWS verwaltet die `aws-lambda-java-events` Bibliothek unabhängig und hat ihre eigenen Abhängigkeitsanforderungen. Die `aws-lambda-java-events` Bibliothek funktioniert nur mit S3-Ereignissen in Lambda-Funktionen, wohingegen das SDK for Java 2.x mit S3-Ereignissen in Lambda-Funktionen, Amazon SNS und Amazon SQS funktioniert.
Beide Ansätze modellieren die Nutzlast für JSON-Ereignisbenachrichtigungen auf objektorientierte Weise mit ähnlichen Methoden. APIs Die folgende Tabelle zeigt die wesentlichen Unterschiede zwischen der Verwendung der beiden Ansätze.
****
| | AWS SDK für Java | aws-lambda-java-events Bibliothek |
| --- | --- | --- |
| Benennung von Paketen | `software.amazon.awssdk.eventnotifications.s3.model.S3EventNotification` | com.amazonaws.services.lambda.runtime.events.models.s3.S3EventNotification |
| RequestHandler Parameter | Schreiben Sie die `RequestHandler` Implementierung Ihrer Lambda-Funktion, um eine JSON-Zeichenfolge zu erhalten: import com.amazonaws.services.lambda.runtime.Context;
import com.amazonaws.services.lambda.runtime.RequestHandler;
import software.amazon.awssdk.eventnotifications.s3.model.S3EventNotification;
public class Handler implements RequestHandler {
@Override
public String handleRequest(String jsonS3Event, Context context) {
S3EventNotification s3Event = S3EventNotification
.fromJson(jsonS3Event);
// Work with the s3Event object.
...
}
}
| Schreiben Sie die RequestHandler Implementierung Ihrer Lambda-Funktion, um ein S3Event Objekt zu empfangen:import com.amazonaws.services.lambda.runtime.Context;
import com.amazonaws.services.lambda.runtime.RequestHandler;
import com.amazonaws.services.lambda.runtime.events.S3Event;
public class Handler implements RequestHandler {
@Override
public String handleRequest(S3Event s3event, Context context) {
// Work with the s3Event object.
...
}
}
|
| Maven-Abhängigkeiten |
software.amazon.awssdk
bom
2.X.X
pom
import
software.amazon.awssdk
s3-event-notifications
|
software.amazon.awssdk
bom
2.X.X
pom
import
com.amazonaws
aws-lambda-java-core
1.2.3
com.amazonaws
aws-lambda-java-events
3.15.0
|