Schritt 1: Bereiten Sie sich auf dieses Tutorial vor Schritt 2: Erstellen Sie das Projekt Schritt 3: Schreiben Sie den Code Schritt 4: Erstellen Sie die Anwendung und führen Sie sie aus Nächste Schritte

Fangen Sie mit dem SDK für Kotlin an

Das AWS SDK for Kotlin bietet Kotlin APIs für jeden AWS-Service. Mit dem SDK können Sie Kotlin-Anwendungen erstellen, die mit Amazon S3, Amazon EC2, Amazon DynamoDB und mehr funktionieren.

Dieses Tutorial zeigt Ihnen, wie Sie Gradle verwenden, um Abhängigkeiten für zu definieren. AWS SDK for Kotlin Anschließend erstellen Sie Code, der Daten in eine DynamoDB-Tabelle schreibt. Obwohl Sie vielleicht die Funktionen einer IDE verwenden möchten, benötigen Sie für dieses Tutorial lediglich ein Terminalfenster und einen Texteditor.

Gehen Sie wie folgt vor, um dieses Tutorial abzuschließen:

Schritt 1: Richten Sie sich für dieses Tutorial ein
Schritt 2: Erstellen Sie das Projekt
Schritt 3: Schreiben Sie den Code
Schritt 4: Erstellen Sie die Anwendung und führen Sie sie aus

Schritt 1: Bereiten Sie sich auf dieses Tutorial vor

Bevor Sie mit diesem Tutorial beginnen, benötigen Sie einen IAM Identity Center-Berechtigungssatz, der auf DynamoDB zugreifen kann, und Sie benötigen eine Kotlin-Entwicklungsumgebung, die mit IAM Identity Center Single Sign-On-Einstellungen konfiguriert ist, auf die Sie zugreifen können. AWS

Folgen Sie den Anweisungen in diesem Handbuch, um die Grundlegende Einrichtung Grundlagen für dieses Tutorial einzurichten.

Nachdem Sie Ihre Entwicklungsumgebung mit Single Sign-On-Zugriff für das Kotlin SDK konfiguriert haben und Sie eine aktive AWS Access-Portal-Sitzung haben, fahren Sie mit Schritt 2 fort.

Schritt 2: Erstellen Sie das Projekt

Um das Projekt für dieses Tutorial zu erstellen, verwenden Sie zunächst Gradle, um die Basisdateien für ein Kotlin-Projekt zu erstellen. Aktualisieren Sie dann die Dateien mit den erforderlichen Einstellungen, Abhängigkeiten und dem Code für. AWS SDK for Kotlin

Um ein neues Projekt mit Gradle zu erstellen

Anmerkung

Dieses Tutorial verwendet Gradle Version 8.11.1 mit dem gradle init Befehl, der in Schritt 3 unten fünf Eingabeaufforderungen bietet. Wenn Sie eine andere Version von Gradle verwenden, können sich die Eingabeaufforderungen unterscheiden, ebenso wie die vorausgefüllten Versionen von Artefakten.

Erstellen Sie ein neues Verzeichnis mit einem Namen getstarted an einem Ort Ihrer Wahl, z. B. auf Ihrem Desktop oder Ihrem Home-Ordner.
Öffnen Sie ein Terminal- oder Befehlszeilenfenster und navigieren Sie zu dem getstarted Verzeichnis, das Sie erstellt haben.
Verwenden Sie den folgenden Befehl, um ein neues Gradle-Projekt und eine grundlegende Kotlin-Klasse zu erstellen.
```
gradle init --type kotlin-application --dsl kotlin
```
- Wenn Sie nach dem Ziel gefragt werdenJava version, drücken Sie Enter (Standardeinstellung). 21
- Wenn Sie dazu aufgefordert werdenProject name, drücken Sie Enter (getstartedin diesem Tutorial wird standardmäßig der Verzeichnisname verwendet).
- Wenn Sie dazu aufgefordert werdenapplication structure, drücken Sie Enter (standardmäßig). Single application project
- Wenn Sie dazu aufgefordert werdenSelect test framework, drücken Sie Enter (standardmäßig). kotlin.test
- Wenn Sie dazu aufgefordert werdenGenerate build using new APIs and behavior, drücken Sie Enter (standardmäßig). no

