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

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

设置Amazon SDK for Java

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

Prerequisites

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

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

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

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

下载和解压缩开发工具包

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

注意

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

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

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

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

  • documentation-包含 API 文档 (同时在 Web 上提供: Amazon SDK for JavaAPI 参考)。

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

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

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

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

安装开发工具包的旧版本

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

  1. 访问开发工具包的 GitHub 页面: Amazon SDK for Java(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 开发环境

Amazon 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 证书的内置支持,而在Amazon2015 年 9 月 30 日以后,

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

选择 JVM

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

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