使用java开发阿里云OSS开放云存储服务

时间:2024-04-01 09:56:52

购买了阿里云后,我们发现一般ECS的存储空间都比较小,当然我们可以动态的扩展一些存储空间。但是作为开发者,我们在日常使用中需要一些更大的灵活性,因此就需要我们自己对OSS存储有一些自己的扩展。今天就为大家分享一下如何使用java来对接阿里云的OSS存储服务。

OSS产品概述

阿里云对象存储服务(Object Storage Service,简称 OSS),是阿里云提供的海量、安全、低成本、高可靠的云存储服务。您可以通过调用 API,在任何应用、任何时间、任何地点上传和下载数据,也可以通过 Web 控制台对数据进行简单的管理。OSS 适合存放任意类型的文件,适合各种网站、开发企业及开发者使用。

开通阿里云OSS服务

首先要登录阿里云官网,然后选择产品——>存储于CDN——>对象存储 OSS。如下图:

使用java开发阿里云OSS开放云存储服务

然后我们可以根据自己的情况进行开通。开通完成后,我们就可以进入OSS控制台了。

OSS 控制台

OSS控制台布局包括bucket列表,bucket所在地域,创建时间和对于bucket操作。bucket这个概念用比较通俗的说法,就是用户创建的顶层目录,所有用户上传的文件都必须存在bucket下面,而且bucket在OSS系统中是不能重名的。如果已经有一个用户创建了bucket名称叫abc,那么很遗憾,您就不能创建一个名称叫abc的bucket了,每个用户可以创建10个bucket。注意红圈标注的ACCESSKEY管理按钮,点击后可以进行ACCESSKEY管理界面。

使用java开发阿里云OSS开放云存储服务

进入后点击显示,可以看到秘钥,AccesskeyId&AccessKeySecret 的使用方法请见OSS API文档
点击具体bucket,进入bucket 管理功能,包括bucket属性设置、object管理等。

使用java开发阿里云OSS开放云存储服务

创建Bucket

如果你还没有创建bucket,点击新建bucket。

使用java开发阿里云OSS开放云存储服务

进入新建Bucket页面,并填写Bucket信息

使用java开发阿里云OSS开放云存储服务

填写Bucket名称,选择所属地域,设置读写权限。 在填写完bucket信息后点击提交,创建bucket。

上传文件

点击红圈标注的上传文件,会弹出文件框列表,选择需要上传的文件进行上传。

使用java开发阿里云OSS开放云存储服务

分享文件

点击对应文件的获取地址,会弹出一个object 地址信息,其中地址链接可以是在公网访问到的。别人点击这个链接就可以下载到这个文件了,但是亲这可是要注意会产生流量费用的。

使用java开发阿里云OSS开放云存储服务

注意:如你的OSS Bucket未绑定域名,则你访问文件链接后默认为下载该文件,而不能直接浏览该文件。

java开发OSS存储服务

开通OSS服务器后,会有endpoint,跟地址;accessKeyId,类似用户名;accessKeySecret,类似密码;buketName:第一层文件夹的名字,一个用户可以创建十个bucketName,类似于我们的C,D,E,F盘符;accessUrl,很明显用户可以通过浏览器访问的地址。例如我们上传一个html文件,我们就可以通过"accessUrl/bucketName/目录/文件名.html,来进行访问。我在这里负责一个是页面静态化的功能,将动态的JSP页面生成静态的html页面,然后上传的OSS服务器,返回地址,让用户直接访问静态页面,这样就大大加快访问的速度。
OSS信息实体类,OSSConfigure.Java:
import java.io.IOException;
import java.util.Properties;

public class OSSConfigure {

	private String endpoint;
	private String accessKeyId;
	private String accessKeySecret;
	private String bucketName;
	private String accessUrl;

	public OSSConfigure() {

	}

