weixin4j微信開發-零開發新手接入

其實在weixin4j中，已經爲大家提供了一個默認的消息接入Filter，大家只需要將jar包引入，然後配置一下web.xml和weixin4j.properties，然後部署web項目，也可以實現新手接入。

首先先展示一下默認的Filter源碼

/*
 * 微信公衆平臺(JAVA) SDK
 *
 * Copyright (c) 2014, Ansitech Network Technology Co.,Ltd All rights reserved.
 * 
 * http://www.weixin4j.org/
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.weixin4j;

import org.weixin4j.util.TokenUtil;
import java.io.IOException;
import javax.servlet.Filter;
import javax.servlet.FilterChain;
import javax.servlet.FilterConfig;
import javax.servlet.ServletException;
import javax.servlet.ServletInputStream;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.weixin4j.spi.IMessageHandler;
import org.weixin4j.spi.HandlerFactory;

/**
 * 微信公衆平臺接受消息默認攔截器
 *
 * @author yangqisheng
 * @since 0.0.1
 */
public class WeixinUrlFilter implements Filter {

    @Override
    public void init(FilterConfig config) throws ServletException {
        if (Configuration.isDebug()) {
            System.out.println("WeixinUrlFilter啓動成功!");
        }
    }

    @Override
    public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws IOException, ServletException {
        HttpServletRequest request = (HttpServletRequest) req;
        HttpServletResponse response = (HttpServletResponse) res;
        //微信服務器將發送GET請求到填寫的URL上,這裏需要判定是否爲GET請求
        boolean isGet = request.getMethod().toLowerCase().equals("get");
        if (Configuration.isDebug()) {
            System.out.println("獲得微信請求:" + request.getMethod() + " 方式");
            System.out.println("微信請求URL:" + request.getServletPath());
        }
        //消息來源可靠性驗證
        String signature = request.getParameter("signature");// 微信加密簽名
        String timestamp = request.getParameter("timestamp");// 時間戳
        String nonce = request.getParameter("nonce");       // 隨機數
        //Token爲weixin4j.properties中配置的Token
        String token = TokenUtil.get();
        if (isGet) {
            //1.驗證消息真實性
            //http://mp.weixin.qq.com/wiki/index.php?title=驗證消息真實性
            //URL爲http://www.weixin4j.org/api/公衆號
            //成爲開發者驗證
            String echostr = request.getParameter("echostr");   //
            //確認此次GET請求來自微信服務器，原樣返回echostr參數內容，則接入生效，成爲開發者成功，否則接入失敗
            if (TokenUtil.checkSignature(token, signature, timestamp, nonce)) {
                response.getWriter().write(echostr);
            }
        } else {
            //確認此次GET請求來自微信服務器，原樣返回echostr參數內容，則接入生效，成爲開發者成功，否則接入失敗
            if (!TokenUtil.checkSignature(token, signature, timestamp, nonce)) {
                //消息不可靠，直接返回
                response.getWriter().write("");
                return;
            }
            //用戶每次向公衆號發送消息、或者產生自定義菜單點擊事件時，響應URL將得到推送
            doPost(request, response);
        }
    }

    //當普通微信用戶向公衆賬號發消息時，微信服務器將POST消息的XML數據包到開發者填寫的URL上
    //用戶在關注與取消關注公衆號時，微信會把這個事件推送到開發者填寫的URL
    //用戶每次發送語音給公衆號時，微信會在推送的語音消息XML數據包中，增加一個Recongnition字段
    private void doPost(HttpServletRequest request, HttpServletResponse response) throws IOException {
        try {
            response.setCharacterEncoding("UTF-8");
            response.setContentType("text/xml");
            //獲取POST流
            ServletInputStream in = request.getInputStream();
            if (Configuration.isDebug()) {
                System.out.println("接收到微信輸入流,準備處理...");
            }
            IMessageHandler messageHandler = HandlerFactory.getMessageHandler();
            //處理輸入消息，返回結果
            String xml = messageHandler.invoke(in);
            //返回結果
            response.getWriter().write(xml);
        } catch (Exception ex) {
            ex.printStackTrace();
            response.getWriter().write("");
        }
    }

    @Override
    public void destroy() {
    }
}

源碼大家可以看，也可以不看。

下面教大家，直接在web.xml中，加一個Filter即可。

<!-- 默認Filter方式 微信接入配置 -->
<servlet>
    <servlet-name>wechatFilter</servlet-name>
    <servlet-class>org.weixin4j.WeixinUrlFilter</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>wechatFilter</servlet-name>
    <url-pattern>/api/*</url-pattern>
</servlet-mapping>

最後，將項目打包，發佈到服務器，就可以在微信公衆號平臺中，進行開發者接入認證了。

祝你部署成功，生活愉快！

明天會有更精彩的內容，別走開，馬上回來！

您可以加入我們的官方QQ羣：365736353，專業人爲您解答各種技術問題。

更多文章，請關注：http://www.weixin4j.org/