设置 Apache Maven 项目 - Amazon SDK for Java
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

您现在可以通过使用Amazon S3转移管理器(开发人员预览版)中的Amazon SDK for Java2.x 用于加速文件传输。试试吧告诉我们您的想法!顺便说一句,Amazon SDK for Java团队正在招聘软件开发工程师

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

设置 Apache Maven 项目

您可以使用Apache Maven来设置和构建Amazon SDK for Java或构建开发工具包本身。

先决条件

要将Amazon SDK for Java与 Maven 结合使用,您需要以下各项:

创建 Maven 项目

要从命令行创建 Maven 项目,请打开终端或命令提示符窗口,输入或粘贴以下命令,然后按 Enter 或 Return。

mvn -B archetype:generate \ -DarchetypeGroupId=software.amazon.awssdk \ -DarchetypeArtifactId=archetype-lambda -Dservice=s3 -Dregion=US_WEST_2 \ -DgroupId=com.example.myapp \ -DartifactId=myapp
注意

com.example.myapp 替换为您的应用程序的完整程序包命名空间。还可以将 myapp 替换为您的项目名称。这将成为项目的目录的名称。

此命令使用 Amazon Lambda 项目原型创建 Maven 项目。此项目原型预配置为使用 Java SE 8 进行编译,并包括对于Amazon SDK for Java的依赖项。

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

为 Maven 配置 Java 编译器

如果您使用前面所述的 Amazon Lambda 项目原型创建了项目,则已经为您完成此操作。

要验证此配置存在,请首先从执行上一个命令时创建的项目文件夹(例如, myapp)中打开 pom.xml 文件。检查第 11 行和第 12 行以查看此 Maven 项目的 Java 编译器版本设置,以及检查第 71-75 行上是否包含所需的 Maven 编译器插件。

<project> <properties> <maven.compiler.source>1.8</maven.compiler.source> <maven.compiler.target>1.8</maven.compiler.target> </properties> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>${maven.compiler.plugin.version}</version> </plugin> </plugins> </build> </project>

如果您使用不同的原型或使用其他方法创建项目,则必须确保 Maven 编译器插件是构建的一部分,并确保其源属性和目标属性都设置为1.8中的pom.xml文件。

有关一种配置这些必需设置的方法,请参阅上一个代码段。

或者,您可以使用插件声明内联配置编译器配置,如下所示。

<project> <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> </project>

将开发工具包声明为依赖项

使用Amazon SDK for Java在项目中,您需要在项目的中将该工具包声明为依赖项。pom.xml文件。

如果您使用前面所述的项目原型创建了项目,则开发工具包已配置为项目中的依赖项。我们建议您更新此配置以引用Amazon SDK for Java的最新版本。为此,请打开 pom.xml 文件并将 aws.java.sdk.version 属性(在第 16 行上)更改为最新版本。以下是示例。

<project> <properties> <aws.java.sdk.version>2.16.1</aws.java.sdk.version> </properties> </project>

查找最新版本的Amazon SDK for Java中的Amazon SDK for JavaAPI 参考版本 2.x.

如果您以不同的方式创建了 Maven 项目,请通过确保 pom.xml 文件包含以下内容来为项目配置最新版本的开发工具包。

<project> <dependencyManagement> <dependencies> <dependency> <groupId>software.amazon.awssdk</groupId> <artifactId>bom</artifactId> <version>2.X.X</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> </project>
注意

Replace2.X.X中的pom.xml具有有效版本的文件Amazon SDK for Java版本 2。

设置开发工具包模块的依赖项

现在您已配置了开发工具包,您可以为项目中要使用的一个或多个Amazon SDK for Java模块添加依赖项。

尽管您可以为每个组件指定版本号,但无需这样做,因为您已经在 dependencyManagement 部分中声明了开发工具包版本。要加载给定模块的自定义版本,请为其依赖项指定版本号。

如果您使用前面所述的项目原型创建了项目,则您的项目已配置了多个依赖项。其中包括 Lambda 和 Amazon DynamoDB 的依赖项,如下所示。

<project> <dependencies> <dependency> <groupId>software.amazon.awssdk</groupId> <artifactId>dynamodb</artifactId> </dependency> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-lambda-java-core</artifactId> <version>1.2.0</version> </dependency> </dependencies> </project>

将模块添加到您的项目中,以获得Amazon Web Service以及您的项目所需的功能。由Amazon SDK for Java BOM 管理的模块(依赖项)列在 Maven 中央存储库上 (https://mvnrepository.com/artifact/software.amazon.awssdk/bom/latest)。

注意

您可以从代码示例中查看 pom.xml 文件,以确定您的项目需要哪些依赖项。例如,如果您想了解的依赖关系Amazon S3服务,请参阅此示例来自 的Amazon代码示例存储库(位于 GitHub 上)。(寻找pom.xml下的文件文件/java2/example_code/s3。)

将整个开发工具包构建到您的项目中

为了优化您的应用程序,强烈建议您仅拉入所需的组件而不是整个开发工具包。但是,要将整个Amazon SDK for Java构建到您的项目中,请在 pom.xml 文件中声明它,如下所示。

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

重新构建项目。

配置 pom.xml 文件后,您可以使用 Maven 构建您的项目。

要从命令行生成 Maven 项目,请打开终端或命令提示符窗口,导航到项目目录(例如,myapp),输入或粘贴以下命令,然后按 Enter 或 Return。

mvn package

这将在 target 目录(例如, myapp/target)中创建单个 .jar 文件 (JAR)。此 JAR 包含您在 pom.xml 文件中指定为依赖项的所有开发工具包模块。