小程序开发流程(java后端)

一、准备工作

1、参考https://mp.weixin.qq.com/debug/wxadoc/dev/?t=1476434677599 先注册账号；

2、下载官网前端开发工具 https://mp.weixin.qq.com/debug/wxadoc/dev/devtools/download.html?t=1476434678461

3、其他的接口及文档请参考 https://mp.weixin.qq.com/debug/wxadoc/introduction/index.html?t=2018125

二、java后端

1、先去github下载sdk https://github.com/Wechat-Group/weixin-java-tools

2、demo参考 https://github.com/binarywang/weixin-java-miniapp-demo 注： 此demo是采用了jdk8和spring boot开发的。

三、本人折腾过程

我本地是采用jdk7,spring mvc和mybatis的搭建框架；

1、在resources/properties新增wxconfig.properties文件，用于配置

appid=填写自己注册的小程序
appsecret=密钥（通过获取或是重置方式取到，在客服消息转发需要用）
token=自己定义
aeskey=加密
templateId=推送消息模块ID,也是自己在小程序后台-->模板消息中获取；
msgDataFormat=JSON （传送的格式还有或者是XML）
domain=推送模板消息时，如需要点详情时（因为开发小程序有可能是有开发或线上二个域名的）
detail=详情的链接，和在app.json中配置的一样

2、新增一类来加载此配置文件并读取相关的内容到静态变量中；

import org.apache.log4j.Logger;

import java.util.ResourceBundle;

/**
* @author foreach03
* @company 深圳市
* @create 2018/1/10 13:31
*/
public class WxConfigUtils {
private static Logger log = Logger.getLogger(WxConfigUtils.class);
private static String appid;
private static String appsecret;
private static String token;
private static String aeskey;
private static String templateId;
private static String msgDataFormat;
private static String domain;
private static String detail;

private WxConfigUtils(){

}
static {
// 加载wxcofig配置文件
ResourceBundle bundle = ResourceBundle.getBundle("properties/wxconfig");
if (bundle == null) {
throw new IllegalArgumentException(
"[wxcofig.properties] is not found!");
}
appid = bundle.getString("appid");
appsecret = bundle.getString("appsecret");
token = bundle.getString("token");
aeskey = bundle.getString("aeskey");
templateId = bundle.getString("templateId");
msgDataFormat = bundle.getString("msgDataFormat");
domain = bundle.getString("domain");
detail = bundle.getString("detail");

log.info("appid is:" + appid);
log.info("appsecret is:" + appsecret);
log.info("token is:" + token);
log.info("aeskey is:" + aeskey);
log.info("templateId is:" + templateId);
log.info("msgDataFormat is:" + msgDataFormat);
log.info("domain is:" + domain);
log.info("detail is:" + detail);
}

public static String getAppid() {
return appid;
}

public static void setAppid(String appid) {
WxConfigUtils.appid = appid;
}

public static String getAppsecret() {
return appsecret;
}

public static void setAppsecret(String appsecret) {
WxConfigUtils.appsecret = appsecret;
}

public static String getToken() {
return token;
}

public static void setToken(String token) {
WxConfigUtils.token = token;
}

public static String getAeskey() {
return aeskey;
}

public static void setAeskey(String aeskey) {
WxConfigUtils.aeskey = aeskey;
}

public static String getTemplateId() {
return templateId;
}

public static void setTemplateId(String templateId) {
WxConfigUtils.templateId = templateId;
}

public static String getMsgDataFormat() {
return msgDataFormat;
}

public static void setMsgDataFormat(String msgDataFormat) {
WxConfigUtils.msgDataFormat = msgDataFormat;
}

public static String getDomain() {
return domain;
}

public static void setDomain(String domain) {
WxConfigUtils.domain = domain;
}

public static String getDetail() {
return detail;
}

public static void setDetail(String detail) {
WxConfigUtils.detail = detail;
}

}

3、新增一个常量类WXMPConfig，其实也可以不用此类。

/**
* @author foreach03
* @company 深圳市
* @create 2018/1/10 13:37
*/
public class WXMPConfig {
// 服务号常量定义
public static final String APPID = WxConfigUtils.getAppid();//测试
public static final String APPSECRET = WxConfigUtils.getAppsecret();
public static final String TOKEN =WxConfigUtils.getToken();
public static final String ENCODINGAESKEY =WxConfigUtils.getAeskey();
public static final String TEMPLATEID = WxConfigUtils.getTemplateId();
public static final String MSGDATAFORMAT = WxConfigUtils.getMsgDataFormat();
public static final String DOMAIN = WxConfigUtils.getDomain();
public static final String DETAIL = WxConfigUtils.getDetail();

private WXMPConfig(){

}
}

4、新建一个工厂类WxMpServiceFactory，用于初始化maservice

import cn.binarywang.wx.miniapp.api.WxMaService;
import cn.binarywang.wx.miniapp.api.impl.WxMaServiceImpl;
import cn.binarywang.wx.miniapp.config.WxMaInMemoryConfig;
import cn.binarywang.wx.miniapp.message.WxMaMessageRouter;
import com.***.config.constant.WXMPConfig;

/**
* @author
* @company 深圳市
* @create 2018/1/10 13:25
*/
public class WxMpServiceFactory {
private static WxMaService instance;

private static WxMaInMemoryConfig wxMaConfigStorage;
private static WxMaMessageRouter router = new WxMaMessageRouter(getInstance());
private WxMpServiceFactory() {
// ......
}

// 产生WxmaService实例
public static WxMaService getInstance() {
if(wxMaConfigStorage == null){
wxMaConfigStorage = new WxMaInMemoryConfig();
wxMaConfigStorage.setAppid(WXMPConfig.APPID);
wxMaConfigStorage.setSecret(WXMPConfig.APPSECRET);
wxMaConfigStorage.setToken(WXMPConfig.TOKEN);
wxMaConfigStorage.setAesKey(WXMPConfig.ENCODINGAESKEY);
wxMaConfigStorage.setMsgDataFormat(WXMPConfig.MSGDATAFORMAT);
}

if (instance == null) {
instance = new WxMaServiceImpl();
instance.setWxMaConfig(wxMaConfigStorage);
}

return instance;
}

public static WxMaInMemoryConfig getWxMaConfigStorage() {
return wxMaConfigStorage;
}

public static void setWxMaConfigStorage(WxMaInMemoryConfig wxMpConfigStorage) {
WxMpServiceFactory.wxMaConfigStorage = wxMpConfigStorage;
}

public static void setInstance(WxMaService instance) {
WxMpServiceFactory.instance = instance;
}

public static WxMaMessageRouter getRouter() {
return router;
}

public static void setRouter(WxMaMessageRouter router) {
WxMpServiceFactory.router = router;
}

}

5、这样在controller类上就可以通过

private WxMaService wxService= WxMpServiceFactory.getInstance(); 来初始化；

6、如需要发送模板消息的

这里需要注意的是：formid只能提交的那openId才可以使用；

如果想推送很多的消息的话，那就让前端更可能的收集多一些formId

wxService.getMsgService().sendTemplateMsg(WxMaTemplateMessage.builder()
.templateId(自己配置的模板ID)
.formId(前端提交的formId)
.data(datalist)
.toUser(要推送的openid)
.page(就是域名+detail了)
.build());

7、关于一些跳坑的案例，可以参考 http://blog.csdn.net/qq_38530880/article/details/72930341