无线开放 API

文件存储服务简介

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。