微信公众号开发（一）前期 配置
微信公众号开发步骤：
一：有一个公众号，可以是测试公众号，也可以是客户提供的已经申请好的公众号
申请测试公众号的网址：http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login
申请步骤比较简单，这里就不多阐述了。
我开发的主要是客户提供的公众号，一些特殊权限（支付）已经得到开通，可以直接使用，关于测试公众号的某些特殊权限，本人并没有经验。
二：登录到微信公众平台进行开发配置，在登录时可能需要管理员授权，这个就自己联系你们的客户，管理员授权，你才能登录。
登录网址：https://mp.weixin.qq.com/（微信公众平台--官网）
管路员授权之后，我们就可以开始配置了，首先是“基本配置”
首先，来到开发-->基本配置，这里我在初次开发的时候，不知道这里的url应该怎样填写，经过测试，这里的路径主要是一个外界能访问的路径。我的后台开发框架是springMVC，用户访问主要是通过controller，于是我新建了一个项目叫做WXTest,配置好springMVC之后写了一个controller,里面有一个方法叫Test,它的value值是"test"，至于如何配置springMVC的项目，这里就不阐述了，如果有需要，我会单独写一篇文章阐述如何搭建一个简单的springNVC的框架。
好了，配置好controller之后，我们可以通过本地访问：http://127.0.0.1:8080/WXTest/test 这样就可以访问到了，但是如何能让微信服务器访问我的controller,如果没有公网，可以通过花生壳的内网映射，如果有公网，可以直接通过公网的ip（开通了80端口的）访问，这里使用的是花生壳，壳域名就是http://uranusyiju.6655.la,通过花生的内网映射，我可以将其映射到我的8080端口，于是http://uranusyiju.6655.la就相当于我的http://127.0.0.1:8080，所以我这里的url配置就填写http://uranusyiju.6655.la/WXTest(项目名)/test（controller的方法路径），配置好url之后，至于token，主要是用于url的验证，你配置了之后，微信访问你的controller的时候会将这个数据发送于你的后台，你根据token判断是否是微信服务器在访问你，然后返回相应的数据，下面会提到，所以这里的token就是一个双方请求的标识而已，不必过于复杂。填写完token之后，下面的EncodingAESKey可以随机生成，然后确认没问题，点击提交，这里就会开始验证了，所以前期需要将你的框架搭建好，确保路径可以正确访问，以及返回正确的交互数据（如果你controller里的方法写得不对，则无法验证通过验证（下面会提到如何写controller的方法），验证通过了，最后，也是最重要的一个地方，请在外面选择“启用”。
***下面是controller的代码：
@Controller
public class WeixinController{
@Resource
UserSubscribeService userSubscribeService;
@Resource
UserUnSubscribeService userUnSubscribeService;
@Resource
UserScanQrCodeService userScanQrCodeService;
// 唯藌的url、token接口设置(来自微信服务器的消息)
@RequestMapping("/test" )
@ResponseBody
public void weixinUrlSet(HttpServletRequest request,
HttpServletResponse response) throws IOException {
System. out.println("进入test,微信的访问会有2种方式post以及get,get只是做url验证。 " );
boolean isGet = request .getMethod().toLowerCase().equals("get");
if (isGet ) {
System. out.println("request:" + request .toString());
//get方法，一般用于微信服务器与本机服务器开发的基本配置（就是token验证，确定服务器是你的）
String str = access( request, response);
response.getWriter().write( str);
} else {
//post方法，一般是用户的事件处理（例如：关注/取消关注、点击按钮、发送消息....）
System. out.println("enter post" );
try {
// 接收消息并返回消息
String str = acceptMessage( request, response);
response.getWriter().write( str);
} catch (IOException e ) {
e.printStackTrace();
}
}
}
/**
* 验证URL真实性
*
* @author morning
* @date 2015年2月17日 上午10:53:07
* @param request
* @param response
* @return String
* @throws NoSuchAlgorithmException
* @throws UnsupportedEncodingException
*/
private String access(HttpServletRequest request ,
HttpServletResponse response) {
// 验证URL真实性
System. out.println("进入验证access" );
String signature = request .getParameter("signature"); // 微信加密签名
String timestamp = request .getParameter("timestamp"); // 时间戳
String nonce = request.getParameter( "nonce");// 随机数
String echostr = request.getParameter( "echostr");// 随机字符串
List<String> params = new ArrayList<String>();
//WeixinStaticData. TOKEN就是配置时的token
params.add(WeixinStaticData. TOKEN);
params.add( timestamp);
params.add( nonce);
// 1. 将token、timestamp、nonce三个参数进行字典序排序
Collections. sort(params, new Comparator<String>() {
@Override
public int compare(String o1, String o2) {
return o1 .compareTo(o2);
}
});
// 2. 将三个参数字符串拼接成一个字符串进行sha1加密
String str = params.get(0) + params.get(1) + params.get(2);
MessageDigest crypt;
try {
crypt = MessageDigest. getInstance("SHA-1");
crypt.reset();
try {
crypt.update( str.getBytes( "UTF-8"));
String temp = WeixinTool. batySHA1(crypt.digest());
if (temp .equals(signature )) {
System. out.println("成功返回 echostr：" + echostr);
return echostr ;
} else {
System. out.println("失败 认证" );
}
} catch (UnsupportedEncodingException e1 ) {
// TODO Auto-generated catch block
e1.printStackTrace();
}
} catch (NoSuchAlgorithmException e1 ) {
// TODO Auto-generated catch block
e1.printStackTrace();
}
return null ;
}
private String acceptMessage(HttpServletRequest request,
HttpServletResponse response) throws IOException {
Map<String, String> reqMap = MessageUtil. parseXml(request);
System. out.println("reqMap:" +reqMap .toString());
String fromUserName = reqMap .get("FromUserName" );
String toUserName = reqMap .get("ToUserName" );
String msgType = reqMap.get( "MsgType");
BaseMsg msg = null;// 要发送的消息
// 事件推送
if (msgType .equals(ReqType.EVENT)) {
// 事件类型
String eventType = reqMap .get("Event" );
// 二维码事件
String ticket = reqMap.get( "Ticket");
if (ticket != null) {
String eventKey = reqMap.get( "EventKey");
QrCodeEvent event = new QrCodeEvent(eventKey , ticket);
buildBasicEvent( reqMap, event);
msg = handleQrCodeEvent( event);
}
// 关注
if (eventType .equals(EventType.SUBSCRIBE)) {
//根据reqMap 可以判断用户是否扫带有有参数的二维码
BaseEvent event = new BaseEvent();
buildBasicEvent( reqMap, event);
msg = handleSubscribe( event, reqMap);
}
// 取消关注
else if (eventType .equals(EventType.UNSUBSCRIBE)) {
BaseEvent event = new BaseEvent();
buildBasicEvent( reqMap, event);
msg = handleUnsubscribe( event);
}
// 点击菜单拉取消息时的事件推送
else if (eventType .equals(EventType.CLICK)) {
System. out.println("点击菜单拉取消息时的事件推送" );
String eventKey = reqMap.get( "EventKey");
MenuEvent event = new MenuEvent(eventKey );
buildBasicEvent( reqMap, event);
msg = handleMenuClickEvent( event);
}
// 点击菜单跳转链接时的事件推送
else if (eventType .equals(EventType.VIEW)) {
System. out.println("点击菜单跳转链接时的事件推送" );
String eventKey = reqMap.get( "EventKey");
MenuEvent event = new MenuEvent(eventKey );
System. out.println("event：" +event .toXml().toString());
buildBasicEvent( reqMap, event);
msg = handleMenuViewEvent( event);
}
// 上报地理位置事件
else if (eventType .equals(EventType.LOCATION)) {
double latitude = Double.parseDouble(reqMap.get("Latitude"));
double longitude = Double.parseDouble(reqMap.get("Longitude"));
double precision = Double.parseDouble(reqMap.get("Precision"));
LocationEvent event = new LocationEvent(latitude , longitude,
precision);
buildBasicEvent( reqMap, event);
msg = handleLocationEvent( event);
}
} else {// 接受普通消息
// 文本消息
if (msgType .equals(ReqType.TEXT)) {
String content = reqMap.get( "Content");
TextReqMsg textReqMsg = new TextReqMsg(content);
buildBasicReqMsg( reqMap, textReqMsg);
msg = handleTextMsg( textReqMsg);
}
// 图片消息
else if (msgType .equals(ReqType.IMAGE)) {
String picUrl = reqMap.get( "PicUrl");
String mediaId = reqMap.get( "MediaId");
ImageReqMsg imageReqMsg = new ImageReqMsg(picUrl, mediaId);
buildBasicReqMsg( reqMap, imageReqMsg);
msg = handleImageMsg( imageReqMsg);
}
// 音频消息
else if (msgType .equals(ReqType.VOICE)) {
String format = reqMap.get( "Format");
String mediaId = reqMap.get( "MediaId");
String recognition = reqMap .get("Recognition" );
VoiceReqMsg voiceReqMsg = new VoiceReqMsg(mediaId, format,
recognition);
buildBasicReqMsg( reqMap, voiceReqMsg);
msg = handleVoiceMsg( voiceReqMsg);
}
// 视频消息
else if (msgType .equals(ReqType.VIDEO)) {
String thumbMediaId = reqMap .get("ThumbMediaId" );
String mediaId = reqMap.get( "MediaId");
VideoReqMsg videoReqMsg = new VideoReqMsg(mediaId, thumbMediaId);
buildBasicReqMsg( reqMap, videoReqMsg);
msg = handleVideoMsg( videoReqMsg);
}
// 地理位置消息
else if (msgType .equals(ReqType.LOCATION)) {
double locationX = Double.parseDouble(reqMap.get("Location_X"));
double locationY = Double.parseDouble(reqMap.get("Location_Y"));
int scale = Integer.parseInt (reqMap .get("Scale" ));
String label = reqMap.get( "Label");
LocationReqMsg locationReqMsg = new LocationReqMsg(locationX,
locationY, scale , label );
buildBasicReqMsg( reqMap, locationReqMsg);
msg = handleLocationMsg( locationReqMsg);
}
// 链接消息
else if (msgType .equals(ReqType.LINK)) {
String title = reqMap.get( "Title");
String description = reqMap .get("Description" );
String url = reqMap.get( "Url");
LinkReqMsg linkReqMsg = new LinkReqMsg(title, description, url );
buildBasicReqMsg( reqMap, linkReqMsg);
msg = handleLinkMsg( linkReqMsg);
}
}
if (msg == null) {
// 回复空串是微信的规定，代表不回复
return "" ;
}
msg.setFromUserName( toUserName);
msg.setToUserName( fromUserName);
return msg .toXml();
}
/*******************************************下面为处理每个请求的具体逻辑入口*******************************/
/**
* 处理文本消息
*/
protected BaseMsg handleTextMsg(TextReqMsg msg ) {
return handleDefaultMsg(msg );
}
/**
* 处理图片消息
*/
protected BaseMsg handleImageMsg(ImageReqMsg msg ) {
return handleDefaultMsg(msg );
}
/**
* 处理语音消息
*/
protected BaseMsg handleVoiceMsg(VoiceReqMsg msg ) {
return handleDefaultMsg(msg );
}
/**
* 处理视频消息
*/
protected BaseMsg handleVideoMsg(VideoReqMsg msg ) {
return handleDefaultMsg(msg );
}
/**
* 处理地理位置消息
*/
protected BaseMsg handleLocationMsg(LocationReqMsg msg) {
return handleDefaultMsg(msg );
}
/**
* 处理链接消息
*/
protected BaseMsg handleLinkMsg(LinkReqMsg msg ) {
return handleDefaultMsg(msg );
}
/**
* 处理扫描带参数二维码事件
*/
protected BaseMsg handleQrCodeEvent(QrCodeEvent event ) {
System. out.println("处理扫描带参数二维码事件" );
System. out.println("event:" +event .toXml());
userScanQrCodeService.handleScanQrCode();
return handleDefaultEvent(event );
}
/**
* 处理上报地理位置事件
*/
protected BaseMsg handleLocationEvent(LocationEvent event) {
return handleDefaultEvent(event );
}
/**
* 处理点击菜单拉取消息时的事件推送
*/
protected BaseMsg handleMenuClickEvent(MenuEvent event) {
return handleDefaultEvent(event );
}
/**
* 处理点击菜单跳转链接时的事件推送
*/
protected BaseMsg handleMenuViewEvent(MenuEvent event ) {
return handleDefaultEvent(event );
}
/**
* 处理关注事件
* 默认不回复
*/
protected BaseMsg handleSubscribe(BaseEvent event , Map<String,String> reMap) {
System. out.println("用户关注======" );
userSubscribeService.handleSubscribeService(event ,reMap );
String msg = userSubscribeService.displayAutoReturn();
return new TextMsg(msg);
}
/**
* 处理取消订阅事件 <br>
* 默认不回复
*/
protected BaseMsg handleUnsubscribe(BaseEvent event ) {
System. out.println("用户取消关注======" );
userUnSubscribeService.handleUnSubscribe(event );
return null ;
}
/**
* 处理消息的默认方式 <br>
* 如果不重写该方法，则默认不返回任何消息
*/
protected BaseMsg handleDefaultMsg(BaseReqMsg msg ) {
return null ;
}
/**
* 设置处理事件的默认方式 <br>
* 如果不重写该方法，则默认不返回任何消息
*/
protected BaseMsg handleDefaultEvent(BaseEvent event ) {
return null ;
}
/**
* 为事件普通消息对象添加基本参数 <br>
* 参数包括：MsgId、MsgType、FromUserName、ToUserName和CreateTime
*/
private void buildBasicReqMsg(Map<String, String> reqMap, BaseReqMsg reqMsg) {
addBasicReqParams( reqMap, reqMsg);
reqMsg.setMsgId( reqMap.get( "MsgId"));
}
/**
* 为事件推送对象添加基本参数 <br>
* 参数包括：Event、MsgType、FromUserName、ToUserName和CreateTime
*/
private void buildBasicEvent(Map<String, String> reqMap, BaseEvent event) {
addBasicReqParams( reqMap, event);
event.setEvent( reqMap.get( "Event"));
}
/**
* 为请求对象添加基本参数，包括MsgType、FromUserName、ToUserName和CreateTime <br>
* 请求对象包括普通消息和事件推送
*/
private void addBasicReqParams(Map<String, String> reqMap, BaseReq req) {
req.setMsgType( reqMap.get( "MsgType"));
req.setFromUserName( reqMap.get( "FromUserName"));
req.setToUserName( reqMap.get( "ToUserName"));
req.setCreateTime(Long. parseLong(reqMap.get("CreateTime")));
}
}
上面的代码很多，其实浏览一下能知道大概意思就可以了。
ok,现在配置以及初步处理微信请求都已经准备好了，还有很多其他配置，在需要的时候会提到，下面就开始进入正式的开发了.....
