java 移动端网页_Java企业微信开发_09_身份验证之移动端网页授权(有完整项目源码)...

一、本节要点

1.1 授权回调域(可信域名)

在开始使用网页授权之前，需要先设置一下授权回调域。这里瞬间想到之前做JSSDK的时候，也设置过一个域名。二者本质上都是设置可信域名。

当用户授权完毕之后，请求将重定向到此域名(或者子域名)下的执行者(jsp页面或者servlet等)。如何设置授权回调域，请见第二节。

1.2 获取Code

https://open.weixin.qq.com/connect/oauth2/authorize?appid=CORPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&agentid=AGENTID&state=STATE#wechat_redirect

可将根据此链接生成一个view菜单按钮，用户点击此按钮时，将跳转到授权页面，授权成功后，页面重定向到指定的REDIRECT_URI页面，同时带上code和state请求参数，即页面将跳转至 redirect_uri?code=CODE&state=STATE页面。

1.3 移动端网页授权流程

(1)用户点击1.2中菜单按钮，跳转至授权页面

(2)用户授权成功，页面重定向到 redirect_uri?code=CODE&state=STATE 页面

(3)接收code，根据code获取成员信息(UserId，user_ticket)

(4)拿到UserId后可选择去根据UserId获取成员详细信息， 参见Java企业微信开发_02_通讯录同步 中的 Contacts_UserService类

(5) 拿到 user_ticket后可选择去使用user_ticket获取成员详情(其中包括用户头像)

在此我们只关注于打通 企业微信官方文档中 移动端网页授权 相关的接口，这是基础，至于实际工作中企业是如何去具体实现他们自己的授权业务，暂时不在我们讨论的范围内。

二、代码实现

2.1设置可信域名(授权回调域)

登录企业微信后台—>企业应用—>自建应用中的你的具体应用—>企业微信授权登录—>Web网页

2.2 生成菜单按钮

添加一个用于网页授权的菜单按钮，运行MenuTest.testCreateMenu()方法生成按钮。

在已经成功生成菜单按钮时，有时可能出现菜单没有及时更新的情况，这时可以通过取消关注企业号，再重新关注企业号来解决这个问题。

(1)MenuService.java

