[置顶] 微信开放平台的第三方平台、全网发布流程、组件API、返回普通文本消息

        微信开放平台的第三方平台全网发布流程

1、在这里先吐槽一下微信的开放平台的全网发布流程文档。说实话：这个文档写的是真的不咋地！

 (1)、公众号消息校验Token、公众号消息加解密Key、公众号消息与事件接收URL、网页开发域名.
这些信息都需要在微信开放平台设置

 
   (2) 、 加密、解密的 代码在微信开放平台文档里面都有，自己下载即可.

2、啥也不说了，直接上代码:

 

import java.io.BufferedReader;
import java.io.IOException;

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

import net.rubyeye.xmemcached.MemcachedClient;
import net.sf.json.JSONObject;

import org.apache.commons.lang.StringUtils;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.codehaus.jackson.JsonEncoding;
import org.codehaus.jackson.map.ObjectMapper;
import org.dom4j.Document;
import org.dom4j.DocumentException;
import org.dom4j.DocumentHelper;
import org.dom4j.Element;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.ResponseBody;

import com.weixin.core.aes.AesException;
import com.weixin.core.aes.WXBizMsgCrypt;
import com.weixin.scm.auth.model.PlatformParam;
import com.weixin.scm.auth.service.PlatformParamService;
import com.weixin.support.api.ProxyInterfaceApi;
import com.weixin.support.model.component.AuthorizationInfo;
import com.weixin.support.model.component.MpAuthorization;
import com.weixin.support.service.WxConfigStorageService;
import com.weixin.util.HttpClientCommonSSL;

