text: /*
   * AlibcNetPacket.h 
   *
   * 阿里百川电商
   * 项目名称：阿里巴巴电商 AlibcTradeBiz 
   * 版本号：4.0.0.2
   * 发布时间：2019-09-15
   * 开发团队：阿里巴巴商家服务引擎团队
   * 阿里巴巴电商SDK答疑群号：1488705339  2071154343(阿里旺旺)
   * Copyright (c) 2016-2020 阿里巴巴-淘宝-百川. 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);   //发送失败
  typedef void (^ErrorJSAction)(id 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, assign) NSInteger sessionExpireType; // 0 AutoLoginAndMaunlLogin 1 AutoLoginOnly
  
  @property(nonatomic, copy) NSString *bizId; //组件id,默认不需要填,组件发起的才需要填
  @property(nonatomic, copy) NSString *ttid;// 不设置 用默认百川的ttid
  
  
  - (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;
  @property(nonatomic, copy) ErrorJSAction failJSAction;
  
  
  //**************供子类重载用的
  //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;
  
  - (BOOL)sendJSPacket;
  
  @end
  
  #endif
  