153 lines
4.6 KiB
Objective-C
153 lines
4.6 KiB
Objective-C
//
|
||
// DDWriteDefaultConfigMethods.h
|
||
// AFNetworking
|
||
//
|
||
// Created by DDLi on 2020/3/27.
|
||
//
|
||
|
||
#import <Foundation/Foundation.h>
|
||
#import "DDWriteFileSupport.h"
|
||
|
||
NS_ASSUME_NONNULL_BEGIN
|
||
|
||
@interface DDWriteDefaultConfigMethods : NSObject
|
||
|
||
/// 默认存储文件夹路径
|
||
@property (nonatomic, copy, readonly) NSString *path;
|
||
|
||
/**
|
||
单实例化，此类为方便快速使用DDWriteFileSupport的方法，不再需要自己创建文件夹，管理路径。均使用默认配置
|
||
|
||
@return 返回生成的单实例
|
||
*/
|
||
+ (nonnull DDWriteDefaultConfigMethods *)ShareInstance;
|
||
|
||
#pragma mark - ***** 获取路径 *****
|
||
/// 通过img存储时的url获取图片绝对路径，不存在则返回null
|
||
///
|
||
/// @param url 图片url,传入nil搜索无意义，故设置为nonnull
|
||
/// @param type 图片类型
|
||
- (nullable NSString *)defaultSearchByUrl:(nonnull NSString *)url
|
||
imgType:(DDImgType)type;
|
||
/// 通过file文件名获取文件绝对路径，不存在则返回null
|
||
/// @param name 文件name,传入nil搜索无意义，故设置为nonnull
|
||
- (nullable NSString *)defaultSearchByFileName:(nonnull NSString *)name;
|
||
|
||
#pragma mark - ***** 获取默认文件夹下所有子文件路径或文件名 *****
|
||
/**
|
||
返回默认存储的文件夹路径下所有文件或文件夹路径
|
||
|
||
@return 返回的文件列表数组，数组元素为子文件或子文件夹的绝对路径
|
||
*/
|
||
- (nullable NSMutableArray <NSString *> *)searchDefaultDirFilePaths;
|
||
/**
|
||
读取默认存储的文件夹下所有文件名。包含文件夹名
|
||
|
||
@return 返回的文件列表数组，数组元素为自文件或自文件夹的名字
|
||
*/
|
||
- (nullable NSArray <NSString *> *)searchDefaultDirFileNames;
|
||
|
||
#pragma mark - ***** 写入 *****
|
||
/**
|
||
直接存储data流到本地default位置，文件名为name，不管路径上是否已存在文件
|
||
|
||
@param name 文件名
|
||
@param data 二进制流，数组或字典，图片。图片默认为png格式，如果需要写jpg图片请使用选择图片type的方法
|
||
@return 返回写入结果
|
||
*/
|
||
- (BOOL)directWriteFileName:(nonnull NSString *)name
|
||
data:(nonnull id)data;
|
||
/**
|
||
存储data流到本地default位置，文件名为name，路径上如果已存在文件则返回写入失败
|
||
|
||
@param name 文件名
|
||
@param data 二进制流，数组或字典，图片，图片默认为png格式，如果需要写jpg图片请使用选择图片type的方法
|
||
@return 返回写入结果
|
||
*/
|
||
- (BOOL)writeFile:(nonnull NSString *)name
|
||
data:(nonnull id)data;
|
||
/**
|
||
直接存储图片到本地default位置，一般为存储网络图片到沙盒，不管路径上是否已存在文件
|
||
|
||
@param url 图片的网络url
|
||
@param img 图片
|
||
@param imgType 图片类型
|
||
@return 返回写入结果
|
||
*/
|
||
- (BOOL)directWriteImg:(nonnull NSString *)url
|
||
img:(nonnull UIImage *)img
|
||
imageType:(DDImgType)imgType;
|
||
/**
|
||
存储图片到本地default位置，一般为存储网络图片到沙盒，路径上已存在文件则返回失败
|
||
|
||
@param url 图片的网络url
|
||
@param img 图片
|
||
@param imgType 图片类型
|
||
@return 返回写入结果
|
||
*/
|
||
- (BOOL)writeImg:(nonnull NSString *)url
|
||
img:(nonnull UIImage *)img
|
||
imageType:(DDImgType)imgType;
|
||
|
||
#pragma mark - ***** 删除 *****
|
||
/**
|
||
以文件名删除单个文件，如果不存在文件返回NO
|
||
|
||
@param name 文件名
|
||
@return 删除结果
|
||
*/
|
||
- (BOOL)removeFile:(nonnull NSString *)name;
|
||
/**
|
||
以图片url删除单个图片，如果不存在文件返回NO
|
||
|
||
@param url 图片url
|
||
@param imgType 图片类型
|
||
@return 删除结果
|
||
*/
|
||
- (BOOL)removeImg:(nonnull NSString *)url
|
||
imgType:(DDImgType)imgType;
|
||
/**
|
||
以文件夹名删除文件夹
|
||
|
||
@param dirName 文件夹名
|
||
@return 删除结果
|
||
*/
|
||
- (BOOL)removeDirFiles:(nonnull NSString *)dirName;
|
||
|
||
#pragma mark - 读取文件操作
|
||
/**
|
||
根据name读取默认文件夹下的文件，不存在则返回nil，可选择直接返回的type,如果缓存中存在则直接返回不需要设置返回type
|
||
|
||
@param name 文件名
|
||
@param type 返回文件类型
|
||
@return 返回文件
|
||
*/
|
||
- (nullable id)readFile:(nonnull NSString *)name
|
||
fileType:(DDFileType)type;
|
||
/**
|
||
读取存储的image
|
||
|
||
@param url 保存图片的url
|
||
@param imgType 图片类型
|
||
@return 返回文件
|
||
*/
|
||
- (nullable UIImage *)readImg:(nonnull NSString *)url
|
||
imgType:(DDImgType)imgType;
|
||
/**
|
||
删除nscache内的缓存
|
||
*/
|
||
- (void)flushCache;
|
||
|
||
#pragma mark - 计算文件或文件夹大小操作
|
||
/**
|
||
通过获取默认存储位置的文件大小
|
||
|
||
@param type 返回文件大小的计算格式，kb,mb,gb,tb
|
||
@return 返回文件大小
|
||
*/
|
||
- (float)countSize:(DDSizeType)type;
|
||
|
||
@end
|
||
|
||
NS_ASSUME_NONNULL_END
|