学习一下微信公众号的开发_微信公众号开发

简单记录一下微信公众号之订阅号的开发。
首先是官网地址：https://mp.weixin.qq.com/

首先要注册用户，注册登录进来之后，我们找到接口权限，由于是个人的，权限很少，能做的事非常少，如下图。

这个时候，为了我们开发者使用，我们去使用测试的。
退出账号，找到开发文档

我们找到接口权限，可以看到，这里的权限较高，方便我们开发使用

点进去，扫码登录

1、开始接入，该地址是我用内网穿透工具映射到本地80端口地址，详情可见https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Access_Overview.html

ps:正式的地址：https://mp.weixin.qq.com/

验证消息的确来自微信服务器，返回相应的echostr即可(完整的需要进行排序加密比较)

@GetMapping("/verify")
	public String verify_wx_token(HttpServletRequest request, HttpServletResponse response) throws UnsupportedEncodingException{
	    	request.setCharacterEncoding("UTF-8");
	    	String signature = request.getParameter("signature");
	    	String timestamp = request.getParameter("timestamp");
	    	String nonce = request.getParameter("nonce");
	    	String echostr = request.getParameter("echostr");
	    	System.err.println("signature="+signature);
	    	System.err.println("timestamp="+timestamp);
	    	System.err.println("nonce="+nonce);
	    	System.err.println("echostr="+echostr);
	      return echostr;
	}
1
2
3
4
5
6
7
8
9
10
11
12
13

2、接收消息。当普通微信用户向公众账号发消息时，微信服务器将POST消息的XML数据包到开发者填写的URL上。 这个URL就是我们刚才填写的URL，不过此时需要发送POST请求。
https://developers.weixin.qq.com/doc/offiaccount/Message_Management/Receiving_standard_messages.html
我们这里以text文本为例，其他类似。这是用户发来的消息格式，我们需要解析该内容

解析需要用到的依赖

<dependency>
		   <groupId>dom4j</groupId>
		   <artifactId>dom4j</artifactId>
		   <version>1.6.1</version>
		</dependency>
		
		<dependency>
		   <groupId>com.thoughtworks.xstream</groupId>
		   <artifactId>xstream</artifactId>
		   <version>1.4.11.1</version>
		</dependency>
1
2
3
4
5
6
7
8
9
10
11

将xml解析成map方法

public static Map<String, String> parseXml(HttpServletRequest request) throws Exception {
	    Map<String, String> map = new HashMap<String, String>();
	    InputStream inputStream = request.getInputStream();
	    SAXReader reader = new SAXReader();
	    Document document = reader.read(inputStream);
	    Element root = document.getRootElement();
	    List<Element> elementList = root.elements();
	    for (Element e : elementList)
	        map.put(e.getName(), e.getText());
	    inputStream.close();
	    inputStream = null;
	    return map;
	}
1
2
3
4
5
6
7
8
9
10
11
12
13

我在该测试号上发送了"来来来"，可以看到，我们成功的接收到了该消息

那么如果我们想给他做出响应该如何处理呢？我们只需要按照对应格式返回给它就行，此处还是以文本消息为例。

//消息的基类
@Data
@NoArgsConstructor
@AllArgsConstructor
public class BaseMessage {

	protected String ToUserName;
    protected String FromUserName;
    protected long CreateTime;
    protected String MsgType;
}
1
2
3
4
5
6
7
8
9
10
11

//文本消息实体类
@Data
@NoArgsConstructor
@AllArgsConstructor
public class MessageText extends BaseMessage {

    private String Content;// 文本消息内容

    private String MsgId;// 消息id，64位整型

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

使用工具类将消息封装格式

import java.util.Date;
import java.util.Map;

import com.thoughtworks.xstream.XStream;

public class TextMessageUtil {
   
    public  String messageToxml(MessageText  message) {
        XStream xstream  = new XStream();
        xstream.alias("xml", message.getClass());
        return xstream.toXML(message);
    }
   
