本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 適用於 Java 的 AWS SDK 2.x 入門本主題中的各節將逐步引導您開始建置連接至的 Java 應用程式的基本步驟 AWS 服務。這些章節涵蓋使用 Java 設定開發環境，以及建置 Maven 或 Gradle 等工具、設定安全身分驗證 AWS，以及透過實作教學課程建立您的第一個工作應用程式。這個適合初學者的主題是使用 Java AWS 開發的進入點，提供您在探索更進階功能之前所需的基礎。 **Contents** + [設定適用於 Java 的 AWS SDK 2.x](setup.md) + [設定概觀](setup.md#setup-overview) + [安裝 Java 和建置工具以使用 AWS SDK for Java 2.x](setup-java-buildtool.md) + [設定使用的 Apache Maven 專案 AWS SDK for Java 2.x](setup-project-maven.md) + [先決條件](setup-project-maven.md#prerequisitesmaven) + [建立 Maven 專案](setup-project-maven.md#create-maven-project) + [設定適用於 Maven 的 Java 編譯器](setup-project-maven.md#configure-maven-compiler) + [將開發套件宣告為相依性](setup-project-maven.md#sdk-as-dependency) + [設定開發套件模組的相依性](setup-project-maven.md#modules-dependencies) + [在專案中建立整個開發套件](setup-project-maven.md#build-the-entire-sdk-into-your-project) + [建立專案](setup-project-maven.md#build-project) + [設定使用的 Gradle 專案 AWS SDK for Java 2.x](setup-project-gradle.md) + [設定使用的 GraalVM 原生映像專案 AWS SDK for Java 2.x](setup-project-graalvm.md) + [先決條件](setup-project-graalvm.md#setup-graalvmnativeimage-prereq) + [使用原型建立專案](setup-project-graalvm.md#setup-graalvmnativeimage-project) + [建置原生映像](setup-project-graalvm.md#build-graalvmnativeimage-project) + [AWS 使用透過驗證 AWS SDK for Java 2.x](get-started-auth.md) + [設定身分驗證](get-started-auth.md#setup-auth) + [1. 使用短期登入資料進行本機開發](get-started-auth.md#setup-login) + [2. 設定 SDK 的單一登入存取](get-started-auth.md#setup-credentials) + [3. 使用登入 AWS CLI](get-started-auth.md#setup-login-sso) + [其他身分驗證選項](get-started-auth.md#setup-additional) + [使用建立簡單的應用程式 AWS SDK for Java 2.x](get-started-tutorial.md) + [步驟 1：設定本教學課程](get-started-tutorial.md#get-started-setup) + [步驟 2：建立專案](get-started-tutorial.md#get-started-projectsetup) + [步驟 3：撰寫程式碼](get-started-tutorial.md#get-started-code) + [步驟 4：建置並執行應用程式](get-started-tutorial.md#get-started-run) + [成功](get-started-tutorial.md#get-started-success) + [清除](get-started-tutorial.md#cleanup) + [後續步驟](get-started-tutorial.md#get-started-next) # 設定適用於 Java 的 AWS SDK 2.x 本節提供如何設定開發環境和專案以使用的相關資訊 AWS SDK for Java 2.x。 ## 設定概觀若要成功開發 AWS 服務使用存取的應用程式適用於 Java 的 AWS SDK，需要下列條件： + Java 開發套件必須能夠存取登入資料，以代表您[驗證請求](get-started-auth.md#setup-auth)。 + 為 SDK 設定的 [IAM 角色許可](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html)必須允許存取 AWS 服務您的應用程式所需的。與 **PowerUserAccess** AWS 受管政策相關聯的許可足以滿足大多數開發需求。 + 具有下列元素的開發環境： + 至少以下列其中一種方式設定的[共用組態檔案](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html)： + `config` 檔案包含 [IAM Identity Center 單一登入設定](get-started-auth.md#setup-credentials)，讓 SDK 可以取得 AWS 登入資料。 + `credentials` 檔案包含臨時登入資料。 + [安裝 Java 8 ](setup-java-buildtool.md)或更新版本。 + [建置自動化工具](setup-java-buildtool.md)，例如 [Maven](https://maven.apache.org/download.cgi) 或 [Gradle](https://gradle.org/install/)。 + 使用程式碼的文字編輯器。 + （選用，但建議使用） IDE （整合式開發環境），例如 [IntelliJ IDEA](https://www.jetbrains.com/idea/download/#section=windows)、[Eclipse](https://www.eclipse.org/ide/) 或 [NetBeans](https://netbeans.apache.org/front/main/download/index.html)。如果您使用 IntelliJ IDEA，也可以新增 [AWS Toolkit for IntelliJ IDEA](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/welcome.html) 以 AWS 服務直接整合到 IDE，以協助您簡化開發。 + 當您準備好執行應用程式時，作用中的 AWS 存取入口網站工作階段。您可以使用 AWS Command Line Interface [啟動 IAM Identity Center 存取入口網站的登入程序](get-started-auth.md#setup-login-sso)。 AWS **重要** 此設定區段中的指示假設您或組織使用 IAM Identity Center。如果您的組織使用獨立於 IAM Identity Center 運作的外部身分提供者，請了解如何取得適用於 Java 的 SDK 暫時登入資料。請依照[這些指示](credentials-temporary.md#credentials-temporary-from-portal)，將臨時登入資料新增至 `~/.aws/credentials` 檔案。如果您的身分提供者自動將臨時登入資料新增至 `~/.aws/credentials` 檔案，請確定設定檔名稱為，`[default]`如此您就不需要提供設定檔名稱給 SDK 或 AWS CLI。 # 安裝 Java 和建置工具以使用 AWS SDK for Java 2.x 您需要下列 Java 開發環境需求，才能使用適用於 Java 的 SDK 2.x： + Java 8 或更新版本。適用於 Java 的 AWS SDK 適用於 [Oracle Java SE 開發套件](https://www.oracle.com/java/technologies/downloads/)和 Open Java 開發套件 (OpenJDK) 的發行版本，例如 [Amazon Corretto](https://aws.amazon.com/corretto/)、[Red Hat OpenJDK](https://developers.redhat.com/products/openjdk/overview) 和 [Adoptium](https://adoptium.net/)。 + 與 Maven 相容的建置工具，例如 Apache Maven、Apache Ant with Ivy、Gradle 或 IntelliJ。 + 如需如何安裝和使用 Maven 的詳細資訊，請參閱 https：//[https://maven.apache.org/](https://maven.apache.org/)。 + 如需如何安裝和使用 Apache Ivy 的詳細資訊，請參閱 https：//[https://ant.apache.org/ivy/](https://ant.apache.org/ivy/)。 + 如需如何安裝和使用 Gradle 的詳細資訊，請參閱 https：//[https://gradle.org/](https://gradle.org/)。 + 如需如何安裝和使用 IntelliJ IDEA 的資訊，請參閱 https：//[https://www.jetbrains.com/idea/](https://www.jetbrains.com/idea/)。 # 設定使用的 Apache Maven 專案 AWS SDK for Java 2.x 您可以使用 [Apache Maven](https://maven.apache.org/) 來設定和建置 AWS SDK for Java 2.x 專案，或[建置 SDK 本身](https://github.com/aws/aws-sdk-java-v2/tree/master#building-from-source)。 ## 先決條件若要搭配 Maven 使用適用於 Java 的 SDK 2.x，您需要下列項目： + Java *8.0 或更新版本*。您可以從 [http://www.oracle.com/technetwork/java/javase/downloads/](https://www.oracle.com/java/technologies/downloads/) 下載最新的 Java SE 開發套件軟體。適用於 Java 的 SDK 2.x 也適用於 [OpenJDK](https://openjdk.org/) Amazon Corretto和 Open Java 開發套件 (OpenJDK) 的發行版本。從 [https://openjdk.java.net/install/index.html](https://openjdk.org/install/index.html) 下載最新版本的 OpenJDK。從 [Corretto 頁面](https://aws.amazon.com/corretto/)下載最新的 Amazon Corretto 8 或 Amazon Corretto 11 版本。 + *Apache Maven*。如果您需要安裝 Maven，請前往 [http://maven.apache.org/](https://maven.apache.org/) 下載並安裝。 ## 建立 Maven 專案若要從命令列建立 Maven 專案，請從終端機或命令提示字元視窗執行下列命令````。 ``` mvn -B archetype:generate \ -DarchetypeGroupId=software.amazon.awssdk \ -DarchetypeArtifactId=archetype-lambda -Dservice=s3 -Dregion=US_WEST_2 \ -DarchetypeVersion=2.X.X \ -DgroupId=com.example.myapp \ -DartifactId=myapp ``` **注意** 將 *com.example.myapp* 更換為您應用程式的完整套件命名空間。亦請將 *myapp* 更換為您的專案名稱。這會成為您專案的目錄名稱。若要使用最新版本的原型，請將 *2.X.X 取代*為 [Maven 中央的最新版本](https://central.sonatype.com/artifact/software.amazon.awssdk/archetype-lambda)。此命令會使用原型範本化工具組建立 Maven 專案。原型會為 AWS Lambda 函數處理常式專案產生 scaffolding。此專案原型已預先設定為使用 Java SE 8 編譯，並包含對使用指定之適用於 Java 2.x 的 SDK 版本的相依性。 `-DarchetypeVersion` 如需建立和設定 Maven 專案的詳細資訊，請參閱 [Maven 入門指南](https://maven.apache.org/guides/getting-started/)。 ## 設定適用於 Maven 的 Java 編譯器如果您如先前所述使用 AWS Lambda 專案原型建立專案，Java 編譯器的組態已為您完成。若要驗證此組態是否存在，請從您執行上一個指令時所建立的專案資料夾中 (例如 `myapp`)，開啟 `pom.xml` 檔案開始。查看第 11 行和第 12 行中此 Maven 專案的 Java 編譯器版本設定，以及在第 71 至 75 行中必須包含的 Maven 編譯器外掛程式。 ``` 1.8 1.8 org.apache.maven.plugins maven-compiler-plugin ${maven.compiler.plugin.version} ``` 如果您使用不同的原型或使用其他方法建立專案，則必須確保 Maven 編譯器外掛程式是組建的一部分，且其來源和目標屬性在 `pom.xml` 檔案中都設定為 **1.8**。請參閱上一個程式碼片段，以了解設定這些必要設定的一種方法。或者，您也可以使用外掛程式宣告設定編譯器組態內嵌，如下所示。 ``` org.apache.maven.plugins maven-compiler-plugin 1.8 1.8 ``` ## 將開發套件宣告為相依性若要在專案適用於 Java 的 AWS SDK 中使用，您需要在專案的 `pom.xml` 檔案中將其宣告為相依性。如果您如先前所述使用專案原型建立專案，則 SDK 的最新版本已在專案中設定為相依性。原型會為`software.amazon.awssdk`群組 ID 產生 BOM （物料帳單）成品相依性。使用 BOM，您不需要為共用相同群組 ID 的個別成品相依性指定 maven 版本。如以不同方式建立 Maven 專案，請確保 `pom.xml` 檔案包含以下內容，以為專案設定開發套件的最新版本。 ``` 2.X.X software.amazon.awssdk bom ${aws.java.sdk.version} pom import ``` **注意** 將 `pom.xml` 檔案中的 *2.X.X* 取代為[最新版本的 AWS SDK for Java 2.x](https://central.sonatype.com/artifact/software.amazon.awssdk/bom) 。 ## 設定開發套件模組的相依性現在您已設定 SDK，您可以為一或多個要在專案中使用的適用於 Java 的 AWS SDK 模組新增相依性。雖然您可以指定每個元件的版本編號，但您不需要，因為您已在 `dependencyManagement`區段中使用物料清單成品宣告 SDK 版本。若要載入指定模組的不同版本，請指定其相依性的版本編號。如果您使用上述的專案原型建立專案，您的專案已設定多個相依性。這些包括 AWS Lambda 函數處理常式和 Amazon S3 的相依性，如下所示。 ``` software.amazon.awssdk s3 software.amazon.awssdk netty-nio-client software.amazon.awssdk apache-client software.amazon.awssdk url-connection-client com.amazonaws aws-lambda-java-core ${aws.lambda.java.version} ``` **注意** 在上述`pom.xml`範例中，相依性來自不同的 `groupId`。`s3` 相依性來自 `software.amazon.awssdk`，`aws-lambda-java-core`而相依性來自 `com.amazonaws`。BOM 相依性管理組態會影響的成品`software.amazon.awssdk`，因此`aws-lambda-java-core`成品需要版本。對於使用適用於 Java 的 SDK 2.x 開發 *Lambda 函數處理常式*， `aws-lambda-java-core`是正確的相依性。不過，如果您的應用程式需要使用 `listFunctions`、、 `deleteFunction``invokeFunction`和等操作來管理 Lambda 資源`createFunction`，您的應用程式需要下列相依性。 ``` software.amazon.awssdk lambda ``` **注意** `s3` 相依性會排除 `netty-nio-client`和可`apache-client`轉移相依性。原型會取代其中一個 HTTP 用戶端，包括`url-connection-client`相依性，這有助於[減少函數的 AWS Lambda 啟動延遲](lambda-optimize-starttime.md#lambda-quick-url)。將模組新增至專案，以取得專案所需的 AWS 服務和功能。由 BOM 管理的適用於 Java 的 AWS SDK 模組（相依性）會列在 [Maven 中央儲存庫](https://central.sonatype.com/artifact/software.amazon.awssdk/bom)上。 **注意** 您可以在程式碼範例中查看 `pom.xml` 檔案，以判斷專案需要的相依性。例如，如果您對 DynamoDB 服務的相依性感興趣，請參閱 GitHub 上[AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2)中的[此範例](https://github.com/awsdocs/aws-doc-sdk-examples/blob/da520cb4436f8567a90b6f73f77232fd590a50bf/javav2/example_code/dynamodb/pom.xml)。（尋找 [/javav2/example\$1code/dynamodb](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/dynamodb) 下的 `pom.xml` 檔案。) ### 在專案中建立整個開發套件若要最佳化您的應用程式，強烈建議您只提取所需元件，不要提取整個開發套件。不過，若要在專案適用於 Java 的 AWS SDK 中建置整個，請在您的 `pom.xml` 檔案中宣告它，如下所示。 ``` software.amazon.awssdk aws-sdk-java 2.X.X ``` ## 建立專案設定 `pom.xml` 檔案後，您就可以使用 Maven 建立您的專案。若要從命令列建立 Maven 專案，請開啟終端機或命令提示視窗，導覽至您的專案目錄 (例如 `myapp`)，輸入或貼上以下命令，然後按 Enter 或 Return。 ``` mvn package ``` 這會在 `target` 目錄中建立單一 `.jar` 檔案 (JAR) (例如 `myapp/target`)。此 JAR 包含您在 `pom.xml` 檔案中指定為相依性的所有開發套件模組。 # 設定使用的 Gradle 專案 AWS SDK for Java 2.x 您可以使用 [Gradle](https://gradle.org/) 來設定和建置 AWS SDK for Java 2.x 專案。下列範例中的初始步驟來自 [Gradle 的 8.4 版入門指南](https://docs.gradle.org/current/samples/sample_building_java_applications.html)。如果您使用不同的版本，結果可能會略有不同。 **使用 Gradle 建立 Java 應用程式（命令列）** 1. 建立目錄以保留您的專案。在此範例中， `demo`是目錄名稱。 1. 在 `demo`目錄中，執行 `gradle init`命令，並提供以紅色反白顯示的值，如下列命令列輸出所示。針對演練，我們選擇 Kotlin 做為建置指令碼 DSL 語言，但本主題結尾也會顯示 Groovy 的完整範例。 ``` > gradle init Starting a Gradle Daemon (subsequent builds will be faster) Select type of project to generate: 1: basic 2: application 3: library 4: Gradle plugin Enter selection (default: basic) [1..4] 2 Select implementation language: 1: C++ 2: Groovy 3: Java 4: Kotlin 5: Scala 6: Swift Enter selection (default: Java) [1..6] 3 Generate multiple subprojects for application? (default: no) [yes, no] no Select build script DSL: 1: Kotlin 2: Groovy Enter selection (default: Kotlin) [1..2] Select test framework: 1: JUnit 4 2: TestNG 3: Spock 4: JUnit Jupiter Enter selection (default: JUnit Jupiter) [1..4] 4 Project name (default: demo): Source package (default: demo): Enter target version of Java (min. 7) (default: 11): Generate build using new APIs and behavior (some features may change in the next minor release)? (default: no) [yes, no] > Task :init To learn more about Gradle by exploring our Samples at https://docs.gradle.org/8.4/samples/sample_building_java_applications.html BUILD SUCCESSFUL in 3m 43s 2 actionable tasks: 2 executed ``` 1. `init` 任務完成後，`demo`目錄會包含下列樹狀結構。在下一節中，我們會進一步了解主要建置檔案 `build.gradle.kts`（以紅色標示）。 ``` ├── app │ ├── build.gradle.kts │ └── src │ ├── main │ │ ├── java │ │ │ └── demo │ │ │ └── App.java │ │ └── resources │ └── test │ ├── java │ │ └── demo │ │ └── AppTest.java │ └── resources ├── gradle │ └── wrapper │ ├── gradle-wrapper.jar │ └── gradle-wrapper.properties ├── gradlew ├── gradlew.bat └── settings.gradle.kts ``` `build.gradle.kts` 檔案包含下列 scaffolded 內容。 ``` /* * This file was generated by the Gradle 'init' task. * * This generated file contains a sample Java application project to get you started. * For more details on building Java & JVM projects, please refer to https://docs.gradle.org/8.4/userguide/building_java_projects.html in the Gradle documentation. */ plugins { // Apply the application plugin to add support for building a CLI application in Java. application } repositories { // Use Maven Central for resolving dependencies. mavenCentral() } dependencies { // Use JUnit Jupiter for testing. testImplementation("org.junit.jupiter:junit-jupiter:5.9.3") testRuntimeOnly("org.junit.platform:junit-platform-launcher") // This dependency is used by the application. implementation("com.google.guava:guava:33.3.0-jre") } // Apply a specific Java toolchain to ease working on different environments. java { toolchain { languageVersion.set(JavaLanguageVersion.of(11)) } } application { // Define the main class for the application. mainClass.set("demo.App") } tasks.named("test") { // Use JUnit Platform for unit tests. useJUnitPlatform() } ``` 1. 使用堆疊的 Gradle 建置檔案做為 AWS 專案的基礎。 1. 若要管理 Gradle 專案的 SDK 相依性，請將的 Maven 物料清單 (BOM) 新增至 `build.gradle.kts` 檔案的 AWS SDK for Java 2.x `dependencies`區段。 ``` ... dependencies { implementation(platform("software.amazon.awssdk:bom:2.27.21")) // With the bom declared, you specify individual SDK dependencies without a version. ... } ... ``` **注意** 在此範例建置檔案中，將 *2.27.21* 取代為最新版本的適用於 Java 的 SDK 2.x。尋找 [Maven 中央儲存庫](https://central.sonatype.com/artifact/software.amazon.awssdk/bom/versions)中可用的最新版本。 1. 在 `dependencies`區段中指定應用程式所需的 SDK 模組。例如，以下內容會在 Amazon Simple Storage Service 上新增相依性。 ``` ... dependencies { implementation(platform("software.amazon.awssdk:bom:2.27.21")) implementation("software.amazon.awssdk:s3") ... } ... ``` Gradle 會使用 BOM 中的資訊，自動解析宣告相依性的正確版本。下列範例顯示 Kotlin 和 Groovy DSLs中完整的 Gradle 建置檔案。建置檔案包含 Amazon S3、身分驗證、記錄和測試的相依性。Java 的來源和目標版本是版本 11。 ------ #### [ Kotlin DSL (build.gradle.kts) ] ``` /* * This file was generated by the Gradle 'init' task. * * This generated file contains a sample Java application project to get you started. * For more details on building Java & JVM projects, please refer to https://docs.gradle.org/8.4/userguide/building_java_projects.html in the Gradle documentation. */ plugins { // Apply the application plugin to add support for building a CLI application in Java. application } repositories { // Use Maven Central for resolving dependencies. mavenCentral() } dependencies { implementation(platform("software.amazon.awssdk:bom:2.20.56")) implementation("software.amazon.awssdk:s3") implementation("software.amazon.awssdk:sso") implementation("software.amazon.awssdk:ssooidc") implementation(platform("org.apache.logging.log4j:log4j-bom:2.20.0")) implementation("org.apache.logging.log4j:log4j-slf4j2-impl") implementation("org.apache.logging.log4j:log4j-1.2-api") testImplementation(platform("org.junit:junit-bom:5.10.0")) testImplementation("org.junit.jupiter:junit-jupiter") } // Apply a specific Java toolchain to ease working on different environments. java { toolchain { languageVersion.set(JavaLanguageVersion.of(11)) } } application { // Define the main class for the application. mainClass.set("demo.App") } tasks.named("test") { // Use JUnit Platform for unit tests. useJUnitPlatform() } ``` ------ #### [ Groovy DSL (build.gradle) ] ``` /* * This file was generated by the Gradle 'init' task. * * This generated file contains a sample Java application project to get you started. * For more details on building Java & JVM projects, please refer to https://docs.gradle.org/8.4/userguide/building_java_projects.html in the Gradle documentation. */ plugins { // Apply the application plugin to add support for building a CLI application in Java. id 'application' } repositories { // Use Maven Central for resolving dependencies. mavenCentral() } dependencies { implementation platform('software.amazon.awssdk:bom:2.27.21') implementation 'software.amazon.awssdk:s3' implementation 'software.amazon.awssdk:sso' implementation 'software.amazon.awssdk:ssooidc' implementation platform('org.apache.logging.log4j:log4j-bom:2.20.0') implementation 'org.apache.logging.log4j:log4j-slf4j2-impl' implementation 'org.apache.logging.log4j:log4j-1.2-api' testImplementation platform('org.junit:junit-bom:5.10.0') testImplementation 'org.junit.jupiter:junit-jupiter' } // Apply a specific Java toolchain to ease working on different environments. java { toolchain { languageVersion = JavaLanguageVersion.of(11) } } application { // Define the main class for the application. mainClass = 'demo_groovy.App' } tasks.named('test') { // Use JUnit Platform for unit tests. useJUnitPlatform() } ``` ------ 如需後續步驟，請參閱 Gradle 網站上的入門指南，以取得如何[建置和執行 Gradle 應用程式](https://docs.gradle.org/current/samples/sample_building_java_applications.html#run_the_application)的指示。 # 設定使用的 GraalVM 原生映像專案 AWS SDK for Java 2.x 使用 2.16.1 版和更新版本時，為 GraalVM 原生映像應用程式 AWS SDK for Java 2.x 提供out-of-the-box支援。使用 `archetype-app-quickstart` Maven 原型來設定具有內建原生映像支援的專案。 ## 先決條件 + 完成[設定適用於 Java 的 AWS SDK 2.x](setup.md) 中的步驟。 + 安裝 [GraalVM 原生映像](https://www.graalvm.org/reference-manual/native-image/#install-native-image)。 ## 使用原型建立專案若要建立具有內建原生映像支援的 Maven 專案，請在終端機或命令提示字元視窗中使用下列命令。 **注意** `com.example.mynativeimageapp` 以應用程式的完整套件命名空間取代。也請將取代`mynativeimageapp`為您的專案名稱。這會成為您專案的目錄名稱。 ``` mvn archetype:generate \ -DarchetypeGroupId=software.amazon.awssdk \ -DarchetypeArtifactId=archetype-app-quickstart \ -DarchetypeVersion=2.27.21\ -DnativeImage=true \ -DhttpClient=apache-client \ -Dservice=s3 \ -DgroupId=com.example.mynativeimageapp \ -DartifactId=mynativeimageapp \ -DinteractiveMode=false ``` 此命令會為適用於 Java 的 AWS SDK Amazon S3、和 `ApacheHttpClient` HTTP 用戶端建立以相依性設定的 Maven 專案。它還包含 [GraalVM 原生映像 Maven 外掛程式](https://graalvm.github.io/native-build-tools/latest/index.html)的相依性，因此您可以使用 Maven 建置原生映像。若要包含不同的相依性 Amazon Web Services，請將 `-Dservice` 參數的值設定為該服務的成品 ID。範例包括 `dynamodb`、`comprehend` 和 `pinpoint`。如需成品 IDs 的完整清單，請參閱 [Maven Central 上 software.amazon.awssdk](https://mvnrepository.com/artifact/software.amazon.awssdk/bom/latest) 的受管相依性清單。若要使用非同步 HTTP 用戶端，請將 `-DhttpClient` 參數設定為 `netty-nio-client`。若要使用 `UrlConnectionHttpClient`做為同步 HTTP 用戶端而非 `apache-client`，請將 `-DhttpClient` 參數設定為 `url-connection-client`。 ## 建置原生映像建立專案之後，請從專案目錄執行下列命令，例如 `mynativeimageapp`： ``` mvn package -P native-image ``` 這會在 `target`目錄中建立原生映像應用程式，例如 `target/mynativeimageapp`。 # AWS 使用透過驗證 AWS SDK for Java 2.x 當您使用 AWS 服務進行開發 AWS 時，您必須建立的 AWS SDK for Java 2.x 身分驗證方式。SDK 會管理登入資料探索、簽章建立和登入資料，完全在幕後重新整理，讓您專注於應用程式邏輯。 ## 設定身分驗證 AWS SDKs和工具參考指南中的[身分驗證和存取](https://docs.aws.amazon.com/sdkref/latest/guide/access.html)主題說明不同的身分驗證方法。對於本機開發，建議的方法是使用主控台登入憑證登入 AWS CLI，以使用短期登入資料。如果您使用根帳戶、IAM 使用者或 IAM 聯合帳戶 AWS 存取，建議使用。按照[使用存取互動式開發工作的登入資料 AWS SDK for Java 2.x](credentials-temporary.md)中的指示進行。遵循 AWS SDKs和工具參考指南的指示後，您的系統應設定為允許 SDK 簽署請求： ### 1. 使用短期登入資料進行本機開發對於本機開發，建議的方法是使用主控台登入憑證登入 AWS CLI，以使用短期登入資料。如果您使用根帳戶、IAM 使用者或 IAM 聯合帳戶 AWS 存取，建議使用。如需說明，請參閱[《》中的使用登入資料提供者 AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/credentials-temporary.html)。 ### 2. 設定 SDK 的單一登入存取在[程式設計存取區段](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html#idcGettingStarted)中完成步驟 2 後，開發套件可以使用 IAM Identity Center 身分驗證，您的系統應該包含下列元素。 + 在執行應用程式之前 AWS CLI，您用來啟動[AWS 存取入口網站工作階段](#setup-login-sso)的。 + 包含[預設設定檔](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile)`~/.aws/config`的檔案。適用於 Java 的 SDK 使用描述檔的 SSO 字符提供者組態，在傳送請求至之前取得憑證 AWS。該 `sso_role_name` 值是連接到 IAM Identity Center 許可集合的 IAM 角色，應該允許存取應用程式中使用的 AWS 服務。下列範例`config`檔案顯示使用 SSO 字符提供者組態設定的預設設定檔。設定檔的 `sso_session` 設定是指已命名的 `sso-session` 區段。此 `sso-session` 區段包含用來啟動 AWS 存取入口網站工作階段的設定。 ``` [default] sso_session = my-sso sso_account_id = 111122223333 sso_role_name = SampleRole region = us-east-1 output = json [sso-session my-sso] sso_region = us-east-1 sso_start_url = https://provided-domain.awsapps.com/start sso_registration_scopes = sso:account:access ``` 如需 SSO 權杖提供者組態中使用的設定詳細資訊，請參閱 AWS SDKs和工具參考指南中的 [SSO 權杖提供者組態](https://docs.aws.amazon.com/sdkref/latest/guide/feature-sso-credentials.html#sso-token-config)。如果您的開發環境未如先前所示設定程式設計存取，請遵循 [ SDKs參考指南中的步驟 2](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html#idcGettingStarted)。 ### 3. 使用登入 AWS CLI 在執行存取的應用程式之前 AWS 服務，您需要作用中的 AWS 存取入口網站工作階段，開發套件才能使用 IAM Identity Center 身分驗證來解析登入資料。在中執行下列命令 AWS CLI ，以登入 AWS 存取入口網站。 ``` aws sso login ``` 由於您有預設的設定檔設定，因此您不需要使用 `--profile` 選項呼叫指令。如果您的 SSO 權杖提供者組態使用已命名的設定檔，則命令為 `aws sso login --profile named-profile`。若要測試您是否已有作用中的工作階段，請執行下列 AWS CLI 命令。 ``` aws sts get-caller-identity ``` 對此命令的回應，應報告共用 `config` 檔案中設定的 IAM Identity Center 帳戶和許可集合。 **注意** 如果您已有作用中的 AWS 存取入口網站工作階段並執行 `aws sso login`，則不需要提供登入資料。不過，您會看到一個對話方塊，請求 `botocore`存取您資訊的許可。 `botocore`是的基礎 AWS CLI 。選取**允許**以授權存取適用於 Java 的 AWS CLI 和開發套件的資訊。 ## 其他身分驗證選項如需 SDK 身分驗證的更多選項，例如使用設定檔和環境變數，請參閱《 AWS SDKs和工具參考指南》中的[組態](https://docs.aws.amazon.com/sdkref/latest/guide/creds-config-files.html)章節。 # 使用建立簡單的應用程式 AWS SDK for Java 2.x 本教學課程說明如何使用 [Apache Maven](https://maven.apache.org/) 定義適用於 Java 的 SDK 2.x 的相依性，然後撰寫連線至的程式碼 Amazon S3 來上傳檔案。請依照下列步驟完成本教學課程： + [步驟 1：設定本教學課程](#get-started-setup) + [步驟 2：建立專案](#get-started-projectsetup) + [步驟 3：撰寫程式碼](#get-started-code) + [步驟 4：建置並執行應用程式](#get-started-run) ## 步驟 1：設定本教學課程在開始本教學課程之前，您需要以下項目： + 存取許可 Amazon S3 + 設定為 AWS 服務使用單一登入存取的 Java 開發環境 AWS IAM Identity Center 使用中的指示[設定概觀](setup.md#setup-overview)來設定本教學課程。使用 Java 開發套件的[單一登入存取設定開發環境](get-started-auth.md#setup-credentials)，並擁有[作用中的 AWS 存取入口網站工作階段](get-started-auth.md#setup-login-sso)後，請繼續本教學課程的步驟 2。 ## 步驟 2：建立專案若要建立本教學課程的專案，請執行 Maven 命令，該命令會提示您輸入如何設定專案。輸入並確認所有輸入後，Maven 會透過建立 `pom.xml`和建立 stub Java 檔案來完成建置專案。 1. 開啟終端機或命令提示視窗，然後導覽至您選擇的目錄，例如您的 `Desktop` 或 `Home` 資料夾。 1. 在終端機輸入下列命令，然後按 `Enter`。 ``` mvn archetype:generate \ -DarchetypeGroupId=software.amazon.awssdk \ -DarchetypeArtifactId=archetype-app-quickstart \ -DarchetypeVersion=2.27.21 ``` 1. 為每個提示輸入第二欄中列出的值。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/sdk-for-java/latest/developer-guide/get-started-tutorial.html) 1. 輸入最後一個值後，Maven 會列出您所做的選擇。輸入來確認，*`Y`*或輸入來重新輸入值*`N`*。 Maven `getstarted`會根據您輸入的`artifactId`值建立名為的專案資料夾。在 `getstarted`資料夾中，尋找您可以檢閱`README.md`的檔案、`pom.xml`檔案和`src`目錄。 Maven 會建置下列目錄樹狀目錄。 ``` getstarted ├── README.md ├── pom.xml └── src ├── main │ ├── java │ │ └── org │ │ └── example │ │ ├── App.java │ │ ├── DependencyFactory.java │ │ └── Handler.java │ └── resources │ └── simplelogger.properties └── test └── java └── org └── example └── HandlerTest.java 10 directories, 7 files ``` 下列顯示 `pom.xml` 專案檔案的內容。 ### `pom.xml` `dependencyManagement` 區段包含的 AWS SDK for Java 2.x 相依性，而 `dependencies`區段具有 Amazon S3 的相依性。由於 `maven.compiler.source` 和 `maven.compiler.target` 屬性中的 `1.8` 值，專案使用 Java 1.8。 ``` 4.0.0 org.example getstarted 1.0-SNAPSHOT jar UTF-8 1.8 1.8 3.2.1 3.6.1

1.6.0

2.27.21 <-------- SDK version picked up from archetype version. 1.7.28 5.8.1 software.amazon.awssdk bom ${aws.java.sdk.version} pom import software.amazon.awssdk s3 <-------- S3 dependency software.amazon.awssdk netty-nio-client software.amazon.awssdk apache-client software.amazon.awssdk sso <-------- Required for identity center authentication. software.amazon.awssdk ssooidc <-------- Required for identity center authentication. software.amazon.awssdk apache-client <-------- HTTP client specified. commons-logging commons-logging org.slf4j slf4j-api ${slf4j.version} org.slf4j slf4j-simple ${slf4j.version} org.slf4j jcl-over-slf4j ${slf4j.version} org.junit.jupiter junit-jupiter ${junit5.version} test org.apache.maven.plugins maven-compiler-plugin ${maven.compiler.plugin.version} ``` ## 步驟 3：撰寫程式碼下列程式碼顯示 Maven 建立的`App`類別。`main` 方法是應用程式的進入點，它會建立 `Handler` 類別的執行個體，然後呼叫其 `sendRequest` 方法。 ### `App` 類別 ``` package org.example; import org.slf4j.Logger; import org.slf4j.LoggerFactory; public class App { private static final Logger logger = LoggerFactory.getLogger(App.class); public static void main(String... args) { logger.info("Application starts"); Handler handler = new Handler(); handler.sendRequest(); logger.info("Application ends"); } } ``` Maven 建立的 `DependencyFactory`類別包含建置和傳回[https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3Client.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3Client.html)執行個體的`s3Client`工廠方法。`S3Client` 執行個體使用 Apache 型 HTTP 用戶端的執行個體。這是因為您在 Maven 提示您使用哪個 HTTP 用戶端時指定了 `apache-client`。 `DependencyFactory` 顯示在下列程式碼中。 ### `DependencyFactory` 類別 ``` package org.example; import software.amazon.awssdk.http.apache.ApacheHttpClient; import software.amazon.awssdk.services.s3.S3Client; /** * The module containing all dependencies required by the {@link Handler}. */ public class DependencyFactory { private DependencyFactory() {} /** * @return an instance of S3Client */ public static S3Client s3Client() { return S3Client.builder() .httpClientBuilder(ApacheHttpClient.builder()) .build(); } } ``` `Handler` 類別包含您程式的主要邏輯。`App` 類別中建立了 `Handler` 的執行個體時，`DependencyFactory` 會提供 `S3Client` 服務用戶端。您的程式碼使用`S3Client`執行個體來呼叫 Amazon S3 服務。 Maven 會產生具有 `TODO` 註解的下列 `Handler` 類別。教學課程的下一個步驟*`TODO`*會以程式碼取代。 ### `Handler` 類別，Maven 產生的 ``` package org.example; import software.amazon.awssdk.services.s3.S3Client; public class Handler { private final S3Client s3Client; public Handler() { s3Client = DependencyFactory.s3Client(); } public void sendRequest() { // TODO: invoking the api calls using s3Client. } } ``` 若要填入邏輯，請使用下列程式碼取代 `Handler` 類別的整個內容。`sendRequest` 方法已填入，並新增必要的匯入。 ### `Handler` 類別，已實作程式碼會先使用產生的最後一個部分名稱建立新的 S3 `System.currentTimeMillis()` 儲存貯體，讓儲存貯體名稱是唯一的。在 `createBucket()`方法中建立儲存貯體後，程式會使用的 [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3Client.html#putObject(software.amazon.awssdk.services.s3.model.PutObjectRequest,software.amazon.awssdk.core.sync.RequestBody)](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3Client.html#putObject(software.amazon.awssdk.services.s3.model.PutObjectRequest,software.amazon.awssdk.core.sync.RequestBody))方法上傳物件`S3Client`。物件的內容是使用 `RequestBody.fromString`方法建立的簡單字串。最後，程式會刪除 `cleanUp`方法中的物件，後面接著儲存貯體。 ``` package org.example; import software.amazon.awssdk.core.sync.RequestBody; import software.amazon.awssdk.services.s3.S3Client; import software.amazon.awssdk.services.s3.model.CreateBucketRequest; import software.amazon.awssdk.services.s3.model.DeleteBucketRequest; import software.amazon.awssdk.services.s3.model.DeleteObjectRequest; import software.amazon.awssdk.services.s3.model.HeadBucketRequest; import software.amazon.awssdk.services.s3.model.PutObjectRequest; import software.amazon.awssdk.services.s3.model.S3Exception; public class Handler { private final S3Client s3Client; public Handler() { s3Client = DependencyFactory.s3Client(); } public void sendRequest() { String bucket = "bucket" + System.currentTimeMillis(); String key = "key"; createBucket(s3Client, bucket); System.out.println("Uploading object..."); s3Client.putObject(PutObjectRequest.builder().bucket(bucket).key(key) .build(), RequestBody.fromString("Testing with the {sdk-java}")); System.out.println("Upload complete"); System.out.printf("%n"); cleanUp(s3Client, bucket, key); System.out.println("Closing the connection to {S3}"); s3Client.close(); System.out.println("Connection closed"); System.out.println("Exiting..."); } public static void createBucket(S3Client s3Client, String bucketName) { try { s3Client.createBucket(CreateBucketRequest .builder() .bucket(bucketName) .build()); System.out.println("Creating bucket: " + bucketName); s3Client.waiter().waitUntilBucketExists(HeadBucketRequest.builder() .bucket(bucketName) .build()); System.out.println(bucketName + " is ready."); System.out.printf("%n"); } catch (S3Exception e) { System.err.println(e.awsErrorDetails().errorMessage()); System.exit(1); } } public static void cleanUp(S3Client s3Client, String bucketName, String keyName) { System.out.println("Cleaning up..."); try { System.out.println("Deleting object: " + keyName); DeleteObjectRequest deleteObjectRequest = DeleteObjectRequest.builder().bucket(bucketName).key(keyName).build(); s3Client.deleteObject(deleteObjectRequest); System.out.println(keyName + " has been deleted."); System.out.println("Deleting bucket: " + bucketName); DeleteBucketRequest deleteBucketRequest = DeleteBucketRequest.builder().bucket(bucketName).build(); s3Client.deleteBucket(deleteBucketRequest); System.out.println(bucketName + " has been deleted."); System.out.printf("%n"); } catch (S3Exception e) { System.err.println(e.awsErrorDetails().errorMessage()); System.exit(1); } System.out.println("Cleanup complete"); System.out.printf("%n"); } } ``` ## 步驟 4：建置並執行應用程式建立專案並包含完整`Handler`類別之後，請建置並執行應用程式。 1. 請確定您有一個作用中的 IAM Identity Center 工作階段。若要這樣做，請執行 AWS Command Line Interface 命令`aws sts get-caller-identity`並檢查回應。如果您沒有作用中的工作階段，請參閱[本節](get-started-auth.md#setup-login-sso)以取得說明。 1. 開啟終端機或命令提示視窗，然後導覽至您的專案目錄 `getstarted`。 1. 使用下列命令來建置您的專案： ``` mvn clean package ``` 1. 使用下列命令來執行應用程式。 ``` mvn exec:java -Dexec.mainClass="org.example.App" ``` 若要檢視程式建立的新儲存貯體和物件，請執行下列步驟。 1. 在中`Handler.java`，註解 `sendRequest`方法`cleanUp(s3Client, bucket, key)`中的行，並儲存檔案。 1. 執行來重建專案`mvn clean package`。 1. 重新執行 `mvn exec:java -Dexec.mainClass="org.example.App"` 以再次上傳文字物件。 1. 登入 [ S3 主控台](https://console.aws.amazon.com/s3/)，在新建立的儲存貯體中檢視新物件。檢視檔案之後，請刪除物件，然後刪除儲存貯體。 ### 成功如果您的 Maven 專案能建置且執行時沒有錯誤，恭喜您！您已成功使用適用於 Java 的 SDK 2.x 建置第一個 Java 應用程式。 ### 清除若要清除您在本教學課程中建立的資源，請執行下列動作： + 如果您尚未這麼做，[請在 S3 主控台](https://console.aws.amazon.com/s3/)中刪除執行應用程式時建立的任何物件和儲存貯體。 + 刪除專案資料夾 (`getstarted`)。 ## 後續步驟現在您已完成基本概念，您可以了解以下內容： + [使用 Amazon S3](examples-s3.md) + [使用其他 Amazon Web Services](work-with-services.md) ，例如 [DynamoDB](examples-dynamodb.md)、 [Amazon EC2](examples-ec2.md)和[各種資料庫服務](examples-databases.md) + [使用 SDK](using.md) + [的安全性適用於 Java 的 AWS SDK](security.md) **