【公众号开发】Access Token的获取 · 请求公众号服务器创建自定义菜单 · 处理自定义菜单按钮事件

【公众号开发】（3）

文章目录

• 【公众号开发】（3）
• • 1. 获取Access token
  • • 1.1 确定参数
    • 1.2 补全URL（添加query string）
    • 1.3 测试
  • 2. 封装AccessToken以便保存与后期使用
  • • 2.1 TokenUtils做出一些调整
    • 2.2 单例模式的AccessToken
    • 2.3 TokenUtils获取全局唯一的token字符串的方法
  • 3. 自定义菜单
  • • 3.1 菜单显示的原理
    • 3.2 封装菜单类
    • 3.3 构造一个菜单对象
    • 3.4 发送post请求
    • 3.5 启动main方法查看效果
  • 4. 处理自定义菜单事件
  • • 4.1 了解公众号发过来的post请求机制
    • 4.2 了解公众号发过来的post请求格式
    • 4.3 分支处理请求
    • 4.4 测试

【公众号开发】（3）

开始开发 / 获取 Access token (qq.com)

access_token是公众号的全局唯一的接口调用凭据，公众号调用各接口时都需使用access_token

开发者需要进行妥善保存

1. access_token的存储至少要保留512个字符空间
2. access_token的有效期目前为2个小时（7200s），需定时刷新，重复获取将导致上次获取的access_token失效

获取到Access token，我们才能够去调用微信公众号给我们提供的一些接口（Access token就类似于第三方接口的key，验证凭据后才可以去实现一些功能）

1. 获取Access token

这里是几张来自文档的重点截图：

1.1 确定参数

public class TokenUtils {


    private static final String APP_ID = "wxdadd0122365919e8";

    private static final String APP_SECRET = "69fd4a3ad04167f288e49bea9dce3e45";


    public static String getAccessToken() {
        // 获取token的url
        final String URL = "https://api.weixin.qq.com/cgi-bin/token";
        // 获取token的grant_type
        final String GRANT_TYPE = "client_credential";

    }

}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

1.2 补全URL（添加query string）

