NETSHARP微信开发说明

一、微信开发介绍

1.微信分为个人号，订阅号、服务号，需要去理解三个号的区别，对于开发来说也需要了解不同的账号所提供的功能

2.微信号需要审批，审批之后有一些功能才能使用

3.微信提供的功能及使用情况登陆http://mp.weixin.qq.com,通过左侧菜单“/开发/接口权限”查看

4.更多关于微信开发的信息，不是本文介绍的内容，此处指提出使用netsharp.weixin的要求

二、netsharp微信开发配置

netsharp平台可以支持多个微信公众号，具体配置如下列表和明细图，一些字段的意思保持和微信开发者一直便于理解

1.列表

2.表单

3.微信开发和netsharp的绑定

mp.weixin.qq.com下面当启用二次开发的时候，需要配置开发者的微信接收的地址，形如

http://host/wx?oid=gh_befcc6d4c40d

其中oid参数是微信的originalId

4.netsharp微信开发服务器接收代码

 package org.netsharp.servlet;

 import java.io.IOException;
 import java.io.InputStream;

 import javax.servlet.ServletException;
 import javax.servlet.annotation.WebServlet;
 import javax.servlet.http.HttpServlet;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;

 import org.apache.commons.logging.Log;
 import org.apache.commons.logging.LogFactory;
 import org.netsharp.wx.mp.message.WeixinMessageDispatcher;
 import org.netsharp.wx.mp.sdk.WeixinRequestParameters;

 @WebServlet(name = "weixin", urlPatterns = "/wx")
 public class WeixinServlet extends HttpServlet {

     private static final long serialVersionUID = 1L;
     private static Log logger = LogFactory.getLog("weixin." + WeixinServlet.class.getSimpleName());

     public WeixinServlet() {
         super();
     }

     // http://121.40.86.55/wx?oid=gh_befcc6d4c40d
     protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

         response.setCharacterEncoding("utf-8");

         logger.error("微信开发者配置验证开始");

         response.getWriter().write("");

         WeixinRequestParameters par = this.getWeixinParameter(request);

         try {
             WeixinMessageDispatcher mc = new WeixinMessageDispatcher();
             mc.validate(par);
             response.getWriter().write(par.Echostr);
         } catch (Exception ex) {
             logger.error("servlet 微信get异常", ex);
         }

         logger.error("微信开发者配置验证结束");
     }

     protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

         response.setCharacterEncoding("utf-8");

         response.getWriter().write("");

         WeixinRequestParameters par = this.getWeixinParameter(request);
         InputStream stream = request.getInputStream();
 //        String xml = FileManager.read(stream);
 //        logger.error("[收到微信消息]：" + xml);

         try {
             WeixinMessageDispatcher mc = new WeixinMessageDispatcher();
             String content = mc.processRequest(par, stream);

             logger.error("[回复消息]：" + content);

             response.getWriter().write(content);
         } catch (Exception ex) {
             logger.error("servlet 微信post异常", ex);
         }
     }

     private WeixinRequestParameters getWeixinParameter(HttpServletRequest request) {

         WeixinRequestParameters par = new WeixinRequestParameters();
         {
             par.Signature = request.getParameter("signature");
             par.Timestamp = request.getParameter("timestamp");
             par.Nonce = request.getParameter("nonce");
             par.Echostr = request.getParameter("echostr");
             par.Oid = request.getParameter("oid");
         }

         logger.error(par.toString());

         return par;
     }
 }

三、Netsharp微信其他配置

1.菜单配置

微信启动二次开发了之后，菜单则需要通过接口创建，netsharp进行了封装并且提供了工具，菜单设置好以后在列表上点击“同步"按钮即可

重新生成菜单之后，开发者要及时看到菜单的最新设置，需要取消重新关注

现在netsharp的菜单还不能处理父子关系的菜单，但是数据库可以修改parent_id来修改其关系，界面会自动显示树状关系

2.文字及图文关注

3.微信回复和关注处理配置

文字和图文的回复是一种特殊的回复，微信的二次开发有大量的消息、关注的处理，这些处理除了js端，服务端都是可以配置的

netsharp提供了一些默认配置，

四、Netsharp微信框架介绍

本文之前主要介绍的是netsharp下的配置和管理功能，下面主要介绍Netsharp微信框架的技术部分