微信小程序篇_01 微信小程序与Java后端接口交互

Posted 2023-04-09 凤文Studying

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了微信小程序篇_01 微信小程序与Java后端接口交互相关的知识，希望对你有一定的参考价值。

微信小程序与Java后端接口交互

- 准备
- - 创建后端项目
  - 创建小程序项目

本文主要介绍小程序前后端数据的交互，实践演示。

准备

创建后端项目

我这里就创建一个SpringBoot项目作为演示。

在创建项目中选择Spring Initializr

要勾选SpringWeb框架，当然你也可以后面导入，确认好设置后，创建项目。

然后在Maven依赖中调整SpringBoot的版本

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.8.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
        <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
<!--            <scope>test</scope>-->
        </dependency>
    </dependencies>

目录结构如下，缺少的自行创建：

配置文件application.yml配置如下（仅供参考），

server:
  port: 80
  servlet:
    context-path: /
    tomcat:
      uri-encoding: utf-8

代码HelloWeiXin类（后端接口，在controller层）：

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * @Author: Forward Seen
 * @CreateTime: 2022/04/22 17:10
 * @Description: 微信小程序请求接口
 */
@RestController
public class HelloWeXin 

    @RequestMapping("/getMessage")
    public String getMessage(Integer userId) 
        return "Hello,微信用户" + userId + "!";

测试，然后我们就可以在浏览器访问测试接口

这样我们的后端接口就创建完成了。

创建小程序项目

打开微信开发者工具，创建项目：
模板我使用javascript基础模板（js比较主流，推荐这个），创建即可。

具体的小程序学习请参考官方文档
学习起来很简单，我这里直接写案例代码了。
创建一个页面，wxml代码如下：

<!--pages/hello/helloworld.wxml-->
<text>后端返回的数据：message</text>

js代码如下

// pages/hello/helloworld.js
Page(
  /**
   * 页面的初始数据
   */
  data: 
    message: "请求中。。。",
  ,

  getData() 
    const that = this
    wx.request(
      url: 'http://localhost/getMessage',
      data: 
        userId: 666
      ,
      method: 'GET',
      success(res) 
        console.log("请求状态：" + res.statusCode)
        console.log(res.data)
        that.setData(
          message: res.data
        )
      
    )
  ,

  /**
   * 生命周期函数--监听页面加载
   */
  onLoad: function (options) 
    this.getData()
  ,

)

我对这几行代码有如下解释：
wx.request(Object)是请求的方法，具体用法请参考文档中API的网络，
其中url，data，method都是该Object的属性，显而易见，url就是请求的接口地址，data中存放的是请求的参数，method是请求方式，默认是get。
success(response)是一个函数，或者说对象中的方法，它是将请求成功返回来的结果拿回来，也就是回调，回来的就是一个响应对象，数据在响应对象的data属性中，我们操作它。

代码中有几个细节要注意：
我把回调过程都封装在getData方法中，在onLoad方法中调用，onLoad你可以理解为内置方法，它是在页面加载是自动调用的。
其次，在getData方法中使用了另一个对象，这个对象若向访问页面对象，要提前声明个that = this，否则作用域不用，在success方法中this用的就是wx对象了。
如果你遇到如下问题，提示域名不安全，注意这不是跨域问题，只是由于访问的地址没有正规的检查。

你需要手动设置一下开发工具

在右上角的详情，勾选这个

就ok了。
页面和控制台都是正常的了。

这就实现了前后端的交互。

微信小程序篇（微信小程序的支付）转载 “微信小程序联盟”

微信小程序的支付和微信公众号的支付是类似的，对比起来还比公众号支付简单了一些，我们只需要调用微信的统一下单接口获取prepay_id之后我们在调用微信的支付即可。

今天我们来封装一般node的支付接口！！！

首先调用统一下单接口我们需要知道一些信息

var bookingNo = ‘davdian‘ + this.createNonceStr() + this.createTimeStamp()
    var deferred = Q.defer()  
    var appid = config.appId  
    var nonce_str = this.createNonceStr()  
    var timeStamp = this.createTimeStamp()  
    var url = "https://api.mch.weixin.qq.com/pay/unifiedorder"  
    var formData = "<xml>"  
    formData += "<appid>" + appid + "</appid>" //appid  
    formData += "<attach>" + attach + "</attach>" //附加数据  
    formData += "<body>" + body + "</body>"  
    formData += "<mch_id>" + mch_id + "</mch_id>" //商户号  
    formData += "<nonce_str>" + nonce_str + "</nonce_str>" //随机字符串，不长于32位。  
    formData += "<notify_url>" + notify_url + "</notify_url>"  
    formData += "<openid>" + openid + "</openid>"  
    formData += "<out_trade_no>" + bookingNo + "</out_trade_no>"  
    formData += "<spbill_create_ip>61.50.221.43</spbill_create_ip>"  
    formData += "<total_fee>" + total_fee + "</total_fee>"  
    formData += "<trade_type>JSAPI</trade_type>"  
    formData += "<sign>" + this.paysignjsapi(appid, attach, body, mch_id, nonce_str, notify_url, openid, bookingNo, ‘61.50.221.43‘, total_fee, ‘JSAPI‘) + "</sign>"  
    formData += "</xml>"  
    var self = this
    request({  
      url: url,  
      method: ‘POST‘,  
      body: formData  
    }, function(err, response, body) {  
      if (!err && response.statusCode == 200) {  
        var prepay_id = self.getXMLNodeValue(‘prepay_id‘, body.toString("utf-8")) 
        var tmp = prepay_id.split(‘[‘)  
        var tmp1 = tmp[2].split(‘]‘)  
        //签名  
        var _paySignjs = self.paysignjs(appid, nonce_str, ‘prepay_id=‘ + tmp1[0], ‘MD5‘, timeStamp)  
        var args = {  
          appId: appid,  
          timeStamp: timeStamp,  
          nonceStr: nonce_str,  
          signType: "MD5",  
          package: tmp1[0],  
          paySign: _paySignjs  
        }
        deferred.resolve(args)  
      } else {  
        console.log(body)  
      } 
    })  
    return deferred.promise

