从零开始设计搭建ios App框架(十)

支付模块


相信做过电商App的同胞们有个功能模块是必需的,那就是线上支付。app用户通过线上支付完成商品和服务的购买。

现如今线上支付的方式有多种,ios自家的支付就有苹果内购,applePay,其他大的支付平台有支付宝、微信、银联,以及跟银联合作而衍生出来小支付平台。在这里就不一一介绍各各支付平台。

总之大部分支付平台支付流程跟下图相似

支付.jpg

当然此文我重点是介绍客户端的支付模块设计。

支付场景:
  • 当app用户购买商品或者服务到结算页面时,就会有下单与支付需求;
  • 当用户进入自己的订单列表时,可以对没有支付的订单进行支付;
  • 当用户进入未支付的订单详情页面时,也可以进行订单支付;
app线上支付模块设计:

1、不需要对原有App框架作大的改动,也就是说低偶合;
2、支付API简单明了,方便集成;
3、支付结果能正确告之支付发起者;
4、在原有模块中可以方便扩展添加新的支付平台;

经过分析会得出下图的左边部分

客户端支付模块.jpg

发起支付的场景一般都会在ViewController中进行,为了方便也为了代码简洁,我们一般不会在每个支付发起的Controller中都去写创建订单、获取支付参数等这些相似的代码。有没有办法解决一下呢?

这个时候想到最快的方式就是构建个BaseViewController继承于ViewController,将上述相关代码封装好。然后支付场景的ViewController都继承这个BaseViewController。

继承的确可以做到,但不知道你有没有这样的经历,当有新功能需新建一个Demo来预演时,通过我们会拷贝现有工程中的部分文件,不想重新写,ViewController一般是包括在其中的,这个时候就你要把支付相关的模块逻辑也拷贝出来,不然编译不过。有一种拔出萝卜带出泥的感觉。

其实还有做法就是用catagory,为Controller新建一支付相关的分类,目前我采用的就是这种方法。

typedef void(^PGPayFinishBlock)(PGPayResult *resultObj);
typedef void(^PGPayParamBlock)(NSString *orderId, PGPayType payType);

@interface PGBaseController (pay)<PGPayManagerDelegate>
/*
 支付完成时的block回调
 */
@property(nonatomic, copy)PGPayFinishBlock payFinishBlock;
/*
 获取支付所需的支付参数
 */
@property(nonatomic, copy)PGPayParamBlock payParamBlock;
/*
 订单号
 */
@property(nonatomic, copy)NSString *payOrderId;

/*
 进行支付
 */
- (void)pay:(NSString *)szOrderId;
/*
 用对应的支付方式进行支付
 */
- (void)startPayWithParam:(NSDictionary *)dicParam
                  payType:(PGPayType)payType
                  orderId:(NSString *)szOrderId;

@end

支付方式这么多种,我是不是可以有一个统一的管理类对这些支付逻辑进行模块化封装。用这个类统一处理第三方支付平台(支付,结果 回调处理)逻辑,处理完成后回调给支付场景。
这样分析后就会得出上图中右边部分。
定义支付方式:

/*
 支付方式
 */
typedef NS_ENUM(NSInteger, PGPayType) {
    PGPayType_None      = 0,//不支付
    PGPayType_WxPay     = 1,//微信支付
    PGPayType_AliPay    = 2,//支付宝支付
};

支付定义结果:

/*
 支付结果状态
 */
typedef NS_ENUM(NSInteger, PayErrCode) {
    PaySuccess           = 0,    /**< 成功    */
    PayErrCodeCommon     = -1,   /**< 失败    */
    PayErrCodeUserCancel = -2,   /**< 用户点击取消并返回    */
};

#pragma mark -
/**
 支付结果
 */
@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: 支付结果
 */
- (void)payFinished:(PGPayResult *)payResult;
/*
 平台App没有安装
 */
- (void)noInstallPlatformApp:(PGPayType)type orderId:(NSString *)orderId;
@end

#pragma mark -
@interface PGPayManager : NSObject

+ (PGPayManager *)shareInstance;
/*
 支付完成后,应用间的信息传递
 */
- (void)handleOpenURL:(NSURL *)url;
/*
 初始化各支付平台
 */
- (void)platformInit;
/*
 开始支付
 dicParam: 平台SDK支付所需的参数
 type:支付方式
 delegate: 支付完成后的回调
 */
- (void)startPayWithParam:(NSDictionary *)dicParam
                  orderId:(NSString *)orderId
                  payType:(PGPayType)type
                 delegate:(id<PGPayManagerDelegate>)delegate;
/*
 获取微信支付下载地址
 */
+ (NSString *)getWXAppInstallUrl;


@end

支付场景发起支付调用示例

#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)
        {
            //
            //获取支付所需的参数进行支付
            // ...
            //
            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 = @"订单号xxxxxxx";
    
    WEAKSELF
    self.payParamBlock = ^(NSString *orderId, PGPayType payType) {
        dispatch_async(dispatch_get_main_queue(), ^{
            [weakSelf showWaitingView:nil];
            //去服务器端通过订单号与支付方式获取支付所需的参数
            [PGRequestManager startPostClient:API_TYPE_ORDER_PAY param:@{@"orderId":orderId} target:weakSelf extendParam:[NSNumber numberWithInteger:payType]];
        });
    };
    
    //支付完成后回调
    self.payFinishBlock = ^(PGPayResult *result) {
        if(result.errorCode == PaySuccess)
        {
            //支付成功
        }
        else if(result.errorCode == PayErrCodeCommon)
        {
            //支付失败
        }
        else
        {
            //支付取消
        }
        
        //作相应的页面跳转
        
    };
}

调用效果


C5EF7091-E5B9-4D77-B6BB-353753DF5ADA.png

感谢您的阅读!

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,372评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,368评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,415评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,157评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,171评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,125评论 1 297
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,028评论 3 417
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,887评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,310评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,533评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,690评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,411评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,004评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,659评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,812评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,693评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,577评论 2 353

推荐阅读更多精彩内容