支付宝下载账单[下载+解压(中文转码)+过滤+保存数据库]

图片发自App

年初的时候，支付宝查询账单是通过账务明细分页查询接口“account.page.query”进行账单查询，通过调用该接口获取账单信息，返回的是xml格式的字符串信息。
根据返回的字符串进行过滤保存到数据库或者添加表头注释信息再生成账单文件（xxx.csv），xml格式字符串信息有限。直到年中的时候支付宝方面开放了账单下载的API接口，新增了操作员字段以及终端号等字段，我们可以调用下载账单的接口“alipay.data.dataservice.bill.downloadurl.query”获取账单的下载地址，打开地址时会保存账单的压缩文件，包括（账单汇总）、（账单明细）。

image.png

第一个为通过下载链接地址获得压缩文件，解压后里面包括之后两个文件。

正常情况下我们只需要“账单明细”这个文件中的内容，为了不占用电脑内存，我们把原压缩文件以及“账单汇总”进行过滤删除，最终只保留“账单明细”这个文件，用户需要的时候可以去下载查看。

账单明细文件内容

要保存到数据库的话就得把数据提取出来，每一行第一个字符串为“#”的以及表头都需要过滤掉，只留下中间的数据部分，再进行分割过滤从而获取到一小格一小格的字符串。

支付宝下载账单API

如上图所示，仅需提供两个入参bill_type,bill_date便可得到下载地址bill_download_url，一个是账单类型，一个是账单的时间（格式为yyyy-MM-dd）

支付宝API文档也提供各种版本的案例，这里只讲Java版本的

java调用支付宝下载账单API

整个过程大概分为以下几个步骤
(1)获取账单下载地址：String billUrl = getAliPayDownloadUrl();
(2)获取账单压缩文件名：String filename = getDownloadFileName(billUrl);
(3)创建账单压缩文件存放目录以及空压缩文件
(4)将内容写入空压缩文件：boolean downloadBill = toDownloadAliPayBill(billUrl,downloadUrl);
(5)解压压缩文件： FileUtil.unZip(downloadUrl,parientUrl);//解压账单文件
(6)过滤和删除无用的文件，获取业务明细文件内容 ：String billContent = getAliPayBillContent(parientUrl);
(7)过滤业务详情账单：content = readTxt(f.getPath())
(8)删除数据库中当天的账单数据
(9)保存新的账单数据至数据库

总基本流程

接下来一步步细讲
一、获取账单下载地址

image.png

二、获取账单文件名
在账单下载地址里面downloadFileName键后面的值就是，自己去通过字符串检索获取。

三、创建账单压缩文件存放目录记忆空压缩文件
根据自身所需自己解决

四、将内容写入空压缩文件

image.png

五、解压压缩文件

image.png

FileUtil是工具类，里面放了unZip方法，此处就是传参数进去解压文件，上图方法即unZip方法

六、过滤和删除无用的文件，获取业务明细文件内容

image.png

这里须特别注意，我账单压缩文件的解压是把文件解压到压缩文件同目录，为了遍历的时候删除，也可以解压成功后就删除，
这里有个问题，如果你在该目录下保存了其他的账单文件，名字不匹配全部会被删除，所以建议一个文件存放一个目录，例如我每个文件的目录是“D:\bill\aliPayBill\2018\12\20181207\aliPayBill.csv”
因为账单是一天一个的，放在同一个文件夹里面多了之后日后想找就麻烦，所以分类好。
至于改文件名，那是客户要求的，大家根据所需调整。

七、过滤业务详情账单
实际上是第六步里面就得执行的过程

image.png

• BufferedReader要传编码符GBK，否则会中文乱码
• 以“|”为分隔符分割每一行，后期分割的时候要添加转义符 String[] str = result.split("\|");

你可能会遇到的坑

• 获取不到账单下载地址？
  ①公共请求参数是否正确？
  ②请求参数类型是否匹配？账单时间格式为yyyy-MM-dd
  ③请求地址是否在支付宝平台设置的授权回调地址等信息？不管是微信还是支付宝，都需要配置回调地址，该过程称之为“握手”，把项目的域名配置进去，该域名下的所有请求地址都可以与支付宝进行连接，并不是什么项目都可以的。

• 解压一直失败报错？
  ①可能是文件流、字节流没有关闭？
  ②JDK1.7以上自带的FileZip包可以传编码GBK，以下的不能，所以会造成文件名乱码，百度下载ant的1.6.5版本的jar包，用ant中的FileZip包
  ③缓存问题，清掉缓存试试？

• 偶尔解压失败报错？
  ①是否解压成功的时候一高兴就打开文件看看，之后没关闭就再次执行？下载和解压时会删除已有的文件再创建新的，打开之后就被占用啦，没发删除，所以报错啦。

• 解压中文乱码？
  ①参考第二个第②条

以上内容为本人真实项目经验，第一次写这种业务功能，觉得有必要保存起来，也供大家参考，如果错误信息，请联系本人修改以免误导，或者你有更好的建议，欢迎交流。