5.2 Java SDK

<div hidden="">AI抽取开始标记</div>

# Java SDK 使用指南
通联支付数字营销平台Java SDK旨在降低对接门槛与成本，提供了一套功能完整的开发工具包，以帮助开发者快速完成平台集成。

### 前提条件

1. 已开通数字营销机构，详情请咨询业务对接人员。
2. 已获得接口对接参数，详情请咨询业务对接人员。

### 安装 SDK

#### 在 Maven 项目中加入依赖项（推荐方式）

在 Maven 工程中使用 Java SDK，只需在 pom.xml 中加入相应依赖即可。以 1.0.0 版本为例，步骤如下：

在 pom.xml 的 &lt;dependencies&gt; 中加入如下内容：
```xml 
<dependency>
    <groupId>com.allinpay.cus.sdk</groupId>
    <artifactId>allinpay-shopoint-sdk-java</artifactId>
    <version>1.0.0</version>
</dependency>
```

特殊情况处理：在无法访问 Maven 中央仓库的情况下，先下载 JAR 包（下载地址：[点击下载](https://repo1.maven.org/maven2/com/allinpay/cus/sdk/allinpay-shopoint-sdk-java/1.0.0/allinpay-shopoint-sdk-java-1.0.0.jar)），再将 JAR 安装到 Maven 仓库，使用如下命令：

```bash
mvn install:install-file -Dfile=.\allinpay-shopoint-sdk-java-1.0.0.jar -DgroupId=com.allinpay.cus.sdk -DartifactId=allinpay-shopoint-sdk-java -Dversion=1.0.0 -Dpackaging=jar
```

### 示例代码
#### 生成RSA秘钥对
本示例中，采用单元测试的方式生成RSA密钥对。示例如下：
```java
     /**
     * 生成RSA密钥对（2048位）
     */
    @Test
    public void generateRsaKey() {
        // 创建RSA对象，默认就是2048位
        RSA rsa = new RSA();

// 获取Base64编码的公钥
        String publicKey = rsa.getPublicKeyBase64();
        // 获取Base64编码的私钥
        String privateKey = rsa.getPrivateKeyBase64();

System.out.println("==============privateKey==============");
        System.out.println(privateKey);

System.out.println("==============publicKey==============");
        System.out.println(publicKey);

assertNotNull(publicKey);
        assertNotNull(privateKey);
    }
```
#### 生成SM2秘钥对
本示例中，采用单元测试的方式生成SM2密钥对。示例如下：
```java
    /**
     * 生成SM2密钥对
     */
    @Test
    public void generateSm2Key() {
        SM2 sm2 = new SM2();
        // 生成公钥
        String publicKey = sm2.getPublicKeyBase64();
        //生成私钥
        String privateKey = sm2.getPrivateKeyBase64();
        System.out.println("==============privateKey==============");
        System.out.println(privateKey);

System.out.println("==============publicKey==============");
        System.out.println(publicKey);
        assertNotNull(publicKey);
        assertNotNull(privateKey);
    }
```
#### 使用RSA调用
本示例中，采用单元测试的方式使用RSA签名算法调用 3.4统一查询 接口。示例如下：
```java
    /**
     * 单元测试：RSA接口调用示例
     */
    @Test
    public void testRSASimpleRequest() {
        // 数字营销接口地址：测试环境=https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/apiweb，生产环境=https://dms-api.shopoint.cn/shopoint-openapis-web/szyx/apiweb
        String endpoint = "https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/apiweb";
        // 数字营销分配的appid
        String appId = "PDlGLYa******";
        // 数字营销的RSA公钥
        String providerPublicKey = "MIGfMA0GCSq******";
        // 对接方的RSA私钥
        String callerPrivateKey = "MIICdwIBAD******";
        // 接口调用凭证（RSA）
        CredentialsProvider credsProvider = new OCPayRSACredentialsProvider(appId, providerPublicKey, callerPrivateKey);
        // 一码付接口client
        OCPayApisClient client = new OCPayApisClient(endpoint, credsProvider);

TreeMap<String, String> paramMap = new TreeMap<String, String>();
        paramMap.put("cusid", "266649");
        paramMap.put("version", "11");
        paramMap.put("reqsn", "202509108000002");
        paramMap.put("randomstr", UUID.randomUUID().toString());

try {
            Map<String, String> map = client.requestApis("/tranx/query", paramMap);
            assertTrue(Objects.nonNull(map.get("retcode")) && "SUCCESS".equals(map.get("retcode")));
        } catch (Exception e) {
            LogUtils.logException("testRSASimpleRequest:", e);
            fail();
        }

}
```
#### 使用SM2调用
本示例中，采用单元测试的方式使用SM2签名算法调用 3.4统一查询 接口。示例如下：
```java
    /**
     * 单元测试：SM2接口调用示例
     */
    @Test
    public void testSM2SimpleRequest() {
        // 数字营销接口地址：测试环境=https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/apiweb，生产环境=https://dms-api.shopoint.cn/shopoint-openapis-web/szyx/apiweb
        String endpoint = "https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/apiweb";
        // 数字营销分配的appid
        String appId = "DkbQWIj******";
        // 数字营销的SM2公钥
        String providerPublicKey = "MIGfMA0GCSq******";
        // 对接方的SM私钥
        String callerPrivateKey = "MIGTAgEAMBM******";
        // 接口调用凭证（SM2）
        CredentialsProvider credsProvider = new OCPaySM2CredentialsProvider(appId, providerPublicKey, callerPrivateKey);
        // 一码付接口client
        OCPayApisClient client = new OCPayApisClient(endpoint, credsProvider);

TreeMap<String, String> paramMap = new TreeMap<String, String>();
        paramMap.put("cusid", "266649");
        paramMap.put("version", "11");
        paramMap.put("reqsn", "202509108000002");
        paramMap.put("randomstr", UUID.randomUUID().toString());

try {
            Map<String, String> map = client.requestApis("/tranx/query", paramMap);
            assertTrue(Objects.nonNull(map.get("retcode")) && "SUCCESS".equals(map.get("retcode")));
        } catch (Exception e) {
            LogUtils.logException("testSM2SimpleRequest:", e);
            fail();
        }

}
```
#### 使用MD5调用（不推荐）
本示例中，采用单元测试的方式使用MD5签名算法调用 3.4统一查询 接口。示例如下：
```java
    /**
     * 单元测试：MD5接口调用示例
     */
    @Test
    public void testMD5SimpleRequest() {
        // 数字营销接口地址：测试环境=https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/apiweb，生产环境=https://dms-api.shopoint.cn/shopoint-openapis-web/szyx/apiweb
        String endpoint = "https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/apiweb";
        // 数字营销分配的appid
        String appId = "IisAYeM******";
        // 对接方的MD5秘钥
        String callerPrivateKey = "2368******";
        // 接口调用凭证（MD5）
        CredentialsProvider credsProvider = new OCPayMD5CredentialsProvider(appId, callerPrivateKey);
        // 一码付接口client
        OCPayApisClient client = new OCPayApisClient(endpoint, credsProvider);

TreeMap<String, String> paramMap = new TreeMap<String, String>();
        paramMap.put("cusid", "266649");
        paramMap.put("version", "11");
        paramMap.put("reqsn", "202509108000002");
        paramMap.put("randomstr", UUID.randomUUID().toString());

try {
            Map<String, String> map = client.requestApis("/tranx/query", paramMap);
            assertTrue(Objects.nonNull(map.get("retcode")) && "SUCCESS".equals(map.get("retcode")));
        } catch (Exception e) {
            LogUtils.logException("testMD5SimpleRequest:", e);
            fail();
        }

}
```
### 注意事项

• 请确保使用的 SDK 版本与接口版本匹配

• 如遇依赖冲突问题，请检查项目中是否存在相同组件的不同版本

• 生产环境建议使用最新的稳定版本

<div hidden="">AI抽取结束标记</div>