LeonaClient (leona-java 1.1.3 API)

java.lang.Object
- com.lehuipay.leona.LeonaClient

所有已实现的接口:

Client
```
public class LeonaClient
extends Object
implements Client
```
LeonaClient一个线程安全的, 支持异步的, 可复用的客户端工具类. 多个请求请使用同一个LeonaClient实例, 避免重复初始化. Client client = LeonaClient.builder() .setAgentID(agent_id) .setAgentKey(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 QRCodePaymentRequest request = QRCodePaymentRequest.builder() .setMerchantID(merchantID) .setTerminalID("2") .setOrderNo("20200313000000000001") .setAmount(1) .setTags(new String[]{"tag1", "tag2"}) .build(); client.createQRCodePayment(request, (e, data) -> { if (e != null) { System.err.println(e); return; } System.out.println(data); }); } catch (LeonaException e) { System.err.println(e); } // 同步 try { final QRCodePayRequest request = QRCodePayRequest.builder() * .setMerchantID(merchantID) * .setTerminalID("2") * .setOrderNo("20200313000000000001") * .setAmount(1) * .setTags(new String[]{"tag1", "tag2"}) * .build(); final QRCodePaymentResponse response = client.createQRCodePayment(request); System.out.println(response); } catch (LeonaException e) { System.err.printf(e); }
该类所有同步的http请求都会抛出LeonaException. 具体情况为--加签验签, 加密解密, 网络IO异常, httpRequest返回状态码不为200, 统一抛出LeonaException, 区别在于LeonaException的getType, getCode, getMessage方法各自拥有不同的结果. 异常结果详见枚举类 LeonaErrorCodeEnum. httpRequest返回状态码不为200返回的LeonaException是responseBody的封装, 具体内容见合作伙伴平台API手册
而该类所有异步的http请求也会抛出LeonaException. 情况为--加签验签, 加密解密, 网络IO异常. httpRequest返回状态码不为200的异常情况不在其中, 而在方法的callback参数中进行处理.

另请参阅:

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

嵌套类概要

嵌套类
限定符和类型类和说明

static class LeonaClient.Builder

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

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`static LeonaClient.Builder`	`builder()`
`JspayPaymentResponse`	`createJspayPayment(JspayPaymentRequest req)` 消费者扫商家二维码支付
`void`	`createJspayPayment(JspayPaymentRequest req, Callback<JspayPaymentResponse> callback)` 消费者扫商家二维码支付(异步)
`MicropayPaymentResponse`	`createMicropayPayment(MicropayPaymentRequest req)` 刷卡交易
`void`	`createMicropayPayment(MicropayPaymentRequest req, Callback<MicropayPaymentResponse> callback)` 刷卡交易(异步)
`QRCodePaymentResponse`	`createQRCodePayment(QRCodePaymentRequest req)` 二维码支付
`void`	`createQRCodePayment(QRCodePaymentRequest req, Callback<QRCodePaymentResponse> callback)` 二维码支付(异步)
`RefundResponse`	`createRefund(RefundRequest req)` 退款
`void`	`createRefund(RefundRequest req, Callback<RefundResponse> callback)` 退款(异步)
`void`	`downloadBills(DownloadBillsRequest req, Callback<OutputStream> callback)` 获取账单(异步)
`void`	`downloadBills(DownloadBillsRequest req, OutputStream dst)` 获取账单
`Options`	`getOptions()` 获得LeonaClient的初始化参数
`QueryBalanceResponse`	`queryBalance(QueryBalanceRequest req)` 查询账户余额
`void`	`queryBalance(QueryBalanceRequest req, Callback<QueryBalanceResponse> callback)` 查询账户余额(异步)
`QueryPaymentResponse`	`queryPayment(QueryPaymentRequest req)` 查询交易
`void`	`queryPayment(QueryPaymentRequest req, Callback<QueryPaymentResponse> callback)` 查询交易(异步)
`QueryRefundResponse`	`queryRefund(QueryRefundRequest req)` 查询退款
`void`	`queryRefund(QueryRefundRequest req, Callback<QueryRefundResponse> callback)` 查询退款(异步)
`QueryWithdrawalResponse`	`queryWithdrawal(QueryWithdrawalRequest req)` 查询提现结果
`void`	`queryWithdrawal(QueryWithdrawalRequest req, Callback<QueryWithdrawalResponse> callback)` 查询提现结果(异步)
`WithdrawResponse`	`withdraw(WithdrawRequest req)` 手动提现
`void`	`withdraw(WithdrawRequest req, Callback<WithdrawResponse> callback)` 手动提现(异步)

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - builder
```
public static LeonaClient.Builder builder()
```
  - createQRCodePayment
