update md

weixin4j-mp/README.md

@@ -33,6 +33,8 @@ weixin4j-mp
   + Pay3Api `V3支付API`
   
   + DataApi `数据统计API`
+  
+  + OauthApi `oauth授权API`
 
 * **weixin4j-mp-server**
 
@@ -46,14 +48,15 @@ weixin4j-mp
 
 2.API的成功调用依赖于正确的appid等数据,创建(或者copy项目里面的)一个名为**weixin.properties**的资源文件放在自己工程中的classpath下.
 
-| 属性名       |       说明      |
+| 属性名       	|       说明      |
-| :---------- | :-------------- |
+| :---------- 	| :-------------- |
-| account     | 微信公众号信息 `json格式`  |
+| account    	| 微信公众号信息 `json格式`  |
-| token_path  | 使用FileTokenHolder时token保存的物理路径 |
+| token_path  	| 使用FileTokenHolder时token保存的物理路径 |
-| qr_path     | 调用二维码接口时保存二维码图片的物理路径 |
+| qr_path     	| 调用二维码接口时保存二维码图片的物理路径 |
-| media_path  | 调用媒体接口时保存媒体文件的物理路径 |
+| media_path  	| 调用媒体接口时保存媒体文件的物理路径 |
-| bill_path   | 调用下载对账单接口保存excel文件的物理路径 |
+| bill_path   	| 调用下载对账单接口保存excel文件的物理路径 |
-| ca_file     | 调用某些接口(支付相关)强制需要auth的ca授权文件 |
+| ca_file     	| 调用某些接口(支付相关)强制需要auth的ca授权文件 |
+| redirect_uri     | 调用OauthApi接口时需要填写的重定向路径 |
 
 示例(properties中换行用右斜杆\\)
 
@@ -73,6 +76,9 @@ weixin4j-mp
 	# ca证书存放的完整路径 (V2版本后缀为*.pfx,V3版本后缀为*.p12)
 	ca_file=/tmp/weixin/xxxxx.p12
 	#classpath路径下:ca_file=classpath:xxxxx.p12
+	
+	#微信登陆授权的重定向路径
+	redirect_uri=http://xxx
 
 3.在项目根目录下执行`mvn package -Prelease`命令后得到jar包,将`weixin4j-mp-full`包或者`weixin4j-base`和`weixin4j-mp-api`两个包引入到自己的工程.
 

weixin4j-mp/weixin4j-mp-api/README.md

@@ -70,6 +70,7 @@ weixin.properties说明
 	ca_file=/tmp/weixin/xxxxx.p12
 	#classpath路径下:ca_file=classpath:xxxxx.p12
 	
+	#微信登陆授权的重定向路径
 	redirect_uri=http://xxx
 
 2.实例化一个`WeixinProxy`对象,调用API,需要强调的是如果只传入appid,appsecret两个参数将无法调用支付相关接口

weixin4j-mp/weixin4j-mp-api/src/main/java/com/foxinmy/weixin4j/mp/api/OauthApi.java

@@ -0,0 +1,173 @@
+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.Response;
+import com.foxinmy.weixin4j.model.Consts;
+import com.foxinmy.weixin4j.model.WeixinMpAccount;
+import com.foxinmy.weixin4j.mp.model.OauthToken;
+import com.foxinmy.weixin4j.mp.model.User;
+import com.foxinmy.weixin4j.util.ConfigUtil;
+
+/**
+ * oauth授权
+ * 
+ * @className OauthApi
+ * @author jy
+ * @date 2015年3月6日
+ * @since JDK 1.7
+ * @see <a
+ *      href="https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&lang=zh_CN">微信登陆</a>
+ */
+public class OauthApi extends MpApi {
+	/**
+	 * @see {@link com.foxinmy.weixin4j.mp.api.OauthApi#getAuthorizeURL(String, String,String)}
+	 * 
+	 * @return
+	 */
+	public String getAuthorizeURL() {
+		return getAuthorizeURL("state");
+	}
+
+	/**
+	 * @see {@link com.foxinmy.weixin4j.mp.api.OauthApi#getAuthorizeURL(String, String,String)}
+	 * 
+	 * @return
+	 */
+	public String getAuthorizeURL(String state) {
+		String appId = ConfigUtil.getWeixinMpAccount().getId();
+		String redirectUri = ConfigUtil.getValue("redirect_uri");
+		return getAuthorizeURL(appId, redirectUri, state);
+	}
+
+	/**
+	 * 请求CODE
+	 * 
+	 * @param appId
+	 *            应用ID
+	 * @param redirectUri
+	 *            重定向地址
+	 * @param state
+	 *            用于保持请求和回调的状态，授权请求后原样带回给第三方
+	 * @return 请求的URL
+	 */
+	public String getAuthorizeURL(String appId, String redirectUri, String state) {
+		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()),
+					"snsapi_login", state);
+		} catch (UnsupportedEncodingException e) {
+			;
+		}
+		return "";
+	}
+
+	/**
+	 * @see {@link com.foxinmy.weixin4j.mp.api.OauthApi#getOauthToken(String, String,String)}
+	 * 
+	 * @return
+	 */
+	public OauthToken getOauthToken(String code) throws WeixinException {
+		WeixinMpAccount account = ConfigUtil.getWeixinMpAccount();
+		return getOauthToken(code, account.getId(), 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");
+		Response response = request.get(String.format(user_token_uri, appid,
+				appsecret, code));
+
+		return response.getAsObject(new TypeReference<OauthToken>() {
+		});
+	}
+
+	/**
+	 * @see {@link com.foxinmy.weixin4j.mp.api.OauthApi#getOauthToken(String, String,String)}
+	 * 
+	 * @return
+	 */
+	public OauthToken refreshToken(String refreshToken) throws WeixinException {
+		WeixinMpAccount account = ConfigUtil.getWeixinMpAccount();
+		return refreshToken(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");
+		Response response = request.get(String.format(sns_token_refresh_uri,
+				appId, refreshToken));
+
+		return response.getAsObject(new TypeReference<OauthToken>() {
+		});
+	}
+
+	/**
+	 * 验证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 {
+			request.get(String.format(sns_auth_token_uri, accessToken, openId));
+			return true;
+		} catch (WeixinException e) {
+			;
+		}
+		return false;
+	}
+
+	/**
+	 * oauth获取用户信息
+	 * 
+	 * @param token
+	 *            授权票据
+	 * @return 用户对象
+	 * @throws WeixinException
+	 * @see <a
+	 *      href="http://mp.weixin.qq.com/wiki/17/c0f37d5704f0b64713d5d2c37b468d75.html">拉取用户信息</a>
+	 * @see com.foxinmy.weixin4j.mp.model.User
+	 * @see com.foxinmy.weixin4j.mp.model.OauthToken
+	 * @see {@link com.foxinmy.weixin4j.mp.api.UserApi#getOauthToken(String)}
+	 */
+	public User getUser(OauthToken token) throws WeixinException {
+		String user_info_uri = getRequestUri("sns_user_info_uri");
+		Response response = request.get(String.format(user_info_uri,
+				token.getAccessToken(), token.getOpenid()));
+
+		return response.getAsObject(new TypeReference<User>() {
+		});
+	}
+}