public static String getAccessToken() {
    // 获取token的url
    final String URL = "https://api.weixin.qq.com/cgi-bin/token";
    // 获取token的grant_type
    final String GRANT_TYPE = "client_credential";
    // 构造参数表
    Map<String, Object> param = new HashMap<String, Object>(){{
        this.put("grant_type", GRANT_TYPE);
        this.put("appid", APP_ID);
        this.put("secret", APP_SECRET);
    }};
    // 发起get请求
    String response = HttpUtils.doGet(URL, param);
    // 解析json
    Map<String, Object> result = JsonUtils.jsonToMap(response);
    System.out.println(result);
    // 返回token
    return (String) result.get("access_token");
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

1.3 测试

public static void main(String[] args) {
    System.out.println(getAccessToken());
}
1
2
3

2. 封装AccessToken以便保存与后期使用

这里我们全局的AccessToken唯一一份，我们希望其未过期就无需刷新，这里用的是**单例模式**！

2.1 TokenUtils做出一些调整

为了实现这个初心，在TokenUtils做出一些调整

• 改为获取map

2.2 单例模式的AccessToken

• 单例模式参考文章：【JavaEE】线程案例-单例模式 and 阻塞队列_s:103的博客-CSDN博客

@Data
public class AccessToken {

    private String token;

    private long expireTime;//有效期限


    volatile private static AccessToken accessToken = null;

    public void setExpireTime(long expireIn) {
        // 设置有效期限的时候的时间戳
        this.expireTime = System.currentTimeMillis() + expireIn * 1000;
    }

    public boolean isExpired() {
        return System.currentTimeMillis() > this.getExpireTime();
    }


    private static void setAccessToken() {
        if(accessToken == null) {
            accessToken = new AccessToken();
        }
        Map<String, Object> map = TokenUtils.getAccessTokenMap();
        accessToken.setToken((String) map.get("access_token"));
        accessToken.setExpireTime((Integer) map.get("expires_in"));
    }

    public static AccessToken getAccessToken() {
        if(accessToken == null || accessToken.isExpired()) {
            synchronized (AccessToken.class) {
                if(accessToken == null || accessToken.isExpired()) {
                    setAccessToken();
                }
            }
        }
        return accessToken;
    }

}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

2.3 TokenUtils获取全局唯一的token字符串的方法

public static String getToken() {
    return AccessToken.getAccessToken().getToken();
}
1
2
3

测试：

public static void main(String[] args) {
    System.out.println(getToken());
    System.out.println(getToken());
    System.out.println(getToken());
}
1
2
3
4
5

• 三个一样，代表我们的AccessToken单例第一次被实例和设置并且因为没有过期而没有被更新~

有了凭据之后，我们就可以去调用微信公众号给我们提供的一些接口了，实现一些功能~

3. 自定义菜单

你会发现，我们的测试公众号现在还没有菜单的选项

而我们的常识也知道，公众号的菜单是必不可少的，接下来我们来完成一下自定义菜单吧

开发手册：自定义菜单 / 创建接口 (qq.com)

抓重点：

• 按字数截取…
• 刷新策略我们创建后再讲

自定义菜单接口，就相当于触发各种各样事件

3.1 菜单显示的原理

我们提交的信息会给公众号服务器保存起来，构造成菜单显示给用户~

这里我们来看个post请求body的例子：

• （要求是json，这也合理，因为我们要传递的信息就是多个菜单，多级菜单，这个可是对象~）

我们需要什么功能，我们就查看与学习对应的按钮类型和其他参数就行了

• 自定义菜单 / 创建接口 (qq.com)

3.2 封装菜单类

对于这个post请求的body，也就是这个json字符串的构造，是最大的问题，我们首先要封装菜单类

@Data
public class Button {

    private List<AbstractButton> button;

}
1
2
3
4
5
6

这是构造最外层的button属性：

{
    "button": [...]
}
1
2
3

AbstractButton是我们抽象出来的按钮类（可以是一些按钮/二级菜单）

@Data
public abstract class AbstractButton {

    private String name;

    public AbstractButton(String name) {
        this.name = name;
    }
    public AbstractButton() {
        
    }
}
1
2
3
4
5
6
7
8
9
10
11
12

这个name属性是按钮/二级菜单的共性（二级菜单没有type，所以这里不应该写type）

根据刚才的json字符串，里面提到的属性就是对应类型按钮的属性~

以这几个为示例（其他根据实际举一反三就行）：

@Data
public class ViewButton extends AbstractButton {

    private final String type = "view";

    private String url;

    public ViewButton(String name) {
        super(name);
    }
}

1
2
3
4
5
6
7
8
9
10
11
12

@Data
public class ClickButton extends AbstractButton {

    private final String type = "click";

    private String key;

    public ClickButton(String name) {
        super(name);
    }

}
1
2
3
4
5
6
7
8
9
10
11
12

@Data
public class PicPhotoOrAlbumButton extends AbstractButton {

    private final String type = "pic_photo_or_album";

    private String key;


    public PicPhotoOrAlbumButton(String name) {
        super(name);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12

@Data
public class SubButton extends AbstractButton {

    private List<AbstractButton> sub_button;


    public SubButton(String name) {
        super(name);
    }
}
1
2
3
4
5
6
7
8
9
10

3.3 构造一个菜单对象

预计菜单效果如下：

public class ButtonUtils {

    public static Button createButton() {
        Button button = new Button();
        button.setButton(new ArrayList<>());
        return button;
    }

    public static ClickButton createClickButton(String name, String key) {
        ClickButton clickButton = new ClickButton(name);
        clickButton.setKey(key);
        return clickButton;
    }

    public static ViewButton createViewButton(String name, String url) {
        ViewButton viewButton = new ViewButton(name);
        viewButton.setUrl(url);
        return viewButton;
    }

    public static SubButton createSubButton(String name) {
        SubButton subButton = new SubButton(name);
        subButton.setSub_button(new ArrayList<>());
        return subButton;
    }
    public static PicPhotoOrAlbumButton createPicPhotoOrAlbumButton(String name, String key) {
        PicPhotoOrAlbumButton picPhotoOrAlbumButton = new PicPhotoOrAlbumButton(name);
        picPhotoOrAlbumButton.setKey(key);
        return picPhotoOrAlbumButton;
    }



    public static void main(String[] args) {
        Button button = createButton();
        // 一级菜单的两个按钮
        button.getButton().add(createClickButton("mara\uD83D\uDE00😀😀😀", "1"));
        button.getButton().add(createViewButton("baidu\uD83D\uDE00", "https://www.baidu.com"));
        // 二级菜单
        SubButton subButton = createSubButton("更多\uD83D\uDE00");
        subButton.getSub_button().add(createClickButton("mason\uD83D\uDE00", "2"));
        subButton.getSub_button().add(createViewButton("blog\uD83D\uDE00", "https://blog.csdn.net/Carefree_State?type=blog"));
        subButton.getSub_button().add(createPicPhotoOrAlbumButton("上传图片\uD83D\uDE00", "3"));
        // 二级菜单加入到一级菜单中
        button.getButton().add(subButton);
//        System.out.println(button);
        String json = JsonUtils.objectToJson(button);
        System.out.println(json);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

emoji可以直接复制或者用unicode码，本质没啥区别，跟普通字符差不多：

• 之前我做的网站，文本中有emoji是不行的，因为我的服务器并不支持emoji存到数据库
• 可以这样：👨‍💻你知道如何使用MySQL存储Emoji表情吗？明白MySQL中UTF-8和UTF-8MB4字符编码有何区别吗？ - 知乎 (zhihu.com)

Unicode 11.0版本的emoji表情 - emoji大全，emoji百科 (emojidaquan.com)

打印json后查看效果：

在线 JSON 解析 | 菜鸟工具 (runoob.com)

😊符合预期😊

对于json集合属性的序列，各个元素json字符串都不一样或者有联系，可以试试抽象成一个类，具体类继承这个抽象类，序列化的时候序列的是具体的实例！

或者，你干脆写成List