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