packagecom.ray.service;importorg.slf4j.Logger;importorg.slf4j.LoggerFactory;importcom.google.gson.Gson;importcom.ray.pojo.menu.Button;importcom.ray.pojo.menu.CommonButton;importcom.ray.pojo.menu.ComplexButton;importcom.ray.pojo.menu.Menu;importcom.ray.pojo.menu.ViewButton;importcom.ray.util.WeiXinUtil;importnet.sf.json.JSONObject;public classMenuService {private static Logger log = LoggerFactory.getLogger(MenuService.class);//菜单创建(POST) 限100(次/天)

public static String create_menu_url = "https://qyapi.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN&agentid=AGENTID";/*** 1.创建菜单

*

*@parammenu 菜单实例

*@paramaccessToken 有效的access_token

*@return0表示成功，其他值表示失败*/

public void createMenu(String accessToken,Menu menu,intagentId) {//1.获取json字符串：将Menu对象转换为json字符串

Gson gson = newGson();

String jsonMenu=gson.toJson(menu); //使用gson.toJson(user)即可将user对象顺序转成json

System.out.println("jsonMenu:"+jsonMenu);//2.获取请求的url

create_menu_url = create_menu_url.replace("ACCESS_TOKEN", accessToken)

.replace("AGENTID", String.valueOf(agentId));//3.调用接口,发送请求，创建菜单

JSONObject jsonObject = WeiXinUtil.httpRequest(create_menu_url, "POST", jsonMenu);

System.out.println("jsonObject:"+jsonObject.toString());//4.错误消息处理

if (null !=jsonObject) {if (0 != jsonObject.getInt("errcode")) {

log.error("创建菜单失败 errcode:{} errmsg:{}", jsonObject.getInt("errcode"), jsonObject.getString("errmsg"));

}

}

}/*** 2.组装菜单数据

*

*@return

*/

publicMenu getMenu() {/*ViewButton btn11 = new ViewButton();

btn11.setName("添加报销单");

btn11.setType("view");

btn11.setUrl("http://5nffqn.natappfree.cc/WeiXin_QiYe_Demo/uploadExpenseAccaout.jsp");*/ViewButton btn11= newViewButton();

btn11.setName("JSSDK多图上传");

btn11.setType("view");

btn11.setUrl("http://zvuntx.natappfree.cc/WeiXin_QiYe_Demo/JSSDKUploadPics.jsp");

ViewButton btn21= newViewButton();

btn21.setName("JSSDK测试(全)");

btn21.setType("view");

btn21.setUrl("http://zvuntx.natappfree.cc/WeiXin_QiYe_Demo/jsapiTicktAll.jsp");

ViewButton btn22= newViewButton();

btn22.setName("PC端网页授权");

btn22.setType("view");

btn22.setUrl("https://open.work.weixin.qq.com/wwopen/sso/qrConnect?appid=ww92f5da92bb24696e&agentid=1000002&redirect_uri=http%3A%2F%2Fzvuntx.natappfree.cc%2FWeiXin_QiYe_Demo%2FPCAuthorization.jsp&state=state");

ViewButton btn23= newViewButton();

btn23.setName("移动端网页授权");

btn23.setType("view");

btn23.setUrl("https://open.weixin.qq.com/connect/oauth2/authorize?appid=ww92f5da92bb24696e&redirect_uri=http%3A%2F%2Fzvuntx.natappfree.cc%2FWeiXin_QiYe_Demo%2FMTAuthorization.jsp&response_type=code&scope=snsapi_privateinfo&agentid=1000002&state=hec#wechat_redirect");

CommonButton btn12= newCommonButton();

btn12.setName("扫一扫");

btn12.setType("click");

btn12.setKey("12");

CommonButton btn13= newCommonButton();

btn13.setName("翻译功能");

btn13.setType("click");

btn13.setKey("13");

ViewButton btn14= newViewButton();

btn14.setName("上传图片");

btn14.setType("view");

btn14.setUrl("http://5nffqn.natappfree.cc/WeiXin_SanFenBaiXue/uploadimg.jsp");

ViewButton btn15= newViewButton();

btn15.setName("上传图片2");

btn15.setType("view");

btn15.setUrl("http://5nffqn.natappfree.cc/WeiXin_SanFenBaiXue/index2.jsp");

CommonButton btn24= newCommonButton();

btn24.setName("人脸识别");

btn24.setType("click");

btn24.setKey("24");

CommonButton btn25= newCommonButton();

btn25.setName("聊天唠嗑");

btn25.setType("click");

btn25.setKey("25");

CommonButton btn31= newCommonButton();

btn31.setName("Q友圈");

btn31.setType("click");

btn31.setKey("31");

CommonButton btn33= newCommonButton();

btn33.setName("幽默笑话");

btn33.setType("click");

btn33.setKey("33");

CommonButton btn34= newCommonButton();

btn34.setName("用户反馈");

btn34.setType("click");

btn34.setKey("34");

CommonButton btn35= newCommonButton();

btn35.setName("关于我们");

btn35.setType("click");

btn35.setKey("35");

ViewButton btn32= newViewButton();

btn32.setName("周边搜索");

btn32.setType("view");

btn32.setUrl("http://liufeng.gotoip2.com/xiaoqrobot/help.jsp");

ComplexButton mainBtn1= newComplexButton();

mainBtn1.setName("正在做功能");

mainBtn1.setSub_button(newButton[] { btn11, btn12, btn13, btn14, btn15 });

ComplexButton mainBtn2= newComplexButton();

mainBtn2.setName("测试");

mainBtn2.setSub_button(newButton[] { btn21, btn22, btn23, btn24, btn25 });

ComplexButton mainBtn3= newComplexButton();

mainBtn3.setName("更多");

mainBtn3.setSub_button(newButton[] { btn31, btn33, btn34, btn35, btn32 });/*** 这是企业号目前的菜单结构，每个一级菜单都有二级菜单项

*

* 在某个一级菜单下没有二级菜单的情况，menu该如何定义呢？

* 比如，第三个一级菜单项不是“更多体验”，而直接是“幽默笑话”，那么menu应该这样定义：

* menu.setButton(new Button[] { mainBtn1, mainBtn2, btn33 });*/Menu menu= newMenu();

menu.setButton(newButton[] { mainBtn1, mainBtn2, mainBtn3 });returnmenu;

}

}

View Code

(2)MenuTest.java

packagecom.ray.test;importorg.junit.Test;importcom.ray.pojo.menu.Menu;importcom.ray.service.MenuService;importcom.ray.util.WeiXinParamesUtil;importcom.ray.util.WeiXinUtil;public classMenuTest {

@Testpublic voidtestCreateMenu(){//1.组装菜单

MenuService ms=newMenuService();

Menu menu=ms.getMenu();//2.获取access_token:根据企业id和应用密钥获取access_token

String accessToken=WeiXinUtil.getAccessToken(WeiXinParamesUtil.corpId, WeiXinParamesUtil.agentSecret).getToken();

System.out.println("accessToken:"+accessToken);//3.创建菜单

ms.createMenu( accessToken, menu, WeiXinParamesUtil.agentId);

}

}

