JAVA实操项目:转账接口设计

时间:2024-07-06 08:37:32

JAVA实操项目:转账接口设计

  在一个项目中,一般都会支付相关的业务,而涉及到支付必定会有转账的操作,转账这一步想起来算是比较关键的部分,这个接口的设计能力,也大致体现出一个人的水平。

  昨天碰到了一个题目:

  尝试用java编写一个转账接口,传入主要业务参数包括转出账号,转入账号,转账金额,完成转出和转入账号的资金处理,该服务要确保在资金处理时转出账户的余额不会透支,金额计算准确。

  设计

  首先一般在系统中的参数不会有这么少,一般情况下请求参数还会有一些公共的信息,比如请求来源(请求ip与系统)、请求流水号,请求时间,等信息。网关上一般会拦截一些不合法的请求

  如果有返回结果,一般包含处理结果,响应时间,处理后的状态,原始的请求信息一般也会返回去

  看要求是否有强一致性的需求,如果没有强一致性的需求,是否要及时返回结果。根据需求做出来,如果不用实时返回结果,可以在后端不断的重试,知道有最终结果,有强一致性的要求,则需要做一些特殊处理,如果没有保证最终一致性即可。

  幂等性设计,一个唯一的请求流水号只能对应一笔支付,防止重复扣款

  可能会涉及到一些其它的远程服务,做一些操作,这里就需要根据与其它系统协商来处理,当然这个接口的入参也要与会调用这个系统的人说下

  题目说的,要对余额做判断,内部要判断用户的资金是否足够。可以从数据库层面上,让用户的余额不能小于0。金额计算准确,一般用BigDecimal。

  写代码的时候注意一些规范事项

  内部注意一些限制条件,账户是否合法

  代码

  我的代码里面没有做幂等性的处理。可能代码还有一些其它的问题,如果有没考虑到的点,欢迎指出

  package me.aihe.demo;

  import org.springframework.transaction.annotation.Transactional;

  import org.springframework.util.StringUtils;

  import java.math.BigDecimal;

  import java.util.HashMap;

  /**

  * 尝试用java编写一个转账接口,传入主要业务参数包括转出账号,

  * 转入账号,转账金额,完成转出和转入账号的资金处理,

  * 该服务要确保在资金处理时转出账户的余额不会透支,金额计算准确。

  */

  public class FirstProblem {

  /**

  * 假设这个东西是一个远程服务名称

  */

  private String checkAmoutisEnoughRemoteService = 一个可以校验用户余额是否足够的远程服务;

  /*

  * 题目分析:

  * 定义接口:

  * 入参: 转出账号 转入账号 转账金额

  * 要求:

  * 完成转出转入账号的资金处理

  * 处理时转出账户的余额不会透支 fromPerson 要判断余额是否足够

  * 金额准确 使用BigDeceimal

  *

  * 疑问:

  * 是否需要返回值?还是只是一次处理即可

  *

  *

  * 关键点:

  * 关键操作记得打日志

  * 如果存在并发情况记得加分布式锁

  * 其余的根据需求,是否做一些额外控制,比如限流,回滚,重试

  * 如果远程调用可能存在等待状态,可以进行重试,尽可能的同步,

  * 如果可以异步,后台加定时任务进行异步数据查询并更新

  *

  */

  // 我在这里直接写接口,就不定义类的名称了,如果需要也可以定义一下类的名字

  // 因为不是接口,我先把方法留空

  /**

  * 转账接口,尝试用java编写一个转账接口,传入主要业务参数包括转出账号,

  * 转入账号,转账金额,完成转出和转入账号的资金处理,

  * 该服务要确保在资金处理时转出账户的余额不会透支,金额计算准确。

  *

  * @author he.ai 2019-04-18 20:16

  *

  * @param sourceAccount 题目中的转出账号,也就是从谁哪里把钱拿出来

  * @param destAccout 题目中的转入账号,也就是钱转给谁

  * @param amout 定义为字符串,是想将字符串转为BigDecimal,传入BigDeceimal也是可以的,可以再做商量

  *

  * 假设这里需要返回结果的话,一般会用公用的Result类,封装远程调用的code,结果,已经数据之类的

  */

  void transfer(

  String sourceAccount,

  String destAccout,

  String amout

  ){

  // 假设这里我们可以获取到转出账号(sourceAccout)的余额

  // 来源可以为:远程调用服务,直接从数据库拿,总之要能获取到当前账户的余额

  // 1. 首先对参数进行校验,是否合法

  // 如果有异常的话,需定义异常在什么位置进行处理

  checkParam(sourceAccount, destAccout, amout);

  // 也可以对账户是否存在做一次检验

  // 2. 校验转出账号的余额是否足够,这一步看我们是否有权限,

  // 如果我们没有权限获取用户的余额信息,需调用有权限的部门进行判断

  // 我这里假设的是我们没有权限知道用户的余额,需要判断

  // 调用远程的参数,这个入参需要根据与其他系统进行协商

  HashMapmap = new HashMap();

  map.put(account,sourceAccount);

  map.put(amount,amout);

  Result result = callRemoteService(checkAmoutisEnoughRemoteService, map);

  // 对result进行处理

  // 进行判断用户余额是否足够,我就不写判断逻辑了

  // 3. 进行转账操作,代码能运行到这里,代表用户账户是ok的,余额也是ok的

  // 至于什么风险控制,用户是否有安全隐患,看需求,以及其它的系统

  // 这里看要求是否要有一个全局事务进行控制,如果对数据的一致性要求很高,那么可以做全局的事务控制

  // 如果这里对数据的一致性要求不高,那么我们可以先进行出来,再补写定时任务,或者采用异步通知的方式

  // 甚至可以加锁

  doTransfer(sourceAccount,destAccout,amout);

  // 到这一步,假设钱已经转好了,看要求是否要通知其他的业务系统

  sendNotifytoOthers();

  }

  private void sendNotifytoOthers() {

  }

  /**

  * 假设这里有个全局事务,本地事务也行

  */

  @Transactional(rollbackFor = Exception.class)

  public void doTransfer(String sourceAccount, String destAccout, String amout) {

  // 其实既然让我们做了,我们应该是有权限获取余额的

  // 假设我们这里获取到了用户的余额,当然调用其他的系统,真正做也有可能

  // 但是我们还是要有一份备份数据

  // 用户的余额,这一步要根据系统要求,看看从哪里获取

  BigDecimal sourceLeftMoney = new BigDecimal(1000);

  BigDecimal destLeftMoney = new BigDecimal(200);

  // 再做一个假设,如果我们有权限,我就直接更新了,上面的校验也不用调用远程服务了

  // 这里一般的ORM框架,可以帮我们进行转换

  // update userDatabase set rest_money = (sourceLeftMoney - amout) where rest_money = sourceLeftMoney and accout = sourceAccount

  // 记得打日志。

  updatesourceAccount(sourceAccount,amout);

  // 这里的剩余金额是转入账户的剩余金额

  // update userDatabase set rest_money = (destLeftMoney + amout) where rest_money = destLeftMoney and accout = destAccout

  updatedestAccout(destAccout,amout);

  }

  private void updatedestAccout(String destAccout, String amout) {

  }

  private void updatesourceAccount(String sourceAccount, String amout) {

  }

  /**

  * 工具方法,可以直接调用远程服务

  * @param checkAmoutisEnoughRemoteService

  * @param map

  */

  private Result callRemoteService(String checkAmoutisEnoughRemoteService, HashMapmap) {

  // 远程服务的处理逻辑

  return null;

  }

  static class Result{

  }

  /**

  * 其实这里的多个参数可以封装为一个对象的,就不用专递这么多参数

  * @param sourceAccount

  * @param destAccout

  * @param amout

  */

  private void checkParam(String sourceAccount, String destAccout, String amout) {

  if (StringUtils.isEmpty(sourceAccount)){

  // 这个业务异常,项目内一般都有自己项目的业务异常,这里为了方便就抛出了运行时异常

  // 至于异常的补货,根据项目选择是在当前进行捕获,或者丢给全局异常进行捕获

  // 这里为了方便,我就不捕获异常了

  // 如果是关键业务,可以尝试发出报警

  throw new RuntimeException(业务异常 + 转出账号为空);

  }

  // 可以根据不同的参数,抛出不同的异常

  if (StringUtils.isEmpty(destAccout)){

  throw new RuntimeException(业务异常: + 转入账号为空);

  }

  if (StringUtils.isEmpty(amout)){

  throw new RuntimeException(转账金额为空);

  }

  }

  }