一、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='60px;height:60px' /><br/>"); %> </body> </html>
测试页的效果如下:
三、Netsharp下微信菜单的配置
因为oauth的页面拼接很麻烦,netsharp.weixin工具把这些工作给封装了,在微信菜单的配置,只要配置redirect_url就可以了,参见如下界面: