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

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

设置AWS SDK for Java

说明如何在您的项目中使用 AWS SDK for Java。

Prerequisites

要使用 AWS SDK for Java,必须拥有:

在您的项目中包括开发工具包

要在项目中包括开发工具包,根据您的编译系统或 IDE 使用以下方法之一:

如果您使用上述方法之一(例如,您使用的是 Maven),则无需下载并安装 AWS JAR 文件(您可以跳过以下部分)。如果要使用不同 IDE、使用 Apache Ant 或任何其他方法构建项目,请按照下一节中的说明下载并提取开发工具包。

下载和解压缩开发工具包

我们建议您为新项目使用预建的最新开发工具包版本,从而针对所有 AWS 服务为您提供最新支持。

注意

有关如何下载和构建开发工具包旧版本的信息,请参阅安装开发工具包的旧版本

下载和提取开发工具包的最新版本

  1. 从 https://sdk-for-java.amazonwebservices.com/latest/aws-java-sdk.zip 下载开发工具包。

  2. 下载开发工具包之后,将内容提取到本地目录中。

开发工具包包含以下目录:

  • documentation – 包含 API 文档(同时在 Web 上提供:适用于 Java 的 AWS 开发工具包 API 参考)。

  • lib– 包含开发工具包 .jar 文件。

  • samples– 包含说明如何使用开发工具包的实用示例代码。

  • third-party/lib– 包含开发工具包使用的第三方库,例如 Apache Commons 日志记录、AspectJ 和 Spring 框架。

要使用开发工具包,将完整路径添加到 lib,并将 third-party 目录添加到编译文件中的依赖项,然后将它们添加到 java CLASSPATH 以运行代码。

安装开发工具包的旧版本

预建表单中仅提供开发工具包的最新版本。不过,可使用 Apache Maven (开源) 构建开发工具包的旧版本。Maven 将一步完成下载所有必需的依赖项、构建和安装开发工具包。有关安装说明和更多信息,请访问 http://maven.apache.org/

要安装开发工具包的旧版本

  1. 转到开发工具包的 GitHub 页面: 适用于 Java 的 AWS 开发工具包 (GitHub)

  2. 选择与所需开发工具包的版本号对应的标签。例如:1.6.10

  3. 单击 Download Zip 按钮下载选择的开发工具包版本。

  4. 将文件解压缩到开发系统中的一个目录中。在很多系统中,可使用自己的图形文件管理器执行该操作,或在终端窗口中使用 unzip 实用程序。

  5. 在终端窗口中,导航到将开发工具包源文件解压缩的目录。

  6. 使用以下命令构建并安装开发工具包 (Maven 需要):

    mvn clean install

    生成的 .jar 文件会构建到 target 目录中。

  7. (可选) 使用以下命令构建 API 参考文档:

    mvn javadoc:javadoc

    该文档构建到 target/site/apidocs/ 目录中。

安装 Java 开发环境

AWS SDK for Java要求使用 J2SE Development Kit 6.0 或更高版本。可以从 http://www.oracle.com/technetwork/java/javase/downloads/ 下载最新的 Java 软件。

重要

Java 版本 1.6 (JS2E 6.0) 中没有 SHA256 签名的 SSL 证书的内置支持,而在 2015 年 9 月 30 日以后,与 AWS 的所有 HTTPS 连接都需要该功能。

Java 版本 1.7 或更高版本包含已更新证书,不受这一问题的影响。

选择 JVM

为了让使用适用于 Java 的 AWS 开发工具包的基于服务器的应用程序获得最佳性能,我们建议您使用 Java 虚拟机 (JVM) 的 64 位版本。此 JVM 仅在服务器模式下运行,即使在运行时指定了 -Client 选项也是如此。

在运行时将 JVM 的 32 位版本与 -Server 选项一起使用应可以提供与 64 位 JVM 相当的性能。