支付模塊
相信做過電商App的同胞們有個(gè)功能模塊是必需的，那就是線上支付。app用戶通過線上支付完成商品和服務(wù)的購買。
現(xiàn)如今線上支付的方式有多種，ios自家的支付就有蘋果內(nèi)購，applePay，其他大的支付平臺(tái)有支付寶、微信、銀聯(lián)，以及跟銀聯(lián)合作而衍生出來小支付平臺(tái)。在這里就不一一介紹各各支付平臺(tái)。
總之大部分支付平臺(tái)支付流程跟下圖相似
當(dāng)然此文我重點(diǎn)是介紹客戶端的支付模塊設(shè)計(jì)。
支付場(chǎng)景：
- 當(dāng)app用戶購買商品或者服務(wù)到結(jié)算頁面時(shí)，就會(huì)有下單與支付需求；
- 當(dāng)用戶進(jìn)入自己的訂單列表時(shí)，可以對(duì)沒有支付的訂單進(jìn)行支付；
- 當(dāng)用戶進(jìn)入未支付的訂單詳情頁面時(shí)，也可以進(jìn)行訂單支付；
app線上支付模塊設(shè)計(jì)：
1、不需要對(duì)原有App框架作大的改動(dòng)，也就是說低偶合；
2、支付API簡(jiǎn)單明了，方便集成；
3、支付結(jié)果能正確告之支付發(fā)起者；
4、在原有模塊中可以方便擴(kuò)展添加新的支付平臺(tái)；
經(jīng)過分析會(huì)得出下圖的左邊部分
發(fā)起支付的場(chǎng)景一般都會(huì)在ViewController中進(jìn)行，為了方便也為了代碼簡(jiǎn)潔，我們一般不會(huì)在每個(gè)支付發(fā)起的Controller中都去寫創(chuàng)建訂單、獲取支付參數(shù)等這些相似的代碼。有沒有辦法解決一下呢？
這個(gè)時(shí)候想到最快的方式就是構(gòu)建個(gè)BaseViewController繼承于ViewController，將上述相關(guān)代碼封裝好。然后支付場(chǎng)景的ViewController都繼承這個(gè)BaseViewController。
繼承的確可以做到，但不知道你有沒有這樣的經(jīng)歷，當(dāng)有新功能需新建一個(gè)Demo來預(yù)演時(shí)，通過我們會(huì)拷貝現(xiàn)有工程中的部分文件，不想重新寫，ViewController一般是包括在其中的，這個(gè)時(shí)候就你要把支付相關(guān)的模塊邏輯也拷貝出來，不然編譯不過。有一種拔出蘿卜帶出泥的感覺。
其實(shí)還有做法就是用catagory，為Controller新建一支付相關(guān)的分類，目前我采用的就是這種方法。
typedef void(^PGPayFinishBlock)(PGPayResult *resultObj);
typedef void(^PGPayParamBlock)(NSString *orderId, PGPayType payType);
@interface PGBaseController (pay)<PGPayManagerDelegate>
/*
支付完成時(shí)的block回調(diào)
*/
@property(nonatomic, copy)PGPayFinishBlock payFinishBlock;
/*
獲取支付所需的支付參數(shù)
*/
@property(nonatomic, copy)PGPayParamBlock payParamBlock;
/*
訂單號(hào)
*/
@property(nonatomic, copy)NSString *payOrderId;
/*
進(jìn)行支付
*/
- (void)pay:(NSString *)szOrderId;
/*
用對(duì)應(yīng)的支付方式進(jìn)行支付
*/
- (void)startPayWithParam:(NSDictionary *)dicParam
payType:(PGPayType)payType
orderId:(NSString *)szOrderId;
@end
支付方式這么多種，我是不是可以有一個(gè)統(tǒng)一的管理類對(duì)這些支付邏輯進(jìn)行模塊化封裝。用這個(gè)類統(tǒng)一處理第三方支付平臺(tái)（支付，結(jié)果 回調(diào)處理）邏輯，處理完成后回調(diào)給支付場(chǎng)景。
這樣分析后就會(huì)得出上圖中右邊部分。
定義支付方式：
/*
支付方式
*/
typedef NS_ENUM(NSInteger, PGPayType) {
PGPayType_None = 0,//不支付
PGPayType_WxPay = 1,//微信支付
PGPayType_AliPay = 2,//支付寶支付
};
支付定義結(jié)果：
/*
支付結(jié)果狀態(tài)
*/
typedef NS_ENUM(NSInteger, PayErrCode) {
PaySuccess = 0, /**< 成功 */
PayErrCodeCommon = -1, /**< 失敗 */
PayErrCodeUserCancel = -2, /**< 用戶點(diǎn)擊取消并返回 */
};
#pragma mark -
/**
支付結(jié)果
*/
@interface PGPayResult : NSObject
@property(nonatomic, strong)NSString *szOrder;
@property(nonatomic, assign)PayErrCode errorCode;
@property(nonatomic, strong)NSString *szDesc;
@end
支付管理類PGPayManager：
#pragma mark -
@protocol PGPayManagerDelegate <NSObject>
@required
/*
payResult: 支付結(jié)果
*/
- (void)payFinished:(PGPayResult *)payResult;
/*
平臺(tái)App沒有安裝
*/
- (void)noInstallPlatformApp:(PGPayType)type orderId:(NSString *)orderId;
@end
#pragma mark -
@interface PGPayManager : NSObject
+ (PGPayManager *)shareInstance;
/*
支付完成后，應(yīng)用間的信息傳遞
*/
- (void)handleOpenURL:(NSURL *)url;
/*
初始化各支付平臺(tái)
*/
- (void)platformInit;
/*
開始支付
dicParam: 平臺(tái)SDK支付所需的參數(shù)
type:支付方式
delegate: 支付完成后的回調(diào)
*/
- (void)startPayWithParam:(NSDictionary *)dicParam
orderId:(NSString *)orderId
payType:(PGPayType)type
delegate:(id<PGPayManagerDelegate>)delegate;
/*
獲取微信支付下載地址
*/
+ (NSString *)getWXAppInstallUrl;
@end
支付場(chǎng)景發(fā)起支付調(diào)用示例
#pragma mark -
- (void)payOrder
{
//訂單支付
[self pay:self.payOrderId];
}
#pragma mark - PGApiDelegate
- (void)dataRequestFinish:(PGResultObject *)resultObj apiType:(PGApiType)apiType
{
[self hideWaitingView];
if(apiType == API_TYPE_ORDER_PAY)
{
if(resultObj.nCode == 0)
{
//
//獲取支付所需的參數(shù)進(jìn)行支付
// ...
//
NSDictionary *dicParam = [[NSDictionary alloc] init];
NSInteger payType = [(NSNumber *)resultObj.extendParam integerValue];
[self startPayWithParam:dicParam payType:payType orderId:self.payOrderId];
}
else
{
[self showMsg:resultObj.szErrorDes];
}
}
}
- (void)createInitData
{
[super createInitData];
self.payOrderId = @"訂單號(hào)xxxxxxx";
WEAKSELF
self.payParamBlock = ^(NSString *orderId, PGPayType payType) {
dispatch_async(dispatch_get_main_queue(), ^{
[weakSelf showWaitingView:nil];
//去服務(wù)器端通過訂單號(hào)與支付方式獲取支付所需的參數(shù)
[PGRequestManager startPostClient:API_TYPE_ORDER_PAY param:@{@"orderId":orderId} target:weakSelf extendParam:[NSNumber numberWithInteger:payType]];
});
};
//支付完成后回調(diào)
self.payFinishBlock = ^(PGPayResult *result) {
if(result.errorCode == PaySuccess)
{
//支付成功
}
else if(result.errorCode == PayErrCodeCommon)
{
//支付失敗
}
else
{
//支付取消
}
//作相應(yīng)的頁面跳轉(zhuǎn)
};
}
調(diào)用效果
感謝您的閱讀！
