#MACProject 传送门:https://github.com/azheng51714/MACProject
这是使用 Objective-C 整理的一套 iOS 轻量级框架,内部包含大量或自己整理或修改自网络的 Category 、Utils、DataManager、Macros & UIComponents 旨在快速构建中小型 iOS App,并尝试用其整理了个 MACProject 样例以来抛砖引玉,愿与大犇们相互学习交流,不足之处望批评指正, 更欢迎 Star。
##目录结构
基于MVC:对常用控件、常用扩展类、数据缓存、网络请求、工具类、常用动画进行封装或二次封装;
-
对包括 UIImageView、UILabel、UIButton、UINavgationBar、UINavgationController、UITableView、UITextView、UISearchBar、UIViewController 等在内的常用控件及其扩展类进行了整理,其中对常用的数据加载、提示语、AlertView、sheetView也进行了一键集成;
-
对包括 NSData、NSDate、NSString、NSArray、NSDictionary、NSNumber、NSObject 等数据类型常用的转换或解析方法进行了整理;
-
对包括 NSBundle、NSFile、NSFileManger 等数据读取或操作的常用方法行了整理;
-
对 UIFont、UIColor、UIImage、UIApplication、NSTimer 等也进行了分类整理,保证相关操作简洁高效,常用方法一键实现;
-
对数据下载(DownLoadManager)、网络请求(BaseService)、GCD、Animation、UserAuth 等也行了简洁的封装。
这里对几个常用控件源代码进行简单的说明: 基于AF网络请求库的二次封装,根据状态码递归解析请求的加密数据;接口类型包括: 普通访问接口、带数据缓存接口、带有网络提示、带有上传文件等;
#import <Foundation/Foundation.h>
/**
* HTTP访问回调
*
* @param urlString 状态码 0 访问失败 200 正常 500 空 其他异常
* @param result 返回数据 nil 为空
* @param error 错误描述
*/
typedef void(^ResultBlock)(NSInteger stateCode, NSMutableArray* result, NSError *error);
//block不是self的属性或者变量时,在block内使用self也不会循环引用:
@interface BaseService : NSObject
/**
* 普通的访问请求(有提示,带判断网络状态)
*
* @param URLString 接口地址
* @param parameters 字典参数
* @param requestBlock 回调函数
*/
+ (void)POST:(NSString *)URLString parameters:(id)parameters result:(ResultBlock)requestBlock;
/**
* 普通的访问请求(无提示,不带判断网络状态)
*
* @param URLString 接口地址
* @param parameters 字典参数
* @param requestBlock 回调函数
*/
+ (void)POSTWithNormal:(NSString *)URLString parameters:(id)parameters result:(ResultBlock)requestBlock;
/**
* 访问请求(有提示带缓存,带判断网络状态)
*
* @param URLString 请求地址
* @param parameters 请求参数
* @param requestBlock 请求回调
*/
+ (void)POSTWithCache:(NSString *)URLString parameters:(id)parameters completionBlock:(ResultBlock)requestBlock;
/**
* 无提示的访问请求(带缓存,带判断网络状态)
*
* @param URLString 请求地址
* @param parameters 请求参数
* @param requestBlock 请求回调
*/
+(void)POSTWithCacheNormal:(NSString *)URLString parameters:(id)parameters completionBlock:(ResultBlock)requestBlock cacheBlock:(ResultBlock)cacheBlock;
/**
* 上传多媒体文件接口
*
* @param URLString 请求地址
* @param parameters 请求参数
* @param mediaDatas 多媒体数据 图片传 UIImage 语音传url字符串地址
* @param requestBlock 请求回调
*/
+(void)POSTWithFormDataURL:(NSString *)URLString parameters:(id)parameters mediaData:(NSMutableArray *)mediaDatas completionBlock:(ResultBlock)requestBlock;
同时对 UITableView 空白页文字、空白页图片、上拉下拉事件等进行了高度封装,命名为MACTableView,使用简单高效,一键集成:
typedef NS_ENUM(NSInteger, MACRefreshState) {
/** 下拉刷新的状态 */
MACRefreshing,
/** pull刷新中的状态 */
MACPulling,
};
@protocol MACTableViewDelegate <NSObject>
@optional
/**
* 获取数据
*
* @param state MACRefreshing为Refresh MACPulling 为 Pull
*/
-(void)loadDataRefreshOrPull:(MACRefreshState)state;
@end
@interface MACTableView : UITableView<DZNEmptyDataSetSource, DZNEmptyDataSetDelegate>
/**
* macTableView delegate
*/
@property (nonatomic,weak) id<MACTableViewDelegate> macTableViewDelegate;
/**
* 是否支持下拉刷新 默认为YES
*/
@property (nonatomic,assign) BOOL isRefresh;
/**
* 是否可以加载更多 默认为YES
*/
@property (nonatomic,assign) BOOL isLoadMore;
/**
* 当前访问的page 下标
*/
@property (nonatomic,assign) NSInteger page;
/**
* 是否展示空白页 默认为YES
*/
@property(nonatomic,assign)BOOL isShowEmpty;
/**
* 空白页的标题 默认为 “" 为空不显示
*/
@property(nonatomic,copy) NSString *titleForEmpty;
/**
* 空白页的副标题 默认为 “" 为空不显示
*/
@property(nonatomic,copy) NSString *descriptionForEmpty;
/**
* 空白页展位图名称 默认为 “img_placehoder_icon" 为空或nil无图片
*/
@property(nonatomic,copy) NSString *imageNameForEmpty;
/**
* CellDataAdapter arr 暂未 用到
*/
@property(nonatomic,strong) NSMutableArray *cellDataArr;
/**
*
* 获取当下访问接口下标
*/
-(NSNumber *)getCurrentPage;
/**
* 开始加载
*/
-(void)beginLoading;
/**
* 结束刷新
*/
-(void)endLoading;
///**
// * 提示无更多数据
// */
//-(void)noMoreData;
@end
##首页
###仿闲鱼同城界面:
GCD、CollectionView、Xib 约束、Frame 约束、AutoLayout 代码约束简单应用,抛砖引玉;
###城市模糊查询:
定位 、 KMP & SearchTree 搜索实现快速数据检索 与 系统匹配不一样的感受;
##朋友圈
###仿QQ通信录:
高仿QQ聊天通讯录,人员分组:
高仿朋友圈 & QQ空间
我的消息
##云周边(暂未开放)
##发现(动画&控件)