当前位置：首页 > news >正文

虚拟电商-话费充值业务（二）话费充值对接供应商模块开发

news 来源：原创 2025/7/14 9:22:08

一、对接供应商模块开发

供应商对接模块chongba_recharge_supplier主要负责的就是调用外部的供应商系统进行充值下单，这种调用是一种基于HTTP协议的调用。

此外在供应商对接模块中主要是实现的业务逻辑有：

1：余额或押金不足情况下的失败轮转

2：网络故障/充值失败重试，需要添加一个重试任务

3：重试次数到达阈值后停止供应商对接

4：供应商异步回调，订单状态修改

二、对接供应商服务接口定义

chongba_recharge_supplier监听到支付成功消息之后，接收到的消息：RechargeRequest，具体对接的不直接写在监听类中，单独定义一个对接供应商服务接口

步骤1：在chongba_recharge_supplier模块下创建包：com.chongba.supplier.inf，在该包下创建充吧系统对接供应商接口：SupplierService，接口中定义一个对接方法：void recharge(RechargeRequest rechargeRequest);

public interface SupplierService {/*** 对接供应商下单* @param rechargeRequest*/public void recharge(RechargeRequest rechargeRequest);
}

步骤2：在chongba_recharge_supplier模块下创建包：com.chongba.supplier.service，在该包下创建一个接口的实现类：SupplierServiceImpl

@Slf4j
@Service
public class SupplierServiceImpl implements SupplierService{    @Overridepublic void recharge(RechargeRequest rechargeRequest) {}
}

步骤3：配置供应商系统的接口地址，在实际业务中调用第三方系统接口大都基于HTTP协议调用，充吧系统在模块中模拟了两个供应商，注意这个模块并没有在充吧的注册中心去注册，因为我们模拟的是外部系统，所以我们要调用外部系统必须得知道系统接口的调用地址；

在application-dev.yml中配置如下：

supplier:apis: {"jisuapi": "http://127.0.0.1:8090/jisuapi/mobilerecharge/recharge","juheapi": "http://127.0.0.1:8090/juheapi/recharge"}

步骤4：编写配置类读取配置，在chongba_recharge_supplier模块下创建包：com.chongba.supplier.conf，在该包下创建配置类：SupplierConfig

@Data
@Component
@ConfigurationProperties(prefix = "supplier")
public class SupplierConfig {private Map<String,String> apis; //加载供应商api地址
}

步骤5：在对接服务实现类：SupplierServiceImpl中注入配置类SupplierConfig，并测试配置能否正常读取

@Slf4j
@Service
public class SupplierServiceImpl implements SupplierService{@Autowiredprivate SupplierConfig supplierConfig;@PostConstructpublic void init(){System.out.println("加载到的配置如下:"+supplierConfig.getApis());}@Overridepublic void recharge(RechargeRequest rechargeRequest) {}
}

运行启动类：SupplierApplication，查看控制台输出：

三、对接供应商逻辑编写

配置正常加载之后需要编写对接供应商的处理逻辑，先将代码结构实现，然后补充细节

1）.编写对接逻辑分发方法：doDispatchSupplier(RechargeRequest rechargeRequest)，根据供应商编号进行分发
2）.编写对接聚合的方法：doPostJuhe(RechargeRequest rechargeRequest)
3）.编写对接极速的方法：doPostJisu(RechargeRequest rechargeRequest)

对接第三方其实就是向第三方系统接口地址发起HTTP请求，我们可以使用HttpClient等工具。

步骤1：在启动类SupplierApplication中向容器注入RestTemplate

@Bean
public RestTemplate restTemplate(){return new RestTemplate();
}

步骤2：整体对接代码结构如下：

@Autowiredprivate RestTemplate restTemplate;

