微信公眾號開發 (3) 選單處理

首頁>技術>鄭清2020-01-18 11:53

微信公眾號開發 (3) 選單處理

根據AppID和AppSecret獲取access_token自定義選單（建立選單、查詢選單、刪除選單）微信文件中提示的一些注意點：access_token的`儲存`至少要保留`512`個`字元`空間。accesstoken的有效期為2小時，需定時重新整理，重複獲取將導致上次獲取的accesstoken失效自定義選單最多3個一級選單，每一級選單最多5個二級選單一級選單最多4個漢字，二級選單最多7個漢字選單重新整理策略：5分鐘之後更新選單。測試時可以嘗試取消關注公眾賬號後再次關注，則可以看到建立後的效果二、RestTemplate配置 (用於遠端呼叫微信http介面方法)

RestTemplate是Spring提供的用於訪問Rest服務的客戶端,RestTemplate提供了多種便捷訪問遠端Http服務的方法,能夠大大提高客戶端的編寫效率。

@Configurationpublic class RestTemplateConfig {    @Bean    public RestTemplate restTemplate() {        RestTemplate restTemplate = new RestTemplate();        // 解決post請求中文亂碼問題        restTemplate.getMessageConverters().set(1, new StringHttpMessageConverter(StandardCharsets.UTF_8));        return restTemplate;    }}

獲取accesstoken介面：【GET請求】 `/file/2020/01/18/20200118115113_16864.jpg ：【GET請求】 /file/2020/01/18/20200118115113_16865.jpg : 【GET請求】 /file/2020/01/18/20200118115113_16866.jpg : 【POST請求】 /file/2020/01/18/20200118115113_16867.jpg class Constants { /** * TODO 填寫自己的 `appID` 和 `appsecret` */ public static final String APP_ID = "xxx"; public static final String APP_SECRET = "xxx"; /** * 通過 `GET請求方式` 獲取 `access_token` */ public static final String GET_ACCESS_TOKEN_URL = "/file/2020/01/18/20200118115114_16868.jpg /** * TODO 只做臨時方便測試使用 */ public static final String ACCESS_TOKEN = "xxx"; /** * 查詢選單介面 - GET請求 */ public static final String GET_MENU_URL = "/file/2020/01/18/20200118115114_16869.jpg /** * 刪除選單介面 - GET請求（注意，在個性化選單時，呼叫此介面會刪除預設選單及全部個性化選單） */ public static final String DELETE_MENU_URL = "/file/2020/01/18/20200118115114_16870.jpg /** * 建立選單介面 - POST請求 */ public static final String CREATE_MENU_URL = "/file/2020/01/18/20200118115114_16871.jpg 封裝響應結果AccessTokenVO

@Data@ApiModel(description = &#34;access_token: 公眾號的全域性唯一介面呼叫憑據&#34;)public class AccessTokenVO {    @ApiModelProperty(value = &#34;獲取到的憑證&#34;)    private String access_token;    @ApiModelProperty(value = &#34;憑證有效時間，單位：秒(微信目前暫7200秒，即2小時，過期後需再次獲取)&#34;)    private int expires_in;}

② 服務類

public interface IWeixinService {    /**     * 根據AppID和AppSecret獲取access_token     *     * @param appId:     * @param appSecret:     * @return: com.zhengqing.demo.modules.weixin.model.AccessTokenVO     */    AccessTokenVO getAccessToken(String appId, String appSecret);}

@Slf4j@Servicepublic class WeixinServiceImpl implements IWeixinService {    @Autowired    private RestTemplate restTemplate;    @Override    public AccessTokenVO getAccessToken(String appId, String appSecret) {        AccessTokenVO accessTokenVO = restTemplate.getForObject(Constants.GET_ACCESS_TOKEN_URL.replace(&#34;APPID&#34;, appId).replace(&#34;APPSECRET&#34;, appSecret), AccessTokenVO.class);        return accessTokenVO;    }}

五、自定義選單處理click和view請求示例

{     &#34;button&#34;:[     {              &#34;type&#34;:&#34;click&#34;,          &#34;name&#34;:&#34;今日歌曲&#34;,          &#34;key&#34;:&#34;V1001_TODAY_MUSIC&#34;      },      {           &#34;name&#34;:&#34;選單&#34;,           &#34;sub_button&#34;:[           {                   &#34;type&#34;:&#34;view&#34;,               &#34;name&#34;:&#34;搜尋&#34;,               &#34;url&#34;:&#34;http://www.soso.com/&#34;            },            {                 &#34;type&#34;:&#34;miniprogram&#34;,                 &#34;name&#34;:&#34;wxa&#34;,                 &#34;url&#34;:&#34;http://mp.weixin.qq.com&#34;,                 &#34;appid&#34;:&#34;wx286b93c14bbf93aa&#34;,                 &#34;pagepath&#34;:&#34;pages/lunar/index&#34;             },            {               &#34;type&#34;:&#34;click&#34;,               &#34;name&#34;:&#34;贊一下我們&#34;,               &#34;key&#34;:&#34;V1001_GOOD&#34;            }]       }] }

1、封裝選單資料① 選單型別列舉類

public enum MenuType {    // 點選式選單    CLICK(&#34;click&#34;),    // 連結式選單    VIEW(&#34;view&#34;);}

② 選單 - 基類

@Data@ApiModel(description = &#34;選單 - 基類&#34;)public class Button {    @ApiModelProperty(value = &#34;選單標題，不超過16個位元組，子選單不超過60個位元組&#34;)    private String name;}

@Data@ApiModel(description = &#34;使用者點選選單可接收訊息推送&#34;)public class ClickButton extends Button {    @ApiModelProperty(value = &#34;選單的響應動作型別，view表示網頁型別，click表示點選型別，miniprogram表示小程式型別&#34;)    private String type = MenuType.CLICK.getType();    @ApiModelProperty(value = &#34;選單KEY值，用於訊息介面推送，不超過128位元組&#34;)    private String key;}

④ 連結式選單

@Data@ApiModel(description = &#34;使用者點選選單可開啟連結&#34;)public class ViewButton extends Button {    @ApiModelProperty(value = &#34;選單的響應動作型別，view表示網頁型別，click表示點選型別，miniprogram表示小程式型別&#34;)    private String type = MenuType.VIEW.getType();    @ApiModelProperty(value = &#34;(view、miniprogram型別必須) 網頁 連結，使用者點選選單可開啟連結，不超過1024位元組。 type為miniprogram時，不支援小程式的老版本客戶端將開啟本url&#34;)    private String url;}

⑤ 含二級選單的一級選單

@Data@ApiModel(description = &#34;含二級選單的一級選單&#34;)public class ComplexButton extends Button {    @ApiModelProperty(value = &#34;二級選單陣列，個數應為1~5個&#34;)    private Button[] sub_button;}

⑥ 最外層的選單樹

@Data@ApiModel(description = &#34;選單樹&#34;)public class Menu {    @ApiModelProperty(value = &#34;一級選單陣列，個數應為1~3個&#34;)    private Button[] button;}

2、服務類

public interface IMenuService {    /**     * 查詢選單     *     * @param accessToken:訪問憑據     * @return: java.lang.Object     */    Object getMenu(String accessToken);    /**     * 刪除選單     *     * @param accessToken:訪問憑據     * @return: com.zhengqing.demo.modules.weixin.model.WeixinResponseResult     */    WeixinResponseResult deleteMenu(String accessToken);    /**     * 建立選單     *     * @param menu        : 建立的選單資料     * @param accessToken : 訪問憑據     * @return: com.zhengqing.demo.modules.weixin.model.WeixinResponseResult     */    WeixinResponseResult createMenu(Menu menu, String accessToken);}

3、服務實現類

@Slf4j@Servicepublic class MenuServiceImpl implements IMenuService {    @Autowired    private RestTemplate restTemplate;    @Override    public Object getMenu(String accessToken) {        Object menu = restTemplate.getForObject(Constants.GET_MENU_URL.replace(&#34;ACCESS_TOKEN&#34;, accessToken), Object.class);        return menu;    }    @Override    public WeixinResponseResult deleteMenu(String accessToken) {        WeixinResponseResult result = restTemplate.getForObject(Constants.DELETE_MENU_URL.replace(&#34;ACCESS_TOKEN&#34;, accessToken), WeixinResponseResult.class);        return result;    }    @Override    public WeixinResponseResult createMenu(Menu menu, String accessToken) {        // 將選單物件轉換成json字串        String jsonMenu = JSON.toJSONString(menu);        WeixinResponseResult result = restTemplate.postForObject(Constants.CREATE_MENU_URL.replace(&#34;ACCESS_TOKEN&#34;, accessToken), jsonMenu, WeixinResponseResult.class);        return result;    }}

六、測試1、獲取access_token

@Slf4j@RunWith(SpringRunner.class)@SpringBootTest(classes = DemoApplication.class)public class WeixinTest {    @Autowired    private IWeixinService weixinService;    @Test // 獲取 `access_token`    public void getAccessToken() throws Exception {        AccessTokenVO accessTokenVO = weixinService.getAccessToken(Constants.APP_ID, Constants.APP_SECRET);        log.info(&#34;======================================== \\n&#34; + accessTokenVO.getAccess_token());    }}

2、建立自定義選單、查詢選單、刪除選單

注：這裡小編將獲取到的access_token 寫死到常量 Constants.ACCESS_TOKEN 中做測試，實際專案中可將access_token儲存到快取中，每隔快到2個小時的時候去重新獲取一次重新整理快取資料 ~

@Slf4j@RunWith(SpringRunner.class)@SpringBootTest(classes = DemoApplication.class)public class MenuTest {    @Autowired    private IMenuService menuService;    @Test // 查詢選單    public void getMenu() {        Object menu = menuService.getMenu(Constants.ACCESS_TOKEN);        log.info(&#34;======================================== \\n&#34; + JSON.toJSONString(menu));    }    @Test // 刪除選單    public void deleteMenu() {        WeixinResponseResult result = menuService.deleteMenu(Constants.ACCESS_TOKEN);        log.info(&#34;======================================== \\n&#34; + result);    }    @Test // 建立選單    public void createMenu() {        WeixinResponseResult result = menuService.createMenu(createMenuTree(), Constants.ACCESS_TOKEN);        log.info(&#34;======================================== \\n&#34; + result);    }    /**     * 選單資料     */     private Menu createMenuTree() {        // 連結式選單        ViewButton btn11 = new ViewButton();        btn11.setName(&#34;CSDN&#34;);        btn11.setUrl(&#34;https://zhengqing.blog.csdn.net/&#34;);        ViewButton btn12 = new ViewButton();        btn12.setName(&#34;個人部落格&#34;);        btn12.setUrl(&#34;http://zhengqingya.gitee.io/blog/&#34;);        // 點選式選單        ClickButton mainBtn2 = new ClickButton();        mainBtn2.setName(&#34;點我吖&#34;);        mainBtn2.setKey(&#34;hello&#34;);        ViewButton btn31 = new ViewButton();        btn31.setName(&#34;碼雲&#34;);        btn31.setUrl(&#34;https://gitee.com/zhengqingya/projects&#34;);        ViewButton btn32 = new ViewButton();        btn32.setName(&#34;GitHub&#34;);        btn32.setUrl(&#34;/file/2020/01/18/20200118115116_16872.jpg        // 含二級選單的一級選單        ComplexButton mainBtn1 = new ComplexButton();        mainBtn1.setName(&#34;部落格&#34;);        mainBtn1.setSub_button(new ViewButton[]{btn11, btn12});        ComplexButton mainBtn3 = new ComplexButton();        mainBtn3.setName(&#34;倉庫&#34;);        mainBtn3.setSub_button(new ViewButton[]{btn31, btn32});        Menu menu = new Menu();        menu.setButton(new Button[]{mainBtn1, mainBtn2, mainBtn3});        return menu;    }}

最終自定義的選單

本文案例demo原始碼

https://gitee.com/zhengqingya/java-workspace

微信

∨ PHP/MySQL開發環境軟體----MAMP Pro for Mac

熱門排行

劇多

微信公眾號開發 (3) 選單處理

微信