微信公众号开发（二）—— 微信公众平台接入

　　在上一篇《微信公众号开发（一）——环境搭建》中我们已经准备好了微信公众号开发环境，那么接下来我们要真正的开始进行公众号的实际开发之旅。

在真正的开发公众号之前我们必须要接入微信公众平台，那为什么要接入、如何接入本文就这些问题一一解答；

首先我们来了解一下接入平台的原理，然后再贴出代码上手实践测试。

一、微信公众平台的基本原理

微信服务器就相当于一个转发服务器，终端（手机、Pad等）发起请求至微信服务器，微信服务器然后将请求转发给我们的应用服务器。应用服务器处理完毕后，将响应数据回发给微信服务器，微信服务器再将具体响应信息回复到微信App终端。

　　通信协议为：HTTP

　　数据传输格式为：XML

　　具体的流程如下图所示：

　　来一张更加直观的图吧:

　　我们需要做的事情，就是对微信服务器转发的HTTP请求做出响应。具体的请求内容，我们按照特定的XML格式去解析，处理完毕后，也要按照特定的XML格式返回。

二、微信公众平台接入步骤

在微信公众平台开发者文档上，关于公众号接入这一节内容在接入指南上写的比较详细的，文档中说接入公众号需要3个步骤，分别是：

　　1、填写服务器配置
　　2、验证服务器地址的有效性
　　3、依据接口文档实现业务逻辑

　　其实，第3步已经不能算做公众号接入的步骤，而是接入之后，开发人员可以根据微信公众号提供的接口所能做的一些开发。

　　第1步中服务器配置包含服务器地址（URL）、Token和EncodingAESKey。

　　服务器地址即公众号后台提供业务逻辑的入口地址，目前只支持80端口，之后包括接入验证以及任何其它的操作的请求（例如消息的发送、菜单管理、素材管理等）都要从这个地址进入。接入验证和其它请求的区别就是，接入验证时是get请求，其它时候是post请求；

　　Token可由开发者可以任意填写，用作生成签名（该Token会和接口URL中包含的Token进行比对，从而验证安全性）；

　　EncodingAESKey由开发者手动填写或随机生成，将用作消息体加解密密钥。本例中全部以未加密的明文消息方式，不涉及此配置项。

以测试账号为例：

　　第1步配置我们的服务器参数

我们点击修改按钮输入url和token点击提交；

第2步，验证服务器地址的有效性，当点击“提交”按钮后，微信服务器将发送一个http的get请求到刚刚填写的服务器地址，并且携带四个参数：

　　接到请求后，我们需要做如下三步，若确认此次GET请求来自微信服务器，原样返回echostr参数内容，则接入生效，否则接入失败。

　　1. 将token、timestamp、nonce三个参数进行字典序排序
　　2. 将三个参数字符串拼接成一个字符串进行sha1加密
　　3. 开发者获得加密后的字符串可与signature对比，标识该请求来源于微信

第3步依据接口文档实现业务逻辑　

　　验证URL有效性成功后即接入生效，成为开发者。你可以在公众平台网站中申请微信认证，认证成功后，将获得更多接口权限，满足更多业务需求。
　　成为开发者后，用户每次向公众号发送消息、或者产生自定义菜单、或产生微信支付订单等情况时，开发者填写的服务器配置URL将得到微信服务器推送过来的消息和事件，开

　　发者可以依据自身业务逻辑进行响应，如回复消息。

　　公众号调用各接口时，一般会获得正确的结果，具体结果可见对应接口的说明。返回错误时，可根据返回码来查询错误原因。全局返回码说明
　　用户向公众号发送消息时，公众号方收到的消息发送者是一个OpenID，是使用用户微信号加密后的结果，每个用户对每个公众号有一个唯一的OpenID

三、代码示例

　　1、首先我们要创建一个java web 工程

　　2、创建一个controller 来进行服务器的验证

package com.quanlian.controller;

import java.io.UnsupportedEncodingException;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.Arrays;
import java.util.Map;

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

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;

import util.NetWorkHelper;

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import com.quanlian.entity.AccessToken;
import com.quanlian.entity.AccessTokenInfo;
import com.quanlian.runner.MyApplicationRunner;


@RestController
public class WxController {
    
    private final String TOKEN = "super";
    @RequestMapping(value="/hello")
    public String hello(){
        return "hello";
    }
    
    @RequestMapping(value = "wx")
    public String wxcheck(HttpServletRequest request,HttpServletResponse response) throws UnsupportedEncodingException {
        String method = request.getMethod();
        System.out.println(method);
        if(method.equals("POST")){
            return wxMessage(request,response);
        }else{
            String signature = request.getParameter("signature");  
            String timestamp = request.getParameter("timestamp");  
            String nonce = request.getParameter("nonce");  
            String echostr = request.getParameter("echostr");  
            System.out.println(echostr);
            //排序
            String sortString = sort(TOKEN, timestamp, nonce);
            //加密
            String mySignature = sha1(sortString);
            if(signature!=null&&signature!=""&&signature.equals(mySignature)){
                System.out.println("签名校验通过。");
                return echostr;
            }else{
                System.out.println("签名校验失败.");
                return "xxxx";
            }
        }

    }
    
    @RequestMapping(value="wxMessage",method=RequestMethod.POST)
    public String wxMessage(HttpServletRequest request,HttpServletResponse response) throws UnsupportedEncodingException{
        request.setCharacterEncoding("UTF-8");
        response.setCharacterEncoding("UTF-8");
        System.out.println("请求进入");
        String result = "";
        try {
            Map<String,String> map = MessageHandlerUtil.parseXml(request);
            System.out.println("开始构造消息");
            result = MessageHandlerUtil.buildXml(map);
            System.out.println(result);
            if(result.equals("")){
                result = "未正确响应";
            }
        } catch (Exception e) {
            e.printStackTrace();
            System.out.println("发生异常："+ e.getMessage());
        }
        return result;
    }
    
    /**
     * 排序
     */
    public String sort(String token, String timestamp, String nonce){
        String[] strArray = {token,timestamp,nonce};
        Arrays.sort(strArray);
        StringBuilder sb = new StringBuilder();
        for(String str : strArray){
            sb.append(str);
        }
        return sb.toString();
    }
    /**
     * 进行sha1加密
     */
    public String sha1(String str){
        try {
            MessageDigest digest = MessageDigest.getInstance("SHA-1");
            digest.update(str.getBytes());
            byte messageDigest[] = digest.digest();
            // Create Hex String
            StringBuffer hexString = new StringBuffer();
            // 字节数组转换为 十六进制 数
            for (int i = 0; i < messageDigest.length; i++) {
                String shaHex = Integer.toHexString(messageDigest[i] & 0xFF);
                if (shaHex.length() < 2) {
                    hexString.append(0);
                }
                hexString.append(shaHex);
            }
            return hexString.toString();

        } catch (NoSuchAlgorithmException e) {
            e.printStackTrace();
        }
        return "";
        
    }
    
}