98 lines
4.2 KiB
Objective-C
Executable File
98 lines
4.2 KiB
Objective-C
Executable File
#import <Foundation/Foundation.h>
|
||
@class TUIGroupPendencyCellData;
|
||
|
||
NS_ASSUME_NONNULL_BEGIN
|
||
|
||
/**
|
||
* 【模块名称】TUIGroupPendencyViewModel
|
||
* 【功能说明】群组请求视图模型
|
||
* 本视图模型负责统一处理群组请求的消息。比如获取未读计数，接收新的请求消息并进行更新，在已有数据队列中同意/移除数据等一系列逻辑。
|
||
*
|
||
* 【Module name】 TUIGroupPendencyViewModel
|
||
* 【Function description】Group request view model
|
||
* This view model is responsible for unified processing of group request messages. For example, a series of logics such as obtaining the unread count, receiving new request messages and updating them, agreeing/removing data in the existing data queue, etc.
|
||
*/
|
||
@interface TUIGroupPendencyViewDataProvider : NSObject
|
||
|
||
/**
|
||
* 请求数据列表
|
||
* 该列表中存放的对象类型为 TUIGroupPendencyCellData。
|
||
* 即本数组中存放了当前群所有的待处理请求数据，且本属性为只读，不允许修改。
|
||
*
|
||
* Request data list
|
||
* The object type stored in this list is TUIGroupPendencyCellData.
|
||
* That is, this array stores all pending request data of the current group, and this attribute is read-only and cannot be modified.
|
||
*/
|
||
@property (readonly) NSArray *dataList;
|
||
|
||
/**
|
||
* 是否具有下一个请求数据。
|
||
* 加载数据时，当前群组的请求列表还有未读取出时，hasNextData 为 YES。
|
||
*
|
||
* Whether to have next request data.
|
||
* When loading data, hasNextData is YES when the request list of the current group has not been read out.
|
||
*/
|
||
@property BOOL hasNextData;
|
||
|
||
/**
|
||
* 加载标识符
|
||
* 当前视图模型正在加载数据时，本属性为 YES，此时不允许再次加载，直至当前加载过程完成。
|
||
*
|
||
* Loading identifier
|
||
* When the current view model is loading data, this property is YES. At this time, loading again is not allowed until the current loading process is completed.
|
||
*/
|
||
@property BOOL isLoading;
|
||
|
||
/**
|
||
* 未读计数
|
||
* 即当前群组请求的未处理数目。
|
||
*
|
||
* Unread count, that is, the number of outstanding requests for the current group.
|
||
*/
|
||
@property int unReadCnt;
|
||
|
||
/**
|
||
* 群组 ID
|
||
* 用于识别当前群组，判定入群请求是否是针对本群组的请求。
|
||
*
|
||
* group ID
|
||
* It is used to identify the current group and determine whether the request to join the group is a request for this group.
|
||
*/
|
||
@property NSString *groupId;
|
||
|
||
/**
|
||
* 加载数据
|
||
* 1、先判断当前是否在加载，如果是，则终止本次加载。
|
||
* 2、通过 IM SDK 中的 TIMGroupManager 类提供的 getPendencyFromServer 接口从服务器拉取请求数据，默认一页100个请求。
|
||
* 3、对于拉取的数据，判定请求对应的群组 ID 是否与本群相同，若相同，则将该请求转换为 TUIGroupPendencyCellData 并存入 datalist。（从服务器拉取的请求对象为 TIMGroupPendencyItem）。
|
||
*
|
||
* Load data
|
||
* 1. First determine whether it is currently loading, and if so, terminate this loading.
|
||
* 2. Pull the request data from the server through the getPendencyFromServer interface provided by the TIMGroupManager class in the IM SDK. The default is 100 requests per page.
|
||
* 3. For the pulled data, determine whether the group ID corresponding to the request is the same as this group, and if so, convert the request to TUIGroupPendencyCellData and store
|
||
* it in the datalist. (The request object pulled from the server is TIMGroupPendencyItem).
|
||
*/
|
||
- (void)loadData;
|
||
|
||
/**
|
||
* 批准当前请求数据。
|
||
* 本函数直接调用 TUIGroupPendencyCellData 中实现的 accept，同时未读计数减1。
|
||
*
|
||
* Approve current request data.
|
||
* This function directly calls accept implemented in TUIGroupPendencyCellData, and the unread count is decremented by 1.
|
||
*/
|
||
- (void)acceptData:(TUIGroupPendencyCellData *)data;
|
||
|
||
/**
|
||
* 拒绝当前请求数据。
|
||
* 将参数中的 data 从 datalist 中移除，并调用 TUIGroupPendencyCellData 中实现的 reject，同时未读计数减1。
|
||
*
|
||
* Deny the current request data.
|
||
* Remove the data in the parameter from the datalist, and call reject implemented in TUIGroupPendencyCellData, while the unread count is decremented by 1.
|
||
*/
|
||
- (void)removeData:(TUIGroupPendencyCellData *)data;
|
||
|
||
@end
|
||
|
||
NS_ASSUME_NONNULL_END
|