/*************************************************************************************************/
/* RTAPIManagerParamSourceDelegate */
/*************************************************************************************************/
//讓manager能夠獲取調(diào)用API所需要的數(shù)據(jù)
@protocol RTAPIManagerParamSourceDelegate <NSObject>
@required
- (NSDictionary *)paramsForApi:(RTAPIBaseManager *)manager;
@end
/*
當(dāng)產(chǎn)品要求返回?cái)?shù)據(jù)不正確或者為空的時(shí)候顯示一套UI侍咱,請(qǐng)求超時(shí)和網(wǎng)絡(luò)不通的時(shí)候顯示另一套UI時(shí)叭喜,使用這個(gè)enum來(lái)決定使用哪種UI。(安居客PAD就有這樣的需求熙兔,sigh~)
你不應(yīng)該在回調(diào)數(shù)據(jù)驗(yàn)證函數(shù)里面設(shè)置這些值,事實(shí)上,在任何派生的子類(lèi)里面你都不應(yīng)該自己設(shè)置manager的這個(gè)狀態(tài),baseManager已經(jīng)幫你搞定了悴了。
強(qiáng)行修改manager的這個(gè)狀態(tài)有可能會(huì)造成程序流程的改變,容易造成混亂违寿。
*/
typedef NS_ENUM (NSUInteger, RTAPIManagerErrorType){
RTAPIManagerErrorTypeDefault, //沒(méi)有產(chǎn)生過(guò)API請(qǐng)求,這個(gè)是manager的默認(rèn)狀態(tài)熟空。
RTAPIManagerErrorTypeSuccess, //API請(qǐng)求成功且返回?cái)?shù)據(jù)正確藤巢,此時(shí)manager的數(shù)據(jù)是可以直接拿來(lái)使用的。
RTAPIManagerErrorTypeNoContent, //API請(qǐng)求成功但返回?cái)?shù)據(jù)不正確息罗。如果回調(diào)數(shù)據(jù)驗(yàn)證函數(shù)返回值為NO掂咒,manager的狀態(tài)就會(huì)是這個(gè)。
RTAPIManagerErrorTypeParamsError, //參數(shù)錯(cuò)誤,此時(shí)manager不會(huì)調(diào)用API绍刮,因?yàn)閰?shù)驗(yàn)證是在調(diào)用API之前做的温圆。
RTAPIManagerErrorTypeTimeout, //請(qǐng)求超時(shí)。RTApiProxy設(shè)置的是20秒超時(shí)孩革,具體超時(shí)時(shí)間的設(shè)置請(qǐng)自己去看RTApiProxy的相關(guān)代碼岁歉。
RTAPIManagerErrorTypeNoNetWork //網(wǎng)絡(luò)不通。在調(diào)用API之前會(huì)判斷一下當(dāng)前網(wǎng)絡(luò)是否通暢膝蜈,這個(gè)也是在調(diào)用API之前驗(yàn)證的锅移,和上面超時(shí)的狀態(tài)是有區(qū)別的。
};
typedef NS_ENUM (NSUInteger, RTAPIManagerRequestType){
RTAPIManagerRequestTypeGet,
RTAPIManagerRequestTypePost,
RTAPIManagerRequestTypeRestGet,
RTAPIManagerRequestTypeRestPost
};