cn.ponfee.commons.util

类 Wechats

java.lang.Object

cn.ponfee.commons.util.Wechats

public class Wechats
extends Object

微信工具类：https://www.cnblogs.com/txw1958/p/weixin76-user-info.html OAuth2.0：https://www.jianshu.com/p/6392420faf99

作者:

Ponfee

构造器概要

构造器

构造器和说明
Wechats()

方法概要

限定符和类型	方法和说明
static String	buildAuthorizeUrl(String appid, String redirect, String state)
static String	buildAuthorizeUrl(String appid, String charset, String redirect, String state)
static String	buildAuthorizeUrl(String appid, String charset, String redirect, String state, String scope) 构建授权地址
static String	getAccessToken(String appid, String secret) Gets global access token
static String	getJsapiTicket(String accessToken)
static Map<String,Object>	getOAuth2(String appid, String secret, String code) 1、构建的微信授权地址返回到客户端 2、用户客户端访问此微信授权地址进行登录授权 3、微信会让用户客户端重定向到redirect(应用的回调地址)并附带code参数 4、应用通过code换取网页授权access_token和openId scope=snsapi_userinfo { "access_token":"OezXcEiiBSKSxW0eow", "expires_in":7200, "refresh_token":"OezXcqDQy52232WDXB3Msuzq1A", "openid":"oLVPpjqs9BhvzwPj5A-vTYAX3GLc", "scope":"snsapi_userinfo," } scope=snsapi_base { "access_token": "OezXcEiiBSKSxW0eoylIeAsR0GmYd1awCffdHgb4fhS_KKf2CotGj2cBNUKQQvj-oJ9VmO-0Z-_izfnSAX_s0aqDsYkW4s8W5dLZ4iyNj5Y6vey3dgDtFki5C8r6D0E6mSVxxtb8BjLMhb-mCyT_Yg", "expires_in": 7200, "refresh_token": "OezXcEiiBSKSxW0eoylIeAsR0GmYd1awCffdHgb4fhS_KKf2CotGj2cBNUKQQvj-oJ9VmO-0Z-_izfnSAX_s0aqDsYkW4s8W5dLZ4iyNj5YBkF0ZUH1Ew8Iqea6x_itq13sYDqP1D7ieaDy9u2AHHw", "openid": "oLVPpjqs9BhvzwPj5A-vTYAX3GLc", "scope": "snsapi_base" } 获取微信openID及授权access_token password模式：https://api.oauth2server.com/token?
static String	getTicket(String type, String accessToken) Gets jsapi ticket
static Map<String,Object>	getUserInfoByGlobal(String accessToken, String openid) 1、用户关注以及回复消息的时候，均可以获得用户的OpenID
static Map<String,Object>	getUserInfoByOAuth2(String accessToken, String openid) { "openid":"oLVPpjqs9BhvzwPj5A-vTYAX3GLc", "nickname":"方倍", "sex":1, "language":"zh_CN", "city":"Shenzhen", "province":"Guangdong", "country":"CN", "headimgurl":"http://wx.qlogo.cn/mmopen/utpBBg18/0", "privilege":[] } 通过OAuth2.0方式弹出授权页面获得用户基本信息（因scope=snsapi_userinfo会弹出授权页面）
static Map<String,Object>	refreshAccessToken(String appid, String refreshToken) Refresh the access token by refresh_token
static Map<String,String>	shareUrl(String jsapiTicket, String appid, String url) Returns the share url link to the wechat friend moments

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

Wechats

public Wechats()

方法详细资料

buildAuthorizeUrl

public static String buildAuthorizeUrl(String appid,
                                       String redirect,
                                       String state)

buildAuthorizeUrl

public static String buildAuthorizeUrl(String appid,
                                       String charset,
                                       String redirect,
                                       String state)

buildAuthorizeUrl

public static String buildAuthorizeUrl(String appid,
                                       String charset,
                                       String redirect,
                                       String state,
                                       String scope)

构建授权地址

参数:

appid - the appid

charset - the charset for params encoding

redirect - the service url

state - 在发送state之后，可以把state保存到Session以便用于后续回调时的比较。 这样做的目的是防止应用接受任意伪造的授权码（CSRF）。

scope - snsapi_base ：不弹出授权页面，直接跳转，只能获取用户openid

snsapi_userinfo：弹出授权页面，可通过openid拿到昵称、性别、所在地。并且，即使在未关注的情况下，只要用户授权，也能获取其信息

snsapi_login ：登录

返回:

a url of wechat auth

getOAuth2