这个是一个统一下单接口的代码，我们需要appid小程序公众号id，mch_id商户号id,openid小程序的唯一标实,key支付用的密码，剩下的参数都是订单的信息和价格之类的，本人require进q模块使用promise，这个因人而异，可以根据自己需要来。我们需要请求https://api.mch.weixin.qq.com/pay/unifiedorder接口

注意：这里我们传递的formdata是一个xml而不是json

然后我们需要签名方法，这里我们需要封装两个方法，一个是签名方法调用统一下单接口会用到，另一个是调用小程序支付用到

统一下单接口sign：

var ret = {  
      appid: appid,  
      attach: attach,  
      body: body,  
      mch_id: mch_id,  
      nonce_str: nonce_str,  
      notify_url: notify_url,  
      openid: openid,  
      out_trade_no: out_trade_no,  
      spbill_create_ip: spbill_create_ip,  
      total_fee: total_fee,  
      trade_type: trade_type  
    }  
    var string = this.raw(ret)  
    string = string + ‘&key=‘ + key  
    var crypto = require(‘crypto‘)  
    var sign = crypto.createHash(‘md5‘).update(string, ‘utf8‘).digest(‘hex‘)  
    return sign.toUpperCase() 

支付sign：

var ret = {  
        appId: appid,  
        nonceStr: nonceStr,  
        package: package,  
        signType: signType,  
        timeStamp: timeStamp  
    }  
    var string = this.raw(ret)  
    string = string + ‘&key=‘ + key  
    var sign = crypto.createHash(‘md5‘).update(string, ‘utf8‘).digest(‘hex‘)  
    return sign.toUpperCase()  

注意加密的时候我们获取的是string而不是一个json，所以我们需要吧json转换成string，代码如下：

var keys = Object.keys(args)  
    keys = keys.sort()  
    var newArgs = {}  
    keys.forEach(function(key) {  
        newArgs[key] = args[key]  
    })  
    var string = ‘‘  
    for (var k in newArgs) {  
        string += ‘&‘ + k + ‘=‘ + newArgs[k]  
    }  
    string = string.substr(1)  
    return string  

统一下单接口返回的是带有prepay_id的xml，所以我们需要一个方法进行解析，代码如下：

var tmp = xml.split("<" + node_name + ">")  
    var _tmp = tmp[1].split("</" + node_name + ">")  
    return _tmp[0]  

最后我们只需要把这些连接到一起就是可以获取所有微信支付所需参数，代码如下：

//微信小程序支付封装,暂支持md5加密，不支持sha1
/**
***create order by jianchep 2016/11/22     
 **/
