java實(shí)現(xiàn)微信公眾號(hào)消息推送的方法詳解

更新時(shí)間：2023年10月07日 14:35:26 作者：古渡藍(lán)按

這篇文章主要為大家詳細(xì)介紹了如何利用java實(shí)現(xiàn)微信公眾號(hào)消息推送的功能,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下

一、注冊(cè)公眾號(hào)

1，官網(wǎng)地址：申請(qǐng)測(cè)試公眾號(hào)

地址：微信公眾平臺(tái) (qq.com)

文檔地址：微信開(kāi)放文檔 (qq.com)

2，注冊(cè)后可以查看自己的appId 和 appsecret

3，創(chuàng)建模板

請(qǐng)注意：

1、測(cè)試模板的模板ID僅用于測(cè)試，不能用來(lái)給正式帳號(hào)發(fā)送模板消息

2、為方便測(cè)試，測(cè)試模板可任意指定內(nèi)容，但實(shí)際上正式帳號(hào)的模板消息，只能從模板庫(kù)中獲得

3、需為正式帳號(hào)申請(qǐng)新增符合要求的模板，需使用正式號(hào)登錄公眾平臺(tái)，按指引申請(qǐng)

4、模板內(nèi)容可設(shè)置參數(shù)(模板標(biāo)題不可)，供接口調(diào)用時(shí)使用，參數(shù)需以{{開(kāi)頭，以.DATA}}結(jié)尾

我創(chuàng)建的模板

早安！:{{name.DATA}} 
天氣：{{weather.DATA}} 
距離破殼日：{{birthday.DATA}}

二、代碼部分

? 發(fā)送消息和推送消息都是需要 token 的，所以第一步就可以獲取token，再拿獲取的token 進(jìn)行發(fā)送消息，每天獲取token的是有次數(shù)限制的（2000次）

添加依賴

使用微信公眾號(hào)需要的依賴

        <dependency>
            <groupId>com.github.binarywang</groupId>
            <artifactId>weixin-java-mp</artifactId>
            <version>3.3.0</version>
        </dependency>

我這里把也添上，等下可以在swagger測(cè)試

        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.9.2</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.9.2</version>
        </dependency>
<!--        knife4j 依賴-->
        <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>knife4j-spring-boot-starter</artifactId>
            <version>2.0.7</version>
        </dependency>

具體代碼

controller 層

這里就兩個(gè)部分，getToken() 方法是獲取token， pushMessage() 是推送消息（這里代碼中沒(méi)有模板id，需要修改成上面自己創(chuàng)建的模板id）

@Api(tags = "各項(xiàng)測(cè)試")
@RestController
@RequestMapping("/loginInfo")
public class SendWeChatMessageController {
//    /*
//     * 功能: 公眾號(hào)：appid,這里也可以配置到y(tǒng)aml 文件里面
//     */
//
//    @Value("${wx.appId}")
//    private String appId;
//
//    /*
//     * 功能: 公眾號(hào)：appsecret
//     */
//
//    @Value("${wx.appsecret}")
//    private String appsecret;
    private final Logger logger = LoggerFactory.getLogger(SendWeChatMessageController.class);
    @ApiOperation("獲取token")
    @GetMapping("/getToken")
    public Object getToken(@PathParam("grantType") String grantType,@PathParam("appId") String appId,@PathParam("secret") String secret) throws Exception {
        String tokenUrl = WeChatUrlEnum.TOKEN.getUrl();
        String params = "grant_type=" + grantType + "&appid=" + appId + "&secret=" + secret;
        logger.info("請(qǐng)求地址為：" + tokenUrl + params);
        String tokenResponse = HttpUtils.sendGet(tokenUrl, params);
        JSON parse = JSONUtil.parseObj(tokenResponse);
        System.out.println(parse);
        return parse;
    }
    @ApiOperation("發(fā)送消息")
    @PostMapping("/testPushMessage")
    public String pushMessage(@RequestBody PushMessageToUserVo pushMessageToUserVo) {
        // 組裝要發(fā)送的數(shù)據(jù)
        JSONObject body = new JSONObject();
        // 要推給誰(shuí)
        body.put("touser", pushMessageToUserVo.getTouser());
        // 模板ID
        body.put("template_id", "這里填寫自己的模板id");
        String accessToken = pushMessageToUserVo.getAccessToken();
        // 創(chuàng)建消息和內(nèi)容，這里可以自己定義，對(duì)應(yīng)好模板就行
        JSONObject data = new JSONObject();
        data.put("name", new JSONObject().put("value", "做一個(gè)身體和心靈都勇敢的人，趁著身體未老，心靈還透明。晚安!"));
        data.put("weather", new JSONObject().put("value", "陰天  19°c"));
        data.put("birthday", new JSONObject().put("value", "53   天"));
        body.put("data", data);
        logger.info("body---->{}", body.toString());
        String post = HttpUtil.post("https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=" + accessToken, body.toString());
        logger.info("通知到用戶--->{}", post);
        return body.toString();
    }
}

