asp.net mvc 5 微信接入VB版 - 获取AccessToken

获取AccessToken是微信接入的又一个基础操作。很多微信接口需要这个2小时一刷新的AccessToken作为参数。

转载请说明作者Nukepayload2

首先根据开发文档把获取AccessToken需要Get的那个链接拼凑出来。

Const AccessToken = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=" & AppId & "&secret=" & Secret

注意这里不要使用字符串内插，因为那个不能给常量表达式用。

文档上写着返回的是Json，那就把Newtonsoft.Json装上。

然后写这个函数放到某个模块里面备用。

    Public Async Function GetJsonPopulateObjectAsync(url As String, obj As Object) As Task
        Dim httpClient As New HttpClient
        httpClient.DefaultRequestHeaders.Accept.Add(New MediaTypeWithQualityHeaderValue("application/json"))
        Dim response = Await httpClient.GetAsync(url)
        If response.IsSuccessStatusCode Then
            Dim str = Await response.Content.ReadAsStringAsync()
            JsonConvert.PopulateObject(str, obj)
        End If
    End Function

接下来就是写获取数据了。AccessToken适合单实例的对象，那么我们新建模块。

用一个嵌套的类把需要反序列化的数据描述一下，并且初始化。

这里注意一下，Await是不能在SyncLock里面用的，所以要利用Monitor。

Imports System.Threading
Imports System.Threading.Tasks

Module AccessToken
    Dim dat As New Data

    Sub New()
        CreateTime = Date.Now
    End Sub
    Public Async Function GetValueAsync() As Task(Of String)
        Try
            Monitor.Enter(dat)
            If IsExpiredOrEmpty Then
                Await GetJsonFillObjectAsync(WeChatGlobalValues.AccessToken, dat)
                _CreateTime = Date.Now
                WeChatException.Assert(dat.errcode)
            End If
            Return dat.access_token
        Finally
            Monitor.Exit(dat)
        End Try
    End Function
    Public ReadOnly Property CreateTime As Date
    Public ReadOnly Property IsExpiredOrEmpty As Boolean
        Get
            Return Date.Now >= CreateTime.AddSeconds(dat.expires_in)
        End Get
    End Property
    Private Class Data
        Public Property access_token$
        Public Property expires_in% = -
        Public Property errcode%
        Public Property errmsg$
    End Class
End Module

如果出错，微信会产生错误码。根据错误码表编写异常类