@Overridepublic void recharge(RechargeRequest rechargeRequest) {doDispatchSupplier(rechargeRequest);}/*** 对接逻辑分发* @param rechargeRequest*/private void doDispatchSupplier(RechargeRequest rechargeRequest) {//设置供应商的调用地址:String url = supplierConfig.getApis().get(rechargeRequest.getSupply());rechargeRequest.setRechargeUrl(url);
//根据需要对接的供应商的编号确定不同的对接方式---不同的api需要传递的参数类型和参数名称等各不相同if(Constants.juheapi.equals(rechargeRequest.getSupply())){//对接聚合doPostJuhe(rechargeRequest);}else if(Constants.jisuapi.equals(rechargeRequest.getSupply())) {//对接极速doPostJisu(rechargeRequest);}}private void doPostJuhe(RechargeRequest rechargeRequest) {//聚合要求传递的是json格式的数据//创建并设置请求头HttpHeaders headers = new HttpHeaders();headers.setContentType(MediaType.APPLICATION_JSON);//创建请求实体HttpEntity httpEntity = new HttpEntity(JSON.toJSONString(rechargeRequest),headers);//发送请求ResponseEntity<String> responseEntity = restTemplate.postForEntity(rechargeRequest.getRechargeUrl(), httpEntity, String.class);//获得结果String body = responseEntity.getBody();System.out.println(body);}
private void doPostJisu(RechargeRequest rechargeRequest) {}

然后注意：在我们监听类中监听到消息之后，要去调用我们供应商对接服务接口方法：

@Component
@Slf4j
@RocketMQMessageListener(topic = "pay",consumerGroup = "order-paid-consumer")
public class PayRocketListener implements RocketMQListener<RechargeRequest>{
@Autowiredprivate SupplierService supplierService;
/*** 监听消息:* @param rechargeRequest*/@Overridepublic void onMessage(RechargeRequest rechargeRequest) {log.info("PayRocketListener 监听到了消息,{}",rechargeRequest);supplierService.recharge(rechargeRequest);}
}

启动测试：

启动chongba_recharge_web工程，chongba_recharge_mock工程，chongba_recharge_supplier工程

访问：http://localhost:191/ 进行充值，查看结果

步骤3：供应商返回结果封装处理：对于供应商的返回结果数据我们可以统一封装处理

对进行泛型的反序列化，使用TypeReference可以明确的指定反序列化的类型

@Overridepublic void recharge(RechargeRequest rechargeRequest) {Result<RechargeResponse> result = doDispatchSupplier(rechargeRequest);if(result !=null){           }}/*** 对接逻辑分发* @param rechargeRequest*/private Result<RechargeResponse> doDispatchSupplier(RechargeRequest rechargeRequest) {//设置供应商的调用地址:String url = supplierConfig.getApis().get(rechargeRequest.getSupply());rechargeRequest.setRechargeUrl(url);
//根据需要对接的供应商的编号确定不同的对接方式---不同的api需要传递的参数类型和参数名称等各不相同if(Constants.juheapi.equals(rechargeRequest.getSupply())){//对接聚合return  doPostJuhe(rechargeRequest);}else if(Constants.jisuapi.equals(rechargeRequest.getSupply())) {//对接极速return  doPostJisu(rechargeRequest);}return null;}private Result<RechargeResponse> doPostJuhe(RechargeRequest rechargeRequest) {//聚合要求传递的是json格式的数据//创建并设置请求头HttpHeaders headers = new HttpHeaders();headers.setContentType(MediaType.APPLICATION_JSON);//创建请求实体HttpEntity httpEntity = new HttpEntity(JSON.toJSONString(rechargeRequest),headers);//发送请求ResponseEntity<String> responseEntity = restTemplate.postForEntity(rechargeRequest.getRechargeUrl(), httpEntity, String.class);//获得结果/*String body = responseEntity.getBody();// Result<RechargeResponse>Result result = JSON.parseObject(body, Result.class);//因为泛型的问题可能会导致出现问题System.out.println(body);*/Result<RechargeResponse> result = JSON.parseObject(responseEntity.getBody(), new TypeReference<Result<RechargeResponse>>(){});return result;}
// 对接极速private Result<RechargeResponse> doPostJisu(RechargeRequest rechargeRequest) {return null;}

四、对接供应商测试

业务逻辑：

选择手机充值进行话费充值。进行充值，然后支付成功。支付成功后，对接供应商模块，发送消息到供应商平台，然后接收聚合供应商返回的消息。进行处理。

选择充值：
在这里插入图片描述

进行充值：
在这里插入图片描述
充值话费成功：

对接供应商模块，发送消息到供应商平台，然后接收聚合供应商返回的消息（余额不足）。对接成功。

一、对接供应商模块开发

二、对接供应商服务接口定义

三、对接供应商逻辑编写

四、对接供应商测试

相关文章：