其他代碼

config

這里使用 knife4j，等下好測(cè)試接口

@Configuration
@EnableSwagger2
public class SwaggerConfiguration {
    @Bean(value = "defaultApi2")
    public Docket defaultApi2() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(new ApiInfoBuilder()
                        //.title("swagger-bootstrap-ui-demo RESTful APIs")
                        .description("# swagger-bootstrap-ui-demo RESTful APIs")
                        .termsOfServiceUrl("http://www.xx.com/")
                        .contact("xx@qq.com")
                        .version("1.0")
                        .build())
                //分組名稱
                .groupName("2.X版本")
                .select()
                //這里指定Controller掃描包路徑,自行記得修改?。。?！
                .apis(RequestHandlerSelectors.basePackage("com.example.springbootwechat.controller"))
                .paths(PathSelectors.any())
                .build();
    }
}

entity

這個(gè)是推送消息vo，給那個(gè)用戶推送消息，并帶上token

@Data
@ApiModel(description = "用戶推送vo")
public class PushMessageToUserVo {
    @ApiModelProperty(value = "用戶微信關(guān)注號(hào)", required = true)
    private String touser;
    @ApiModelProperty(value = "用戶Token", required = true)
    private String accessToken;
}

enum

我這里是把地址都變成枚舉，因?yàn)楹竺娴刂窌?huì)比較多，便于維護(hù)，當(dāng)然也可以配置在yaml ,或者定義在使用處。

public enum WeChatUrlEnum {
    /**
     * 獲取token
     */
    TOKEN("獲取微信 token的地址","https://api.weixin.qq.com/cgi-bin/token");
    private String info;
    private String url;
    WeChatUrlEnum(String info,String url) {
        this.info =info;
        this.url = url;
    }
    public String getInfo() {
        return info;
    }
    public void setInfo(String info) {
        this.info = info;
    }
    public String getUrl() {
        return url;
    }
    public void setUrl(String url) {
        this.url = url;
    }
}

utils

工具類：發(fā)送http get,post 請(qǐng)求

public class HttpUtils {
   public static String sendGet(String url, String query) throws Exception {
       String fullUrl = url + "?" + query;
       HttpURLConnection connection = (HttpURLConnection) new URL(fullUrl).openConnection();
       connection.setRequestMethod("GET");
       connection.setRequestProperty("Accept", "application/json");
       if (connection.getResponseCode()!= 200) {
           throw new RuntimeException("Failed : HTTP error code : " + connection.getResponseCode());
       }
       BufferedReader br = new BufferedReader(new InputStreamReader((connection.getInputStream())));
       StringBuilder sb = new StringBuilder();
       String output;
       while ((output = br.readLine())!= null) {
           sb.append(output);
       }
       connection.disconnect();
       return sb.toString();
   }
   public static String sendPost(String url, String data) throws Exception {
       URL fullUrl = new URL(url);
       HttpURLConnection connection = (HttpURLConnection) fullUrl.openConnection();
       connection.setRequestMethod("POST");
       connection.setRequestProperty("Content-Type", "application/json");
       connection.setRequestProperty("Accept", "application/json");
       connection.setDoOutput(true);
       DataOutputStream wr = new DataOutputStream(connection.getOutputStream());
       wr.writeBytes(data);
       wr.flush();
       wr.close();
       if (connection.getResponseCode()!= 200) {
           throw new RuntimeException("Failed : HTTP error code : " + connection.getResponseCode());
       }
       BufferedReader br = new BufferedReader(new InputStreamReader((connection.getInputStream())));
       StringBuilder sb = new StringBuilder();
       String output;
       while ((output = br.readLine())!= null) {
           sb.append(output);
       }
       connection.disconnect();
       return sb.toString();
   }
}