View Code

2.3 移动端网页授权业务类——MTAuthorizationService.java

包括两个方法：

(1)根据code获取成员信息

(2)使用userTicket获取成员详情

packagecom.ray.service;importorg.slf4j.Logger;importorg.slf4j.LoggerFactory;importcom.google.gson.Gson;importcom.ray.pojo.UserTicket;importcom.ray.util.WeiXinUtil;importnet.sf.json.JSONObject;/*** @desc : 移动端网页授权Service

*

*@author: shirayner

* @date : 2017年9月14日 下午12:18:38*/

public classMTAuthorizationService {private static Logger log = LoggerFactory.getLogger(MenuService.class);public static final String GET_USERINFO_URL = "https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo?access_token=ACCESS_TOKEN&code=CODE";public static final String GET_USERDETAIL_URL = "https://qyapi.weixin.qq.com/cgi-bin/user/getuserdetail?access_token=ACCESS_TOKEN";/**1.根据code获取成员信息

* @desc ：GET请求、

* 成员信息包括

* UserId 成员UserID

* DeviceId 手机设备号(由企业微信在安装时随机生成，删除重装会改变，升级不受影响)

* user_ticket 成员票据，最大为512字节。scope为snsapi_userinfo或snsapi_privateinfo，且用户在应用可见范围之内时返回此参数。

* 后续利用该参数可以获取用户信息或敏感信息。

* expires_in user_token的有效时间(秒)，随user_ticket一起返回

*

*@paramaccessToken

*@paramcode void*/

publicJSONObject getUserInfo(String accessToken,String code) {//1.获取请求的url

String get_userInfo_url=GET_USERINFO_URL.replace("ACCESS_TOKEN", accessToken)

.replace("CODE", code);//2.调用接口，发送请求，获取成员信息

JSONObject jsonObject = WeiXinUtil.httpRequest(get_userInfo_url, "GET", null);

System.out.println("jsonObject:"+jsonObject.toString());//3.错误消息处理

if (null !=jsonObject) {if (0 != jsonObject.getInt("errcode")) {

log.error("获取成员信息失败 errcode:{} errmsg:{}", jsonObject.getInt("errcode"), jsonObject.getString("errmsg"));

}

}returnjsonObject;

}/**2.使用userTicket获取成员详情

* @desc ：POST请求

*

*@paramaccessToken

*@paramuserTicket

*@returnJSONObject*/

publicJSONObject getUserDetail(String accessToken,UserTicket userTicket) {//1.获取请求地址

String get_userDetail_url=GET_USERDETAIL_URL.replace("ACCESS_TOKEN", accessToken);//2.准备好请求包体

Gson gson = newGson();

String jsonUserTicket=gson.toJson(userTicket); //使用gson.toJson(user)即可将user对象顺序转成json

System.out.println("jsonUserTicket:"+jsonUserTicket);//2.调用接口，发送请求，获取成员信息

JSONObject jsonObject = WeiXinUtil.httpRequest(get_userDetail_url, "POST", jsonUserTicket);

System.out.println("jsonObject:"+jsonObject.toString());//3.错误消息处理

if (null !=jsonObject) {if (0 != jsonObject.getInt("errcode")) {

log.error("获取成员信息失败 errcode:{} errmsg:{}", jsonObject.getInt("errcode"), jsonObject.getString("errmsg"));

}

}returnjsonObject;

}

}

View Code

2.4前端页面——MTAuthorization.jsp

授权成功后将跳转到这个页面。在这个页面里调用了MTAuthorizationService中的方法来获取用户信息

移动端网页授权

String state=request.getParameter("state");

MTAuthorizationService mts=newMTAuthorizationService();

String accessToken=WeiXinUtil.getAccessToken(WeiXinParamesUtil.corpId, WeiXinParamesUtil.agentSecret).getToken();//获取成员信息

JSONObject userInfo=mts.getUserInfo(accessToken, code);//获取成员详情

UserTicket userTicket=newUserTicket();

userTicket.setUser_ticket(userInfo.getString("user_ticket"));

JSONObject userDetail=mts.getUserDetail(accessToken, userTicket);%>hello，这里是第三方应用

code=
state=
userInfo=
userTicket=
userDetail=

View Code