```
public QRCodePaymentResponse createQRCodePayment(QRCodePaymentRequest req)
                                          throws LeonaException
```
    二维码支付
    
    指定者:
    
    createQRCodePayment 在接口中 Client
    
    参数:
    
    req - 请求体
    
    返回:
    
    二维码支付结果
    
    抛出:
    
    LeonaException - 说明见类文档
  - createQRCodePayment
```
public void createQRCodePayment(QRCodePaymentRequest req,
                                Callback<QRCodePaymentResponse> callback)
                         throws LeonaException
```
    二维码支付(异步)
    
    指定者:
    
    createQRCodePayment 在接口中 Client
    
    参数:
    
    req - 请求体
    
    callback - Callback, 定义了请求失败与成功时应有的操作, 详见接口说明
    
    抛出:
    
    LeonaException - 说明见类文档
  - createMicropayPayment
```
public MicropayPaymentResponse createMicropayPayment(MicropayPaymentRequest req)
                                              throws LeonaException
```
    刷卡交易
    
    指定者:
    
    createMicropayPayment 在接口中 Client
    
    参数:
    
    req - 请求体
    
    返回:
    
    刷卡交易结果
    
    抛出:
    
    LeonaException - 说明见类文档
  - createMicropayPayment
```
public void createMicropayPayment(MicropayPaymentRequest req,
                                  Callback<MicropayPaymentResponse> callback)
                           throws LeonaException
```
    刷卡交易(异步)
    
    指定者:
    
    createMicropayPayment 在接口中 Client
    
    参数:
    
    req - 请求体
    
    callback - Callback, 定义了请求失败与成功时应有的操作, 详见接口说明
    
    抛出:
    
    LeonaException - 说明见类文档
  - queryPayment
```
public QueryPaymentResponse queryPayment(QueryPaymentRequest req)
                                  throws LeonaException
```
    查询交易
    
    指定者:
    
    queryPayment 在接口中 Client
    
    参数:
    
    req - 请求体
    
    返回:
    
    查询交易结果
    
    抛出:
    
    LeonaException - 说明见类文档
  - queryPayment
```
public void queryPayment(QueryPaymentRequest req,
                         Callback<QueryPaymentResponse> callback)
                  throws LeonaException
```
    查询交易(异步)
    
    指定者:
    
    queryPayment 在接口中 Client
    
    参数:
    
    req - 请求体
    
    callback - Callback, 定义了请求失败与成功时应有的操作, 详见接口说明
    
    抛出:
    
    LeonaException - 说明见类文档
  - createRefund
```
public RefundResponse createRefund(RefundRequest req)
                            throws LeonaException
```
    退款
    
    指定者:
    
    createRefund 在接口中 Client
    
    参数:
    
    req - 请求体
    
    返回:
    
    退款结果
    
    抛出:
    
    LeonaException - 说明见类文档
  - createRefund
```
public void createRefund(RefundRequest req,
                         Callback<RefundResponse> callback)
                  throws LeonaException
```
    退款(异步)
    
    指定者:
    
    createRefund 在接口中 Client
    
    参数:
    
    req - 请求体
    
    callback - Callback, 定义了请求失败与成功时应有的操作, 详见接口说明
    
    抛出:
    
    LeonaException - 说明见类文档
  - queryRefund
```
public QueryRefundResponse queryRefund(QueryRefundRequest req)
                                throws LeonaException
```
    查询退款
    
    指定者:
    
    queryRefund 在接口中 Client
    
    参数:
    
    req - 请求体
    
    返回:
    
    查询退款结果
    
    抛出:
    
    LeonaException - 说明见类文档
  - queryRefund
```
public void queryRefund(QueryRefundRequest req,
                        Callback<QueryRefundResponse> callback)
                 throws LeonaException
```
    查询退款(异步)
    
    指定者:
    
    queryRefund 在接口中 Client
    
    参数:
    
    req - 请求体
    
    callback - Callback, 定义了请求失败与成功时应有的操作, 详见接口说明
    
    抛出:
    
    LeonaException - 说明见类文档
  - queryBalance