	/**
	 * 通过配置文件.properties文件获取,这几项内容。
	 * @param storageConfName
	 * @throws IOException
	 */
	public OSSConfigure(String storageConfName) throws IOException {

		Properties prop = new Properties();
		prop.load(this.getClass().getClassLoader()
				.getResourceAsStream("conf/" + storageConfName));

		endpoint = prop.getProperty("endpoint").trim();
		accessKeyId = prop.getProperty("accessKeyId").trim();
		accessKeySecret = prop.getProperty("accessKeySecret").trim();
		bucketName = prop.getProperty("bucketName").trim();
		accessUrl = prop.getProperty("accessUrl").trim();

	}

	public OSSConfigure(String endpoint, String accessKeyId,
			String accessKeySecret, String bucketName, String accessUrl) {

		this.endpoint = endpoint;
		this.accessKeyId = accessKeyId;
		this.accessKeySecret = accessKeySecret;
		this.bucketName = bucketName;
		this.accessUrl = accessUrl;
	}

	public String getEndpoint() {
		return endpoint;
	}

	public void setEndpoint(String endpoint) {
		this.endpoint = endpoint;
	}

	public String getAccessKeyId() {
		return accessKeyId;
	}

	public void setAccessKeyId(String accessKeyId) {
		this.accessKeyId = accessKeyId;
	}

	public String getAccessKeySecret() {
		return accessKeySecret;
	}

	public void setAccessKeySecret(String accessKeySecret) {
		this.accessKeySecret = accessKeySecret;
	}

	public String getBucketName() {
		return bucketName;
	}

	public void setBucketName(String bucketName) {
		this.bucketName = bucketName;
	}

	public String getAccessUrl() {
		return accessUrl;
	}

	public void setAccessUrl(String accessUrl) {
		this.accessUrl = accessUrl;
	}

}
然后再创建一个工具类,这里需要提出的OSS服务器,上所有的都是对象,没有文件夹的概念,上传文件,直接写好路劲,他会自动创建。这里有一个入口OSSClient,很多方法都是通过它来实现的。
import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.InputStream;

import org.springframework.web.multipart.MultipartFile;

import com.aliyun.oss.OSSClient;
import com.aliyun.oss.model.ObjectListing;
import com.aliyun.oss.model.ObjectMetadata;

/**
 * 对OSS服务器进行上传删除等的处理
 *
 */
public class OSSManageUtil {
	/**
	 * 上传OSS服务器文件
	* @Title: uploadFile 
	* @Description: 
	* @param @param ossConfigure
	* @param @param file
	* @param @param remotePath
	* @param @return
	* @param @throws Exception    设定文件 
	* @return String    返回类型 
	* @throws
	 */
	public static String uploadFile(OSSConfigure ossConfigure,File file,String remotePath) throws Exception{
		InputStream fileContent=null;
		fileContent=new FileInputStream(file);
		
		OSSClient ossClient=new OSSClient(ossConfigure.getEndpoint(), ossConfigure.getAccessKeyId(), ossConfigure.getAccessKeySecret());
		 String remoteFilePath = remotePath.substring(0, remotePath.length()).replaceAll("\\\\","/")+"/";
		//创建上传Object的Metadata
		ObjectMetadata objectMetadata=new ObjectMetadata();
		objectMetadata.setContentLength(fileContent.available());
		objectMetadata.setCacheControl("no-cache");
		objectMetadata.setHeader("Pragma", "no-cache");
		objectMetadata.setContentType(contentType(file.getName().substring(file.getName().lastIndexOf("."))));
		objectMetadata.setContentDisposition("inline;filename=" + file.getName());
		//上传文件
		ossClient.putObject(ossConfigure.getBucketName(), remoteFilePath + file.getName(), fileContent, objectMetadata);
		System.out.println(ossConfigure.getAccessUrl()+"/" +remoteFilePath + file.getName());
		return ossConfigure.getAccessUrl()+"/" +remoteFilePath + file.getName();
	}
	
	
	/**
	 * 根据key删除OSS服务器上的文件
	* @Title: deleteFile 
	* @Description: 
	* @param @param ossConfigure
	* @param @param filePath    设定文件 
	* @return void    返回类型 
	* @throws
	 */
	public static void deleteFile(OSSConfigure ossConfigure,String filePath){
		OSSClient ossClient = new OSSClient(ossConfigure.getEndpoint(),ossConfigure.getAccessKeyId(), ossConfigure.getAccessKeySecret());
		ossClient.deleteObject(ossConfigure.getBucketName(), filePath);
		
	}
	
