正題:
首先要有一個公眾號和已經備案好的域名! (現在微信限制了域名,一定要已經備好案的域名,以前可以用外網穿透的方式做測試,現在外網穿透用不了,至於,怎么測試,各位就自行解決)
1.配置JS回調域名
2. 獲取appId和appsecret
3. 從官方代碼copy簽名函數
4. 獲取access_token、ticket
5. 獲取url,並進行簽名
6. 集成進java web
7. 前端config函數配置
1):要設置這個域名,里面需要把那個微信提供的 .txt 文本放到項目里面,只要你的域名,能找到這個文件,就可以了
2):獲取AppID , AppSecret
3):官方上面有相應的簽名代碼,咋們去下載下來就行了
進入官方文檔 https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421141115 拉到最下面,看下圖,就能下載了
解壓出來,你胡發現,里面有一些其他的語言的簽名代碼,我們只需要我們大 java 的就可以了,里面只有一個文件,放到我的項目里面,放進去之后,我們還添加了兩個java文件,這兩個文件,我們等會會用到,下面會詳解,我們先看看微信的簽名代碼
import java.util.UUID; import java.util.Map; import java.util.HashMap; import java.util.Formatter; import java.security.MessageDigest; import java.security.NoSuchAlgorithmException; import java.io.UnsupportedEncodingException; public class Sign { /*public static void main(String[] args) { String jsapi_ticket = "jsapi_ticket"; // 注意 URL 一定要動態獲取,不能 hardcode String url = "http://example.com"; Map<String, String> ret = sign(jsapi_ticket, url); for (Map.Entry entry : ret.entrySet()) { System.out.println(entry.getKey() + ", " + entry.getValue()); } };*/ public static Map<String, String> sign(String jsapi_ticket, String url) { Map<String, String> ret = new HashMap<String, String>(); String nonce_str = create_nonce_str(); String timestamp = create_timestamp(); String string1; String signature = ""; //注意這里參數名必須全部小寫,且必須有序 string1 = "jsapi_ticket=" + jsapi_ticket + "&noncestr=" + nonce_str + "×tamp=" + timestamp + "&url=" + url; System.out.println(string1); try { MessageDigest crypt = MessageDigest.getInstance("SHA-1"); crypt.reset(); crypt.update(string1.getBytes("UTF-8")); signature = byteToHex(crypt.digest()); } catch (NoSuchAlgorithmException e) { e.printStackTrace(); } catch (UnsupportedEncodingException e) { e.printStackTrace(); } ret.put("url", url); ret.put("jsapi_ticket", jsapi_ticket); ret.put("nonceStr", nonce_str); ret.put("timestamp", timestamp); ret.put("signature", signature); return ret; } // 生成簽名 private static String byteToHex(final byte[] hash) { Formatter formatter = new Formatter(); for (byte b : hash) { formatter.format("%02x", b); } String result = formatter.toString(); formatter.close(); return result; } // 生成nonceStr private static String create_nonce_str() { return UUID.randomUUID().toString(); } // 生成timestamp private static String create_timestamp() { return Long.toString(System.currentTimeMillis() / 1000); } }
4): 獲取access_token、ticket
建立一個WeinXinUtil類,如下,里面的getAccessToken方法和getTicket方法分別獲取access_token、ticket, getWinXinEntity方法后面再說
這里有兩個點需要注意一下:
1:我沒有添加包名,各位copy下去注意一下就行了
2:WeinXinUtil.java 這個文件需要引入的是 import net.sf.json.JSONObject ,不要弄錯了,有些人引入了之后,發現也是會報錯,原因就是這個包是有其他依賴的,我用的是 Maven ,只要添加下面的就可以了。用 jar 的,自己解決
<!-- https://mvnrepository.com/artifact/org.apache.commons/commons-lang3 --> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-lang3</artifactId> <version>3.6</version> </dependency> <!-- https://mvnrepository.com/artifact/commons-beanutils/commons-beanutils --> <dependency> <groupId>commons-beanutils</groupId> <artifactId>commons-beanutils</artifactId> <version>1.9.2</version> </dependency> <!-- https://mvnrepository.com/artifact/org.apache.commons/commons-collections4 --> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-collections4</artifactId> <version>4.1</version> </dependency> <!-- https://mvnrepository.com/artifact/commons-logging/commons-logging --> <dependency> <groupId>commons-logging</groupId> <artifactId>commons-logging</artifactId> <version>1.2</version> </dependency> <!-- https://mvnrepository.com/artifact/net.sf.ezmorph/ezmorph --> <dependency> <groupId>net.sf.ezmorph</groupId> <artifactId>ezmorph</artifactId> <version>1.0.6</version> </dependency> <!-- https://mvnrepository.com/artifact/net.sf.json-lib/json-lib --> <dependency> <groupId>net.sf.json-lib</groupId> <artifactId>json-lib</artifactId> <version>2.4</version> <classifier>jdk15</classifier> <!-- 看這里,去maven倉庫找加載這個包的時候,是沒有這句話的,這句話,一定要加,要不然,也是會報錯的,還有一個就是,一定要加 jdk15 加其他的也不行,不要問我為什么,我也不知到 --> </dependency>
import java.io.InputStream; import java.net.HttpURLConnection; import java.net.URL; import java.util.Map; import net.sf.json.JSONObject; public class WeinXinUtil { public static WinXinEntity getWinXinEntity(String url) { WinXinEntity wx = new WinXinEntity(); String access_token = getAccessToken(); String ticket = getTicket(access_token); Map<String, String> ret = Sign.sign(ticket, url); // System.out.println(ret.toString()); wx.setTicket(ret.get("jsapi_ticket")); wx.setSignature(ret.get("signature")); wx.setNoncestr(ret.get("nonceStr")); wx.setTimestamp(ret.get("timestamp")); System.out.println("\n\n" + ret.toString() + "\n\n"); return wx; } // 獲取token private static String getAccessToken() { String access_token = ""; String grant_type = "client_credential";// 獲取access_token填寫client_credential String AppId = "wx9fb49b49a4b335a9";// 第三方用戶唯一憑證 String secret = "a8a4dcee000ad4550d77b851685adfad";// 第三方用戶唯一憑證密鑰,即appsecret // 這個url鏈接地址和參數皆不能變 String url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=" + grant_type + "&appid=" + AppId + "&secret=" + secret; // 訪問鏈接 try { URL urlGet = new URL(url); HttpURLConnection http = (HttpURLConnection) urlGet.openConnection(); http.setRequestMethod("GET"); // 必須是get方式請求 http.setRequestProperty("Content-Type", "application/x-www-form-urlencoded"); http.setDoOutput(true); http.setDoInput(true); /* * System.setProperty("sun.net.client.defaultConnectTimeout", * "30000");// 連接超時30秒 * System.setProperty("sun.net.client.defaultReadTimeout", "30000"); * // 讀取超時30秒 */ http.connect(); InputStream is = http.getInputStream(); int size = is.available(); byte[] jsonBytes = new byte[size]; is.read(jsonBytes); String message = new String(jsonBytes, "UTF-8"); JSONObject demoJson = JSONObject.fromObject(message); access_token = demoJson.getString("access_token"); is.close(); } catch (Exception e) { e.printStackTrace(); } return access_token; } // 獲取ticket private static String getTicket(String access_token) { String ticket = null; String url = "https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=" + access_token + "&type=jsapi";// 這個url鏈接和參數不能變 try { URL urlGet = new URL(url); HttpURLConnection http = (HttpURLConnection) urlGet.openConnection(); http.setRequestMethod("GET"); // 必須是get方式請求 http.setRequestProperty("Content-Type", "application/x-www-form-urlencoded"); http.setDoOutput(true); http.setDoInput(true); System.setProperty("sun.net.client.defaultConnectTimeout", "30000");// 連接超時30秒 System.setProperty("sun.net.client.defaultReadTimeout", "30000"); // 讀取超時30秒 http.connect(); InputStream is = http.getInputStream(); int size = is.available(); byte[] jsonBytes = new byte[size]; is.read(jsonBytes); String message = new String(jsonBytes, "UTF-8"); JSONObject demoJson = JSONObject.fromObject(message); ticket = demoJson.getString("ticket"); is.close(); } catch (Exception e) { e.printStackTrace(); } return ticket; } }
5):獲取url,並進行簽名
url的獲取要特別注意,因為微信在分享時會在原來的url上加上一些&from=singlemessage、&from=…的,所以url必須要動態獲取,網上有些用ajax,在網頁通過“location.href.split(‘#’)“ 獲取url,在用ajax傳給后台,這種方法可行,但是不推薦,一方面用ajax返回,就要訪問分享的邏輯,這樣后台分享的邏輯增加復雜度,帶來不便,是代碼不易於維護,可讀性低!另一方面分享是返回頁面,而ajax是返回json,又增加了復雜度。所以,一個java程序員是不會通過ajax從前台獲取url的,這里我們用HttpRequest的方法即可,不管微信加多少后綴,都可以獲取到完整的當前url
1).獲取url的代碼如下,只給出核心代碼(代碼位於處理分享的controller中):
前后的 ... 代表是你自己的邏輯代碼,或者其他的
public String share(HttpServletRequest request) { ... String strUrl = "http://www.xxxxx.com" //換成安全域名 + request.getContextPath() //項目名稱 + request.getServletPath() //請求頁面或其他地址 + "?" + (request.getQueryString()); //參數 ... }
2).我們再新建一個存放微信信息的實體類:WinXinEntity.java
public class WinXinEntity { private String access_token; private String ticket; private String noncestr; private String timestamp; private String str; private String signature; public String getAccess_token() { return access_token; } public void setAccess_token(String access_token) { this.access_token = access_token; } public String getTicket() { return ticket; } public void setTicket(String ticket) { this.ticket = ticket; } public String getNoncestr() { return noncestr; } public void setNoncestr(String noncestr) { this.noncestr = noncestr; } public String getTimestamp() { return timestamp; } public void setTimestamp(String timestamp) { this.timestamp = timestamp; } public String getStr() { return str; } public void setStr(String str) { this.str = str; } public String getSignature() { return signature; } public void setSignature(String signature) { this.signature = signature; } }
3).簽名:
sign類里面有一個簽名的方法public static Map<String, String> sign(String jsapi_ticket, String url)
傳入ticket和url即可。也就是WeinXinUtil的getWinXinEntity方法,並將返回的map的信息讀取存入WinXinEntity 中。在調試時,把sign返回的map打印出來,主要看看生成的signature。然后,把jsapi_ticket、noncestr、timestamp、url 復制到微信提供的”微信 JS 接口簽名校驗工具“:https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=jsapisign ,比較代碼簽名生成的signature與校驗工具生成的簽名signature是否一致,如果一致,說明前面的步驟都是正確的,如果不一致,仔細檢查!
6):集成進java web
我們把微信分享分解成3個工具類,現在在處理分享的controller,只要兩句話就可以調用微信分享,一句獲取url,一句獲取WinXinEntity,下面是核心代碼:
//微信分享 String strUrl = "http://www.xxxxx.com" + request.getContextPath() //項目名稱 + request.getServletPath() //請求頁面或其他地址 + "?" + (request.getQueryString()); //參數 WinXinEntity wx = WeinXinUtil.getWinXinEntity(strUrl); //將wx的信息到給頁面 request.setAttribute("wx", wx);
7):前端config函數配置
下面的代碼放在網頁js代碼的最前面!
”var url = location.href.split(‘#’)[0];“ 頁面的url也可以從后台傳過來,也可以通過location.href.split(‘#’)[0]獲取。為了一點微不足道的速度,這里才用網頁獲取方式。(網頁的url跟前面的后台簽名時得url是一樣的,只是繞過了ajax)
下面只展示了微信朋友圈的,和微信好友的方法,剩下的,QQ,QQ空間之類的,可以到 https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421141115 這里都寫完整的了
<script src="http://res.wx.qq.com/open/js/jweixin-1.2.0.js"></script> <script> var url = location.href.split('#')[0]; wx.config({ debug: false, appId: 'xxxxxxxxxxxxxx', timestamp: "${wx.timestamp}", nonceStr: "${wx.noncestr}", signature: "${wx.signature}", jsApiList: [ // 所有要調用的 API 都要加到這個列表中 'checkJsApi', 'onMenuShareTimeline', 'onMenuShareAppMessage', ] }); wx.ready(function () { // 在這里調用 API wx.onMenuShareTimeline({ title: 'xxxxxxxxxx', // 分享標題 link: url, // 分享鏈接,該鏈接域名或路徑必須與當前頁面對應的公眾號JS安全域名一致 imgUrl: 'xxxxxxxxxxxxxx', // 分享圖標 success: function () { // 用戶確認分享后執行的回調函數 }, cancel: function () { // 用戶取消分享后執行的回調函數 } }); wx.onMenuShareAppMessage({ title: 'xxxxxxxxxxx', // 分享標題 desc: 'xxxxxxxxxxx', // 分享描述 link: url, // 分享鏈接,該鏈接域名或路徑必須與當前頁面對應的公眾號JS安全域名一致 imgUrl: 'xxxxxxxxxx', // 分享圖標 type: '', // 分享類型,music、video或link,不填默認為link dataUrl: '', // 如果type是music或video,則要提供數據鏈接,默認為空 success: function () { // 用戶確認分享后執行的回調函數 }, cancel: function () { // 用戶取消分享后執行的回調函數 } }); }); </script>
!!!!!這里java后端存到redis 頻繁從微信那取會有問題 報錯