java微信開發框架wechat4j入門教程

wechat4j

What is wechat4j?

wechat develop framework for java(微信開發框架JAVA版，最簡單易用微信開發框架)

wechat4j能夠用來幹什麼？

wechat4j是一個幫助你開發微信應用的jar包，使用它，你開發微信公衆號應用只須要幾秒鐘的時間，徹底不用關注太細節的東西。

wechat4j快速開始

能夠去下載wechat4j示例項目，而後在其基礎之上修改便可。若是你要本身搭建，那麼使用wechat4j只須要兩步就能夠搭建微信開發環境。

1. 建立一個web工程，導入jdk和相關的web工程jar包。
2. 下載wechat4j.jar包，下載地址wechat4j下載。
3. 建立wechat4j配置文件，在src目錄下（java根目錄）建立wechat4j.properties文件，配置你微信公衆號的相關信息。內容以下：

#you server url
wechat.url=
#you wechat token
wechat.token=token
#message secret key,if don't set then message is cleartext
wechat.encodingaeskey=

#wechat appid
wechat.appid=appid
#wechat app secret
wechat.appsecret=secret

#wechat access token server ,when you save in db,must implement you server class
#this class must extend org.sword.wechat4j.token.DbAccessTokenServer
#if no this property,then token server is default memery accesstoken server()
wechat.accessToken.server.class=

#jsapi_ticket customer server class name,
#this class must extend org.sword.wechat4j.token.server.CustomerServer
#if no this property,then ticket server is default memery ticket server
wechat.ticket.jsapi.server.class=

你也能夠在jar包的META-INF目錄下找到wechat4j.properties.sample文件，複製到src目錄下修更名稱便可。wechat4j.properties配置文件的配置項意義參見wechat4j配置文件解讀

經過以上步驟，你的微信工程就徹底搭好了。

wechat4j 運行環境

wechat4j要求的最低java運行環境是jdk1.6

wechat4j.jar的依賴jar包

• commons-codec.jar 1.3以上
• commons-lang3.jar
• log4j.jar 1.2以上
• fastjson-1.2.0.jar
• fluent-hc-4.3.6.jar（httpclient依賴）
• httpclient-4.3.6.jar
• httpcore-4.3.3.jar （httpclient依賴）
• servlet-api.jar 若是你是web工程，導入支持web工程的包就會包括，例如tomcat包

開發本身的微信應用

wechat4j開發環境搭好以後，就能夠開始開發本身的微信應用了。好比我有一個微信號的token是lejian,下面就以她爲例子來講明。

建立本身公衆號服務類

建立本身的微信公衆號服務類，須要繼承wechat4j的WechatSupport類，而後實現其抽象方法便可，下面以文本消息處理爲例子

public class Lejian extends WechatSupport{
public Lejian(HttpServletRequest request, String token) {
super(request, token);
}

@Override
protected void onText() {
this.wechatRequest.getFromUserName();
String content = "test ok";
responseText(content);
}
}

上面代碼中的onText()是WechatSupport的抽象方法，須要你本身的類來實現，表示對文本消息的處理，示例中是接收到用戶的消息以後，返回給用戶「test ok」文本消息。

建立微信服務地址

建立微信服務地址（微信公衆平臺中配置的本身服務器地址）servlet類。若是是springmvc則建立對應的controller，若是是struts則建立對應的action類。servlet類示例以下：

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
Lejian lejian = new Lejian(request, TOKEN);
String result = lejian.execute();
response.getOutputStream().write(result.getBytes());
}
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
Lejian lejian = new Lejian(request, TOKEN);
String result = lejian.execute();
response.getOutputStream().write(result.getBytes());

}

經過上面兩步你的微信服務就能夠運行了

如何獲得微信的請求參數

繼承了WechatSupport類以後，你能夠經過wechatRequest.getFromUserName()相似的方法來獲得微信服務器請求的參數。詳細信息請閱讀微信請求參數

如何設置響應參數

繼承了WechatSupport類以後，你能夠經過wechatResponse.setFromUserName(fromUser)相似的方法來設置給微信服務器的響應參數。詳細信息請閱讀響應微信服務器參數

如何響應用戶信息

以文本信息爲例，響應文本信息只須要在你的onText方法中使用responseText(content)便可（參見上面的代碼例子）

wechat4j示例項目

• wechat4jDemo

若是你有好的demo項目，請郵件或者修改本文件而後pull request給我，我會列在上面。

技術支持

• wechat4j技術交流QQ羣 423134346
• 支持郵件 sword_org@163.com
• wechat4j暫不管壇，歡迎開通論壇交流版塊，若是開通請郵件，我會添加到這裏。

貢獻代碼

1. 若是你以爲本項目不錯，但願你可以點擊一下右上角的star
2. 若是你但願參與改進本項目，那麼請點擊右上角的fork，修改以後pull request便可。若是你的貢獻不錯，你就會收到加入sword開源社區的邀請。
3. 若是你發現了一個bug，請你建立一個issue來報告。
   很是很是歡迎你可以參與本項目的建設，每人作出一點點貢獻，對整個項目來講就是一個很是大的貢獻，但願集合衆人的力量，讓項目走的更好，可以爲更多的人服務。

貢獻者列表

• @chengn
• @truecn