JFinal Weixin 2.3 釋出，支援微信小程式開發

小程式開發 JFinal · 發表 2019-02-01 15:35:06

摘要： jfinal weixin 專案早在五年前就釋出了第一個版本，是老牌的微信公眾號開發 SDK，已穩定、可靠服役多年。因為極簡設計、良好的開發體驗，所以深受開發者的喜愛。五年來 jfinal weixin 一直緊跟微信公眾平臺的動向，不斷跟隨新增新的功能，大大方便了使用者開發微信公眾平臺專...

jfinal weixin 專案早在五年前就釋出了第一個版本，是老牌的微信公眾號開發 SDK，已穩定、可靠服役多年。因為極簡設計、良好的開發體驗，所以深受開發者的喜愛。

五年來 jfinal weixin 一直緊跟微信公眾平臺的動向，不斷跟隨新增新的功能，大大方便了使用者開發微信公眾平臺專案。但是鮮有人知道的是 JFinal Weixin 很早就支援小程式開發了，只是一直沒顧上釋出新聞告知大家。

本次 jfinal weixin 2.3 由 @盧春夢及其小夥伴貢獻，感謝 @春夢大神持續為大家帶來的價值。

1、小程式支付

/**
 * 小程式統一下單
 * @param order 小程式支付訂單資訊封裝
 * @throws PaymentException 支付異常
 */
wxaPayApi.unifiedOrder(WxaOrder order);

2、小程式模板訊息

// template 模版物件
wxaTemplateApi.send(WxaTemplate template);

3、小程式登入介面

// js登入時獲取的 code
wxaUserApi.getSessionKey(String jsCode);

參考示例，js 端：http://git.oschina.net/jfinal/jfinal-weixin/blob/master/src/main/webapp/wxaapp/app.js

參考示例，服務端：http://git.oschina.net/jfinal/jfinal-weixin/blob/master/src/main/java/com/jfinal/weixin/demo/WxaUserApiController.java

4、小程式頁面二維碼

/**
 * 獲取小程式頁面二維碼
 * 
 * 通過該介面，僅能生成已釋出的小程式的二維碼。
 * 可以在開發者工具預覽時生成開發版的帶參二維碼。
 * 帶參二維碼只有 100000 個，請謹慎呼叫。
 * 
 * width 預設430
 * @param path 不能為空，最大長度 128 位元組
 */
wxaQrcodeApi.createQrcode(String path);

/**
 * 獲取小程式頁面二維碼
 * 
 * 通過該介面，僅能生成已釋出的小程式的二維碼。
 * 可以在開發者工具預覽時生成開發版的帶參二維碼。
 * 帶參二維碼只有 100000 個，請謹慎呼叫。
 * 
 * @param path 不能為空，最大長度 128 位元組
 * @param width 預設430 二維碼的寬度
 */
wxaQrcodeApi.createQrcode(String path, int width);

5、小程式客服介面

/**
 * 傳送客服訊息
 * @param message 訊息封裝
 * @return ApiResult
 */
wxaMessageApi.sendMsg(Map<String, Object> message);

/**
 * 傳送文字客服訊息
 * @param openId openId
 * @param text 文字訊息
 * @return ApiResult
 */
wxaMessageApi.sendText(String openId, String text);

/**
 * 傳送圖片訊息
 * @param openId openId
 * @param mediaId 圖片媒體id
 * @return ApiResult
 */
wxaMessageApi.sendImage(String openId, String mediaId);

6、小程式素材介面

/**
 * 獲取臨時素材
 * @param mediaId 素材Id
 * @return MediaFile
 */
wxaMaterialApi.getMedia(String mediaId);

/**
 * 上傳臨時素材
 * @param file 需要上傳的檔案
 * @param type image
 * @return ApiResult
 */
wxaMaterialApi.uploadMedia(File file, String type);

JFinal Weixin 的所有 API 的使用盡可能做成一行程式碼搞定，不僅極大降低了使用者的學習成本，而且極大提升了使用者的開發效率。更多用法請移步：https://gitee.com/jfinal/jfinal-weixin/wikis/Home

此外，jfinal weixin 2.3 還針對使用者的一些反饋，打磨了微信公眾號支援的部分功能，在此不再贅述。

重點：JFinal Weixin 不僅僅是微信公眾號 SDK， 也是微信小程式 SDK