阿里云 Java SDK 环境搭建

排查问题过程中，很多时候需要测试下代码是否能正常的运行，而运行代码需要一个搭建好的运行环境，下面介绍下如何利用 MAVEN 在 Eclipse 来搭建运行 OSS JAVA SDK 的简单运行环境，即是完全不懂 java 的同学，也可以轻松使用 SDK 来完成简单的操作与测试。

java安装包的下载与安装

1. java 安装包可以在 java 官网下载首页下载最新的安装包，或者直接点击这里下载可以看到目前最新的是 1.8 版本的，java sdk 要求 java 环境是1.6以上的。
   

   undefined

2. 下载好之后，核对 md5 值，然后默认一步一步点击安装即可，默认安装位置是 C:\Program Files\Java\jdk1.8.0_161 安装好之后需要配置下环境变量

3. 官方文档说明在系统环境中配置 PATH 变量即可，不过根据经验建议增加配置 JAVA_HOME 和 CLASSPATH 变量，并且在 PATH 变量中添加路径，以上面下载的安装包为例，配置如下

undefined

变量名	变量值
JAVA_HOME	C:\Program Files\Java\jdk1.8.0_161
CLASSPATH	.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar
PATH	%JAVA_HOME%\bin;

Eclipse 和 Maven 的下载与安装

1. Eclipse 下载可以到官网的下载页面，有2中安装方式，直接下载 .exe 文件安装或者下载压缩包后进行非侵入式的安装。如果电脑环境下没有 java 环境，安装的时候会报错，需要配置 java 环境
   undefined
2. Maven 下载可以到 maven 官网的下载页面下载。解压后修改 conf 目录下的 setting.xml 文件，建议配置下国内的镜像，下载或更新 sdk 包的时候会比较快，这里使用的配置如下

  <mirrors>
    <mirror>
      <id>alimaven</id>
      <mirrorOf>central</mirrorOf>
      <name>aliyun maven</name>
      <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
    </mirror>
  </mirrors>

3. 打开安装好的 Eclipse 程序，打开 window ---> Preferences 配置 Maven 的全局配置

   
   undefined
   undefined

4. 检查配置的镜像是否生效，打开 windows ---> show View ---> other ---> Maven ---> Maven Repositories

   
   undefined
   undefined
   

   如果 Global Repositories 中配置入上图，说明配置成功

在 Eclipse 中创建并且配置 Maven 项目

1. 创建 Maven 项目，打开 File ---> new ---> Other 选择 Maven Project

   
   undefined
   undefined
   

   完成之后可以看到右侧有一系列的文件

2. 修改 pom.xml 文件配置，在这里可以按照官网的地址添加依赖项了，例如 OSS 和 MTS 的 JAVA SDK 添加方式参考。第一次添加的话，需要一个 dependencies 标签。

<dependencies>
    <dependency>
        <groupId>com.aliyun.oss</groupId>
        <artifactId>aliyun-sdk-oss</artifactId>
        <version>2.8.2</version>
    </dependency>
    
    <dependency>
        <groupId>com.aliyun</groupId>
        <artifactId>aliyun-java-sdk-mts</artifactId>
        <version>2.1.7</version>
    </dependency>
</dependencies>

3. 安装 SDK. 一般会自动安装，如果没有的话，可以点击安装下

   
   undefined
   

   安装完成之后，可以看到多出来一个 Maven Dependencies 的文件，安装的包可以在这里找到

   
   undefined

4. 创建类，并测试SDK是否正常

   
   undefined
   

   例如找一个文件上传的例子

import com.aliyun.oss.OSSClient;
import java.io.File;

public class demo1 {
    private static String endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    private static String accessKeyId = "<accessKeyId>";
    private static String accessKeySecret = "<accessKeySecret>";
    private static String bucketName = "<BucketName>";
    public static void main(String[] args) {
        OSSClient ossClient = new OSSClient(endpoint, accessKeyId, accessKeySecret);
        ossClient.putObject(bucketName, "<objectname>", new File("localFile"));
        System.out.println("Object存入OSS成功。");
    }
}