Spring Boot整合WxJava快速实现生成小程序码

最近业务给咱们开发同事提了一个很简单的需求-生成小程序码，同事可能是平时写CRUD写多了，听到是不熟悉的领域的东西就觉得有些头大，便来问我如何实现，我说：“这个得看官方说明文档了，然后调接口实现。如果觉得麻烦就找开源组件直接引用即可，比如WxJava”。可能是我表述得不够清楚，同事依然一脸懵逼，感觉甚是复杂。

接下来，我们就整合开源组件WxJava的miniapp版本来快速实现小程序码生成功能。

引入wx-java-miniapp-spring-boot-starter

<dependency>
    <groupId>com.github.binarywang</groupId>
    <artifactId>wx-java-miniapp-spring-boot-starter</artifactId>
    <version>4.4.0</version>
</dependency>

配置小程序信息

wx:
  miniapp:
    appid: 小程序AppId
    secret: 小程序secret
    token:
    aesKey:
    msgDataFormat: JSON

如果只是生成小程序码或者获取小程序连接，那便只配置appId和secret即可。

调用API

小程序官方有三种小程序码的生成方式，WxJava封装了官方的API接口为我们提供三个API的方法：

1. createQrcode 对应官方的获取小程序二维码接口，生成的小程序码，永久有效，有数量限制，参数带在URL后面
2. createWxaCode 对应官方的 获取小程序码接口，生成的小程序码，永久有效，有数量限制,参数带在URL后面
3. createWxaCodeUnlimit 对应官方的获取不限制的小程序码接口，生成的小程序码，永久有效，数量暂无限制，参数需要传到scene中，小程序端需要从query.scene中获取

   @Resource
   WxMaService wxMaService;
   
   @GetMapping(value = "/generateQrcode/{id}", produces = {MediaType.IMAGE_JPEG_VALUE, MediaType.IMAGE_PNG_VALUE})
       public byte[] generateQrcode(HttpServletRequest request,@PathVariable("id")String id) throws WxErrorException {
           return wxMaService.getQrcodeService().createWxaCodeBytes("路径?id="+id,"",640,true,null,false);
       }

这里我只是简单的模拟API的调用方式，如果使用有数量限制的API接口，我们需要将生成好的图片上传到文件服务器，或者是保存下来。因为资源有限，我们得节约一点。

@GetMapping(value = "/generateQrcode/{id}")
   public String generateQrcode(HttpServletRequest request,@PathVariable("id")String id) throws WxErrorException {
       File qrcode= wxMaService.getQrcodeService().createWxaCode("路径?id="+id);
       //保存或者上传文件
       return "图片url" ;
   }

默认图片大小为430像素，颜色自动调整，可以通过WxMaCodeLineColor对象来设置生成的颜色，

@GetMapping(value = "/generateQrcode/{id}")
public String generateQrcode(HttpServletRequest request,@PathVariable("id")String id) throws WxErrorException {
    WxMaCodeLineColor color=new WxMaCodeLineColor(); //设置绿色
    color.setB("0");
    color.setG("255");
    color.setR("0");
    File qrcode= wxMaService.getQrcodeService().createWxaCode("路径?id="+id,"",1280,false, color,false);
    //保存或者上传文件
    return "图片url" ;
}

这里需要注意的是，要生成的小程序必须是已发版，如果是调用的createWxaCodeUnlimit方法，路径也必须在正式存在，否则会提示异常

{"errcode":41030,"errmsg":"invalid page rid: 632a72c5-0713dffe-27652c1f"}

如今，开源的组件越来越多，其可帮助我们提升开发效率，但是我们也不能过渡依赖于这些组件，完成工作交差之后就停滞不前，在使用它们的同时也需要多去学习、思考。