97 lines
3.7 KiB
Objective-C
97 lines
3.7 KiB
Objective-C
/*
|
||
* AlibcNetPacket.h
|
||
*
|
||
* 阿里百川电商
|
||
* 项目名称：阿里巴巴电商 AlibcTradeCommon
|
||
* 版本号：3.1.1.93
|
||
* 发布时间：2017-03-06
|
||
* 开发团队：阿里巴巴百川商业化团队
|
||
* 阿里巴巴电商SDK答疑群号：1229144682(阿里旺旺)
|
||
* Copyright (c) 2016-2019 阿里巴巴-移动事业群-百川. All rights reserved.
|
||
*/
|
||
|
||
#import <Foundation/Foundation.h>
|
||
#import "AlibcNetError.h"
|
||
|
||
#ifndef AlibcNetPacket_h
|
||
#define AlibcNetPacket_h
|
||
|
||
//*******使用须知
|
||
//函数是给子类重载用的; block是给外部调用者设置的,子类自己不要用
|
||
|
||
|
||
typedef NS_ENUM(long, ALiNetPriority) {
|
||
ALiNetPriorityHigh = 1, //高,马上发送
|
||
ALiNetPriorityNormal, //普通,发送任务多时,可能等待200ms(等待时可以合并请求)
|
||
ALiNetPriorityLow, //低,等待200ms后发送,供合并请求
|
||
};
|
||
|
||
typedef NS_ENUM(long, AlibcNetPacketStatus) {
|
||
AlibcNetPacketStatusNormal = 1,//请求未处理
|
||
AlibcNetPacketStatusSendng, //发送中
|
||
AlibcNetPacketStatusSuccess, //请求成功
|
||
AlibcNetPacketStatusFail, //请求失败
|
||
};
|
||
|
||
typedef void (^SuccessAction)(id netData); //发送成功
|
||
typedef void (^ErrorAction)(AlibcNetError *error); //发送失败
|
||
|
||
//mtop请求包头定义
|
||
@interface AlibcNetPacketHttpHeader : NSObject
|
||
@property(nonatomic, copy) NSString *cmd; //mtop命令
|
||
@property(nonatomic, copy) NSString *version; //版本,默认值"1.0"
|
||
@property(nonatomic, assign) BOOL needPost; //是否用post,默认是YES
|
||
@property(nonatomic, assign) BOOL needLogin; //是否需要login,默认是NO
|
||
@property(nonatomic, assign) BOOL needAuth; //是否需要授权,默认是NO
|
||
@property(nonatomic, assign) BOOL needWua; //是否需要人机,默认是NO
|
||
|
||
@property(nonatomic, copy) NSString *bizId; //组件id,默认不需要填,组件发起的才需要填
|
||
|
||
|
||
- (instancetype)initWithCmd:(NSString *)cmd;
|
||
@end
|
||
|
||
//......
|
||
@interface AlibcNetPacket<ObjectType> : NSObject
|
||
@property(nonatomic, assign) NSUInteger retryTime; //发送重试次数,默认(0),不重试 最大重试5次
|
||
@property(nonatomic, assign) ALiNetPriority priority; //默认值(AMPNetPriorityNormal)
|
||
|
||
//****** 下面变量,是netservice维护的, ******//
|
||
@property(nonatomic, assign) NSUInteger retryCount; //当前是第几次重试,网络层用..子类不要动,切忌
|
||
@property(nonatomic, assign) AlibcNetPacketStatus status;
|
||
|
||
//block,只供外部使用者设置,子类不要用;
|
||
@property(nonatomic, copy) SuccessAction successAction;
|
||
@property(nonatomic, copy) ErrorAction failAction;
|
||
|
||
|
||
//**************供子类重载用的
|
||
//Mtop发送相关
|
||
- (AlibcNetPacketHttpHeader *)generateMtopHeader;
|
||
|
||
- (NSDictionary *)generateMtopBody;
|
||
|
||
//重试通知, 如果有需要在这里修改内部数据 ,否则不用管,retryCount是第几次(1开始)
|
||
//retryAction时,可以改变netType,这样重试的时候,可以改变通道方式.比如第一次用accs的,重发的时候用mtop
|
||
- (void)retryAction:(NSUInteger)retryCount;
|
||
|
||
//剔除sendPacke中自己已经在请求中部分.如果全部剔除完,返回YES,sendPacke会被丢弃(参考AMPBatchGetUserPacket)
|
||
- (BOOL)filterNewPacket:(__kindof AlibcNetPacket *)sendPack;
|
||
|
||
//等待队列,请求合并..合并待发送的包,返回YES,sendPacke会被丢弃
|
||
- (BOOL)conbineWaitingPacket:(__kindof AlibcNetPacket *)sendPack;
|
||
|
||
//打点逻辑,如果retry时每次都要打点,重载这个..一般的成功失败打点直接successAction,failAction里挂载打点即可..
|
||
- (void)trackActionSuccess:(BOOL)isSuccess error:(AlibcNetError *)error duration:(double)durationMillisecond;
|
||
|
||
|
||
//**********给子类用的辅助函数
|
||
//是否有效,用户切换后则无效 .没事不要重载修改
|
||
- (BOOL)isValued;
|
||
|
||
- (BOOL)sendPacket;
|
||
|
||
@end
|
||
|
||
#endif
|