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微信框架的技术部分