var config = require(‘../config/weapp.js‘)
var Q = require("q")  
var request = require("request")  
var crypto = require(‘crypto‘)  
var ejs = require(‘ejs‘)
var fs = require(‘fs‘)  
var key = config.key
module.exports = {
  // 获取prepay_id
  getXMLNodeValue: function(node_name, xml) {  
    var tmp = xml.split("<" + node_name + ">")  
    var _tmp = tmp[1].split("</" + node_name + ">")  
    return _tmp[0]  
  },
  // object-->string
  raw: function(args) {  
    var keys = Object.keys(args)  
    keys = keys.sort()  
    var newArgs = {}  
    keys.forEach(function(key) {  
        newArgs[key] = args[key]  
    })  
    var string = ‘‘  
    for (var k in newArgs) {  
        string += ‘&‘ + k + ‘=‘ + newArgs[k]  
    }  
    string = string.substr(1)  
    return string  
  },  
    // 随机字符串产生函数  
  createNonceStr: function() {  
      return Math.random().toString(36).substr(2, 15)  
  },  
  // 时间戳产生函数  
  createTimeStamp: function() {  
      return parseInt(new Date().getTime() / 1000) + ‘‘  
  },
  // 支付md5加密获取sign
  paysignjs: function(appid, nonceStr, package, signType, timeStamp) {  
    var ret = {  
        appId: appid,  
        nonceStr: nonceStr,  
        package: package,  
        signType: signType,  
        timeStamp: timeStamp  
    }  
    var string = this.raw(ret)  
    string = string + ‘&key=‘ + key  
    var sign = crypto.createHash(‘md5‘).update(string, ‘utf8‘).digest(‘hex‘)  
    return sign.toUpperCase()  
  },
  // 统一下单接口加密获取sign
  paysignjsapi: function(appid, attach, body, mch_id, nonce_str, notify_url, openid, out_trade_no, spbill_create_ip, total_fee, trade_type) {  
    var ret = {  
      appid: appid,  
      attach: attach,  
      body: body,  
      mch_id: mch_id,  
      nonce_str: nonce_str,  
      notify_url: notify_url,  
      openid: openid,  
      out_trade_no: out_trade_no,  
      spbill_create_ip: spbill_create_ip,  
      total_fee: total_fee,  
      trade_type: trade_type  
    }  
    var string = this.raw(ret)  
    string = string + ‘&key=‘ + key  
    var crypto = require(‘crypto‘)  
    var sign = crypto.createHash(‘md5‘).update(string, ‘utf8‘).digest(‘hex‘)  
    return sign.toUpperCase()  
  },
  // 下单接口
  order: function(attach, body, mch_id, openid, total_fee, notify_url) {
    var bookingNo = ‘davdian‘ + this.createNonceStr() + this.createTimeStamp()
    var deferred = Q.defer()  
    var appid = config.appId  
    var nonce_str = this.createNonceStr()  
    var timeStamp = this.createTimeStamp()  
    var url = "https://api.mch.weixin.qq.com/pay/unifiedorder"  
    var formData = "<xml>"  
    formData += "<appid>" + appid + "</appid>" //appid  
    formData += "<attach>" + attach + "</attach>" //附加数据  
    formData += "<body>" + body + "</body>"  
    formData += "<mch_id>" + mch_id + "</mch_id>" //商户号  
    formData += "<nonce_str>" + nonce_str + "</nonce_str>" //随机字符串，不长于32位。  
    formData += "<notify_url>" + notify_url + "</notify_url>"  
    formData += "<openid>" + openid + "</openid>"  
    formData += "<out_trade_no>" + bookingNo + "</out_trade_no>"  
    formData += "<spbill_create_ip>61.50.221.43</spbill_create_ip>"  
    formData += "<total_fee>" + total_fee + "</total_fee>"  
    formData += "<trade_type>JSAPI</trade_type>"  
    formData += "<sign>" + this.paysignjsapi(appid, attach, body, mch_id, nonce_str, notify_url, openid, bookingNo, ‘61.50.221.43‘, total_fee, ‘JSAPI‘) + "</sign>"  
    formData += "</xml>"  
    var self = this
    request({  
      url: url,  
      method: ‘POST‘,  
      body: formData  
    }, function(err, response, body) {  
      if (!err && response.statusCode == 200) {  
        var prepay_id = self.getXMLNodeValue(‘prepay_id‘, body.toString("utf-8")) 
        var tmp = prepay_id.split(‘[‘)  
        var tmp1 = tmp[2].split(‘]‘)  
        //签名  
        var _paySignjs = self.paysignjs(appid, nonce_str, ‘prepay_id=‘ + tmp1[0], ‘MD5‘, timeStamp)  
        var args = {  
          appId: appid,  
          timeStamp: timeStamp,  
          nonceStr: nonce_str,  
          signType: "MD5",  
          package: tmp1[0],  
          paySign: _paySignjs  
        }
        deferred.resolve(args)  
      } else {  
        console.log(body)  
      } 
    })  
    return deferred.promise  
  }
}

之后我们封装下单接口：

unifiedorder: function (req, res) {
    var body = "测试支付"  
    var openid = "openid"
    var total_fee = 1
    var notify_url = "http://localhost/notify"
    var mch_id = config.shopId
    var attach = "测试"  
    wxpay.order(attach, body, mch_id, openid, total_fee, notify_url)
      .then(function(data){  
        console.log(‘data--->‘, data, 123123)
        res.json(data)
      })  
  },

然后我们只需要在小程序里面调用这个接口，就会获取到所有的支付需要信息，再掉微信支付即可。

这里说几个小程序支付的坑：

1.统一下单接口是xml（这个不只是小程序，公众号也是），返回值也是xml格式需要自己获取prepay_id,

2.签名算法要带上key，最后要转换成大些

3.微信支付的sign算法也要带上appid（这个不科学，深坑）

4.签名算法一定不要用json拼接key

以上是关于微信小程序篇_01 微信小程序与Java后端接口交互的主要内容，如果未能解决你的问题，请参考以下文章

微信小程序篇（微信小程序的支付）

Java后端小程序微信登录怎么写？？

ESP8266 SDK开发: 微信小程序篇-微信小程序通过UDP实现和ESP8266局域网通信控制

ESA2GJK1DH1K微信小程序篇: 测试微信小程序扫描Air202上面的二维码绑定设备,并通过MQTT控制设备

ESA2GJK1DH1K微信小程序篇: 微信小程序APUConfig给WI-Fi模块配网并绑定设备,并通过MQTT控制设备(单片机AT指令版 V1.0 使用SSL连接)