排查问题过程中,很多时候需要测试下代码是否能正常的运行,而运行代码需要一个搭建好的运行环境,下面介绍下如何利用 MAVEN 在 Eclipse 来搭建运行 OSS JAVA SDK 的简单运行环境,即是完全不懂 java 的同学,也可以轻松使用 SDK 来完成简单的操作与测试。
java安装包的下载与安装
-
java 安装包可以在 java 官网下载首页下载最新的安装包,或者直接点击这里下载可以看到目前最新的是 1.8 版本的,java sdk 要求 java 环境是1.6以上的。
下载好之后,核对 md5 值,然后默认一步一步点击安装即可,默认安装位置是
C:\Program Files\Java\jdk1.8.0_161
安装好之后需要配置下环境变量官方文档说明在系统环境中配置 PATH 变量即可,不过根据经验建议增加配置 JAVA_HOME 和 CLASSPATH 变量,并且在 PATH 变量中添加路径,以上面下载的安装包为例,配置如下
变量名 | 变量值 |
---|---|
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 的下载与安装
- Eclipse 下载可以到官网的下载页面,有2中安装方式,直接下载 .exe 文件安装或者下载压缩包后进行非侵入式的安装。如果电脑环境下没有 java 环境,安装的时候会报错,需要配置 java 环境
- 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>
-
打开安装好的 Eclipse 程序,打开 window ---> Preferences 配置 Maven 的全局配置
-
检查配置的镜像是否生效,打开 windows ---> show View ---> other ---> Maven ---> Maven Repositories
如果 Global Repositories 中配置入上图,说明配置成功
在 Eclipse 中创建并且配置 Maven 项目
-
创建 Maven 项目,打开 File ---> new ---> Other 选择 Maven Project
完成之后可以看到右侧有一系列的文件
修改 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>
-
安装 SDK. 一般会自动安装,如果没有的话,可以点击安装下
安装完成之后,可以看到多出来一个 Maven Dependencies 的文件,安装的包可以在这里找到
-
创建类,并测试SDK是否正常
例如找一个文件上传的例子
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成功。");
}
}