微信公眾號平臺專案開發
阿新 • • 發佈：2018-11-14
什麼是微信公眾平臺
微信公眾號主要面向名人、政府、媒體、企業等機構推出的合作推廣業務。在這裡可以通過微信渠道將品牌推廣給上億的微信使用者，減少宣傳成本，提高品牌知名度，打造更具影響力的品牌形象。
初始微信公眾平臺
官方網址
https://mp.weixin.qq.com/cgi-bin/loginpage?t=wxm2-login&lang=zh_CN
帳號分類
微信公眾平臺介紹
訊息管理
使用者管理
素材管理
基本設定
伺服器配置(未啟用)
啟用並設定伺服器配置後，使用者發給公眾號的訊息以及開發者需要的事件推送，將被微信轉發到該URL中
外網對映工具
Ngrok使用
●windows使用者:
1,下載windows版本的客戶端，解壓到你喜歡的目錄
2,在命令列下進入到path/to/windows_386/下
3,執行 ngrok -config=ngrok.cfg -subdomain xxx 80 //(xxx 是你自定義的域名字首)
4,如果開啟成功 你就可以使用 xxx.tunnel.qydev.com 來訪問你本機的 127.0.0.1:80 的服務啦
5,如果你自己有頂級域名，想通過自己的域名來訪問本機的專案，那麼先將自己的頂級域名解析到123.57.165.240(域名需要已備案哦)，然後執行./ngrok -config=ngrok.cfg -hostname xxx.xxx.xxx 80 //(xxx.xxx.xxx是你自定義的頂級域名)
6，如果開啟成功 你就可以使用你的頂級域名來訪問你本機的 127.0.0.1:80 的服務啦
Natapp使用
windows ,點選開始->執行->命令列提示符 後進入 natapp.exe的目錄
執行 natapp -authtoken= 175396706488ac93
公眾測試平臺
因為是非認證公眾號，部分許可權不足，建議大家測試中使用公眾測試平臺。
https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login
微信環境搭建
相關依賴
itmayiedu-shopp-parent 新增
<dependency>
<groupId>dom4j</groupId>
<artifactId>dom4j</artifactId>
</dependency>
<dependency>
<groupId>org.glassfish.jersey.core</groupId>
<artifactId>jersey-server</artifactId>
</dependency>
配置檔案
application.yml
server:
port: 81
# context-path: /web
eureka:
client:
serviceUrl:
defaultZone: http://localhost:8761/eureka/
spring:
application:
name: weixin
微信事件通知驗證
https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421135319
開發者提交資訊後，微信伺服器將傳送GET請求到填寫的伺服器地址URL上，GET請求攜帶引數如下表所示：
工具類
CheckUtil
public class CheckUtil {
public static final String tooken = "itmayiedu"; // 開發者自行定義Tooken
public static boolean checkSignature(String signature, String timestamp, String nonce) {
// 1.定義陣列存放tooken，timestamp,nonce
String[] arr = { tooken, timestamp, nonce };
// 2.對陣列進行排序
Arrays.sort(arr);
// 3.生成字串
StringBuffer sb = new StringBuffer();
for (String s : arr) {
sb.append(s);
}
// 4.sha1加密,網上均有現成程式碼
String temp = getSha1(sb.toString());
// 5.將加密後的字串，與微信傳來的加密簽名比較，返回結果
return temp.equals(signature);
}
public static String getSha1(String str) {
if (str == null || str.length() == 0) {
return null;
}
char hexDigits[] = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f' };
try {
MessageDigest mdTemp = MessageDigest.getInstance("SHA1");
mdTemp.update(str.getBytes("UTF-8"));
byte[] md = mdTemp.digest();
int j = md.length;
char buf[] = new char[j * 2];
int k = 0;
for (int i = 0; i < j; i++) {
byte byte0 = md[i];
buf[k++] = hexDigits[byte0 >>> 4 & 0xf];
buf[k++] = hexDigits[byte0 & 0xf];
}
return new String(buf);
} catch (Exception e) {
return null;
}
}
}XmlUtils
public class XmlUtils {
/**
* 解析微信發來的請求（XML）
*
* @param request
* @return Map<String, String>
* @throws Exception
*/
@SuppressWarnings("unchecked")
public static Map<String, String> parseXml(HttpServletRequest request) throws Exception {
// 將解析結果儲存在HashMap中
Map<String, String> map = new HashMap<String, String>();
// 從request中取得輸入流
InputStream inputStream = request.getInputStream();
// 讀取輸入流
SAXReader reader = new SAXReader();
Document document = reader.read(inputStream);
// 得到xml根元素
Element root = document.getRootElement();
// 得到根元素的所有子節點
List<Element> elementList = root.elements();
// 遍歷所有子節點
for (Element e : elementList)
map.put(e.getName(), e.getText());
// 釋放資源
inputStream.close();
inputStream = null;
return map;
}
/**
* 文字訊息物件轉換成xml
*
* @param textMessage
* 文字訊息物件
* @return xml
*/
public static String messageToXml(TextMessage textMessage) {
xstream.alias("xml", textMessage.getClass());
return xstream.toXML(textMessage);
}
/**
* 擴充套件xstream使其支援CDATA
*/
private static XStream xstream = new XStream();
}
JSONObject
// 呼叫第三方智慧介面
String resultStr = HttpClientUtil
.doGet("http://api.qingyunke.com/api.php?key=free&appid=0&msg=" + content);
JSONObject jsonObject = new JSONObject().parseObject(resultStr);
Integer integer = jsonObject.getInteger("result");
if (integer == null || integer != 0) {
textMessage = setTextMessage("親,系統出錯啦!", toUserName, fromUserName);
} else {
String result = jsonObject.getString("content");
textMessage = setTextMessage(result, toUserName, fromUserName);
}HttpClientUtil
public class HttpClientUtil {
public static String doGet(String url, Map<String, String> param) {
// 建立Httpclient物件
CloseableHttpClient httpclient = HttpClients.createDefault();
String resultString = "";
CloseableHttpResponse response = null;
try {
// 建立uri
URIBuilder builder = new URIBuilder(url);
if (param != null) {
for (String key : param.keySet()) {
builder.addParameter(key, param.get(key));
}
}
URI uri = builder.build();
// 建立http GET請求
HttpGet httpGet = new HttpGet(uri);
// 執行請求
response = httpclient.execute(httpGet);
// 判斷返回狀態是否為200
if (response.getStatusLine().getStatusCode() == 200) {
resultString = EntityUtils.toString(response.getEntity(), "UTF-8");
}
} catch (Exception e) {
e.printStackTrace();
} finally {
try {
if (response != null) {
response.close();
}
httpclient.close();
} catch (IOException e) {
e.printStackTrace();
}
}
return resultString;
}
public static String doGet(String url) {
return doGet(url, null);
}
public static String doPost(String url, Map<String, String> param) {
// 建立Httpclient物件
CloseableHttpClient httpClient = HttpClients.createDefault();
CloseableHttpResponse response = null;
String resultString = "";
try {
// 建立Http Post請求
HttpPost httpPost = new HttpPost(url);
// 建立引數列表
if (param != null) {
List<NameValuePair> paramList = new ArrayList<>();
for (String key : param.keySet()) {
paramList.add(new BasicNameValuePair(key, param.get(key)));
}
// 模擬表單
UrlEncodedFormEntity entity = new UrlEncodedFormEntity(paramList);
httpPost.setEntity(entity);
}
// 執行http請求
response = httpClient.execute(httpPost);
resultString = EntityUtils.toString(response.getEntity(), "utf-8");
} catch (Exception e) {
e.printStackTrace();
} finally {
try {
response.close();
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
return resultString;
}
public static String doPost(String url) {
return doPost(url, null);
}
public static String doPostJson(String url, String json) {
// 建立Httpclient物件
CloseableHttpClient httpClient = HttpClients.createDefault();
CloseableHttpResponse response = null;
String resultString = "";
try {
// 建立Http Post請求
HttpPost httpPost = new HttpPost(url);
// 建立請求內容
StringEntity entity = new StringEntity(json, ContentType.APPLICATION_JSON);
httpPost.setEntity(entity);
// 執行http請求
response = httpClient.execute(httpPost);
resultString = EntityUtils.toString(response.getEntity(), "utf-8");
} catch (Exception e) {
e.printStackTrace();
} finally {
try {
response.close();
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
return resultString;
}
}BaseMessage
@Getter
@Setter
public class BaseMessage {
/**
* 開發者微信
*/
private String ToUserName;
/**
* 傳送方openid
*/
private String FromUserName;
/**
* 建立時間
*/
private long CreateTime;
/**
* 內容型別
*/
private String MsgType;
// /**
// * 訊息id
// */
// private long MsgId ;
}
TextMessage
@Getter
@Setter
public class TextMessage extends BaseMessage {
private String Content;
}
DispatCherServlet
@Slf4j
@RestController
public class DispatCherServlet {
private static final String REQEST_HTTP = "http://api.qingyunke.com/api.php?key=free&appid=0&msg=";
@RequestMapping(value = "/dispatCherServlet", method = RequestMethod.GET)
public String dispatCherServletGet(String signature, String timestamp, String nonce, String echostr) {
// 1.驗證是否微信來源
boolean checkSignature = CheckUtil.checkSignature(signature, timestamp, nonce);
// 2.如果是微信來源 返回 隨機數echostr
if (!checkSignature) {
return null;
}
return echostr;
}
@RequestMapping(value = "/dispatCherServlet", method = RequestMethod.POST)
public void dispatCherServletPost(HttpServletRequest reqest, HttpServletResponse response) throws Exception {
reqest.setCharacterEncoding("UTF-8");
response.setCharacterEncoding("UTF-8");
Map<String, String> mapResult = XmlUtils.parseXml(reqest);
if (mapResult == null) {
return;
}
String msgType = mapResult.get("MsgType");
PrintWriter writer = response.getWriter();
switch (msgType) {
case "text":
// 獲取訊息內容
String content = mapResult.get("Content");
// 傳送訊息
String toUserName = mapResult.get("ToUserName");
// 來自訊息
String fromUserName = mapResult.get("FromUserName");
// 呼叫智慧機器人介面
String requestResultJson = HttpClientUtil.doGet(REQEST_HTTP + content);
JSONObject jsonObject = new JSONObject().parseObject(requestResultJson);
String result = jsonObject.getString("result");
String msg = null;
if (result.equals("0")) {
msg = jsonObject.getString("content");
} else {
msg = "我也不知道回答什麼！";
}
String resultTestMsg = setTextMess(msg, toUserName, fromUserName);
writer.print(resultTestMsg);
break;
default:
break;
}
writer.close();
}
public String setTextMess(String content, String fromUserName, String toUserName) {
TextMessage textMessage = new TextMessage();
textMessage.setFromUserName(fromUserName);
textMessage.setToUserName(toUserName);
textMessage.setContent(content);
textMessage.setMsgType("text");
textMessage.setCreateTime(new Date().getTime());
String messageToXml = XmlUtils.messageToXml(textMessage);
log.info("####setTextMess()###messageToXml:" + messageToXml);
return messageToXml;
}
}青雲客智慧聊天機器人API
智慧機器人API介面說明
支援功能：天氣、翻譯、藏頭詩、笑話、歌詞、計算、域名資訊/備案/收錄查詢、IP查詢、手機號碼歸屬、人工智慧聊天
介面地址：http://api.qingyunke.com/api.php?key=free&appid=0&msg=關鍵詞
key 固定引數free
appid 設定為0，表示智慧識別，可忽略此引數
msg 關鍵詞，請參考下方引數示例，該引數可智慧識別，該值請經過 urlencode 處理後再提交
返回結果：{"result":0,"content":"內容"}
result 狀態，0表示正常，其它數字表示錯誤
content 資訊內容
使用第三方框架開發微信公眾號
weixin-java-tools
https://github.com/wechat-group/weixin-java-tools
微信訊息模板介面
概述
模板訊息僅用於公眾號向用戶傳送重要的服務通知，只能用於符合其要求的服務場景中，如信用卡刷卡通知，商品購買成功通知等。不支援廣告等營銷類訊息以及其它所有可能對使用者造成騷擾的訊息。
參考網址: https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433751277
程式碼
@RestController
@RequestMapping("/weiXin")
public class WeiXinCatController {
@Autowired
private WxMpService wxService;
@RequestMapping("/sendTemplate")
public String createWeiXinCat(@RequestBody WxMpTemplateMessage wxMpTemplateMessage) throws WxErrorException {
WxMpTemplateMsgService templateMsgService = wxService.getTemplateMsgService();
return templateMsgService.sendTemplateMsg(wxMpTemplateMessage);
}
}
引數
請求地址http://127.0.0.1:81/weiXin/sendTemplate
{
"toUser": "okYSmt0cItTc4dZXFn43BbmYW8Rw",
"templateId": "eLozPgRNCPMEgOWGHwNW6cXkfrVqtsyDsyEwVabu0ww",
"url": "http://www.itmayiedu.com",
"data": [
{
"name": "first",
"value": "2017年11月06日 23:32",
"color": "#173177"
},
{
"name": "keyword1",
"value": "30",
"color": "#173177"
},
{
"name": "keyword2",
"value": "201410515111522",
"color": "#173177"
}
]
}
網頁授權
參考文章: https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140842
Http協議轉碼
UrlEnCode與UrlDeCode
有些符號在URL中是不能直接傳遞的，如果要在URL中傳遞這些特殊符號，那麼就要使用他們的編碼了。編碼的格式為：%加字元的ASCII碼，即一個百分號%，後面跟對應字元的ASCII（16進位制）碼值。例如 空格的編碼值是"%20"。
下表中列出了一些URL特殊符號及編碼
:替換為%3A
1. + URL 中+號表示空格 %2B
2. 空格 URL中的空格可以用+號或者編碼 %20
3. / 分隔目錄和子目錄 %2F
4. ? 分隔實際的 URL 和引數 %3F
5. % 指定特殊字元 %25
6. # 表示書籤 %23
7. & URL 中指定的引數間的分隔符 %26
8. = URL 中指定引數的值 %3D
@RequestMapping("/test")
public String test(String name) {
System.out.println("name:" + name);
return "test" + name;
}
public static void main(String[] args) {
String userNameEncode = URLEncoder.encode("yusheng+jun");
System.out.println("userNameEncode:" + userNameEncode);
String userNameDecode = URLDecoder.decode(userNameEncode);
System.out.println("userNameDecode:" + userNameDecode);
}