Java微信公众号开发梳理
现在微信公众平台的开发已经越来越普遍，这次开发需要用到微信公众平台。因此做一个简单的记录，也算是给那些没踩过坑的童鞋一些启示吧。我将分几块来简单的描述一下，之后会做详细的说明。
功能性说明
微信提供了许许多多的接口供用户使用，开发者可以根据这些接口获取用户的信息。
普遍的有用户的昵称性别地理位置等。
其他我就不一一列举了，总之需要根据你的实际业务需求来进行使用。
你需要什么就去看看微信是否提供了相应的接口供你使用。
微信接口文档地址路径：https://mp.weixin.qq.com/wiki/home/index.html
接口调用说明
微信的接口有几种不同的类型：
1、get请求，微信会提供一个地址，然后你直接在这个地址后面加上参数即可调用接口
2、post请求，微信提供一个地址，你需要向这个接口地址传入相应的参数。
3、回调请求，微信在收到用户消息或者别的触发条件成立时调用用户设置的URL地址。
请求格式包括XML和json，需要根据接口文档来。任何语言均可，JS有微信专门的JS-SDK。
我使用的是JAVA
关键词说明
OpenID：用户在你这个公众号上的唯一标识（我这边的处理是与项目中用户的UserId进行绑定，这样也就实现了用户在你的平台进行绑定）
access_token ：注意，这里我把这个名字换一下，“ACCESS_TOKEN”为了和之后的分开。这个东西是一个全局量，当你需要调用特定的微信接口时，微信会验证你是否有权限，你就需要传这个值给微信。注意！！获取access_token是有次数限制的，但是access_token 的过期时间很长，所以在没有过期的情况下请勿重复获取。
access_token：这个和我称作小写的access_token和大写的不一样，这个是用户鉴权时使用，获取这个小写的access_token是没有次数限制的，这个东西能只是用于获取用户openId时使用。（新手千万要区分不同的access_token以免出现问题）
开发者填写的URL：接口文档出现这个的时候一开始我也很懵比，这里的URL是指，当用户如果进行特定的操作，如：发送给公众号消息，进入公众号，等等，微信会把一些参数传入这个URL。举个例子，如果用户发送给公众号一个字符。那么公众号会把这个字符转发给你这个URL，然后你这个URL接到微信给你的发的信息，你就可以返回给用户信息了。
这个URL是在这里设置的：
这里的服务器地址URL就是
其中微信有两个信息比较重要，第一微信会告诉你这是用户的什么事件，第二是哪个用户也就是用户的openId
网页授权域名：
在这里必须设置网页的授权域名，否则用户在微信公众号中对于你的域名下的地址将不信任。
开发三步走
这是建立在你已经做好准备的情况下是三步，如果你连公众号服务器域名都没有的话就不只了。
第一步、网页授权域名
下载对应文件，配置在tomcat你的项目的根目录下。
保证：域名/下载的文件名。这个地址能访问到，能在浏览器中显示文字即可。
第二步、获取openId
文档中在：https://mp.weixin.qq.com/wiki/17/c0f37d5704f0b64713d5d2c37b468d75.html
1、生成地址
https://open.weixin.qq.com/connect/oauth2/authorize?（这个是不动的）
appid=xxxxxxxxxx（这个是你的appid）
&redirect_uri=http%3a%2f%2fwww.xxxxxxx.com%xxxxxxxx%2fweixxxxxit%2fxxxxx（这个是你的回调地址，需要URL编码）
&response_type=code（不动）
&scope=snsapi_base（如果只要获取openId就不动，需要别的参考文档）
#wechat_redirect（不动）
最终地址类似：
https://open.weixin.qq.com/connect/oauth2/authorize?appid=xxxxxxxxxx&redirect_uri=http%3a%2f%2fwww.xxxxxxx.com%xxxxxxxx%2fweixxxxxit%2fxxxxx&response_type=code&scope=snsapi_base#wechat_redirect
用户访问这个地址，微信就会回调你的回调地址，你在回调地址中就可以获取到openId了
回调地址中springMVC的写法：
1 /** 2 * 微信获取openId 3 */ 4 @RequestMapping(value="/weiXin", method=RequestMethod.GET) 5 public String weiXin(HttpServletRequest request) 6 { 7 //获取用户openId 8 String openId = ""; 9 10 //用户同意授权，获取返回值code和state 11 String code = request.getParameter("code"); 12 //如果code为空则（请自己实现判断，这里是简写） 13 if(code == null){ 14 return "index"; 15 } 16 17 //获取openid的地址 18 String getOpenidUri = "https://api.weixin.qq.com/sns/oauth2/access_token" 19 + "?appid=" + AppID 20 + "&secret=" + AppSecret 21 + "&code=" + code 22 + "&grant_type=authorization_code"; 23 try{ 24 //发送请求获取返回参数，使用java原生实现，可以使用httpclient或者第三方库实现 25 URL getOpenidUrl = new URL(getOpenidUri); 26 HttpURLConnection openidConnection = (HttpURLConnection) getOpenidUrl.openConnection(); 27 openidConnection.connect(); 28 29 BufferedReader openidReader = new BufferedReader(new InputStreamReader(openidConnection.getInputStream())); 30 StringBuffer openidStringBuffer = new StringBuffer(); 31 String openidLines; 32 while ((openidLines = openidReader.readLine()) != null) { 33 openidStringBuffer.append(openidLines); 34 } 35 openidReader.close(); 36 openidConnection.disconnect(); 37 38 //返回的参数是json格式 39 JSONObject openidJson = JSONObject.parseObject(openidStringBuffer.toString()); 40 if(openidJson.containsKey("openid")){ 41 openId = openidJson.getString("openid"); 42 } 43 }catch(Exception e){ 44 //连接异常，请求异常，或者json返回值异常均需要处理 45 } 46 47 //需要对openId判空，请自行处理 48 System.out.println(openId); 49 return "index"; 50 }
当微信回调你这个地址之后按照上述代码执行后即可获取到openId，上述代码只是参考，实际中需要改进很多判断以及对很多错误情况的预判。你也可以根据接口文档详细书写。
第三步、微信调用接口设计
checkoutURL
之前说过，在设置URL的时候会有一个核对的过程，你需要给出你的接口地址，然后返回一个参数验证过后微信才会同意你修改这个URL
下面是checkout的代码，因为涉及到加密所以需要多多注意
1 import java.security.MessageDigest; 2 import java.security.NoSuchAlgorithmException; 3 //工具类，之后会被调用 4 public class CheckoutUtil { 5 // 与接口配置信息中的Token要一致 6 private static String token = "xxxxxxxxxxx"; 7 8 /** 9 * 验证签名 10 * 11 * @param signature 12 * @param timestamp 13 * @param nonce 14 * @return 15 */ 16 public static boolean checkSignature(String signature, String timestamp, String nonce) { 17 String[] arr = new String[] { token, timestamp, nonce }; 18 // 将token、timestamp、nonce三个参数进行字典序排序 19 // Arrays.sort(arr); 20 sort(arr); 21 StringBuilder content = new StringBuilder(); 22 for (int i = 0; i < arr.length; i++) { 23 content.append(arr[i]); 24 } 25 MessageDigest md = null; 26 String tmpStr = null; 27 28 try { 29 md = MessageDigest.getInstance("SHA-1"); 30 // 将三个参数字符串拼接成一个字符串进行sha1加密 31 byte[] digest = md.digest(content.toString().getBytes()); 32 tmpStr = byteToStr(digest); 33 } catch (NoSuchAlgorithmException e) { 34 e.printStackTrace(); 35 } 36 content = null; 37 // 将sha1加密后的字符串可与signature对比，标识该请求来源于微信 38 return tmpStr != null ? tmpStr.equals(signature.toUpperCase()) : false; 39 } 40 41 /** 42 * 将字节数组转换为十六进制字符串 43 * 44 * @param byteArray 45 * @return 46 */ 47 private static String byteToStr(byte[] byteArray) { 48 String strDigest = ""; 49 for (int i = 0; i < byteArray.length; i++) { 50 strDigest += byteToHexStr(byteArray[i]); 51 } 52 return strDigest; 53 } 54 55 /** 56 * 将字节转换为十六进制字符串 57 * 58 * @param mByte 59 * @return 60 */ 61 private static String byteToHexStr(byte mByte) { 62 char[] Digit = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F' }; 63 char[] tempArr = new char[2]; 64 tempArr[0] = Digit[(mByte >>> 4) & 0X0F]; 65 tempArr[1] = Digit[mByte & 0X0F]; 66 String s = new String(tempArr); 67 return s; 68 } 69 public static void sort(String a[]) { 70 for (int i = 0; i < a.length - 1; i++) { 71 for (int j = i + 1; j < a.length; j++) { 72 if (a[j].compareTo(a[i]) < 0) { 73 String temp = a[i]; 74 a[i] = a[j]; 75 a[j] = temp; 76 } 77 } 78 } 79 } 80 }
1 @RequestMapping(value="/weixinTest") 2 public void weixinTest(HttpServletRequest request) throws Exception{ 3 boolean isGet = request.getMethod().toLowerCase().equals("get"); 4 PrintWriter print; 5 if (isGet) { 6 // 微信加密签名 7 String signature = request.getParameter("signature"); 8 // 时间戳 9 String timestamp = request.getParameter("timestamp"); 10 // 随机数 11 String nonce = request.getParameter("nonce"); 12 // 随机字符串 13 String echostr = request.getParameter("echostr"); 14 // 通过检验signature对请求进行校验，若校验成功则原样返回echostr，表示接入成功，否则接入失败 15 if (signature != null && CheckoutUtil.checkSignature(signature, timestamp, nonce)) { 16 try { 17 print = response.getWriter(); 18 print.write(echostr); 19 print.flush(); 20 } catch (IOException e) { 21 e.printStackTrace(); 22 } 23 } 24 } 25 }
URL：http://www.xxxxxxxx.com/weixinTest/
Token：xxxxxxxxxxxx
类似上面
测试时使用兼容模式，等测试完成后使用安全模式，微信提供了AES的加密解密工具类
https://mp.weixin.qq.com/wiki/1/5dc395cdeb98e9d23a8541cf0bab38ad.html
最后微信调用URL
需要解析XML，也就顺带加个工具类需要使用相应dom4j的jar
import java.io.InputStream; import java.util.HashMap; import java.util.List; import java.util.Map; import javax.servlet.http.HttpServletRequest; import org.dom4j.Document; import org.dom4j.Element; import org.dom4j.io.SAXReader; public class MessageUtil { public static Map parseXml(HttpServletRequest request) throws Exception { // 将解析结果存储在HashMap中 Map map = new HashMap(); // 从request中取得输入流 InputStream inputStream = request.getInputStream(); // 读取输入流 SAXReader reader = new SAXReader(); Document document = reader.read(inputStream); // 得到xml根元素 Element root = document.getRootElement(); // 得到根元素的所有子节点 List<Element> elementList = root.elements(); // 遍历所有子节点 for (Element e : elementList) map.put(e.getName(), e.getText()); // 释放资源 inputStream.close(); inputStream = null; return map; } }
这边以获取地理位置为例（需要在微信后台手动开启这个功能哦）
1 @RequestMapping(value="/weixinTest") 2 public void weixinTest(HttpServletRequest request) throws Exception{ 3 // 调用parseXml方法解析请求消息 4 Map<String, String> requestMap = MessageUtil.parseXml(request); 5 // 发送方帐号 6 String fromUserName = requestMap.get("FromUserName"); 7 log.error("----------------------------------------------" + fromUserName); 8 // 开发者微信号 9 String toUserName = requestMap.get("ToUserName"); 10 // 消息类型 11 String msgType = requestMap.get("MsgType"); 12 13 if ("event".equals(msgType)){ 14 log.error("----------------------------------------------" +msgType); 15 String Latitude = requestMap.get("Latitude"); 16 log.error("----------------------------------------------" +Latitude); 17 String Longitude = requestMap.get("Longitude"); 18 log.error("----------------------------------------------" +Longitude); 19 20 } 21 }
需要注意的点
1、看清接口文档，仔细理解
2、checkout不要删除，修改地址时需要使用，当地址稳定后项目上线之后直接删除。
3、微信调用URL会被用户平凡访问，向我这样写肯定是不对的，如果你的用户量大负载均衡肯定是必须的。
4、微信接口虽然稳定，但是还是要注意处理意外请求，处理一些可能会出现的错误情况。否则当出现没有这个参数而你去取，很容易导致异常。
5、所有测试均需要在服务器上完成，也就需要外网可以被访问的域名和地址。
6、微信给的权限很多，需要自己看清楚，有的权限是有次数限制的。
7、尽可能把一些参数封装一下，避免代码冗长。
8、所有测试完成后请换成密文形式，不然用户的信息可能泄露。
9、以上所有代码仅供参考，实际中还需要添砖加瓦，大改特改。
10、服务器上调试日志很重要。