微信公众号开发教程(一) 验证接入
作者：陈惠，叩丁狼教育高级讲师。原创文章，转载请注明出处。
微信公众号开发教程(一)验证接入
本篇文章主要介绍了微信公众号开发接入详细流程，希望对刚接触公众号开发的同学有所帮助，有兴趣的同学可多多关注叩丁狼公众号，后续会更新不同的公众号小案例。
公众号的分类
我们平常在微信应用上会看到有很多的公众号，但是各自并不一样，公众号也分很多种类型，不过最常见的就是服务号和订阅号了。下面我们来看一下他们的区别：
1、订阅号
为媒体和个人提供一种信息传播方式，主要偏于为用户传达资讯（类似报纸杂志），主要的定位是阅读，每天可以群发1条消息；
2、服务号
为企业，政府或组织提供对用户进行服务，主要偏于服务交互（类似银行提供服务查询），每个月只可群发4条消息；
3、企业微信(企业号)
为企业，政府，事业单位，实现生产管理和协作运营的移动化，主要用于公司内部通讯使用，旨在为用户提供移动办公，需要先有成员的通讯信息验证才可以关注成功企业微信；
通过以下图片我们可以更清晰的看出不同公众号的区别：
还有一个比较明显的区别就是，订阅号都是存放在一个名叫订阅号的文件夹中，点开才能看到所有关注过的订阅号，但是服务号却和好友一样直接就显示在聊天列表中。这个大家打开微信客户端便能看到。
如果大家有需要申请公众号的，要根据实际需求考虑清楚应该申请哪一种公众号
以下是官方给出的建议，大家可以多参考参考
1）如果想简单的发送消息，达到宣传效果，建议可选择订阅号；
2）如果想用公众号获得更多的功能，例如开通微信支付，建议可以选择服务号；
3）如果想用来管理内部企业员工、团队，对内使用，可申请企业号；
4）订阅号可通过微信认证资质审核通过后有一次升级为服务号的入口，升级成功后类型不可再变；
5）服务号不可变更成订阅号。
4.测试号(用于开发测试及功能体验)
这种是平常普通用户是涉及不到的，是专门为开发人员准备的一种仅用于测试的公众号。
由于用户体验和安全性方面的考虑，微信公众号的注册有一定门槛，某些高级接口的权限需要微信认证后才可以获取。所以，为了帮助开发者快速了解和上手微信公众号开发，熟悉各个接口的调用，微信推出了公众帐号测试号，无需公众帐号、快速申请接口测试号，通过手机微信扫描二维码即可获得，利用测试号我们可以体验和测试更多高级功能。
申请地址：
http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login
但测试号也不是万能的，部分高级功能，如微信支付,卡券功能等也是不开放的。
如果要实现支付功能还是得去注册个正式的公众号。
微信公众平台：
我们注册的公众号都可以在这个平台上进行管理，比如想弄一些自定义菜单，或者自动回复，或者平常推送的文章，都可以在这上面操作。
平台地址:
http://mp.weixin.qq.com
平台中分为两种管理模式：
平台提供了两种管理模式给我们，应该根据我们的需求来选择使用不同的模式。
下面我们来了解一下，两种模式的区别：
编辑模式
主要针对非编程人员及信息发布类公众帐号使用。
开启该模式后，可以方便地通过界面配置“自定义菜单”和“自动回复的消息”。
好处是可视化界面配置，操作简单，快捷，但是功能有限。
开发模式
主要针对具备开发能力的人使用。
开启该模式后，能够使用微信公众平台开放的接口，但是编辑模式的设置会失效，比如“自定义菜单”和“自动回复的消息”功能。通过编程方式可以实现更多复杂的功能，提供个性化服务。
总的来说，编辑模式就是为所有人提供的，如果你的需求仅仅只是最常见的菜单，自动回复等，使用编辑模式已经满足，但是如果你需求的功能比较复杂，有很多很多的想法，就需要使用到开发模式。
下面我们来学习一下，怎么使用这个开发模式。
开发模式配置流程
1.登录测试号页面，可以看到该测试号相关的信息
就是使用电脑打开http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login
使用微信扫一扫二维码，即可在打开的页面中看见微信给你分配的测试号的相关信息。
下面两个属性是唯一的标识，每个测试号都会有自己的appid与appsecret ，是比较重要的信息，不要随意发给别人。
appid：是公众号开发识别码，配合开发者密码可调用公众号的接口能力。
appsecret：是校验公众号开发者身份的密码，具有极高的安全性。
如果是正式的公众号，登录公众平台官网之后，找到“基本配置”菜单栏也可以获取上公众号相关的信息。
2.配置参数介绍
再往下看，我们会看到URL和Token这两个属性，和上面appid/appsecret不同的是，上面的是微信分配给我们的，但是下面这两个是需要我们填进去的。
我们先来了解一下，这两个属性有什么作用。
URL：就是指我们自己的服务器地址
该URL是开发者用来接收和响应微信消息和事件的接口URL
(必须以http://或https://开头，分别支持80端口和443端口)
Token：可任意填写，用作生成签名（必须为英文或数字，长度为3-32字符）
该签名在后边会用到，这里暂时随便填个内容也可以
接下来我们需要了解的是微信与我们的服务器交互的过程：
当我们在微信app上，给公众号发送一条内容的时候，实际会发送到微信的服务器上，此时微信的服务器就会对内容进行封装成某种格式的数据比如xml格式，再转发到我们配置好的URL上，所以该URL实际就是我们处理数据的一个请求路径。所以该URL必须是能暴露给外界访问的一个公网地址，不能使用内网地址，生产环境可以申请腾讯云，阿里云服务器等，但是在开发环境中可以暂时利用一些软件来完成内网穿透，便于修改和测试，如NATAPP，花生壳等软件，使用起来也很方便，在本地安装对应的软件，配置运行后，直接使用软件分配的临时域名来访问本地应用即可，只是偶尔会存在网络不稳定的情况。这里不详细介绍如何使用了，具体教程可参考软件官网。
在开发的过程中，我们会经常使用到微信公众号提供给开发者的开发文档
具体地址：https://mp.weixin.qq.com/wiki
大家打开后可以选择”接入指南”，参考微信提供的一些帮助信息。
3.搭建本地应用(java/python/php等语言均可)
基本概念都了解过后，我们马上就要开始开发了，因此需要先提供好一个应用，接下来就可以在该应用上添加公众号相关的功能了。
本文项目使用java语言，SpringMVC+Spring+MyBatis框架
4.URL接入验证
我们需要先来了解一下接入的过程是怎么样的。下图是微信官方对接入过程的介绍。
由以上介绍可知，当我们填入url与token的值，并提交后，微信会发送一个get请求到我们填写的url上，并且携带4个参数，而signature参数结合了开发者填写的token参数和请求中的timestamp参数、nonce参数来做的加密签名，我们在后台需要对该签名进行校验，看是否合法。实际上，我们发现微信带过来的4个参数中并没有带token参数，仅有signature是和token有关的，所以我们应该在本地应用中也准备一个和填入的token相同的参数，再通过微信传入的timestamp与nonce做相同算法的加密操作，若结果与微信传入的signature相同，即为合法，则原样返回echostr参数，代表接入成功，否则不做处理，则接入失败。
详细流程可参考微信官方提供的逻辑流程图，我们的应用需要以该流程图的步骤来实现。
代码示例：
@Controller
public class WeChatController {
/**
* 微信URL接入验证
* @param signature
* @param timestamp
* @param nonce
* @param echostr
* @return
*/
@RequestMapping(value="/weChat",method= RequestMethod.GET)
@ResponseBody
public String validate(String signature,String timestamp,String nonce,String echostr){
//1. 将token、timestamp、nonce三个参数进行字典序排序
String[] arr = {timestamp,nonce,WeChatUtil.TOKEN};
Arrays.sort(arr);
//2. 将三个参数字符串拼接成一个字符串进行sha1加密
StringBuilder sb = new StringBuilder();
for (String temp : arr) {
sb.append(temp);
}
//3. 开发者获得加密后的字符串可与signature对比，标识该请求来源于微信
if(SecurityUtil.SHA1(sb.toString()).equals(signature)){
//接入成功
return echostr;
}
//接入失败
return null;
}
}
备注：
- 代码中WeChatUtil.TOKEN是一个常量，常量值必须要和我们在页面上填入的token值相同，通常可以抽取到配置文件中来注入值比较灵活。
2.SecurityUtil是一个工具类，提供了sha1加密的方法。
接入成功后即可根据开发文档实现一些小案例了。文章暂时使用的是测试号来做开发，后续有些高级功能权限不够可能会改成正式公众号来进行开发。
