AWS Cloud9 不再向新客户提供。 AWS Cloud9 的现有客户可以继续正常使用这项服务。[了解详情](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/) 本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 的 Java 教程 AWS Cloud9 **重要** 如果您使用的 AWS Cloud9 开发环境由具有 2 GiB 或更大内存的 EC2 实例提供支持，我们建议您激活增强型 Java 支持。这提供了对生产率特性的访问，比如代码完成、错误的 linting、特定于上下文的操作，以及调试选项，比如断点和步进。 有关更多信息，请参阅 [增强了对 Java 开发的支持](enhanced-java.md)。 本教程使你能够在 AWS Cloud9 开发环境中运行一些 Java 代码。 按照本教程操作并创建此示例可能会对您的 AWS 账户收费。其中包括可能对 Amazon EC2 和 Amazon S3 等服务收取的费用。有关更多信息，请参阅 [Amazon EC2 定价](https://aws.amazon.com/ec2/pricing/)和 [Amazon S3 定价](https://aws.amazon.com/s3/pricing/)。 **Topics** + [先决条件](#sample-java-prerequisites) + [步骤 1：安装所需工具](#sample-java-install) + [步骤 2：添加代码](#sample-java-code) + [步骤 3：生成并运行代码](#sample-java-run) + [第 4 步：设置为使用 适用于 Java 的 AWS SDK](#sample-java-sdk) + [步骤 5：在您的环境中设置 AWS 凭证管理](#sample-java-sdk-creds) + [第 6 步：添加 AWS SDK 代码](#sample-java-sdk-code) + [第 7 步：生成并运行 S AWS DK 代码](#sample-java-sdk-run) + [步骤 8：清除](#sample-java-clean-up) ## 先决条件 在使用此示例之前，请确保您的设置满足以下要求： + **您必须拥有现有 AWS Cloud9 的 EC2 开发环境。**本示例假设您已经有连接到运行 Amazon Linux 或 Ubuntu Server 的 Amazon EC2 实例的 EC2 环境。如果您有不同类型的环境或操作系统，可能需要按照本示例的说明来设置相关的工具。有关更多信息，请参阅 [在中创建环境 AWS Cloud9](create-environment.md)。 + **您已经打开了现有环境的 AWS Cloud9 IDE。**打开环境时，会在 Web 浏览器中 AWS Cloud9 打开该环境的 IDE。有关更多信息，请参阅 [在中打开环境 AWS Cloud9](open-environment.md)。 ## 步骤 1：安装所需工具 在此步骤中，您将在开发环境中安装一组 Java AWS Cloud9 开发工具。如果您已在环境中安装了一组 Java 开发工具（如 Oracle JDK 或 OpenJDK），则可以向前跳到 [步骤 2：添加代码](#sample-java-code)。此示例是使用 OpenJDK 8 开发的，您可以通过完成以下过程在环境中安装它。 1. 确认是否已安装 OpenJDK 8。为此，在 AWS Cloud9 IDE 的终端会话中，使用**`-version`**选项运行 Java 运行器的命令行版本。（要开始新的终端会话，请在菜单栏上依次选择 **Window（窗口）**> **New Terminal（新建终端）**。） ``` java -version ``` 根据上述命令的输出，执行以下操作之一： + 如果输出说明未找到 `java` 命令，请继续此过程中的步骤 2 来安装 OpenJDK 8。 + 如果输出包含以 `Java(TM)`、`Java Runtime Environment`、`Java SE`、`J2SE` 或 `Java2` 开头的值，则表明未安装 OpenJDK 或未将 OpenJDK 设置为默认 Java 开发工具集。继续此过程中的步骤 2 来安装 OpenJDK 8，然后切换为使用 OpenJDK 8。 + 如果输出包含以 `java version 1.8` 和 `OpenJDK` 开头的值，请向前跳到 [步骤 2：添加代码](#sample-java-code)。已为此示例正确安装 OpenJDK 8。 + 如果输出包含低于 `java version` 的 `1.8` 和以 `OpenJDK` 开头的值，请继续此过程中的步骤 2 来将已安装的 OpenJDK 版本升级到 OpenJDK 8。 1. 确保已安装最新的安全更新和错误修复。为此，请使用 **`update`** 命令运行 yum 工具（适用于 Amazon Linux）或 apt 工具（适用于 Ubuntu Server）。 对于 Amazon Linux： ``` sudo yum -y update ``` 对于 Ubuntu Server： ``` sudo apt update ``` 1. 安装 OpenJDK 8。为此，请使用 **`install`** 命令运行 yum 工具（适用于 Amazon Linux）或 apt 工具（适用于 Ubuntu Server），指定 OpenJDK 8 程序包。 对于 Amazon Linux： ``` sudo yum -y install java-1.8.0-openjdk-devel ``` 对于 Ubuntu Server： ``` sudo apt install -y openjdk-8-jdk ``` 有关更多信息，请参阅 OpenJDK 网站上的[如何下载并安装预先构建的 OpenJDK 程序包](https://openjdk.org/install/)。 1. 将默认的 Java 开发工具集切换或升级到 OpenJDK 8。为此，请运行带 **`--config`** 选项的 **`update-alternatives`** 命令。运行此命令两次来切换或升级 Java 运行程序和编译器的命令行版本。 ``` sudo update-alternatives --config java sudo update-alternatives --config javac ``` 在每个提示符处，键入 OpenJDK 8 的选择编号（包含 `java-1.8` 的那一个）。 1. 确认 Java 运行程序和编译器的命令行版本使用的是 OpenJDK 8。为此，请运行带 `-version` 选项的 Java 运行程序和编译器的命令行版本。 ``` java -version javac -version ``` 如果已正确安装并设置 OpenJDK 8，则 Java 运行程序版本输出会包含以 `openjdk version 1.8` 开头的值，并且 Java 编译器版本输出会以值 `javac 1.8` 开头。 ## 步骤 2：添加代码 在 AWS Cloud9 IDE 中，使用以下代码创建一个文件，然后使用名称保存该文件`hello.java`。（要创建文件，请在菜单栏上依次选择 **File（文件）**、**New File（新建文件）**。要保存文件，请依次选择 **File（文件）**、**Save（保存）**。） ``` public class hello { public static void main(String []args) { System.out.println("Hello, World!"); System.out.println("The sum of 2 and 3 is 5."); int sum = Integer.parseInt(args[0]) + Integer.parseInt(args[1]); System.out.format("The sum of %s and %s is %s.\n", args[0], args[1], Integer.toString(sum)); } } ``` ## 步骤 3：生成并运行代码 1. 使用 Java 编译器的命令行版本将 `hello.java` 文件编译为 `hello.class` 文件。为此，请使用 AWS Cloud9 IDE 中的终端，从`hello.java`文件所在的同一目录中运行 Java 编译器，指定`hello.java`文件。 ``` javac hello.java ``` 1. 使用 Java 运行程序的命令行版本来运行 `hello.class` 文件。为此，请从 `hello.class` 文件所在的相同目录中，运行 Java 运行程序，指定在 `hello` 文件中声明的 `hello.java` 类的名称，并添加两个整数（例如 `5` 和 `9`）。 ``` java hello 5 9 ``` 1. 比较您的输出。 ``` Hello, World! The sum of 2 and 3 is 5. The sum of 5 and 9 is 14. ``` ## 第 4 步：设置为使用 适用于 Java 的 AWS SDK 您可以增强此示例，使用创建 Amazon S3 存储桶，列出您的可用存储桶，然后删除您刚刚创建的存储桶。 适用于 Java 的 AWS SDK 在此步骤中，您将在环境中安装 [Apache Maven](https://maven.apache.org/) 或 [Gradle](https://gradle.org/)。Maven 和 Gradle 是可用于 Java 项目的常见构建自动化系统。在您安装 Maven 或 Gradle 后，您可以使用它来生成新的 Java 项目。在此新项目中，您将添加对 适用于 Java 的 AWS SDK的引用。这 适用于 Java 的 AWS SDK 提供了一种通过您的 Java 代码与 Amazon S3 等 AWS 服务进行交互的便捷方式。 **Topics** + [使用 Maven 设置](#sample-java-sdk-maven) + [使用 Gradle 设置](#sample-java-sdk-gradle) ### 使用 Maven 设置 1. 在环境中安装 Maven。要查看 Maven 是否已安装，请使用 AWS Cloud9 IDE 中的终端运行 Maven 并带有该**`-version`**选项。 ``` mvn -version ``` 如果成功，输出将包含 Maven 版本号。如果已安装 Maven，请向前跳到此过程中的步骤 4 来使用 Maven 在环境中生成新的 Java 项目。 1. 通过使用终端运行以下命令来安装 Maven。 对于 Amazon Linux，以下命令将获取有关 Maven 存储所在的程序包存储库的信息，然后使用此信息来安装 Maven。 ``` sudo wget http://repos.fedorapeople.org/repos/dchen/apache-maven/epel-apache-maven.repo -O /etc/yum.repos.d/epel-apache-maven.repo sudo sed -i s/\$releasever/6/g /etc/yum.repos.d/epel-apache-maven.repo sudo yum install -y apache-maven ``` 有关上述命令的更多信息，请参阅 Fedora 项目 Wiki 网站上的 [Extra Packages for Enterprise Linux (EPEL)](https://docs.fedoraproject.org/en-US/epel/)。 对于 Ubuntu Server，则运行以下命令。 ``` sudo apt install -y maven ``` 1. 带 **`-version`** 选项运行 Maven 以确认安装。 ``` mvn -version ``` 1. 使用 Maven 生成新的 Java 项目。为此，请使用终端从您希望 Maven 在其中生成项目的目录（例如，环境的根目录）中运行以下命令。 ``` mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false ``` 上述命令在环境中为项目创建以下目录结构。 ``` my-app |- src | `- main | `- java | `- com | `- mycompany | `- app | `-App.java |- test | `- java | `- com | `- mycompany | `- app | `- AppTest.java `- pom.xml ``` 有关上述目录结构的更多信息，请参阅 Apache Maven 项目网站上的 [Maven Quickstart 原型](https://maven.apache.org/archetypes/maven-archetype-quickstart/)和[标准目录布局简介](https://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.html)。 1. 修改项目的项目对象模型 (POM) 文件。（POM 文件定义 Maven 项目的设置。） 为此，请从 **Environment（环境）**窗口中打开 `my-app/pom.xml` 文件。在编辑器中，将该文件的当前内容替换为以下代码，然后保存 `pom.xml` 文件。 ``` 4.0.0 com.mycompany.app my-app jar 1.0-SNAPSHOT org.apache.maven.plugins maven-assembly-plugin 3.6.0 jar-with-dependencies com.mycompany.app.App package single junit junit 3.8.1 test com.amazonaws aws-java-sdk 1.11.330 ``` 上述 POM 文件包含指定声明的项目设置，如下所示： + `artifactid` 的 `my-app` 设置将设置项目的根目录名称，`group-id` 的 `com.mycompany.app` 设置将设置 `com/mycompany/app` 子目录结构以及 `package` 和 `App.Java` 文件中的 `AppTest.java` 声明。 + `artifactId` 的 `my-app` 设置、`packaging` 的 `jar` 设置、`version` 的 `1.0-SNAPSHOT` 设置和 `descriptorRef` 的 `jar-with-dependencies` 设置将设置 `my-app-1.0-SNAPSHOT-jar-with-dependencies.jar` 的输出 JAR 文件的名称。 + `plugin` 部分声明将构建单个 JAR，其中包括所有依赖项。 + `groupId`设置为`com.amazon.aws`和设置的`dependency`部分`aws-java-sdk`包括 适用于 Java 的 AWS SDK 库文件。`artifactId`通过 `version` 设置声明要使用的 适用于 Java 的 AWS SDK 版本。要使用其他版本，请替换此版本号。 向前跳至 [步骤 5：在您的环境中设置 AWS 凭证管理](#sample-java-sdk-creds)。 ### 使用 Gradle 设置 1. 在环境中安装 Gradle。要查看 Gradle 是否已安装，请使用 AWS Cloud9 IDE 中的终端运行 Gradle 并带有该**`-version`**选项。 ``` gradle -version ``` 如果成功，输出将包含 Gradle 版本号。如果已安装 Gradle，请向前跳到此过程中的步骤 4 来使用 Gradle 在环境中生成新的 Java 项目。 1. 通过使用终端运行以下命令来安装 Gradle。这些命令安装并运行 SDKMAN\$1 工具，然后使用 SDKMAN\$1 安装最新版本的 Gradle。 ``` curl -s "https://get.sdkman.io" | bash source "$HOME/.sdkman/bin/sdkman-init.sh" sdk install gradle ``` 有关上述命令的更多信息，请参阅 SDKMAN\$1 网站上的[安装](https://sdkman.io/install)以及 Gradle 网站上的[使用包管理器进行安装](https://gradle.org/install/#with-a-package-manager)。 1. 运行带 **`-version`** 选项的 Gradle 以确认安装。 ``` gradle -version ``` 1. 使用 Gradle 在环境中生成新的 Java 项目。为此，请使用终端运行以下命令来为项目创建目录，然后切换到该目录。 ``` mkdir my-app cd my-app ``` 1. 运行以下命令来让 Gradle 在环境中的 `my-app` 目录中生成新的 Java 应用程序项目。 ``` gradle init --type java-application ``` 上述命令在环境中为项目创建以下目录结构。 ``` my-app |- .gradle | `- (various supporting project folders and files) |- gradle | `- (various supporting project folders and files) |- src | |- main | | `- java | | `- App.java | `- test | `- java | `- AppTest.java |- build.gradle |- gradlew |- gradlew.bat `- settings.gradle ``` 1. 修改项目的 `AppTest.java`。（如果不这样做，则项目可能不会按预期方式构建或运行。） 为此，请从 **Environment（环境）**窗口中打开 `my-app/src/test/java/AppTest.java` 文件。在编辑器中，将该文件的当前内容替换为以下代码，然后保存 `AppTest.java` 文件。 ``` import org.junit.Test; import static org.junit.Assert.*; public class AppTest { @Test public void testAppExists () { try { Class.forName("com.mycompany.app.App"); } catch (ClassNotFoundException e) { fail("Should have a class named App."); } } } ``` 1. 修改项目的 `build.gradle` 文件。（`build.gradle` 文件定义 Gradle 项目的设置。） 为此，请从 **Environment（环境）**窗口中打开 `my-app/build.gradle` 文件。在编辑器中，将该文件的当前内容替换为以下代码，然后保存 `build.gradle` 文件。 ``` apply plugin: 'java' apply plugin: 'application' repositories { jcenter() mavenCentral() } buildscript { repositories { mavenCentral() } dependencies { classpath "io.spring.gradle:dependency-management-plugin:1.0.3.RELEASE" } } apply plugin: "io.spring.dependency-management" dependencyManagement { imports { mavenBom 'com.amazonaws:aws-java-sdk-bom:1.11.330' } } dependencies { compile 'com.amazonaws:aws-java-sdk-s3' testCompile group: 'junit', name: 'junit', version: '4.12' } run { if (project.hasProperty("appArgs")) { args Eval.me(appArgs) } } mainClassName = 'App' ``` 上述 `build.gradle` 文件包含指定声明的项目设置，如下所示： + 该`io.spring.dependency-management`插件用于导入 适用于 Java 的 AWS SDK Maven 物料清单 (BOM)，以管理项目的 适用于 Java 的 AWS SDK 依赖关系。 `classpath`声明要使用的版本。要使用其他版本，请替换此版本号。 + `com.amazonaws:aws-java-sdk-s3` 包含 适用于 Java 的 AWS SDK 库文件的 Amazon S3 部分。`mavenBom` 声明要使用的版本。如果您希望使用其他版本，请替换此版本号。 ## 步骤 5：在您的环境中设置 AWS 凭证管理 每次使用调 适用于 Java 的 AWS SDK 用 AWS 服务时，都必须为呼叫提供一组 AWS 凭据。这些证书决定了是否 适用于 Java 的 AWS SDK 具有进行该呼叫的相应权限。如果凭证没有包括合适的权限，调用将失败。 在此步骤中，您将凭证存储在环境内。为此，请按照 [AWS 服务 从中的环境中呼叫 AWS Cloud9](credentials.md) 中的说明操作，然后返回到本主题。 有关其他信息，请参阅 *适用于 Java 的 AWS SDK 开发人员指南*中的[设置用于开发的 AWS 凭证和区域](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/setup.html#setup-credentials)。 ## 第 6 步：添加 AWS SDK 代码 在此步骤中，您添加用于与 Amazon S3 交互的代码，以创建存储桶，列出可用的存储桶，然后删除刚刚创建的存储桶。 从 **Environment（环境）**窗口中，打开 `my-app/src/main/java/com/mycompany/app/App.java` 文件（适用于 Maven）或 `my-app/src/main/java/App.java` 文件（适用于 Gradle）。在编辑器中，将该文件的当前内容替换为以下代码，然后保存 `App.java` 文件。 ``` package com.mycompany.app; import com.amazonaws.auth.profile.ProfileCredentialsProvider; import com.amazonaws.services.s3.AmazonS3; import com.amazonaws.services.s3.AmazonS3ClientBuilder; import com.amazonaws.services.s3.model.AmazonS3Exception; import com.amazonaws.services.s3.model.Bucket; import com.amazonaws.services.s3.model.CreateBucketRequest; import java.util.List; public class App { private static AmazonS3 s3; public static void main(String[] args) { if (args.length < 2) { System.out.format("Usage: \n" + "Example: my-test-bucket us-east-2\n"); return; } String bucket_name = args[0]; String region = args[1]; s3 = AmazonS3ClientBuilder.standard() .withCredentials(new ProfileCredentialsProvider()) .withRegion(region) .build(); // List current buckets. ListMyBuckets(); // Create the bucket. if (s3.doesBucketExistV2(bucket_name)) { System.out.format("\nCannot create the bucket. \n" + "A bucket named '%s' already exists.", bucket_name); return; } else { try { System.out.format("\nCreating a new bucket named '%s'...\n\n", bucket_name); s3.createBucket(new CreateBucketRequest(bucket_name, region)); } catch (AmazonS3Exception e) { System.err.println(e.getErrorMessage()); } } // Confirm that the bucket was created. ListMyBuckets(); // Delete the bucket. try { System.out.format("\nDeleting the bucket named '%s'...\n\n", bucket_name); s3.deleteBucket(bucket_name); } catch (AmazonS3Exception e) { System.err.println(e.getErrorMessage()); } // Confirm that the bucket was deleted. ListMyBuckets(); } private static void ListMyBuckets() { List buckets = s3.listBuckets(); System.out.println("My buckets now are:"); for (Bucket b : buckets) { System.out.println(b.getName()); } } } ``` ## 第 7 步：生成并运行 S AWS DK 代码 要运行上一步中的代码，请从终端中运行以下命令。这些命令使用 Maven 或 Gradle 为项目创建可执行的 JAR 文件，然后使用 Java 运行程序来运行 JAR。JAR 运行时使用要在 Amazon S3 中创建的存储桶的名称（例如`my-test-bucket`）和要在其中创建存储桶的 AWS 区域 ID 作为输入（例如`us-east-2`）。 对于 Maven，运行以下命令。 ``` cd my-app mvn package java -cp target/my-app-1.0-SNAPSHOT-jar-with-dependencies.jar com.mycompany.app.App my-test-bucket us-east-2 ``` 对于 Gradle，运行以下命令。 ``` gradle build gradle run -PappArgs="['my-test-bucket', 'us-east-2']" ``` 将结果与以下输出进行比较。 ``` My buckets now are: Creating a new bucket named 'my-test-bucket'... My buckets now are: my-test-bucket Deleting the bucket named 'my-test-bucket'... My buckets now are: ``` ## 步骤 8：清除 为了防止在您使用完此示例后继续向您的 AWS 账户收费，您应该删除该环境。有关说明，请参阅[删除中的环境 AWS Cloud9](delete-environment.md)。