jfinal-weixin 極速開發
摘要：
使用最原始的方式做公眾號開發是效率很低的。http 請求，報文解析轉換，access_token 的維護等都要自已寫一遍
好在有 jfinal-weixin 的存在，大大的簡化了開發，jfinal-weixin 是 jfinal 的一個外掛，不過貌似也可以整合的其他的框架裡
jfina...
使用最原始的方式做公眾號開發是效率很低的。http 請求，報文解析轉換，access_token 的維護等都要自已寫一遍
好在有 jfinal-weixin 的存在，大大的簡化了開發，jfinal-weixin 是 jfinal 的一個外掛，不過貌似也可以整合的其他的框架裡
jfinal 就不說了，很好用的一個框架，下面主要是 jfinal-weixin 的使用
專案最小依賴
-
fastjson-1.2.31.jar
-
jfinal-3.4-bin-with-src
-
jfinal-weixin-2.1.jar
AppConfig
web.xml 的配置,指定 AppConfig 的位置
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" id="WebApp_ID" version="3.1"> <display-name>wx</display-name> <welcome-file-list> <welcome-file>index.html</welcome-file> <welcome-file>index.jsp</welcome-file> </welcome-file-list> <filter> <filter-name>jfinal</filter-name> <filter-class>com.jfinal.core.JFinalFilter</filter-class> <init-param> <param-name>configClass</param-name> <param-value>net.tmaize.wx.AppConfig</param-value> </init-param> </filter> <filter-mapping> <filter-name>jfinal</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> </web-app>
config.txt
token = ********** appId = ********** appSecret = ********** # 開發 onlineWebRoot = /usr/local/tomcat-7.0.90/webapps/wx onlineTokenUrl = http://wx.tmaize.net/api/wx/api/getToken
AppConfig.java
public class AppConfig extends JFinalConfig {
@Override
public void configConstant(Constants me) {
PropKit.use("config.txt");
me.setViewType(ViewType.JFINAL_TEMPLATE);
boolean isOnline = isOnlineEnv();
// 列印請求資訊
me.setDevMode(isOnline);
// 列印微信API請求互動的 xml與json資料
ApiConfigKit.setDevMode(isOnline);
}
@Override
public void configRoute(Routes me) {
me.add("/", IndexController.class);
// 微信收發訊息及伺服器驗證地址
me.add("/api/wx/msg", WeixinMsgController.class);
me.add("/api/wx/api", WeixinApiController.class);
}
@Override
public void afterJFinalStart() {
super.afterJFinalStart();
ApiConfig ac = new ApiConfig();
// 配置微信 API 相關引數
ac.setToken(PropKit.get("token"));
ac.setAppId(PropKit.get("appId"));
ac.setAppSecret(PropKit.get("appSecret"));
// 明文模式，密文要setEncodingAesKey
ac.setEncryptMessage(PropKit.getBoolean("encryptMessage", false));
// 多個公眾號時，重複呼叫ApiConfigKit.putApiConfig(ac)依次新增即可，第一個新增的是預設
ApiConfigKit.putApiConfig(ac);
// 開發時使用線上AccessToken
if (!isOnlineEnv()) {
LocalTestTokenCache localTestTokenCache = new LocalTestTokenCache(PropKit.get("onlineTokenUrl"));
ApiConfigKit.setAccessTokenCache(localTestTokenCache);
}
}
/**
* 環境判斷
* @return
*/
public boolean isOnlineEnv() {
return PropKit.get("onlineWebRoot").equals(PathKit.getWebRootPath());
}
}
獲取 access_token
獲取 access_token 就是呼叫一個介面那簡單，上面配置了一個 URL 供開發環境獲取線上的 access_token，看下里面是怎麼獲取的就知道了
WeixinApiController.java
package net.tmaize.wx.controller;
import com.jfinal.weixin.sdk.api.AccessToken;
import com.jfinal.weixin.sdk.api.AccessTokenApi;
import com.jfinal.weixin.sdk.jfinal.ApiController;
public class WeixinApiController extends ApiController {
/**
* 為開發環境提供AccessToken
*/
public void getToken() {
// 一行程式碼搞定
AccessToken accessToken = AccessTokenApi.getAccessToken();
renderJson(accessToken.getJson());
}
}
伺服器驗證及收發訊息
只需要繼承 MsgControllerAdapter 就行了，該地址就具備了伺服器驗證的能力和收發資訊的能力
當然了發信息的邏輯要自己實現
/**
* 處理接收到的文字訊息
* @param inTextMsg 處理接收到的文字訊息
*/
@Override
protected void processInTextMsg(InTextMsg inTextMsg) {
OutTextMsg outMsg = new OutTextMsg(inTextMsg);
switch (inTextMsg.getContent()) {
case "個人資訊":
// 未認證訂閱號，沒有這個許可權
ApiResult userInfo = UserApi.getUserInfo(inTextMsg.getFromUserName());
outMsg.setContent(userInfo.getJson());
break;
case "token":
outMsg.setContent(AccessTokenApi.getAccessTokenStr());
break;
default:
outMsg.setContent(inTextMsg.getContent());
break;
}
render(outMsg);
}
除錯
有時候需要本地呼叫微信介面來除錯，但是又不想啟動整個 web 專案，也是有辦法的
/**
* 測試微信API
* @author tmaize
*
*/
public class WXTest {
public static void init() {
PropKit.use("config.txt");
ApiConfig ac = new ApiConfig();
ac.setToken(PropKit.get("token"));
ac.setAppId(PropKit.get("appId"));
ac.setAppSecret(PropKit.get("appSecret"));
ac.setEncryptMessage(PropKit.getBoolean("encryptMessage", false));
ApiConfigKit.putApiConfig(ac);
if (!PropKit.get("onlineWebRoot").equals(PathKit.getWebRootPath())) {
LocalTestTokenCache localTestTokenCache = new LocalTestTokenCache(PropKit.get("onlineTokenUrl"));
ApiConfigKit.setAccessTokenCache(localTestTokenCache);
}
}
public static void main(String[] args) throws Exception {
init();
System.out.println(AccessTokenApi.getAccessToken().getJson());
}
}
參考
ofollow,noindex" target="_blank">jfinal 官方文件