Netsharp下微信菜单以及OAuth

一、OAuth介绍

在微信开发中，当打开一个页面是，业务场景一般会基于粉丝绑定用户信息，即页面需要基于粉丝和用户的身份处理业务逻辑。

在微信中打开一个页面有三个场景：

1.文本回复中直接包含url

2.图文回复中携带url

3.微信菜单直接打开一个url

对于前两者，因为使用的是请求和回复的方式，回复可以在后台在页面中通过url的参数传递粉丝的openId等身份标识数据。而对于微信菜单的url，因为没有后台的处理，所以无法在url中附加openId，导致菜单打开的页面无法实现粉丝和用户的身份识别。

微信提供了oauth方式，可以用来在微信菜单中打开的url进行粉丝和用户身份的标识。需要说明的是只有微信服务号才支持oauth，对于订阅号是不支持oauth的，即订阅号菜单对应的url中无法识别粉丝和用户的身份。本文介绍的是netsharp.weixin开发下的微信服务号oauth的处理机制。

另外：用户点击一个微信菜单的时候，可以发送一个消息，也可以打开一个url，本文主要介绍打开url的情况

如下场景：

1.业务中微信打开的业务菜单：如http://www.netsharp.org/nav/weixin/index?originalId=gh_cd4d099926d5，本文称之为"redirect_uri"(和微信oauth下的叫法一致)

2.微信要求url必须配置成这样的：https://open.weixin.qq.com/connect/oauth2/authorize?from=weixin&appid=wx19a3e7936ff4ec13&redirect_uri=http%3A%2F%2Fwww.netsharp.org%2Fnav%2Faddins%2Fweixin%2Findex%3ForiginalId%3Dgh_cd4d099926d5&response_type=code&scope=snsapi_base&state=#wechat_redirect，本文称之为oauth_url,在oauth_url中 redirect_uri作为一个参数（即上面的第一点提到的redirect_uri），并且在oauth_url中的redirect_uri部分需要编码

用户点击微信菜单场景：

1.用户点击一个菜单

2.微信打开oauth_url

3.oauth_url页面进行oauth验证

4.oauth_url页验证通过后，跳转到redirect_uri，并且给redirect_uri页面追加了一个参数"code"

5.redirect_uri中，开发人员基于code，调用微信的api得到粉丝的信息

6.基于粉丝信息处理业务

7.结束

二、OAuth示例

下面是redirect_url也的demo代码，首先netsharp会自动把"originalId"参数传递给redirect_url，在redirect_url如果想获取openId则通过oauth_url给redirect_url追加的一个参数“code”获取，netsharp把根据code获取粉丝信息给封装了，参见业务页面的代码：

<%@page language="java" contentType="text/html; charset=utf-8" pageEncoding="UTF-8"%>
<%@page import="org.netsharp.wx.pa.base.IFansService" %>
<%@page import="org.netsharp.communication.ServiceFactory" %>
<%@page import="org.netsharp.wx.pa.entity.Fans" %>
<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="initial-scale=1, maximum-scale=1, user-scalable=no, width=device-width">
    <meta name="format-detection" content="telephone=no" />
    <title>oauth测试页面</title>
 
  </head>
  <body > 
     
    <%
        String originalId = (String)request.getParameter("originalId");
        response.getWriter().write("originalId:"+originalId+"<br/>");
         
        String code = (String)request.getParameter("code");
        response.getWriter().write("code:"+code+"<br/>");
         
        //oauth中必须根据code才能得到粉丝信息
        IFansService fansService = ServiceFactory.create(IFansService.class);
         
        Fans fans = fansService.attachByOpenId(code, originalId);
         
         
        response.getWriter().write("openId:"+fans.getOpenId()+"<br/>");
        response.getWriter().write("nickname:"+fans.getNickname()+"<br/>");
        response.getWriter().write("img:<img src='"+fans.getHeadImgUrl()+"' style='width:60px;height:60px' /><br/>");
         
    %>
  </body>
</html>