EasyPay2.0.0正式发布----让Android支付功能集成极限提速

EasyPay GitHub源码连接

Vision (愿景)

成为Android平台最便捷易用的支付框架

---

Introduction（介绍）

EasyPay(易支付)集成并高度封装了Android平台的微信支付，支付宝支付以银联支付。使用此库，开发者可使用简单轻松方便的 Api 实现支付功能，大量节省集成配置时间。

This is a library for Android Developers easily to use Alipay, WechatPay and UnionPay in Android project.

---

Why （为何有这个库）

不想听我这三几段废话的能够直接跳到下面 Usage(使用) 直接使用啦。

1. 支付平台众多。微信、支付宝、银联、京东、美团、百度等等，须要阅读各家文档，耗费大量时间精力。
2. 集成步骤繁琐。集成过微信支付都知道，必须在包名下配置 ${applicationId}.wxapi.WXPayEntryActivity。。。
3. Api 调用方式不一致。一样的功能，代码差别很大，增长理解成本。
4. 支付结果接收逻辑分散。调用方法与接受结果代码不在同一个地方，逻辑分散，可读性和可维护性差。

Think deeply (思考与指望)

咱们能不能有一种多合一的库，能够省去纷繁的集成步骤，以统一的集成方式，统一的Api调用，统一的回调接收逻辑，同时兼具轻松扩展新的支付方式的能力，以知足支付功能需求。

我给出的答案就是 EasyPay。EasyPay 已诞生三年，使用其实现支付功能的App超3000+，以其极简单的Api实现了多种支付功能获得开发者承认。

How (解决什么问题）

1. EasyPay 用巧妙方式省去了微信支付必须配置wxapi.WXPayActivity的步骤，在客户端甚至你都不须要配置微信AppId
2. EasyPay 分别封装了微信支付、支付宝支付、银联支付，单独成库，按需集成，全部库集成均一句代码完成
3. EasyPay 统一支付调用接口，统一支付结果接收回调，调用代码与接收结果代码集中在一块儿
4. EasyPay 预留扩展其余支付方式接口
5. EasyPay 甚至抽空用反射解决了银联SDK因持有静态Context致使的内存泄漏问题（该问题三年前我反映后六个月也没解决。。。，因此只有本身动手，丰衣足食）
6. EasyPay 让你省出时间陪女友，哈哈哈哈哈哈（if 没有 那省出时间让你去找啊，还期望我给你new 一个对象啊。。。）

有人会说，No Picture, you say a XX。OK, 明白的，安排！

Screenshot（支付效果图）

---

Usage（使用）

使用步骤很是简单，总共两步：1.集成依赖库；2.相关支付Api调用。

使用步骤1、 集成依赖库

集成方式有如下两种，根据须要选择其中一种集成便可：

远程依赖库集成方式 Or 下载源码做为Module导入集成方式；

远程依赖库集成方式

在Project中主App模块中的build.gradle的dependencies块中添加如下依赖：

1) EasyPay支付基类库（必选）:

注意：本步骤必须添加，由于该库是EasyPay基类库

implementation 'com.xgr.easypay:EasyPay:2.0.0'
复制代码

2) 根据须要集成微信支付、支付宝支付、银联支付

注意：如下三个库可根据实际须要增删

1）微信支付集成（可选）：

implementation 'com.xgr.easypay:wechatpay:2.0.0'
复制代码

2）支付宝支付集成（可选）：

implementation 'com.xgr.easypay:alipay:2.0.0'
复制代码

3）银联支付集成（可选）：

implementation 'com.xgr.easypay:unionpay:2.0.0'
复制代码

远程依赖集成方式到此结束。

下载源码后做为module导入：

1) 集成基类依赖库（必选）：

implementation project(':easypay') 复制代码

2) 根据须要集成其余支付依赖库

1）微信支付集成（可选）：

implementation project(':wechatpay') 复制代码

2）支付宝集成（可选）：

implementation project(':alipay') 复制代码

3）银联支付集成（可选）：

implementation project(':unionpay') 复制代码

