微信公共平台开发(一):服务器配置

转载请注明出处:http://blog.csdn.net/xiaojimanman/article/details/45042549

http://www.llwjy.com/blogdetail/43b9fff3f2b827f4444826aeee756ec7.html

个人博客站已经上线了,网址 www.llwjy.com ~欢迎各位吐槽~
-------------------------------------------------------------------------------------------------

      从这篇博客起,个人开启另一个板块的开发介绍:微信公众平台。官方给的参考文档多数都是基于PHP的,所以关于如何使用PHP开发参考官方文档即可,这里只介绍如何基于java做开发。

      微信公共平台官网地址:https://mp.weixin.qq.com/ 没有公共帐号的可以直接在上面注册,注册部分自己实践,这里不做介绍,下面的部分都是在您已有微信公共号的前提下,微信公共平台开发者文档:http://mp.weixin.qq.com/wiki/home/index.html


开发环境准备

      java IDE:MyEclipse;web服务:apache+tomcate;计算机:需要有外网独立IP(如果没有的话,可以搜索下花生壳)。


接入指南

      在开发者文档的新手指南--接入指南中我们可以看到,在实现具体业务之前,需要验证服务器的有效性,因此我们需要先开发一个接口来完成这个验证。注:微信公众号接口只支持80接口,所以apache的监听端口是80。


项目开发

      在MyEclipse中新建一个web项目,自己这边的包分布如下图所示:

微信公共平台开发(一):服务器配置

      在开发者文档中我们可以得知,服务器验证是对一些信息做sha1加密处理,我们需要写加密算法,具体代码如下:

 /**  
 *@Description: JAVA实现常见加密算法
 */ 
package com.lulei.util;  

import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
  
public class Encrypt {

	/**
	 * @param str 需要加密的字符串
	 * @param encName 加密种类  MD5 SHA-1 SHA-256
	 * @return
	 * @Author:lulei  
	 * @Description: 实现对字符串的加密
	 */
	public static String encrypt(String str, String encName){
		String reStr = null;
		try {
			MessageDigest md5 = MessageDigest.getInstance(encName);
			byte[] bytes = md5.digest(str.getBytes());
			StringBuffer stringBuffer = new StringBuffer();
			for (byte b : bytes){
				int bt = b&0xff;
				if (bt < 16){
					stringBuffer.append(0);
				} 
				stringBuffer.append(Integer.toHexString(bt));
			}
			reStr = stringBuffer.toString();
		} catch (NoSuchAlgorithmException e) {
			e.printStackTrace();
		}
		return reStr;
	}
	
	public static void main(String[] args) {
		System.out.println(Encrypt.encrypt("nihao", null));
	}
	
}
加密/校验流程如下:
1. 将token、timestamp、nonce三个参数进行字典序排序
2. 将三个参数字符串拼接成一个字符串进行sha1加密
3. 开发者获得加密后的字符串可与signature对比,标识该请求来源于微信

对于微信公共平台的加密,我们创建SignUtil类,让他来完成具体的验证工作,源代码如下:

 /**  
 *@Description:  微信验证 
 */ 
package com.lulei.weixin.util;  

import java.util.Arrays;

import com.lulei.util.Encrypt;
import com.lulei.weixin.config.Config;

public class SignUtil {
	
	/**
	 * @param signature
	 * @param timestamp
	 * @param nonce
	 * @return
	 * @Author:lulei  
	 * @Description: 微信权限验证
	 */
	public static boolean checkSignature(String signature, String timestamp, String nonce) {
		String[] arr = new String[] { Config.TOKEN, timestamp, nonce };
		//按字典排序
		Arrays.sort(arr);
		StringBuilder content = new StringBuilder();  
        for (int i = 0; i < arr.length; i++) {  
            content.append(arr[i]);  
        }
        //加密并返回验证结果
        return signature == null ? false : signature.equals(Encrypt.encrypt(content.toString(), "SHA-1"));
	}


}
      在上面有一个常量Config.TOKEN,这个是来自配置文件,也就是即将要在微信公共平台填写的Token值,可以根据自己的需要填写(英文或数字,3~32位)。在阅读相关开发者文档后发现,微信公共平台的接口几乎都是输出json字符串或者xml字符串,因此我们创建一个接口父类StringServletBase,具体代码如下:

 /**  
 *@Description:
 */ 
package com.lulei.weixin.servlet;  

