将开发工具包与 Apache Maven 一起使用 - Amazon SDK for Java
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

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

您可以使用 Apache Maven 配置和构建Amazon 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 原型以获得随打包的原型的列表。可以通过向 -DarchetypeArtifactId 命令中添加 archetype:generate 参数来选择要使用的特定原型。例如:

mvn archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DarchetypeArtifactId=maven-archetype-webapp \ -DgroupId=org.example.webapp \ -DartifactId=mywebapp
注意

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

要在项目中使用 Amazon SDK for Java,您需要在项目的 pom.xml 文件中将该工具包声明为依赖项。从 1.9.0 版开始,可以导入单个组件整个开发工具包

指定单独的开发工具包模块

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

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

<dependencyManagement> <dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk-bom</artifactId> <version>1.11.1000</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement>

要查看 Maven Central 中提供的最新版本的Amazon SDK for Java BOM,请访问:https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom。您也可以使用此页查看项目 pom.xml 文件的 <dependencies> 部分中包括的 BOM 管理了哪些模块(依赖项)。

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

<dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk-s3</artifactId> </dependency> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk-dynamodb</artifactId> </dependency> </dependencies>

您还可以参考 Amazon 代码示例目录 了解要用于给定的依赖关系Amazon Web Service. 请参阅特定的服务示例下的 POM 文件。例如,如果您想了解AmazonS3 服务,请参阅完整示例(位于 GitHub 上)。(查看 /java/example_code/s3 下的 pom)。

导入所有开发工具包模块

如果您想将整个开发工具包作为一个依赖项拉入,请勿使用 BOM 方法,而只需在 pom.xml 中声明该开发工具包,如下所示:

<dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk</artifactId> <version>1.11.1000</version> </dependency> </dependencies>

重新构建项目。

在设置项目之后,可以使用 Maven 的 package 命令进行构建:

mvn package

这会在 –0—jar 目录中创建 target 文件。

使用 Maven 构建开发工具包

可以使用 Apache Maven 从源构建开发工具包。为此,请从 GitHub 下载开发工具包代码,在本地解压缩,然后执行下面的 Maven 命令:

mvn clean install