com.foxinmy.weixin4j.mp.api.OauthApi Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of weixin4j-mp Show documentation
微信公众平台API
There is a newer version: 1.10.2
package com.foxinmy.weixin4j.mp.api;

import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;

import com.alibaba.fastjson.TypeReference;
import com.foxinmy.weixin4j.exception.WeixinException;
import com.foxinmy.weixin4j.http.weixin.WeixinResponse;
import com.foxinmy.weixin4j.model.Consts;
import com.foxinmy.weixin4j.mp.model.OauthToken;
import com.foxinmy.weixin4j.mp.model.User;
import com.foxinmy.weixin4j.mp.type.Lang;
import com.foxinmy.weixin4j.util.ConfigUtil;
import com.foxinmy.weixin4j.util.StringUtil;

/**
 * oauth授权
 * 
 * @className OauthApi
 * @author jy
 * @date 2015年3月6日
 * @since JDK 1.7
 * @see 微信登陆
 */
public class OauthApi extends MpApi {

	/**
	 * @see {@link #getAuthorizeURL(String, String,String)}
	 * 
	 * @return 请求授权的URL
	 */
	public String getAuthorizeURL() {
		String appId = DEFAULT_WEIXIN_ACCOUNT.getId();
		String redirectUri = ConfigUtil.getValue("user_oauth_redirect_uri");
		return getAuthorizeURL(appId, redirectUri, "state", "snsapi_login");
	}

	/**
	 * 请求CODE
	 * 
	 * @param appId
	 *            应用ID
	 * @param redirectUri
	 *            重定向地址
	 * @param state
	 *            用于保持请求和回调的状态，授权请求后原样带回给第三方
	 * @return 请求授权的URL
	 */
	public String getAuthorizeURL(String appId, String redirectUri,
			String state, String... scopes) {
		String sns_user_auth_uri = getRequestUri("sns_user_auth_uri");
		try {
			return String.format(sns_user_auth_uri, appId,
					URLEncoder.encode(redirectUri, Consts.UTF_8.name()),
					StringUtil.join(scopes, ','), state);
		} catch (UnsupportedEncodingException e) {
			;
		}
		return "";
	}

	/**
	 * @see {@link #getOauthToken(String, String,String)}
	 * 
	 * @return
	 */
	public OauthToken getOauthToken(String code) throws WeixinException {
		return getOauthToken(code, DEFAULT_WEIXIN_ACCOUNT.getId(),
				DEFAULT_WEIXIN_ACCOUNT.getSecret());
	}

	/**
	 * oauth授权code获取token
	 * 
	 * @param code
	 *            用户授权后返回的code
	 * @param appid
	 *            应用ID
	 * @param appsecret
	 *            应用密钥
	 * @return token对象
	 * @throws WeixinException
	 * @see com.foxinmy.weixin4j.mp.model.OauthToken
	 */
	public OauthToken getOauthToken(String code, String appid, String appsecret)
			throws WeixinException {
		String user_token_uri = getRequestUri("sns_user_token_uri");
		WeixinResponse response = weixinClient.get(String.format(
				user_token_uri, appid, appsecret, code));

		return response.getAsObject(new TypeReference() {
		});
	}

	/**
	 * @see {@link #getOauthToken(String, String,String)}
	 * 
	 * @return
	 */
	public OauthToken refreshToken(String refreshToken) throws WeixinException {
		return refreshToken(DEFAULT_WEIXIN_ACCOUNT.getId(), refreshToken);
	}

	/**
	 * 刷新token
	 * 
	 * @param appId
	 *            应用ID
	 * @param refreshToken
	 *            填写通过access_token获取到的refresh_token参数
	 * @return token对象
	 * @throws WeixinException
	 */
	public OauthToken refreshToken(String appId, String refreshToken)
			throws WeixinException {
		String sns_token_refresh_uri = getRequestUri("sns_token_refresh_uri");
		WeixinResponse response = weixinClient.get(String.format(
				sns_token_refresh_uri, appId, refreshToken));

		return response.getAsObject(new TypeReference() {
		});
	}

	/**
	 * 验证access_token是否正确
	 * 
	 * @param accessToken
	 *            接口调用凭证
	 * @param openId
	 *            用户标识
	 * @return 验证结果
	 */
	public boolean authAccessToken(String accessToken, String openId) {
		String sns_auth_token_uri = getRequestUri("sns_auth_token_uri");
		try {
			weixinClient.get(String.format(sns_auth_token_uri, accessToken,
					openId));
			return true;
		} catch (WeixinException e) {
			;
		}
		return false;
	}

	/**
	 * oauth获取用户信息(需scope为 snsapi_userinfo)
	 * 
	 * @param token
	 *            授权信息(token&openid)
	 * @return 用户对象
	 * @throws WeixinException
	 * @see 授权获取用户信息
	 * @see com.foxinmy.weixin4j.mp.model.User
	 * @see com.foxinmy.weixin4j.mp.model.OauthToken
	 * @see {@link #getOauthToken(String)}
	 * @see {@link #getUser(String,Sring,Lang)}
	 */
	public User getUser(OauthToken token) throws WeixinException {
		return getUser(token.getAccessToken(), token.getOpenid(), Lang.zh_CN);
	}

	/**
	 * oauth获取用户信息(需scope为 snsapi_userinfo)
	 * 
	 * @param oauthToken
	 *            授权票据
	 * @param openid
	 *            用户openid
	 * @param lang
	 *            使用语言
	 * @return 用户对象
	 * @throws WeixinException
	 * @see 授权获取用户信息
	 * @see com.foxinmy.weixin4j.mp.model.User
	 */
	public User getUser(String oauthToken, String openid, Lang lang)
			throws WeixinException {
		String user_info_uri = getRequestUri("sns_user_info_uri");
		WeixinResponse response = weixinClient.get(String.format(user_info_uri,
				oauthToken, openid, lang.name()));

		return response.getAsObject(new TypeReference() {
		});
	}
}