Um Ihr Projekt mit Abhängigkeiten für Amazon S3 AWS SDK for Kotlin und Amazon S3 zu konfigurieren

Ersetzen Sie in dem getstarted Verzeichnis, das Sie im vorherigen Verfahren erstellt haben, den Inhalt der settings.gradle.kts Datei durch den folgenden Inhalt und X.Y.Z ersetzen Sie ihn durch die neueste Version des SDK für Kotlin:


dependencyResolutionManagement {
    repositories {
        mavenCentral()
    }

    versionCatalogs {
        create("awssdk") {
            from("aws.sdk.kotlin:version-catalog:X.Y.Z")
        }
    }
}

plugins {
    // Apply the foojay-resolver plugin to allow automatic download of JDKs.
    id("org.gradle.toolchains.foojay-resolver-convention") version "0.8.0"
}

rootProject.name = "getstarted"
include("app")

Navigieren Sie zu dem gradle Verzeichnis innerhalb des getstarted Verzeichnisses. Ersetzen Sie den Inhalt der benannten Versionskatalogdatei libs.versions.toml durch den folgenden Inhalt:


[versions]
junit-jupiter-engine = "5.10.3"

[libraries]
junit-jupiter-engine = { module = "org.junit.jupiter:junit-jupiter-engine", version.ref = "junit-jupiter-engine" }

[plugins]
kotlin-jvm = { id = "org.jetbrains.kotlin.jvm", version = "2.1.0" }

Navigieren Sie zu dem Verzeichnis app und öffnen Sie die Datei build.gradle.kts. Ersetzen Sie seinen Inhalt durch den folgenden Code und speichern Sie dann Ihre Änderungen.


plugins {
    alias(libs.plugins.kotlin.jvm)
    application
}


dependencies {
    implementation(awssdk.services.s3) // Add dependency on the AWS SDK for Kotlin's S3 client.

    testImplementation("org.jetbrains.kotlin:kotlin-test-junit5")
    testImplementation(libs.junit.jupiter.engine)
    testRuntimeOnly("org.junit.platform:junit-platform-launcher")
}

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(21)
    }
}

application {
    mainClass = "org.example.AppKt"
}

tasks.named<Test>("test") {
    useJUnitPlatform()
}

Der dependencies Abschnitt enthält einen implementation Eintrag für das Amazon S3 S3-Modul von AWS SDK for Kotlin. Der Gradle-Compiler ist in diesem Abschnitt für die Verwendung von Java 2.1 konfiguriert. java

Schritt 3: Schreiben Sie den Code

Nachdem das Projekt erstellt und konfiguriert wurde, bearbeiten Sie die Standardklasse des Projekts, App um den folgenden Beispielcode zu verwenden.

Navigieren Sie in Ihrem Projektordner app zum Verzeichnissrc/main/kotlin/org/example. Öffnen Sie die App.kt Datei.

Ersetzen Sie den Inhalt durch den folgenden Code und speichern Sie die Datei.


package org.example

import aws.sdk.kotlin.services.s3.*
import aws.sdk.kotlin.services.s3.model.BucketLocationConstraint
import aws.smithy.kotlin.runtime.content.ByteStream
import kotlinx.coroutines.runBlocking
import java.util.UUID

val REGION = "us-west-2"
val BUCKET = "bucket-${UUID.randomUUID()}"
val KEY = "key"

fun main(): Unit = runBlocking {
    S3Client
        .fromEnvironment { region = REGION }
        .use { s3 ->
            setupTutorial(s3)

            println("Creating object $BUCKET/$KEY...")

            s3.putObject {
                bucket = BUCKET
                key = KEY
                body = ByteStream.fromString("Testing with the Kotlin SDK")
            }

            println("Object $BUCKET/$KEY created successfully!")

            cleanUp(s3)
        }
}

suspend fun setupTutorial(s3: S3Client) {
    println("Creating bucket $BUCKET...")
    s3.createBucket {
        bucket = BUCKET
        if (REGION != "us-east-1") { // Do not set location constraint for us-east-1.
            createBucketConfiguration {
                locationConstraint = BucketLocationConstraint.fromValue(REGION)
            }
        }
    }
    println("Bucket $BUCKET created successfully!")
}

suspend fun cleanUp(s3: S3Client) {
    println("Deleting object $BUCKET/$KEY...")
    s3.deleteObject {
        bucket = BUCKET
        key = KEY
    }
    println("Object $BUCKET/$KEY deleted successfully!")

    println("Deleting bucket $BUCKET...")
    s3.deleteBucket {
        bucket = BUCKET
    }
    println("Bucket $BUCKET deleted successfully!")
}

Schritt 4: Erstellen Sie die Anwendung und führen Sie sie aus

Nachdem das Projekt erstellt wurde und die Beispielklasse enthält, erstellen Sie die Anwendung und führen Sie sie aus.

Öffnen Sie ein Terminal- oder Befehlszeilenfenster und navigieren Sie zu Ihrem Projektverzeichnisgetstarted.
Verwenden Sie den folgenden Befehl, um Ihre Anwendung zu erstellen und auszuführen:
```
gradle run
```

Anmerkung

Wenn Sie eine erhaltenIdentityProviderException, haben Sie möglicherweise keine aktive Single Sign-On-Sitzung. Führen Sie den aws sso login AWS CLI-Befehl aus, um eine neue Sitzung zu initiieren.

Die Anwendung ruft die CreateBucket-API-Operation auf, um einen neuen S3-Bucket zu erstellen, und ruft dann PutObject auf, um ein neues Objekt in den neuen S3-Bucket einzufügen.

In der cleanUp() Funktion am Ende löscht die Anwendung das Objekt und anschließend den S3-Bucket.

Um die Ergebnisse in der Amazon S3 S3-Konsole zu sehen

Kommentieren Sie die Zeile cleanUp(s3) im runBlocking Abschnitt aus und speichern Sie die Datei. App.kt
Erstellen Sie das Projekt neu und fügen Sie ein neues Objekt in einen neuen S3-Bucket ein, indem Sie Folgendes ausführengradle run.
Melden Sie sich bei der Amazon S3 S3-Konsole an, um das neue Objekt im neuen S3-Bucket anzusehen.

Nachdem Sie das Objekt angesehen haben, löschen Sie den S3-Bucket.

Herzlichen Glückwunsch

Wenn Ihr Gradle-Projekt ohne Fehler erstellt und ausgeführt wurde, dann herzlichen Glückwunsch. Sie haben erfolgreich Ihre erste Kotlin-Anwendung mit dem erstellt. AWS SDK for Kotlin

Bereinigen

Wenn Sie mit der Entwicklung Ihrer neuen Anwendung fertig sind, löschen Sie alle AWS Ressourcen, die Sie in diesem Tutorial erstellt haben, um Gebühren zu vermeiden. Möglicherweise möchten Sie auch den Projektordner (get-started), den Sie in Schritt 2 erstellt haben, löschen oder archivieren.

Gehen Sie wie folgt vor, um Ressourcen zu bereinigen:

Wenn Sie den cleanUp() Funktionsaufruf auskommentiert haben, löschen Sie den S3-Bucket mithilfe der Amazon S3 S3-Konsole.

Nächste Schritte

Nachdem Sie sich mit den Grundlagen vertraut gemacht haben, können Sie sich über Folgendes informieren:

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Was ist der AWS SDK for Kotlin?

Einrichten