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

管理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调用就行了。

自定义菜单

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

从微信开发文档的截图来看,我猜它很久没更新过了。怪不得写的并不咋地,我看了半天也没明白怎么创建自定义菜单。从网上找了一篇微信公众平台开发(八) 自定义菜单功能开发,虽然用的是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开发微信的资源比较少,原来真的挺麻烦的。

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

查询自定义菜单

这个倒是比较简单。我们只要向下面的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代码库上了,虽然不是一个完整的项目,但是包含了与微信对接和管理凭据的一点代码。对于想用Java或Kotlin开发微信公众号的同学可能有一点参考价值。

你可能感兴趣的:(玩一玩微信公众号开发(二) 管理凭据和自定义菜单)