Public Class WeChatException
    Inherits Exception
    Public ReadOnly Property ErrorCode%
    Sub New()
        MyBase.New("调用微信服务时发生异常")
    End Sub
    Sub New(ErrorCode%)
        MyBase.New(ErrorMap(ErrorCode))
        _ErrorCode = ErrorCode
    End Sub
    ''' <summary>
    ''' 断言这个错误码并不代表出错。如果断言失败则抛出异常。
    ''' </summary>
    ''' <param name="ErrorCode%">错误码</param>
    Public Shared Sub Assert(ErrorCode%)
        If ErrorCode <>  Then Throw New WeChatException(ErrorCode)
    End Sub
    Shared ErrorMap As New Dictionary(Of Integer, String) From {
        {-, "系统繁忙，此时请开发者稍候再试"},
        {, "请求成功"},
        {, "获取access_token时AppSecret错误，或者access_token无效。请开发者认真比对AppSecret的正确性，或查看是否正在为恰当的公众号调用接口"},
        {, "不合法的凭证类型"},
        {, "不合法的OpenID，请开发者确认OpenID（该用户）是否已关注公众号，或是否是其他公众号的OpenID"},
        {, "不合法的媒体文件类型"},
        {, "不合法的文件类型"},
        {, "不合法的文件大小"},
        {, "不合法的媒体文件id"},
        {, "不合法的消息类型"},
        {, "不合法的图片文件大小"},
        {, "不合法的语音文件大小"},
        {, "不合法的视频文件大小"},
        {, "不合法的缩略图文件大小"},
        {, "不合法的AppID，请开发者检查AppID的正确性，避免异常字符，注意大小写"},
        {, "不合法的access_token，请开发者认真比对access_token的有效性（如是否过期），或查看是否正在为恰当的公众号调用接口"},
        {, "不合法的菜单类型"},
        {, "不合法的按钮个数"},
        {, "不合法的按钮个数"},
        {, "不合法的按钮名字长度"},
        {, "不合法的按钮KEY长度"},
        {, "不合法的按钮URL长度"},
        {, "不合法的菜单版本号"},
        {, "不合法的子菜单级数"},
        {, "不合法的子菜单按钮个数"},
        {, "不合法的子菜单按钮类型"},
        {, "不合法的子菜单按钮名字长度"},
        {, "不合法的子菜单按钮KEY长度"},
        {, "不合法的子菜单按钮URL长度"},
        {, "不合法的自定义菜单使用用户"},
        {, "不合法的oauth_code"},
        {, "不合法的refresh_token"},
        {, "不合法的openid列表"},
        {, "不合法的openid列表长度"},
        {, "不合法的请求字符，不能包含\uxxxx格式的字符"},
        {, "不合法的参数"},
        {, "不合法的请求格式"},
        {, "不合法的URL长度"},
        {, "不合法的分组id"},
        {, "分组名字不合法"},
        {, "分组名字不合法"},
        {, "media_id大小不合法"},
        {, "button类型错误"},
        {, "button类型错误"},
        {, "不合法的media_id类型"},
        {, "微信号不合法"},
        {, "不支持的图片格式"},
        {, "缺少access_token参数"},
        {, "缺少appid参数"},
        {, "缺少refresh_token参数"},
        {, "缺少secret参数"},
        {, "缺少多媒体文件数据"},
        {, "缺少media_id参数"},
        {, "缺少子菜单数据"},
        {, "缺少oauth code"},
        {, "缺少openid"},
        {, "access_token超时，请检查access_token的有效期，请参考基础支持-获取access_token中，对access_token的详细机制说明"},
        {, "refresh_token超时"},
        {, "oauth_code超时"},
        {, "需要GET请求"},
        {, "需要POST请求"},
        {, "需要HTTPS请求"},
        {, "需要接收者关注"},
        {, "需要好友关系"},
        {, "多媒体文件为空"},
        {, "POST的数据包为空"},
        {, "图文消息内容为空"},
        {, "文本消息内容为空"},
        {, "多媒体文件大小超过限制"},
        {, "消息内容超过限制"},
        {, "标题字段超过限制"},
        {, "描述字段超过限制"},
        {, "链接字段超过限制"},
        {, "图片链接字段超过限制"},
        {, "语音播放时间超过限制"},
        {, "图文消息超过限制"},
        {, "接口调用超过限制"},
        {, "创建菜单个数超过限制"},
        {, "回复时间超过限制"},
        {, "系统分组，不允许修改"},
        {, "分组名字过长"},
        {, "分组数量超过上限"},
        {, "不存在媒体数据"},
        {, "不存在的菜单版本"},
        {, "不存在的菜单数据"},
        {, "不存在的用户"},
        {, "解析JSON/XML内容错误"},
        {, "api功能未授权，请确认公众号已获得该接口，可以在公众平台官网-开发者中心页中查看接口权限"},
        {, "用户未授权该api"},
        {, "用户受限，可能是违规后接口被封禁"},
        {, "参数错误(invalid parameter)"},
        {, "无效客服账号(invalid kf_account)"},
        {, "客服帐号已存在(kf_account exsited)"},
        {, "客服帐号名长度超过限制(仅允许10个英文字符，不包括@及@后的公众号的微信号)(invalid kf_acount length)"},
        {, "客服帐号名包含非法字符(仅允许英文+数字)(illegal character in kf_account)"},
        {, "客服帐号个数超过限制(10个客服账号)(kf_account count exceeded)"},
        {, "无效头像文件类型(invalid file type)"},
        {, "系统错误(system error)"},
        {, "日期格式错误"},
        {, "日期范围错误"},
        {, "POST数据参数不合法"},
        {, "远端服务不可用"},
        {, "Ticket不合法"},
        {, "获取摇周边用户信息失败"},
        {, "获取商户信息失败"},
        {, "获取OpenID失败"},
        {, "上传文件缺失"},
        {, "上传素材的文件类型不合法"},
        {, "上传素材的文件尺寸不合法"},
        {, "上传失败"},
        {, "帐号不合法"},
        {, "已有设备激活率低于50%，不能新增设备"},
        {, "设备申请数不合法，必须为大于0的数字"},
        {, "已存在审核中的设备ID申请"},
        {, "一次查询设备ID数量不能超过50"},
        {, "设备ID不合法"},
        {, "页面ID不合法"},
        {, "页面参数不合法"},
        {, "一次删除页面ID数量不能超过10"},
        {, "页面已应用在设备中，请先解除应用关系再删除"},
        {, "一次查询页面ID数量不能超过50"},
        {, "时间区间不合法"},
        {, "保存设备与页面的绑定关系参数错误"},
        {, "门店ID不合法"},
        {, "设备备注信息过长"},
        {, "设备申请参数不合法"},
        {, "查询起始值begin不合法"}
    }
End Class