玩一玩微信公众号开发（二）管理凭据和自定义菜单

刺骨的言语ヽ痛彻心扉 2022-07-05 14:44 150阅读 0赞

## 管理access\_token ##

### access\_token介绍 ###

在前面我们成功的使用了Spring Boot Web程序和微信对接。但是这仅仅是一个开始，我们还需要获取access\_token，也就是凭据，才能进行之后的工作。微信开发文档有如下介绍。

> access\_token是公众号的全局唯一接口调用凭据，公众号调用各接口时都需使用access\_token。开发者需要进行妥善保存。access\_token的存储至少要保留512个字符空间。access\_token的有效期目前为2个小时，需定时刷新，重复获取将导致上次获取的access\_token失效。

微信开发文档建议我们使用一个中控服务器，获取和刷新token均由服务器进行，我们的程序只从中控服务器获取access\_token。由于每次获取access\_token都会刷新一个新token，因此如果在程序中直接获取，可能造成token不一致和过期问题。

### Spring Boot缓存配置 ###

当然实际上并不是一定要另外整一个服务器。我们利用Spring的缓存功能，也可以比较好的完成任务。下面就来介绍一下。

首先，现在Spring Boot项目中添加下面的依赖，启用Spring的缓存功能。

compile('org.springframework.boot:spring-boot-starter-cache')

上面的依赖仅仅启用了Spring Boot的缓存抽象和自动配置功能。我们还需要选择具体的缓存实现。Spring Boot支持多种Java 缓存实现。我随便挑了个caffeine，它是由Guava库独立出来的缓存库，使用Java 8编写，我看着不错。

compile 'com.github.ben-manes.caffeine:caffeine:2.4.0'

Spring Boot会自动配置caffeine，所以我们可以完全透明的使用它。当然，还需要进行一点配置。由于微信的access\_token的过期时间为7200秒，所以我们的缓存需要在这之前获取新的token。因此这里将caffeine的过期时间配置为7000秒，在`application.properties`中设置即可。

spring.cache.caffeine.spec=expireAfterWrite=7000s

缓存是配置好了，但是这就能直接使用了吗？当然不是，我们还需要编写获取token的服务。获取access\_token需要微信公众平台开发者页面上的appid和appsecret，我们先要获取到它，然后配置到`application.properties`中。

yitian.study.weixin.appid=XXXXXXXXXXXXX
    yitian.study.weixin.appsecret=XXXXXXXXXXXXX

### 获取凭据 ###

获取access\_token需要向`https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET`发送一个GET请求，并包含appid和appsecret两个参数。如果成功获取到token，微信服务器会返回下面这样的json。

{"access_token":"ACCESS_TOKEN","expires_in":7200}

如果出现错误，则会返回错误信息json。

{"errcode":40013,"errmsg":"invalid appid"}

所以Kotlin代码可以写成这样。在方法上使用了@Cacheable注解，Spring会将方法结果缓存起来，下次直接使用缓存结果。

@Service
    class AccessTokenService(
            @Value("\${yitian.study.weixin.appid}") val appId: String,
            @Value("\${yitian.study.weixin.appsecret}") val appSecret: String,
            @Autowired val objectMapper: ObjectMapper
    ) {
    
        @Cacheable("access_token")
        fun refreshAccessToken(): String {
            val requestUrl = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=$appId&secret=$appSecret"
            val json = URL(requestUrl).readText()
            try {
                val result = objectMapper.readValue(json, AccessTokenResult::class.java)
                return result.accessToken
            } catch (ex: JsonMappingException) {
                val error = objectMapper.readValue(json, ErrorResult::class.java)
                throw AccessTokenException(ex, error.toString())
            }
        }
    }

在上面的代码中注入了Spring Boot自动配置的ObjectMapper，用于将结果json转换为Kotlin对象。上面用到的Bean和异常定义在下面。

data class ErrorResult(
            @JsonProperty("errcode") val errorCode: Int,
            @JsonProperty("errmsg") val errorMessage: String
    ) {
    }
    
    data class AccessTokenResult(
            @JsonProperty("access_token") val accessToken: String,
            @JsonProperty("expires_in") val expiresIn: Int) {
    }
    
    class AccessTokenException(val ex: Throwable, val msg: String) : Throwable(msg, ex) { 
    }