下载源码做为Module导入集成方式到此结束。

---

使用步骤2、相关支付Api调用

微信支付（共两步）

1）配置

在项目主App模块的build.gradle文件的android{}块->defaultConfig{}块中配置applicationId,具体以下：

manifestPlaceholders = [
                APPLICATION_ID: applicationId,
        ]
复制代码

2）api调用

private void wxpay(){
        //实例化微信支付策略
        WXPay wxPay = WXPay.getInstance();
        //构造微信订单实体。通常都是由服务端直接返回。
        WXPayInfoImpli wxPayInfoImpli = new WXPayInfoImpli();
        wxPayInfoImpli.setTimestamp("");
        wxPayInfoImpli.setSign("");
        wxPayInfoImpli.setPrepayId("");
        wxPayInfoImpli.setPartnerid("");
        wxPayInfoImpli.setAppid("");
        wxPayInfoImpli.setNonceStr("");
        wxPayInfoImpli.setPackageValue("");
        //策略场景类调起支付方法开始支付，以及接收回调。
        EasyPay.pay(wxPay, this, wxPayInfoImpli, new IPayCallback() {
            @Override
            public void success() {
                toast("支付成功");
            }

            @Override
            public void failed(int code, String msg) {
                toast("支付失败");
            }

            @Override
            public void cancel() {
                toast("支付取消");
            }
        });
    }
复制代码

微信支付到此结束

支付宝支付（共一步）

private void alipay(){
        //实例化支付宝支付策略
        AliPay aliPay = new AliPay();
        //构造支付宝订单实体。通常都是由服务端直接返回。
        AlipayInfoImpli alipayInfoImpli = new AlipayInfoImpli();
        alipayInfoImpli.setOrderInfo("");
        //策略场景类调起支付方法开始支付，以及接收回调。
        EasyPay.pay(aliPay, this, alipayInfoImpli, new IPayCallback() {
            @Override
            public void success() {
                toast("支付成功");
            }

            @Override
            public void failed(int code, String msg) {
                toast("支付失败");
            }

            @Override
            public void cancel() {
                toast("支付取消");
            }
        });
    }
复制代码

支付宝支付到此结束

银联支付（共一步）

private void unionpay(){
        //实例化银联支付策略
        UnionPay unionPay = new UnionPay();
        //构造银联订单实体。通常都是由服务端直接返回。测试时能够用Mode.TEST,发布时用Mode.RELEASE。
        UnionPayInfoImpli unionPayInfoImpli = new UnionPayInfoImpli();
        unionPayInfoImpli.setTn("814144587819703061900");
        unionPayInfoImpli.setMode(Mode.TEST);
        //策略场景类调起支付方法开始支付，以及接收回调。
        EasyPay.pay(unionPay, this, unionPayInfoImpli, new IPayCallback() {
            @Override
            public void success() {
                toast("支付成功");
            }

            @Override
            public void failed(int code, String msg) {
                toast("支付失败");
            }

            @Override
            public void cancel() {
                toast("支付取消");
            }
        });
    }
复制代码

银联支付到此结束

---

项目实现介绍

易支付编码实现遵循设计模式六大原则，而且使用了单例以及策略模式来实现整个库,扩展性良好,能够轻松扩展其余支付方式。

├── activity
│   ├── UnionPayAssistActivity.java     //银联辅助Activity，负责调起银联支付接口以及接收回调。客户端无需关心。
│   └── WXPayEntryBaseActivity.java     //微信支付回调Activity封装。客户端需继承该Activity并实现getAppId()方法。
├── alipay
│   ├── AliPay.java                     //支付宝支付api封装，实现了IPayStrategy接口
│   ├── AlipayInfoImpli.java
│   └── AliPayResult.java
│   └── ResultCode.java
├── base
│   ├── IPayInfo.java                   //易支付支付信息基类接口
│   └── IPayStrategy.java               //易支付支付策略基类接口
├── callback
│   └── IPayCallback.java               //易支付统一回调接口
├── EasyPay.java                        //易支付场景类，客户端调用者
├── unionpay
│   ├── Mode.java
│   ├── UnionPay.java                   //银联支付api封装，，实现了IPayStrategy接口
│   └── UnionPayInfoImpli.java
│   └── UnionPayErrCode.java
└── wxpay
      ├── WXPay.java                      //微信支付api封装，实现了IPayStrategy接口
      └── WXPayInfoImpli.java
      └── WXErrCodeEx.java