public static Map<String,Object> getOAuth2(String appid,
                                           String secret,
                                           String code)

 1、构建的微信授权地址返回到客户端
 2、用户客户端访问此微信授权地址进行登录授权
 3、微信会让用户客户端重定向到redirect(应用的回调地址)并附带code参数
 4、应用通过code换取网页授权access_token和openId

 scope=snsapi_userinfo
  {
    "access_token":"OezXcEiiBSKSxW0eow",
    "expires_in":7200,
    "refresh_token":"OezXcqDQy52232WDXB3Msuzq1A",
    "openid":"oLVPpjqs9BhvzwPj5A-vTYAX3GLc",
    "scope":"snsapi_userinfo,"
  }
  
 scope=snsapi_base
  {
    "access_token": "OezXcEiiBSKSxW0eoylIeAsR0GmYd1awCffdHgb4fhS_KKf2CotGj2cBNUKQQvj-oJ9VmO-0Z-_izfnSAX_s0aqDsYkW4s8W5dLZ4iyNj5Y6vey3dgDtFki5C8r6D0E6mSVxxtb8BjLMhb-mCyT_Yg",
    "expires_in": 7200,
    "refresh_token": "OezXcEiiBSKSxW0eoylIeAsR0GmYd1awCffdHgb4fhS_KKf2CotGj2cBNUKQQvj-oJ9VmO-0Z-_izfnSAX_s0aqDsYkW4s8W5dLZ4iyNj5YBkF0ZUH1Ew8Iqea6x_itq13sYDqP1D7ieaDy9u2AHHw",
    "openid": "oLVPpjqs9BhvzwPj5A-vTYAX3GLc",
    "scope": "snsapi_base"
  }
 

获取微信openID及授权access_token password模式：https://api.oauth2server.com/token?grant_type=password&username=USERNAME&password=PASSWORD&client_id=CLIENT_ID

参数:

appid - the appid

secret - the secret

code - the aut url callback result data, buildAuthorizeUrl(String, String, String, String, String)

返回:

wechat oauth info

refreshAccessToken

public static Map<String,Object> refreshAccessToken(String appid,
                                                    String refreshToken)

Refresh the access token by refresh_token

参数:

appid - the appid

refreshToken - the refresh_token

返回:

refresed a new access_token by refresh_token

getUserInfoByOAuth2

public static Map<String,Object> getUserInfoByOAuth2(String accessToken,
                                                     String openid)

  {
    "openid":"oLVPpjqs9BhvzwPj5A-vTYAX3GLc",
    "nickname":"方倍",
    "sex":1,
    "language":"zh_CN",
    "city":"Shenzhen",
    "province":"Guangdong",
    "country":"CN",
    "headimgurl":"http://wx.qlogo.cn/mmopen/utpBBg18/0",
    "privilege":[]
  }
 

通过OAuth2.0方式弹出授权页面获得用户基本信息（因scope=snsapi_userinfo会弹出授权页面）

参数:

accessToken - the access token, getOAuth2(String, String, String)

openid - the openid, getOAuth2(String, String, String)

返回:

wechat user info

另请参阅:

set scope=snsapi_userinfo

getAccessToken

public static String getAccessToken(String appid,
                                    String secret)

Gets global access token

参数:

appid -

secret -

返回:

{access_token=token, expires_in=7200}

getUserInfoByGlobal

public static Map<String,Object> getUserInfoByGlobal(String accessToken,
                                                     String openid)

  1、用户关注以及回复消息的时候，均可以获得用户的OpenID
   
     
     
     1372307736
     
     
     
   
  其中的FromUserName就是OpenID
 
  2、返回数据格式
  {
    "subscribe": 1,
    "openid": "oLVPpjqs2BhvzwPj5A-vTYAX4GLc",
    "nickname": "nickname",
    "sex": 1,
    "language": "zh_CN",
    "unionid": "unionid" // 只有在用户将公众号绑定到微信开放平台帐号后，才会出现该字段
    "city": "深圳",
    "province": "广东",
    "country": "中国",
    "headimgurl": "http://wx.qlogo.cn/mmopen/JcDicrZBlREhnNXZRudod9PmibRkIs5K2f1tUQ7lFjC63pYHaXGxNDgMzjGDEuvzYZbFOqtUXaxSdoZG6iane5ko9H30krIbzGv/0",
    "subscribe_time": 1386160805 // 用户关注时间，为时间戳。如果用户曾多次关注，则取最后关注时间
  }
 

通过全局Access Token获取用户基本信息

参数:

accessToken - the global access token, getAccessToken(String, String)

openid - the openid, 用户关注以及回复消息时可获取此openid

返回:

wechat user info

getJsapiTicket

public static String getJsapiTicket(String accessToken)

getTicket

public static String getTicket(String type,
                               String accessToken)

Gets jsapi ticket

参数:

type - wx_card 卡券；jsapi js接口票据；

accessToken - the global accessToken, getAccessToken(String, String)

返回:

{errcode=0, errmsg=ok, ticket=ticket, expires_in=7200}

shareUrl

public static Map<String,String> shareUrl(String jsapiTicket,
                                          String appid,
                                          String url)

Returns the share url link to the wechat friend moments

参数:

jsapiTicket - the jsapi ticket, getJsapiTicket(String)

appid - the wechat appid

url - the url link

返回:

share url data with signurate give to client use