这样，access\_token的管理工作就算完成了。以后我们需要获取access\_token，直接从AccessTokenService调用就行了。

## 自定义菜单 ##

对于个人性质的订阅号，没有自定义菜单等高级功能。所以下面我改用[微信测试号][Link 1]来验证这些功能。另外，我们可以使用微信公众平台的在线调试工具来帮助我们开发。

从[微信开发文档][Link 2]的截图来看，我猜它很久没更新过了。怪不得写的并不咋地，我看了半天也没明白怎么创建自定义菜单。从网上找了一篇[微信公众平台开发（八） 自定义菜单功能开发][Link 3]，虽然用的是PHP语言，但是讲的还可以。

### 新建菜单 ###

首先先看看微信文档的注意事项。

> 1、自定义菜单最多包括3个一级菜单，每个一级菜单最多包含5个二级菜单。  
> 2、一级菜单最多4个汉字，二级菜单最多7个汉字，多出来的部分将会以“…”代替。  
> 3、创建自定义菜单后，菜单的刷新策略是，在用户进入公众号会话页或公众号profile页时，如果发现上一次拉取菜单的请求在5分钟以前，就会拉取一下菜单，如果菜单有更新，就会刷新客户端的菜单。测试时可以尝试取消关注公众账号后再次关注，则可以看到创建后的效果。

需要创建菜单的时候，我们需要向微信发送一个`[https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN](https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN)`的POST请求，

请求体是类似这样的JSON。这些按钮的type属性可以指定为多种按钮类型，有不同的作用。这些按钮类型和JSON属性的详细信息直接参考官方文档吧。

{
      "button": [ { "name": "实用功能", "sub_button": [ { "type": "click", "name": "天气预报", "key": "weather_forecast" }, { "type": "click", "name": "说个笑话", "key": "speak_jokes" } ] }, { "type": "media_id", "name": "捐赠作者", "media_id": "g78zk9TnnoFBaGJV4jpEDqR2y-fDNgOOFQkiCfrZIbA" } ] }

如果添加菜单成功，就会返回这样的JSON字符串。

{"errcode":0,"errmsg":"ok"}

如果出现错误，就会返回错误码和错误信息。

{"errcode":40018,"errmsg":"invalid button name size"}

本来我想着找一个比较好用的Java/Kotlin的HTTP传输库来进行这些接口的操作。但是找了半天居然没发现比较好用的，只有一个比较旧的[Apache HttpClient][]，最近更新时间还是2011年。怪不得我看网上关于Java开发微信的资源比较少，原来真的挺麻烦的。

所以呢，这个功能就这样作罢吧。如果需要更新菜单可以使用[在线调试工具][Link 4]，这个倒是比较方便。

### 查询自定义菜单 ###

这个倒是比较简单。我们只要向下面的URL发送GET请求即可，微信服务器就会将对应的自定义菜单的JSON格式返回给我们。

https://api.weixin.qq.com/cgi-bin/menu/get?access_token=ACCESS_TOKEN

### 删除自定义菜单 ###

删除自定义菜单也很简单，同样的，向下面的URL发送GET请求即可。

https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=ACCESS_TOKEN

## 结语 ##

本来微信开发还有很多内容。但是到了这里我就完全不想写了。一来与微信交互需要发送多种类型的HTTP请求给微信服务器。但是我找了一下没找到好用的Java或Kotlin类库。二来微信的官方开发文档写的实在是捉急，例子残缺不全，很多地方也没讲明白。我强行硬啃Spring英文文档都能看个八九不离十。但是我看微信的官方中文文档居然有地方看不懂。所以这系列就到此为止了。谢谢大家的支持！

代码放在[csdn代码库][csdn]上了，虽然不是一个完整的项目，但是包含了与微信对接和管理凭据的一点代码。对于想用Java或Kotlin开发微信公众号的同学可能有一点参考价值。

[Link 1]: http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login
[Link 2]: https://mp.weixin.qq.com/wiki
[Link 3]: http://www.cnblogs.com/mchina/p/3276878.html
[Apache HttpClient]: http://hc.apache.org
[Link 4]: http://mp.weixin.qq.com/debug/
[csdn]: https://code.csdn.net/u011054333/weixin-public-account-sample/tree/master