com.lehuipay.leona

类 LeonaClient

java.lang.Object

com.lehuipay.leona.LeonaClient

所有已实现的接口:

Leona

public class LeonaClient
extends Object
implements Leona

LeonaClient一个线程安全的, 支持异步的, 可复用的客户端工具类. 多个请求请使用同一个LeonaClient实例, 避免重复初始化. Leona client = new LeonaClient .Builder(agent_id, agent_key) // .setPartnerPriKey(cliPriKeyFilePath) // .setLhPubKey(serPubKeyFilePath) // .setSecretKey(secret_key) // .setEncryptionLevel(Const.HEADER_X_LEHUI_ENCRYPTION_LEVEL_L1) // .setEncryptionAccept(Const.HEADER_X_LEHUI_ENCRYPTION_LEVEL_L0) .build(); // 异步 try { final QRCodePayRequest req = new QRCodePayRequest(merchantID, "2", "xxxxxxx", 1, null, null); client.qrCodePay(req, (e, data) -> { if (e != null) { String type = e.getType(); String code = e.getCode(); String message = e.getMessage(); System.err.printf("type: %s, code: %s, message: %s\n", type, code, message); return; } System.out.println(data); }); } catch (LeonaException e) { String type = e.getType(); String code = e.getCode(); String message = e.getMessage(); System.err.printf("type: %s, code: %s, message: %s\n", type, code, message); // e.printStackTrace(); } // 同步 try { final QRCodePayRequest req = new QRCodePayRequest(merchantID, "2", "xxxxxxx", 1, null, null); final QRCodePayResponse resp = client.qrCodePay(req); System.out.println(resp); } catch (LeonaException e) { String type = e.getType(); String code = e.getCode(); String message = e.getMessage(); System.err.printf("type: %s, code: %s, message: %s\n", type, code, message); // e.printStackTrace(); }

该类所有同步的http请求都会抛出LeonaException. 具体情况为--加签验签, 加密解密, 网络IO异常, httpRequest返回状态码不为200, 统一抛出LeonaException, 区别在于LeonaException.getType(), LeonaException.getCode(), LeonaException.getMessage()各自拥有不同的结果. 异常结果详见枚举类 LeonaErrorCodeEnum. httpRequest返回状态码不为200返回的LeonaException是responseBody的封装, 具体内容见 合作伙伴平台API手册

而该类所有异步的http请求也会抛出LeonaException. 情况为--加签验签, 加密解密, 网络IO异常. httpRequest返回状态码不为200的异常情况不在其中, 而在方法的callback参数中进行处理.

另请参阅:

httpRequest返回状态码不为200情况下返回的{@code LeonaException}是responseBody的封装, 具体内容见 合作伙伴平台API手册

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	LeonaClient.Builder

方法概要

限定符和类型	方法和说明
Options	getOptions() 获得LeonaClient的初始化参数
Payment	getOrder(GetOrderRequest req) 查询交易
void	getOrder(GetOrderRequest req, Callback<Payment> callback) 查询交易(异步)
Refund	getRefund(GetRefundRequest req) 查询退款
void	getRefund(GetRefundRequest req, Callback<Refund> callback) 查询退款(异步)
Payment	microPay(MicroPayRequest req) 刷卡交易
void	microPay(MicroPayRequest req, Callback<Payment> callback) 刷卡交易(异步)
QRCodePayResponse	qrCodePay(QRCodePayRequest req) 二维码支付
void	qrCodePay(QRCodePayRequest req, Callback<QRCodePayResponse> callback) 二维码支付(异步)
Refund	refund(RefundRequest req) 退款
void	refund(RefundRequest req, Callback<Refund> callback) 退款(异步)

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

qrCodePay

public QRCodePayResponse qrCodePay(QRCodePayRequest req)
                            throws LeonaException

二维码支付

指定者:

qrCodePay 在接口中 Leona

参数:

req - 请求体

返回:

二维码支付结果

抛出:

LeonaException - 说明见类文档

qrCodePay

public void qrCodePay(QRCodePayRequest req,
                      Callback<QRCodePayResponse> callback)
               throws LeonaException

二维码支付(异步)

指定者:

qrCodePay 在接口中 Leona

参数:

req - 请求体

callback - Callback, 定义了请求失败与成功时应有的操作, 详见接口说明

抛出:

LeonaException - 说明见类文档

microPay

public Payment microPay(MicroPayRequest req)
                 throws LeonaException

刷卡交易

指定者:

microPay 在接口中 Leona

参数:

req - 请求体

返回:

刷卡交易结果

抛出:

LeonaException - 说明见类文档

microPay

public void microPay(MicroPayRequest req,
                     Callback<Payment> callback)
              throws LeonaException

刷卡交易(异步)

指定者:

microPay 在接口中 Leona

参数:

req - 请求体

callback - Callback, 定义了请求失败与成功时应有的操作, 详见接口说明

抛出:

LeonaException - 说明见类文档

getOrder

public Payment getOrder(GetOrderRequest req)
                 throws LeonaException

查询交易

指定者:

getOrder 在接口中 Leona

参数:

req - 请求体

返回:

查询交易结果

抛出:

LeonaException - 说明见类文档

getOrder

public void getOrder(GetOrderRequest req,
                     Callback<Payment> callback)
              throws LeonaException

查询交易(异步)

指定者:

getOrder 在接口中 Leona

参数:

req - 请求体

callback - Callback, 定义了请求失败与成功时应有的操作, 详见接口说明

抛出:

LeonaException - 说明见类文档

refund

public Refund refund(RefundRequest req)
              throws LeonaException

退款

指定者:

refund 在接口中 Leona

参数:

req - 请求体

返回:

退款结果

抛出:

LeonaException - 说明见类文档

refund

public void refund(RefundRequest req,
                   Callback<Refund> callback)
            throws LeonaException

退款(异步)

指定者:

refund 在接口中 Leona

参数:

req - 请求体

callback - Callback, 定义了请求失败与成功时应有的操作, 详见接口说明

抛出:

LeonaException - 说明见类文档

getRefund

public Refund getRefund(GetRefundRequest req)
                 throws LeonaException

查询退款

指定者:

getRefund 在接口中 Leona

参数:

req - 请求体

返回:

查询退款结果

抛出:

LeonaException - 说明见类文档

getRefund

public void getRefund(GetRefundRequest req,
                      Callback<Refund> callback)
               throws LeonaException

查询退款(异步)

指定者:

getRefund 在接口中 Leona

参数:

req - 请求体

callback - Callback, 定义了请求失败与成功时应有的操作, 详见接口说明

抛出:

LeonaException - 说明见类文档

getOptions

public Options getOptions()

获得LeonaClient的初始化参数

返回:

LeonaClient属性参数