美文网首页AndroidAndroid开发安卓开发相关
Android集成支付----微信支付总结与封装

Android集成支付----微信支付总结与封装

作者: chaohx | 来源:发表于2017-07-05 16:13 被阅读10876次

    前言

    之前做过一次微信支付的集成,但是没有总结。最近一个App又要集成微信支付,又要重新下载demo,重新看开发文档,重新写代码。相信所有的程序员遇到这种事情都会抓狂。观察了一下微信支付并不设计业务逻辑,完全可以封装成一个工具。

    这里我们分三大步走:

    一、导入微信SDK

    二、写支付逻辑

    三、封装

    下面开始详解:

    一、集成微信支付SDK

    在集成第三方的时候,首先是要在自己的项目中集成对应的SDK后才可以开发的。这个毋庸置疑。这里给出微信官方的集成文档,读者可自行查看,我在这里只对关键地方做出说明。
    微信官方集成文档:https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=1417751808&token=6e7c5d2622dcc43878e06cd70caaa27a86d3d1d7&lang=zh_CN

    1.导入sdk

    如下图,微信支付sdk已经可以通过gradle来导入了,所以建议还在坚守eclipse的同学赶紧转入Android studio。


    Paste_Image.png
    2.大坑---接收微信的请求及返回值

    先看官方文档,仔细理解下图被框住的文字。第一次做微信支付被这句话坑惨了,搞了两天都TM找不到我到底错在哪里了,现在想起来就生气。所以这句话的正确解读是:在你的包名下一级目录里面,新建一个文件夹名字为wxapi。而不是像下图一样有两个并列的net.sourceforge.simcpux。

    image.png

    当时之所以被坑的惨,也跟包结构显示样式不同有关系。用Android Studio开发时包结构多半是这样的:

    Paste_Image.png

    对比以上两张图,相信聪明的你一点会发现问题。

    二、微信支付开发步骤

    微信SDK集成之后,准备工作也就做好了,接下来就是要写代码了,有木有一点小激动呢。官方文档:https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=9_12&index=2

    1.统一下单(服务端做)

    为了更加安全,微信推荐统一下单是交给服务端人员来做的,当然也有一下服务端开发人员觉得麻烦,会推到客户端来做,这个时候千万别怂,一定要跟他讲。

    2.请求我们自己的接口

    在我们自己的APP中点击微信支付按钮后,我们首先要请求一个我们自己服务端的接口,这时服务端需要走统一下单的逻辑,然后将一些参数返回给我们。这里需要注意,严格来说的话,这个接口应该返回如下所有参数:

    Paste_Image.png

    尤其是这个签名的过程,微信官方强烈建议放在服务端来做。
    而事实上,会有一些服务端开发人员为了他们自己方便,返回过来的数据是这样的:

    Paste_Image.png

    如果这样的话,签名过程就要放在客户端来做喽。

    3.调起微信APP进行支付

    调起微信APP是需要请求参数的,也就是上一步中说到的那些参数,当你把这些参数都凑够了,那么这一步也就没什么难度了,就是照着模板写了:

     private IWXAPI iwxapi; //微信支付api
     /**
     *调起微信支付的方法
     **/
     private void toWXPay() {
            iwxapi = WXAPIFactory.createWXAPI(this, null); //初始化微信api
            iwxapi.registerApp(appid); //注册appid  appid可以在开发平台获取
    
            Runnable payRunnable = new Runnable() {  //这里注意要放在子线程
                @Override
                public void run() {
                    PayReq request = new PayReq(); //调起微信APP的对象
                    //下面是设置必要的参数,也就是前面说的参数,这几个参数从何而来请看上面说明
                    request.appId = appid;
                    request.partnerId = partnerId;
                    request.prepayId = prepayId;
                    request.packageValue = "Sign=WXPay";
                    request.nonceStr = nonceStr;
                    request.timeStamp = timeStamp;
                    request.sign = sign;
                    iwxapi.sendReq(request);//发送调起微信的请求
                }
            };
            Thread payThread = new Thread(payRunnable);
            payThread.start();
        }
    
    4.处理微信支付的回调

    处理微信支付的回调就是在刚刚创建的WXPayEntryActivity中处理。需要实现IWXAPIEventHandler接口,这个接口会要求你实现onResp方法,我们就在这个方法中处理回调。

    
        @Override
        public void onResp(BaseResp resp) {
            
            if(resp.getType()==ConstantsAPI.COMMAND_PAY_BY_WX){
                if(resp.errCode==0){
                    Toast.makeText(this, "支付成功", Toast.LENGTH_LONG).show();
                }
                else {
                    Toast.makeText(this, "支付失败", Toast.LENGTH_LONG).show();
                }
                finish();
            }
        }
    
    

    到此微信支付也就完成了,是不是很简单呀。

    签名问题

    前面提到,有时候签名会让客户端来做,那么我们就来看看签名怎么来搞搞吧。
    先看看官方的签名规则:

    Paste_Image.png

    仔细阅读上面的签名规则,应该不难理解。理解不了也没关系,下面就是我写好的代码:

        /**
         * 调起微信APP支付,签名
         */
        public static String genPackageSign2(List<NameValuePair> params) {
            StringBuilder sb = new StringBuilder();
    
            for (int i = 0; i < params.size(); i++) {    //将参数拼接成键值对样式的字符串
                sb.append(params.get(i).getName());
                sb.append('=');
                sb.append(params.get(i).getValue());
                sb.append('&');
            }
            sb.append("key=");
            sb.append(Constants.API_KEY); //拼接key
    
            //进行MD5加密,并转为大写
            String packageSign = MD5.getMessageDigest(sb.toString().getBytes()).toUpperCase();
            return packageSign;    //返回签名
        }
    
         /**
         * MD5加密算法
         */
        public final static String getMessageDigest(byte[] buffer) {
            char hexDigits[] = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f' };
            try {
                MessageDigest mdTemp = MessageDigest.getInstance("MD5");
                mdTemp.update(buffer);
                byte[] md = mdTemp.digest();
                int j = md.length;
                char str[] = new char[j * 2];
                int k = 0;
                for (int i = 0; i < j; i++) {
                    byte byte0 = md[i];
                    str[k++] = hexDigits[byte0 >>> 4 & 0xf];
                    str[k++] = hexDigits[byte0 & 0xf];
                }
                return new String(str);
            } catch (Exception e) {
                return null;
            }
    
    

    三、微信支付的封装

    由于微信支付不涉及很多业务逻辑,因此完全可以封装成工具类。这里对微信支付做了封装,并且用了Builder设计模块(类似Dialog的使用)。
    封装后的使用案例:

            //在服务端签名
            findViewById(R.id.btn1).setOnClickListener(new View.OnClickListener() {
                @Override
                public void onClick(View view) {
                    //假装请求了服务器 获取到了所有的数据
                    WXPayUtils.WXPayBuilder builder = new WXPayUtils.WXPayBuilder();
                    builder.setAppId("123")
                            .setPartnerId("56465")
                            .setPrepayId("41515")
                            .setPackageValue("5153")
                            .setNonceStr("5645")
                            .setTimeStamp("56512")
                            .setSign("54615")
                            .build().toWXPayNotSign(MainActivity.this,"123");
                }
            });
            //在客户端签名
            findViewById(R.id.btn2).setOnClickListener(new View.OnClickListener() {
                @Override
                public void onClick(View view) {
                    //假装请求了服务端信息,并获取了appid、partnerId、prepayId
                    WXPayUtils.WXPayBuilder builder = new WXPayUtils.WXPayBuilder();
                    builder.setAppId("123")
                            .setPartnerId("213")
                            .setPrepayId("3213")
                            .setPackageValue("Sign=WXPay")
                            .build()
                            .toWXPayAndSign(MainActivity.this,"123","key");
                }
            });
    

    经过这样封装后,下次再接入微信支付就简单多了。会少走很多弯路。
    微信支付到此也就总结完了,是不是感觉很简单呢,不过一定要注意别掉坑里。
    详细代码请参考github:https://github.com/chaohengxing/WXPayUtils.git

    另外在开发中遇到问题可以直接私信我,希望可以帮助到大家

    相关文章

      网友评论

        本文标题:Android集成支付----微信支付总结与封装

        本文链接:https://www.haomeiwen.com/subject/gulqhxtx.html