JAVA中使用OSS存储
JAVA中使用OSS存储
一、为什么要用到OSS存储：
图片和音视频等应用的海量存储：
OSS可用于图片、音视频、日志等海量文件的存储。各种终端设备、Web网站程序、移动应用可以直接向OSS写入或读取数据。OSS支持流式写入和文件写入两种方式。
网页或者移动应用的静态和动态资源分离：
利用BGP带宽，OSS可以实现超低延时的数据直接下载。也可以配合阿里云CDN加速服务，为图片、音视频、移动应用的更新分发提供最佳体验，以及减少服务器本身的压力，让服务器更加的专注于动态资源的加载和处理。
云端数据处理：
上传文件到OSS后，可以配合媒体转码服务(MTS)和图片处理服务（IMG）进行云端的数据处理。
二、如何使用OSS存储(下面以本地OSS存储图片为例)：
阿里云OSS帮助文档：阿里云OSS帮助文档查看
阿里云OSS-JAVA-SDK文档：OSS-JAVA-SDK文档查看
可直接使用OSSImport工具导入文件：ossimport工具导入文件
-
阿里云OSS操作步骤：
1.注册开通阿里云账号2.开通阿里云对象存储 OSS:
3.创建Bucket
自行填写Bucket名称；选择区域（选择离服务区近的区域，这样访问会快一点）；选择存储类型；以及是否需要同城冗余存储（OSS 将您的数据以冗余的方式存储在同一区域（Region）的 3 个可用区（Zone）中。提供机房级容灾能力，需要另外收费 收费明细）
根据需求填写Bucket读写权限，默认私有的，如果是图片，一般是是公共读的；根据情况看是否需要服务端加密以及实时日志查询（免费提供7天内实时日志查询）
4.在刚建的Bucket上新建一个images目录
5.获取记录下 我们待会需要在项目中配置的各种值： -
ENDPOINT值
-
ACCESS_KEY_ID和ACCESS_KEY_SECRET值
概览---->Acess Key---->创建用户---->设置权限
然后选择创建子的Access Key，这样可以保证你账号的安全性以及权限分配，当然你也可以选择"继续使用AccessKey"；
建立好用户后给用户设置权限(本人给了该用户：管理对象存储服务(OSS)权限、只读访问对象存储服务(OSS)权限、管理智能对话分析服务(SCA)的权限、只读访问智能对话分析服务(SCA)的权限)，如果后期需要云服务、云数据、CDN等权限自行新增授权即可；
建立好访问用户以及权限以后就可以得到AccessKey ID和AccessKeySecretl了，把他们记录下来；
6.JAVA中配置阿里云OSS相关文件：
在项目resources下建立一个aliyunoss.properties；然后再配置文件中写入以下配置代码；
#阿里云API的内或外网域名
ENDPOINT=****
#阿里云API的密钥Access Key ID
ACCESS_KEY_ID=****
#阿里云API的密钥Access Key Secret
ACCESS_KEY_SECRET=****
#阿里云API的bucket名称（这是刚刚建的bucket：test-csdn）
BACKET_NAME=****
#阿里云API的文件夹名称 （这个是刚刚创建的文件夹名称、其实OSS并不存在文件夹这一说法）
FOLDER = images/
7.导入相关oss-java-jar包
Maven项目修改pom.xml自动去加载相关包，如果没有使用Maven你可自行下载jar包然后再导入，阿里云OSS-JAVA-SDK相关jar包下载；
以Maven项目为例，在pom.xml中添加配置、以2.8.3版本为例:
<dependency>
<groupId>com.aliyun.oss</groupId>
<artifactId>aliyun-sdk-oss</artifactId>
<version>2.8.3</version>
</dependency>
写一个调用OSS上传图片或者其它文件的工具类：
public class OSSOperationUtil {
// private static Logger logger = Logger.getLogger(OSSOperationUtil.class);
//阿里云API的内或外网域名
private static String ENDPOINT;
//阿里云API的密钥Access Key ID
private static String ACCESS_KEY_ID;
//阿里云API的密钥Access Key Secret
private static String ACCESS_KEY_SECRET;
//阿里云API的bucket名称
private static String BACKET_NAME;
//阿里云API的文件夹名称
private static String FOLDER;
static {
//logger.info("OSS Configuration Loading Begins.");
Properties prop = new Properties();
try {
prop.load(OSSOperationUtil.class.getResourceAsStream("/travel-aliyunoss.properties"));
ENDPOINT = prop.getProperty("ENDPOINT");
ACCESS_KEY_ID = prop.getProperty("ACCESS_KEY_ID");
ACCESS_KEY_SECRET = prop.getProperty("ACCESS_KEY_SECRET");
BACKET_NAME = prop.getProperty("BACKET_NAME");
FOLDER = prop.getProperty("FOLDER");
} catch (Exception e) {
e.printStackTrace();
//logger.error("OSS Configuration Load Failure.");
}
}
/**
* 获取阿里云OSS客户端对象
* @return ossClient
*/
public static OSSClient getOSSClient(){
return new OSSClient(ENDPOINT,ACCESS_KEY_ID, ACCESS_KEY_SECRET);
//怎么获取OSS的客户端：
//ENDPOINT(域名)：http://oss-cn-beijing.aliyuncs.com
//ACCESS_KEY_ID(阿里云API的密钥Access Key)
//ACCESS_KEY_SECRET(阿里云API的密钥Access Secret)
}
private static OSSClient ossClient = getOSSClient();
//获取图片保存路径
public String getFilePath(String moduleName, MultipartFile file)throws BusinessException {
StringBuilder filePath = null;
try {
String originalFilename = file.getOriginalFilename();
filePath = new StringBuilder(128);
filePath.append(moduleName).append("/").append(DateTimes.dayStringOf(new Date(), DateTimes.PATTERN_YYYYMMDD)).append(
"/").append(System.currentTimeMillis()).append("_").append(Global.randomNumbers(2)).
append(".").append(FilenameUtils.getExtension(originalFilename));
}catch (Exception e){
e.printStackTrace();
}finally {
return filePath.toString();
}
}
public String getFilePath2(String moduleName, File file)throws BusinessException {
StringBuilder filePath = null;
try {
String filename = file.getName();
System.out.println(file.getAbsolutePath().toString());
System.out.println(file.getCanonicalPath());
filePath = new StringBuilder(128);
System.out.println(filePath.toString());
}catch (Exception e){
e.printStackTrace();
}finally {
return filePath.toString();
}
}
/**
* 创建存储空间
//* @param ossClient OSS连接
* @param bucketName 存储空间名称
* @return
*/
public static String createBucketName(String bucketName){
//存储空间
final String bucketNames=bucketName;
if(!ossClient.doesBucketExist(bucketName)){
//创建存储空间
Bucket bucket=ossClient.createBucket(bucketName);
return bucket.getName();
}
return bucketNames;
}
/**
* 删除存储空间buckName
//* @param ossClient oss对象
* @param bucketName 存储空间
*/
public static void deleteBucket(String bucketName){
ossClient.deleteBucket(bucketName);
}
/**
* 创建模拟文件夹
//* @param ossClient oss连接
* @param bucketName 存储空间
* @param folder 模拟文件夹名如"qj_nanjing/"
* @return 文件夹名
*/
public static String createFolder(String bucketName,String folder){
//文件夹名
final String keySuffixWithSlash =folder;
//判断文件夹是否存在，不存在则创建
if(!ossClient.doesObjectExist(bucketName, keySuffixWithSlash)){
//创建文件夹
ossClient.putObject(bucketName, keySuffixWithSlash, new ByteArrayInputStream(new byte[0]));
//得到文件夹名
OSSObject object = ossClient.getObject(bucketName, keySuffixWithSlash);
String fileDir=object.getKey();
return fileDir;
}
return keySuffixWithSlash;
}
/**
* 根据key删除OSS服务器上的文件夹
//* @param ossClient oss连接
* @param bucketName 存储空间
* @param folder 模拟文件夹名 如"qj_nanjing/"
* @param key Bucket下的文件的路径名+文件名 如："upload/cake.jpg"
*/
public static void deleteFile(String bucketName, String folder, String key){
ossClient.deleteObject(bucketName, folder + key);
}
/**
* 上传图片至OSS
//* @param ossClient oss连接
* @param file 上传文件（文件全路径如：D:\\image\\cake.jpg）
//* @param bucketName 存储空间
//* @param folder 模拟文件夹名 如"qj_nanjing/"
* @return String 返回的唯一MD5数字签名
* */
public static String uploadObject2OSS(File file,String fileName) {
StringBuilder folder = new StringBuilder(128).append(FOLDER);
//createFolder(BACKET_NAME,folder.toString());//判断是否需要创建一个文件夹
String resultStr = null;
try {
//以输入流的形式上传文件
InputStream is = new FileInputStream(file);
//文件名
//String fileName = file.getName();
//文件大小
Long fileSize = file.length();
//创建上传Object的Metadata
ObjectMetadata metadata = new ObjectMetadata();
//上传的文件的长度
metadata.setContentLength(is.available());
//指定该Object被下载时的网页的缓存行为
metadata.setCacheControl("no-cache");
//指定该Object下设置Header
metadata.setHeader("Pragma", "no-cache");
//指定该Object被下载时的内容编码格式
metadata.setContentEncoding("utf-8");
//文件的MIME，定义文件的类型及网页编码，决定浏览器将以什么形式、什么编码读取文件。如果用户没有指定则根据Key或文件名的扩展名生成，
//如果没有扩展名则填默认值application/octet-stream
metadata.setContentType(getContentType(fileName));
//指定该Object被下载时的名称（指示MINME用户代理如何显示附加的文件，打开或下载，及文件名称）
metadata.setContentDisposition("filename/filesize=" + fileName + "/" + fileSize + "Byte.");
//上传文件 (上传文件流的形式)
PutObjectResult putResult = ossClient.putObject(BACKET_NAME, folder + fileName, is, metadata);
//解析结果
resultStr = putResult.getETag();
} catch (Exception e) {
e.printStackTrace();
//logger.error("上传阿里云OSS服务器异常." + e.getMessage(), e);
}
return resultStr;
}
/**
* 通过文件名判断并获取OSS服务文件上传时文件的contentType
//* @param fileName 文件名
* @return 文件的contentType
*/
public static String getContentType(String fileName){
//文件的后缀名
String fileExtension = fileName.substring(fileName.lastIndexOf("."));
if(".bmp".equalsIgnoreCase(fileExtension)) {
return "image/bmp";
}
if(".gif".equalsIgnoreCase(fileExtension)) {
return "image/gif";
}
if(".jpeg".equalsIgnoreCase(fileExtension) || ".jpg".equalsIgnoreCase(fileExtension) || ".png".equalsIgnoreCase(fileExtension) ) {
return "image/jpeg";
}
if(".html".equalsIgnoreCase(fileExtension)) {
return "text/html";
}
if(".txt".equalsIgnoreCase(fileExtension)) {
return "text/plain";
}
if(".vsd".equalsIgnoreCase(fileExtension)) {
return "application/vnd.visio";
}
if(".ppt".equalsIgnoreCase(fileExtension) || "pptx".equalsIgnoreCase(fileExtension)) {
return "application/vnd.ms-powerpoint";
}
if(".doc".equalsIgnoreCase(fileExtension) || "docx".equalsIgnoreCase(fileExtension)) {
return "application/msword";
}
if(".xml".equalsIgnoreCase(fileExtension)) {
return "text/xml";
}
//默认返回类型
return "image/jpeg";
}
/**
* MultipartFile 转 File
* @param multipartFile
* @throws Exception
*/
public File multipartFileToFile(MultipartFile multipartFile) throws Exception {
File toFile = null;
try {
if(multipartFile.getSize()<=0||multipartFile.isEmpty()){
multipartFile = null;
}else {
InputStream ins = null;
ins = multipartFile.getInputStream();
toFile = new File(multipartFile.getOriginalFilename());
inputStreamToFile(ins, toFile);
ins.close();
}
}catch (Exception e){
e.printStackTrace();
}finally {
return toFile;
}
}
public static void inputStreamToFile(InputStream ins, File file) {
try {
OutputStream os = new FileOutputStream(file);
int bytesRead = 0;
byte[] buffer = new byte[8192];
while ((bytesRead = ins.read(buffer, 0, 8192)) != -1) {
os.write(buffer, 0, bytesRead);
}
os.close();
ins.close();
} catch (Exception e) {
e.printStackTrace();
}
}
}
controller调用(以multipartFile文件为例)：
//制造获取图片路径 规则可自行更改
OSSOperationUtil ossOperationUtil = new OSSOperationUtil();
String filePath = ossOperationUtil.getFilePath("image", multipartFile);
//上传到OSS
File file = null;
try {
//multipartFile 文件转 File
file = ossOperationUtil.multipartFileToFile(multipartFile);
//把图片上传到OSS
ossOperationUtil.uploadObject2OSS(file, filePath);
}catch (Exception e){
e.printStackTrace();
}
图片文件上传成功后即可在OSS控制台查看是否添加成功：