import java.io.IOException;
import java.io.PrintWriter;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public abstract class StringServletBase extends HttpServlet {

	private static final long serialVersionUID = 1L;

	/**
	 * Constructor of the object.
	 */
	public StringServletBase() {
		super();
	}

	/**
	 * Destruction of the servlet. <br>
	 */
	public void destroy() {
		super.destroy(); // Just puts "destroy" string in log
		// Put your code here
	}

	/**
	 * The doGet method of the servlet. <br>
	 *
	 * This method is called when a form has its tag value method equals to get.
	 * 
	 * @param request the request send by the client to the server
	 * @param response the response send by the server to the client
	 * @throws ServletException if an error occurred
	 * @throws IOException if an error occurred
	 */
	public void doGet(HttpServletRequest request, HttpServletResponse response)
			throws ServletException, IOException {
		response.setCharacterEncoding("utf-8");
		PrintWriter out = response.getWriter();
		response.setContentType("text/plain");
		String str = parseString(request);
		if (str != null) {
			out.print(str);
		}
		out.flush();
		out.close();
	}

	/**
	 * The doPost method of the servlet. <br>
	 *
	 * This method is called when a form has its tag value method equals to post.
	 * 
	 * @param request the request send by the client to the server
	 * @param response the response send by the server to the client
	 * @throws ServletException if an error occurred
	 * @throws IOException if an error occurred
	 */
	public void doPost(HttpServletRequest request, HttpServletResponse response)
			throws ServletException, IOException {
		this.doGet(request, response);
	}

	/**
	 * Initialization of the servlet. <br>
	 *
	 * @throws ServletException if an error occurs
	 */
	public void init() throws ServletException {
		
	}
	
	/**
	 * @param request
	 * @return
	 * @Author:lulei  
	 * @Description: 接口需要输出的字符串
	 */
	protected abstract String parseString(HttpServletRequest request);

}
      在接入指南中,还有一个URL项目需要填写,这个URL地址就是微信服务器和自己服务器互相通信的接口,因此我们创建WeiXinServlet接口类,源代码如下:

 /**  
 *@Description:     
 */ 
package com.lulei.weixin.servlet;  

import java.io.IOException;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;

import com.lulei.util.ParseRequest;
import com.lulei.weixin.util.SignUtil;

public class WeiXinServlet extends StringServletBase {

	private static final long serialVersionUID = 1L;

	/**
	 * @param request
	 * @return
	 * @throws ServletException
	 * @throws IOException
	 * @Author:lulei  
	 * @Description: 这里是微信服务器验证
	 */
	protected String check(HttpServletRequest request) { 
		String signature = ParseRequest.getString(request, "signature", "");
		String timestamp = ParseRequest.getString(request, "timestamp", "");
		String nonce = ParseRequest.getString(request, "nonce", "");
		String echostr = ParseRequest.getString(request, "echostr", "");
		if (SignUtil.checkSignature(signature, timestamp, nonce)) {
			return echostr;
		}
		return null;
	}

	@Override
	protected String parseString(HttpServletRequest request) {
		//微信首次验证
		return check(request);
	}

}


配置web.xml

      在web.xml文件中,添加如下代码:

<!-- 微信服务器 -->
<servlet>
	<servlet-name>WeiXinServlet</servlet-name>
	<servlet-class>com.lulei.weixin.servlet.WeiXinServlet</servlet-class>
</servlet>
<servlet-mapping>
	<servlet-name>WeiXinServlet</servlet-name>
	<url-pattern>/weixin.do</url-pattern>
</servlet-mapping>
      到现在为止,所有的准备工作都已经做好,下面就开始配置项的填写(注:自己的这个weixin.do接口必须可以通过外网ip的80端口访问到


填写配置项

      登录微信公共平台,在左侧最下方选择开发者中心菜单,如下图:

微信公共平台开发(一):服务器配置


      在右侧选择配置项启用左侧按钮),在页面上填写与自己开发想匹配的信息,如下图:

微信公共平台开发(一):服务器配置


      EncodingAESKey直接选择随机生成即可,如果你填写的信息都正确的话,提价就完成了服务器有效性验证,这时候点击启用就可以开始自己的微信公共平台开发之旅。下一篇博客将介绍如何采集百小度的聊天信息,实现微信小机器人功能~



微信公共平台开发(一):服务器配置

上一篇:微信摇一摇功能实现


下一篇:微信开发学习日记(五):weiphp开源框架的bug,公众号权限编辑问题