    public  String initMessage(Map<String,String> map) {
        MessageText text = new MessageText();
        text.setToUserName(map.get("FromUserName"));
        text.setFromUserName(map.get("ToUserName"));
        text.setContent(map.get("Content"));
        text.setCreateTime(new Date().getTime());
        text.setMsgType("text");
        return  this.messageToxml(text);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

@PostMapping("/verify")
	public String handChat(HttpServletRequest request, HttpServletResponse response) throws Exception{
		//将微信请求xml转为map格式，获取所需的参数
        Map<String, String> map = parseXml(request);
        map.put("Content", "你好啊");
        TextMessageUtil textMessage = new TextMessageUtil();
        String message = textMessage.initMessage(map);
        return message;
	}
1
2
3
4
5
6
7
8
9

3、自定义菜单https://developers.weixin.qq.com/doc/offiaccount/Custom_Menus/Creating_Custom-Defined_Menu.html

创建自定义菜单需要使用到access_toekn，所以我们先去获取access_tokenhttps://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Get_access_token.html
https请求方式: GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
此处的APPID和APPsecret是我们扫码登录进来时候上面显示的

开始定义菜单实体类，由于定义菜单比较麻烦，我们这里仅以view菜单测试，其他的类似

@Data
public class ViewButton {

	private String type;
    private String name;
    private String url;
}
1
2
3
4
5
6
7

一切准备就绪之后，发送请求，成功响应后，不会立马看到菜单的变化，需要等几分钟或者重新关注即可出现。

@GetMapping("/createMenu")
	public String createMenu(){
		String access_token = redisCache.getCacheObject("access_token");
		if(access_token==null){
			//{"errcode":0,"errmsg":"ok"}  这是正确的返回格式
			String tokenurl ="https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=wx3374895a506a7927&secret=df3b32bce92b9455183217ccbbe280ea";
			Map tokenMap = restTemplate.getForObject(tokenurl, Map.class);
			access_token = tokenMap.get("access_token").toString();//先获取access——token
			redisCache.setCacheObject("access_token", access_token,7200, TimeUnit.SECONDS);
		}
		ViewButton vbt = new ViewButton();
        vbt.setUrl("http://www.baidu.com");
        vbt.setName("按钮");
        vbt.setType("view");
        JSONArray button = new JSONArray();
        button.add(vbt);
        JSONObject menujson = new JSONObject();
        menujson.put("button", button);
		String url="https://api.weixin.qq.com/cgi-bin/menu/create?access_token="+access_token;
	    String rs = HttpRequest.sendPost(url, menujson.toJSONString());
	    System.err.println(rs);
	    return rs;
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

4、其他操作，获取用户信息，用户列表等…根据文档进行操作，基本都可以成功，日后有时间再补充更新

后续来了 2021-12-28
我了方便更多的小伙伴学习使用，我们可以直接使用自己的测试号https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login&token=579271486&lang=zh_CN
下载别人写好的代码：https://github.com/gxianch/weixin-java-mp-demo-springboot-master 放入到自己项目中，修改一下配置使用
引入依赖

 <dependency>
            <groupId>com.github.binarywang</groupId>
            <artifactId>weixin-java-mp</artifactId>
            <version>3.3.0</version>
        </dependency>
1
2
3
4
5

里面各种东西都给你处理好了，接下来我们来演示一下发送消息模板。
新增消息模板

@PostMapping("sendTemplate")
    public String sendTemplate(@RequestBody  LoginReminderReqDto loginTemplateDto) {
        String phone = loginTemplateDto.getPhone();
        String loginIp = loginTemplateDto.getLoginIp();
        String loginTime =loginTemplateDto.getLoginTime();
        String openId = loginTemplateDto.getOpenId();
        String equipment = loginTemplateDto.getEquipment();
        WxMpTemplateMessage wxMpTemplateMessage = new WxMpTemplateMessage();
        wxMpTemplateMessage.setTemplateId(loginTemplateId);
        wxMpTemplateMessage.setToUser(openId);
        List<WxMpTemplateData> data = new ArrayList<>();
        data.add(new WxMpTemplateData("first", phone));
        data.add(new WxMpTemplateData("keyword1",loginTime));
        data.add(new WxMpTemplateData("keyword2", loginIp));
        data.add(new WxMpTemplateData("keyword3", equipment));
        data.add(new WxMpTemplateData("keyword4", "河南省郑州市"));
        wxMpTemplateMessage.setData(data);
        wxMpTemplateMessage.setUrl("http://www.baidu.com");
        try {
            String appId = wxMpProperties.getConfigs().get(0).getAppId();
            WxMpTemplateMsgService templateMsgService = WxMpConfiguration.getMpServices().get(appId).getTemplateMsgService();
            templateMsgService.sendTemplateMsg(wxMpTemplateMessage);
            return "success";
        } catch (Exception e) {
            return "fail";
        }
    }
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

20211231
继续补充，如何通过微信公众号授权绑定用户，依然是使用测试平台

https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html
1

官方文档在这，四部操作，拿code换token再去获取用户信息，在这里主要说一下重要点，首先要配置这个域名

也就是这里点击修改

这里是填写域名，别手欠在后面追加地址啥的

第二个重要点，要在服务端发起

那么我们的主题是微信公众号绑定我们用户，通过确认授权后走回调方法可以获取到对应的openID，如何绑定我们用户表上呢，刚才官方文档也说了不要在前端调用，所以openID不能直接返回给前端，这个时候可以通过UUID存放redis中，将UUID返回给前端，然后前端再通过调用相关将openID绑定用户表

//通过框架发起调用的  直接手写也是一样
 @RequestMapping("/authorizedConnection")
    public String authorizedConnection() {
        String state = UUID.randomUUID().toString();
        String returnRedirectUri =
                wxMpService.oauth2buildAuthorizationUrl(redirectUri, WxConsts.OAuth2Scope.SNSAPI_USERINFO, state);
        return "redirect:" + returnRedirectUri;
    }
//调用之后的回调
@RequestMapping("/wechatOAuth")
    public String wechatOAuth(String code, String state) {
        // 根据用户获取openid
        try {
            WxMpOAuth2AccessToken wxMpOAuth2AccessToken = wxMpService.oauth2getAccessToken(code);
            String openId = wxMpOAuth2AccessToken.getOpenId();
            // 将用户的 openid存入到Redis中
            String openIdToken = tokenUtils.createToken(openId);
            // 跳转到vue
            return "redirect:"+vueAddres + "?openIdToken=" + openIdToken;
        } catch (Exception e) {
            return "error";
        }
    }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23