复制代码

---

框架扩展新的支付平台（如美团、京东等其余支付）

EasyPay从立项之初，就充分考虑了代码扩展性，启用策略模式，所有采用面向接口编程，遵循依赖倒置设计原则。从支付基类扩展出新的支付很是容易。仅需三步。下面给出参考步骤。更具体请参照项目中支付宝或者微信或者银联支付方式封装。

1) 支付订单信息类实现IPayInfo接口

public class XXpayInfoImpli implements IPayInfo {
    public xxType xxField = xxx;
    public yyTYpe xxFiled = yyy;
    ...other Field
}
复制代码

2) 支付策略类实现IPayStrategy。

将第一步中支付实体类传入泛型。支付策略的初衷是将某种支付全部操做都进行集中封装，凡是业务须要用到该支付的地方，都调用这个类便可。

public class XXPay implements IPayStrategy<XXpayInfoImpli> {
    private AlipayInfoImpli alipayInfoImpli;
    private static IPayCallback sPayCallback;

    @Override
    public void pay(Activity activity, AlipayInfoImpli payInfo, IPayCallback payCallback) {
        this.mActivity = activity;
        this.alipayInfoImpli = payInfo;
        sPayCallback = payCallback;
    }
    
    ...other method
}
复制代码

完成上述两步后，根据业务在须要地方调用便可，须要注意是当某支付平台支付回调比较分散时，可在对应地方将调用转发给上述支付类便可。这样，能够将逻辑集中到一个类处理。如不理解这段话，能够看银联支付UnionPayAssistActivity中的onActivityResult()方法，就将逻辑转给 UnionPay.handleResult(this,data)处理了。

3）调用Api

//实例化支付策略
        XXpay xxPay = new XXPay();
        //构造支付宝订单实体。通常都是由服务端直接返回。
        XXpayInfoImpli xxpayInfoImpli = new XXpayInfoImpli();
        xxpayInfoImpli.setXXFiled();
        ...
        //策略场景类调起支付方法开始支付，以及接收回调。
        EasyPay.pay(xxPay, this, xxpayInfoImpli, new IPayCallback() {
            @Override
            public void success() {
                toast("支付成功");
            }

            @Override
            public void failed(int code, String message) {
                toast("支付失败");
            }

            @Override
            public void cancel() {
                toast("支付取消");
            }
        });
复制代码

扩展介绍到此结束

---

(ChangeLog) 更新日志

v2.0.0更新(2019/10/27)

1. 极限精简微信支付集成和使用步骤，并更新微信支付SDK
2. 更新支付宝SDK
3. 更新银联SDK
4. 支付回调fail方法返回code和message

---

联系我

1) 有问题提Issues。欢迎你们交流想法。

2) 邮箱联系(Email : kingofglory@yeah.net)

3) 付费加QQ群

关于为何，说几点：

1. 维护群和解答问题将耗费做者额外时间和精力；
2. 付费将迫使同窗们为了避免付费而更加认真去思考问题和查看源码；
3. 有同窗以为用了个人框架，节省了时间，提升了效率的，愿意请我喝杯咖啡交个朋友的，很是欢迎；
4. 有些同窗可能对本框架不熟悉或者碰到了其余Android支付问题，须要快速咨询的，能够考虑付费入群，不保证能解决，但会尽全力而为。

感谢你们，但愿一块儿起步。

加群步骤：扫码支付时备注：easypay+你的qq号。我看到后将拉你入群。付款不退，慎重考虑。

---

License

MIT License


Copyright (c) 2017 kingofglory


Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:


The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
复制代码