/**
* <p>ClassName: 测试微信 全网检测 </p>
* <p>Description: 检测通过后 才能进行全网发布 </p>
* @author Andy  2015年8月31日
*/
@Controller
@RequestMapping(value = "/weixinOpenCheck")
public class WeixinOpenCheckController {

private static final Log log = LogFactory.getLog(WeixinOpenCheckController.class);

@Autowired
private WxConfigStorageService wxConfigStorageService;

@Autowired
private PlatformParamService platformParamService;

@Autowired
private MemcachedClient memcachedClient;

@ResponseBody
@RequestMapping(value = "{appid}/callback", method = RequestMethod.POST)
public void acceptMessageAndEvent(HttpServletRequest request, HttpServletResponse response
,@PathVariable(value = "appid") String appId)//springMVC 获取地址里面的参数信息
throws IOException, AesException, DocumentException {

log.info("进入全网发布流程=================================================================================");
String nonce = request.getParameter("nonce");
String timestamp = request.getParameter("timestamp");
String msgSignature = request.getParameter("msg_signature");

log.info("读取数据为："+"msg_signature="+msgSignature+",  timestamp="+timestamp+",  nonce="+nonce+",  appid="+appId);

if (!StringUtils.isNotBlank(msgSignature))
return;// 微信推送给第三方开放平台的消息一定是加过密的，无消息加密无法解密消息

StringBuilder sb = new StringBuilder();
BufferedReader in = request.getReader();
String line;
while ((line = in.readLine()) != null) {
sb.append(line);
}
in.close();
String xml = sb.toString(); //将xml变成字符串

log.info("读取的XML为："+xml);

if (appId.equals("wx570bc396a51b8ff8")){// 微信自动化测试的专用测试公众账号

PlatformParam component = platformParamService.selectPlatformParam();//获取 平台ID

WXBizMsgCrypt pc = new WXBizMsgCrypt(component.getToken(),component.getSymmetricKey(),
component.getComponentAppId());
log.info("加解密======================================");
try {
xml = pc.decryptMsg(msgSignature, timestamp, nonce, xml);//将xml进行加密后，和sign签名码进行对比，如果正确则返回xml
log.info("解密后:"+xml);
Document doc = DocumentHelper.parseText(xml);
Element rootElt = doc.getRootElement();
String msgType = rootElt.elementText("MsgType");
String toUserName = rootElt.elementText("ToUserName");
String fromUserName = rootElt.elementText("FromUserName");

if(msgType.equals("event")){// 返回类型值，做一下区分
String event = rootElt.elementText("Event");
//返回时， 将发送人和接收人 调换一下即可
replyEventMessage(request,response,event,fromUserName,toUserName);
}

if(msgType.equals("text")){ //标示文本消息，
String content = rootElt.elementText("Content");
//返回时， 将发送人和接收人 调换一下即可
processTextMessage(request,response,content,fromUserName,toUserName);//用文本消息去拼接字符串。微信规定
}
} catch (AesException e) {
log.error("错误码为: "+e.getCode());
log.error("错误信息为: "+e.getMessage());
//应该做容错处理
}
}else{
log.info("appid="+appId+",正确的值为：wx570bc396a51b8ff8");
log.info("检测不是微信开放平台测试账号,发布程序终止.");
}

}

/**
* 方法描述: 类型为enevt的时候，拼接
* @param request
* @param response
* @param event
* @param toUserName  发送接收人
* @param fromUserName  发送人
* @author Andy 2015年9月1日  下午2:16:26
*/
public void replyEventMessage(HttpServletRequest request, HttpServletResponse response,
String event, String toUserName, String fromUserName)
throws DocumentException, IOException {
String content = event + "from_callback";
replyTextMessage(request,response,content,toUserName,fromUserName);
}

/**
* 方法描述: 立马回应文本消息并最终触达粉丝
* @param content  文本
* @param toUserName  发送接收人
* @param fromUserName  发送人
* @author Andy 2015年8月31日  下午6:24:38
*/
public void processTextMessage(HttpServletRequest request, HttpServletResponse response,
String content,String toUserName, String fromUserName)
throws IOException, DocumentException{
if("TESTCOMPONENT_MSG_TYPE_TEXT".equals(content)){
String returnContent = content+"_callback";
replyTextMessage(request,response,returnContent,toUserName,fromUserName);
}else if(StringUtils.startsWithIgnoreCase(content, "QUERY_AUTH_CODE")){
response.getWriter().print("");//需在5秒内返回空串表明暂时不回复，然后再立即使用客服消息接口发送消息回复粉丝
log.info("content:"+content+" content[1]:"+content.split(":")[1]+" fromUserName:"+fromUserName+" toUserName:"+toUserName);
//接下来客服API再回复一次消息
//此时 content字符的内容为是 QUERY_AUTH_CODE:adsg5qe4q35
replyApiTextMessage(content.split(":")[1],toUserName);
}
}

/**
* 方法描述: 直接返回给微信开放平台
* @param request
* @param response
* @param content  文本
* @param toUserName  发送接收人
* @param fromUserName  发送人
* @author Andy 2015年9月1日  下午2:15:40
*/
public void replyTextMessage(HttpServletRequest request, HttpServletResponse response,
String content,String toUserName, String fromUserName)
throws DocumentException, IOException {
Long createTime = System.currentTimeMillis() / 1000;
StringBuffer sb = new StringBuffer(512);
sb.append("<xml>");
sb.append("<ToUserName><![CDATA["+toUserName+"]]></ToUserName>");
sb.append("<FromUserName><![CDATA["+fromUserName+"]]></FromUserName>");
sb.append("<CreateTime>"+createTime.toString()+"</CreateTime>");
sb.append("<MsgType><![CDATA[text]]></MsgType>");
sb.append("<Content><![CDATA["+content+"]]></Content>");
sb.append("</xml>");
String replyMsg = sb.toString();
log.info("确定发送的XML为："+replyMsg);//千万别加密
returnJSON(replyMsg,response);
}

/**
* 方法描述: 调用客服回复消息给粉丝
* @param auth_code
* @param fromUserName
* @throws DocumentException
* @throws IOException
* @return void
* @author Andy 2015年9月7日  上午9:48:01
*/
public void replyApiTextMessage(String auth_code, String fromUserName) throws DocumentException, IOException {
// 得到微信授权成功的消息后，应该立刻进行处理！！相关信息只会在首次授权的时候推送过来
String componentAccessToken= wxConfigStorageService.getComponentAccessToken();//本人平台缓存的token
PlatformParam component = platformParamService.selectPlatformParam();//获取 平台ID
//https://api.weixin.qq.com/cgi-bin/component/api_query_auth  到这个微信的接口去获取数据
MpAuthorization m=ProxyInterfaceApi.getInstance().mpAuthorization(componentAccessToken, component.getComponentAppId(),auth_code);
AuthorizationInfo info=m.getAuthorization_info();
String authorizer_access_token = info.getAuthorizer_access_token();

String url = "https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token="+authorizer_access_token;
JSONObject json = new JSONObject();
json.put("touser",fromUserName);
json.put("msgtype", "text");
json.put("text", "{\"content\":\""+auth_code+"_from_api"+"\"}");

String result = HttpClientCommonSSL.commonPostStream(url, json.toString());
log.info("客服发送接口返回值:"+result);
}

/**
* 方法描述: 返回数据到请求方
* @param data 数据
* @param response
* @author Andy 2015年9月1日  下午1:06:54
*/
public void returnJSON(Object data,HttpServletResponse response) {
try {
ObjectMapper objectMapper = new ObjectMapper();
JsonEncoding encoding = JsonEncoding.UTF8;
response.setContentType("application/json");
org.codehaus.jackson.JsonGenerator generator = objectMapper.getJsonFactory().
createJsonGenerator(response.getOutputStream(), encoding);
objectMapper.writeValue(generator, data);
} catch (IOException e) {
e.printStackTrace();
}
}

/**
* 方法描述:
* @param args
* @return void
* @author Andy 2015年8月31日  下午5:31:07
*/
public static void main(String[] args) {
JSONObject j=new JSONObject();
j.put("content", "aaa"+"_from_api");
System.out.println(j.toString());
System.out.println("{\"content\":\"好的_from_api\"}");
}

}

3、容易出错的点：

      (1)、组件API： 记住这地方，要去重新获取authorizer_access_token值，发送消息的人，必须是自己，别弄错了，不然返回错误码4***3

      (2)、返回普通文本消息的时候，千万别加密那个XML的字符串，加密就报错.

      (3)、还有一个就是，全网发布的时候，要将自己的外网IP填写在 白名单里面，不然获取token会失败报错 61004

 
    (4)、如果几次的测试都通过的情况下，突然有一天或者一段时间  客服发送接口返回值 出现48001，提示api没有权限，那估计就是腾讯的服务器八成挂了，耐心的等待吧！

4、本文档截稿日期为
2015-09-07， 请距此时间过久的朋友阅读时，具体以微信开放平台官方文档为主！ 此处仅供参考