   /**
     * Description: 判断OSS服务文件上传时文件的contentType
     * @Version1.0
     * @param FilenameExtension 文件后缀
     * @return String 
     */
	 public static String contentType(String FilenameExtension){
		if(FilenameExtension.equals("BMP")||FilenameExtension.equals("bmp")){return "image/bmp";}
		if(FilenameExtension.equals("GIF")||FilenameExtension.equals("gif")){return "image/gif";}
		if(FilenameExtension.equals("JPEG")||FilenameExtension.equals("jpeg")||
		   FilenameExtension.equals("JPG")||FilenameExtension.equals("jpg")||	
		   FilenameExtension.equals("PNG")||FilenameExtension.equals("png")){return "image/jpeg";}
		if(FilenameExtension.equals("HTML")||FilenameExtension.equals("html")){return "text/html";}
		if(FilenameExtension.equals("TXT")||FilenameExtension.equals("txt")){return "text/plain";}
		if(FilenameExtension.equals("VSD")||FilenameExtension.equals("vsd")){return "application/vnd.visio";}
		if(FilenameExtension.equals("PPTX")||FilenameExtension.equals("pptx")||
			FilenameExtension.equals("PPT")||FilenameExtension.equals("ppt")){return "application/vnd.ms-powerpoint";}
		if(FilenameExtension.equals("DOCX")||FilenameExtension.equals("docx")||
			FilenameExtension.equals("DOC")||FilenameExtension.equals("doc")){return "application/msword";}
		if(FilenameExtension.equals("XML")||FilenameExtension.equals("xml")){return "text/xml";}
		return "text/html";
	 }
}
好了,到这里OSS的简单开发就已经完成了。由于时间关系,我这里就写到这里,万事开头难,你对OSS有了简单的认识后。官网剩下的一堆api对你来说都是小菜。下面我在说一下在使用过程中遇到的问题和解决方案。

使用OSS存储服务遇到的问题和解决方案

ECS服务器被清洗

当服务器流量达到用户云盾设置的清洗阈值时,会自动进入流量清洗。
请注意,由于安全策略无法做到100%识别请求是否恶意,所以服务器被清洗后可能会有低概率的误杀存在,但绝大部分情况下正常请求不会受到影响,如果怀疑有误杀可提交工单由售后支持协助判断。

不同帐号下ECS服务器内网不通

默认情况下,不同帐号下的服务器内网是不通的。如果用户同时有多个帐号,并且多个帐号下都有服务器,那么这些服务器内网是不通的。如果需要不同帐号下内网互通,需要提交工单联系售后,阿里云售后工程师会协助打通内网。
请注意,需要内网打通的不同的帐号需要全部提交工单,说明哪些IP和哪些IP进行内网互通,或者帐号下所有服务器内网互通。并且在每一个工单中,都把已经提交的内网互通的工单号列出来(自身的工单号除外),以便阿里云售后工程师进行安全验证。

OSS内存泄漏

如果你遇到OSS内存泄漏问题,首先检查检查你的代码,肯定是某些该关闭IO流没有关闭。如果不能及时解决,可以提交工单,联系客服。

oss的callback返回的数据格式非JSON格式

可能是应用服务器处理过程中抛了异常,导致没有按照预期返回给OSS,而是返回了一些栈信息等,就可能会导致非JSON格式的数据产生。

OSS 返回的状态不为200

400或者其他的status比如404/403等是指应用服务器返回给oss的http是400或者404/403等,正常情况下应用服务器必须返回200给OSS。502是由于应用服务器根本就没有起web服务,没有监听OSS发过来的回调请求。