文件存储服务

更新时间:2015/09/18 访问次数:14275

文件存储服务简介

TAE文件存储服务采用阿里云开放存储服务(Open Storage Service,简称OSS)来支持任意数据类型的存储,支持任意时间、地点的数据上传和下载。OSS中每个存储对象(object)由名称、内容、描述三部分组成。通过OSS可以获得更稳定更安全的存储服务,使开发大容量和高并发系统变得更容易。

文件存储服务API

本节对文件存储服务API的使用方式进行介绍。关于详细的API说明,请 参考Java Doc

引入服务包

获取文件存储服务对象

import com.alibaba.appengine.api.store.StoreService;
import com.alibaba.appengine.api.store.StoreServiceFactory;
StoreService storeService = StoreServiceFactory.getStoreService(alias);
使用StoreServiceFactory的带参getStoreService (String alias)方法获取的storeService。其中,在TAE控制台中,通过工作站->FileStore->实例名称获取alias

storeService.saveTextFile(content, path) 方法

/**
 * 将文本内容保存到指定路径的文件中(使用编码 UTF-8)。
 * 文件的父目录如果没有,会自动创建。
 * @param content 文本内容
 * @param path    文件全路径
 * @throws StoreException       保存失败,比如网络问题
 * @throws NullPointerException 参数为null
 */
 void saveTextFile(String content, String path);

storeService.saveTextFile(content, encoding, path) 方法

/**
 * 将文本内容保存到指定路径的文件中。
 * 文件的父目录如果没有,会自动创建。
 * @param content  文本内容
 * @param encoding 字符编码
 * @param path     文件全路径
 * @throws StoreException       保存失败,比如网络问题
 * @throws NullPointerException 参数为null
 */
 void saveTextFile(String content, String encoding, String path);

storeService.getTextFile(String path)方法

/**
 * 通过指定文件路径,获取其文件的文本内容(使用编码 UTF-8)
 * @param path 文件全路径
 * @return 如果指定文件路径path的文件不存在,或者读取失败是,或path参数为null,
 *         返回null
 * @throws StoreException       获取失败,比如网络问题
 * @throws NullPointerException 参数为null
 */
 String getTextFile(String path); 

storeService.getTextFile(path,encoding) 方法

/**
 * 通过指定文件路径和文件编码,获取其文件的文本内容
 * @param path     文件全路径
 * @param encoding 文件字符编码
 * @return 如果指定文件路径path的文件不存在,或者读取失败是,或path参数为null,
 *         返回null
 * @throws StoreException       获取失败,比如网络问题
 * @throws NullPointerException 参数为null
 */
 String getTextFile(String path, String encoding); 

storeService.getBinaryFile(path) 方法

/**
 * 通过指定文件路径,获取其文件的二进制内容
 * @param path 文件全路径
 * @return 获取文件数据如果指定文件路径path的文件不存在,
 *         则返回null
 * @throws StoreException 读取失败,比如网络问题
 */
 byte[] getBinaryFile(String path); 

storeService.moveFile(srcFilePath,destinationFilePath) 方法

/**
 * 移动文件。
 * 目标文件的父目录如果没有,会自动创建。
 * @param srcFilePath         源文件路径
 * @param destinationFilePath 目的文件路径
 * @throws StoreException       保存失败:目标文件已经存在,网络问题
 * @throws NullPointerException 参数为null
 */
 void moveFile(String srcFilePath, String destinationFilePath); 

storeService.isFileExist(path) 方法

/**
 * 判断文件是否存在
 * @param path 文件全路径
 * @return 如果存在,返回true否则,返回false
 * @throws StoreException       操作失败,比如网络问题
 * @throws NullPointerException 参数为null
 */
 boolean isFileExist(String path); 

storeService.saveBinaryFile(content,path) 方法

/**
 * 将二进制内容保存到指定文件。
 *  
 * 文件的父目录,会自动创建。
 * 
 * @param content 二进制内容
 * @param path    文件全路径
 * @throws StoreException       保存失败,比如网络问题
 * @throws NullPointerException
 */
void saveBinaryFile(byte[] content, String path);

storeService.deleteFile(path) 方法

/**
 *删除指定路径的文件
 *如果文件不存在,成功不操作成功返回
 *
 *@param path 文件全路径
 *@throws StoreException       保存失败,比如网络问题
 *@throws NullPointerException 
 */
 void deleteFile(String path);

文件存储服务使用示例

请参考 基础服务Demo

FAQ

关于此文档暂时还没有FAQ
返回
顶部