适用于 Java 的 AWS 开发工具包
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

将开发工具包与 Apache Maven 一起使用

您可以使用 Apache Maven 配置和构建AWS SDK for Java项目或构建开发工具包本身。

注意

您必须安装 Maven 才能使用本主题中的指导信息。如果尚未安装 Maven,请访问 http://maven.apache.org/ 下载并进行安装。

创建新的 Maven 程序包

要创建基本 Maven 程序包,请打开终端(命令行)窗口并运行以下命令。

mvn -B archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DgroupId=org.example.basicapp \ -DartifactId=myapp

org.example.basicapp 替换为您的应用程序的完整程序包命名空间。将 myapp 替换为您的项目名称(这将成为您的项目的目录名称)。

默认情况下,Maven 使用 quickstart 原型为您创建项目模板。这将创建一个 Java 1.5 项目。您必须将您的应用程序更新到 Java 1.8,以便与 AWS SDK for Java 2.0 兼容。要更新到 Java 1.8,请将以下内容添加到 pom.xml 文件。

<build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin> </plugins> </build>

可以通过向 -DarchetypeArtifactId 命令中添加 archetype:generate 参数来选择要使用的特定原型。要跳过步骤以更新 pom.xml 文件,您可以使用以下原型从头开始创建 Java 1.8 项目。

mvn archetype:generate -B \ -DarchetypeGroupId=pl.org.miki \ -DarchetypeArtifactId=java8-quickstart-archetype \ -DarchetypeVersion=1.0.0 \ -DgroupId=com.example \ -DartifactId=sdk-sandbox \ -Dversion=1.0 \ -Dpackage=com.example

还提供了更多原型。请参阅 Maven 原型以获得随 Maven 打包的原型的列表。

注意

有关创建和配置 Maven 项目的更多信息,请参阅 Maven 入门指南

将开发工具包配置为 Maven 依赖项

要在项目中使用AWS SDK for Java,您需要在项目的 pom.xml 文件中将该工具包声明为依赖项。您可以导入单个组件整个开发工具包。强烈建议您仅拉入所需的组件而不是整个开发工具包。

指定单独的开发工具包模块(推荐)

要选择单独的开发工具包模块,请使用 Maven 的AWS SDK for Java材料清单 (BOM)。这将确保您指定的模块使用相同版本的开发工具包,并且它们相互兼容。

要使用 BOM,请向应用程序的 <dependencyManagement> 文件添加 pom.xml 部分。将 bom 作为依赖项添加并指定要使用的开发工具包的版本。

<dependencyManagement> <dependencies> <dependency> <groupId>software.amazon.awssdk</groupId> <artifactId>bom</artifactId> <version>2.3.9</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement>

要查看 Maven Central 中提供的最新版本的AWS SDK for Java BOM,请参阅 https://mvnrepository.com/artifact/software.amazon.awssdk/bom。此页面还显示了由可包含在项目的 <dependencies> 文件的 pom.xml 部分中的 BOM 管理的模块(依赖项)。

现在,可以从开发工具包中选择用于应用程序的单个模块。由于您已经在 BOM 中声明了开发工具包版本,因此无需为每个组件都指定版本号。

<dependencies> <dependency> <groupId>software.amazon.awssdk</groupId> <artifactId>kinesis</artifactId> </dependency> <dependency> <groupId>software.amazon.awssdk</groupId> <artifactId>dynamodb</artifactId> </dependency> </dependencies>

导入所有开发工具包模块(不推荐)

要将整个开发工具包作为依赖项拉入,请不要使用 BOM 方法。只需在 pom.xml 中声明它即可,如下所示。

<dependencies> <dependency> <groupId>software.amazon.awssdk</groupId> <artifactId>aws-java-sdk</artifactId> <version>2.3.9</version> </dependency> </dependencies>

构建项目

在设置项目后,可以使用 Maven 的 package 命令构建它。

mvn package

这会在 .jar 目录中创建 target 文件。