文件存储服务简介
TAE文件存储服务采用阿里云开放存储服务(Open Storage Service,简称OSS)来支持任意数据类型的存储,支持任意时间、地点的数据上传和下载。OSS中每个存储对象(object)由名称、内容、描述三部分组成。通过OSS可以获得更稳定更安全的存储服务,使开发大容量和高并发系统变得更容易。
文件存储服务API
引入服务包
获取文件存储服务对象
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);
文件存储服务使用示例
FAQ
关于此文档暂时还没有FAQ