```
public QueryBalanceResponse queryBalance(QueryBalanceRequest req)
                                  throws LeonaException
```
    查询账户余额
    
    指定者:
    
    queryBalance 在接口中 Client
    
    参数:
    
    req - 请求体
    
    返回:
    
    查询余额结果
    
    抛出:
    
    LeonaException - 说明见类文档
  - queryBalance
```
public void queryBalance(QueryBalanceRequest req,
                         Callback<QueryBalanceResponse> callback)
                  throws LeonaException
```
    查询账户余额(异步)
    
    指定者:
    
    queryBalance 在接口中 Client
    
    参数:
    
    req - 请求体
    
    callback - Callback, 定义了请求失败与成功时应有的操作, 详见接口说明
    
    抛出:
    
    LeonaException - 说明见类文档
  - withdraw
```
public WithdrawResponse withdraw(WithdrawRequest req)
                          throws LeonaException
```
    手动提现
    
    指定者:
    
    withdraw 在接口中 Client
    
    参数:
    
    req - 请求体
    
    返回:
    
    手动提现结果
    
    抛出:
    
    LeonaException - 说明见类文档
  - withdraw
```
public void withdraw(WithdrawRequest req,
                     Callback<WithdrawResponse> callback)
              throws LeonaException
```
    手动提现(异步)
    
    指定者:
    
    withdraw 在接口中 Client
    
    参数:
    
    req - 请求体
    
    callback - Callback, 定义了请求失败与成功时应有的操作, 详见接口说明
    
    抛出:
    
    LeonaException - 说明见类文档
  - queryWithdrawal
```
public QueryWithdrawalResponse queryWithdrawal(QueryWithdrawalRequest req)
                                        throws LeonaException
```
    查询提现结果
    
    指定者:
    
    queryWithdrawal 在接口中 Client
    
    参数:
    
    req - 请求体
    
    返回:
    
    提现结果
    
    抛出:
    
    LeonaException - 说明见类文档
  - queryWithdrawal
```
public void queryWithdrawal(QueryWithdrawalRequest req,
                            Callback<QueryWithdrawalResponse> callback)
                     throws LeonaException
```
    查询提现结果(异步)
    
    指定者:
    
    queryWithdrawal 在接口中 Client
    
    参数:
    
    req - 请求体
    
    callback - Callback, 定义了请求失败与成功时应有的操作, 详见接口说明
    
    抛出:
    
    LeonaException - 说明见类文档
  - downloadBills
```
public void downloadBills(DownloadBillsRequest req,
                          OutputStream dst)
                   throws LeonaException
```
    获取账单
    
    指定者:
    
    downloadBills 在接口中 Client
    
    参数:
    
    req - 请求体
    
    抛出:
    
    LeonaException - 说明见类文档
  - downloadBills
```
public void downloadBills(DownloadBillsRequest req,
                          Callback<OutputStream> callback)
                   throws LeonaException
```
    获取账单(异步)
    
    指定者:
    
    downloadBills 在接口中 Client
    
    参数:
    
    req - 请求体
    
    callback - Callback, 定义了请求失败与成功时应有的操作, 详见接口说明
    
    抛出:
    
    LeonaException - 说明见类文档
  - createJspayPayment
```
public JspayPaymentResponse createJspayPayment(JspayPaymentRequest req)
                                        throws LeonaException
```
    消费者扫商家二维码支付
    
    指定者:
    
    createJspayPayment 在接口中 Client
    
    参数:
    
    req - 请求体
    
    返回:
    
    提现结果
    
    抛出:
    
    LeonaException - 说明见类文档
  - createJspayPayment
```
public void createJspayPayment(JspayPaymentRequest req,
                               Callback<JspayPaymentResponse> callback)
                        throws LeonaException
```
    消费者扫商家二维码支付(异步)
    
    指定者:
    
    createJspayPayment 在接口中 Client
    
    参数:
    
    req - 请求体
    
    callback - Callback, 定义了请求失败与成功时应有的操作, 详见接口说明
    
    抛出:
    
    LeonaException - 说明见类文档
  - getOptions
```
public Options getOptions()
```
    获得LeonaClient的初始化参数
    
    返回:
    
    LeonaClient属性参数

类 LeonaClient

嵌套类概要

方法概要

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

方法详细资料

builder

createQRCodePayment

createQRCodePayment

createMicropayPayment

createMicropayPayment

queryPayment

queryPayment

createRefund

createRefund

queryRefund

queryRefund

queryBalance

queryBalance

withdraw

withdraw

queryWithdrawal

queryWithdrawal

downloadBills

downloadBills

createJspayPayment

createJspayPayment

getOptions