基于spring-boot的社区社交微信小程序，适合做脚手架、二次开发
1 概述
笔者做的一个后端基于spring-boot的社区社交微信小程序，可以作为开发的脚手架，开发速度快，灵活，前后端分离，很适合二次开发。数据主要存储在MySQL上，笔者封装了一个MysqlGenerator.java工具类，结合spring jdbc，做数据库操作很方便。另外提供了一个文档系统，后端人员产出接口直接写出markdown文件就行，和前端沟通很方便。
2 详细
笔者所在的小区有很多居民，我觉得可以提供一个平台给大家，方便进行信息共享、闲置买卖等，也提供一些常用便民工具，例如电话查询，交通信息查询，另外一些商家也可以发布自己的服务让更多人知晓，例如汽车年审，废品回收，特产，搬家服务等。
笔者做的这个后端，是基于spring-boot的，主要特点如下：
- 方便开发部署，支持一键发布，配置好git之后发送一个http请求,就执行一个脚本，自动拉取最新代码并发布，脚本都在工程根目录。
- 自建文档系统，直接写markdown文件丢进指定文件夹即可，方便给前端人员查阅（暂未做登录验证，请注意保护文档地址url不泄露）。
- spring jdbc封装，数据库操作便捷，会写sql就能做后端业务，方便修改排查问题，速度快，方便性能调优（工具类MysqlGenerator.java源码也简单，可以根据自己业务情况做修改）。
3 配置说明
3-1 环境、物料准备
1.微信小程序账号
2.腾讯COS平台账号（我们图片存在这里，50G免费）
3.Java8，maven 3.5+，Git，MySQL 5.6+，Redis 3.2+
4.微信Web开发者工具（用于调试小程序代码）-> 微信小程序开发文档
3-2 工程目录
4 配置
4-1 账号配置
4-2 一键部署配置
首先要配置好Git，把代码上传到你的仓库，并切换到分支dev，然后请求http接口http://host:port/common/shell/pullrun，会自动运行脚本pullrun.sh,该脚本会拉取最新代码并重新部署,具体原理请查阅pullrun.sh内容及src/main/java/com/shop/modules/apicommon/controller/CommonController.runScript()方法
5 功能说明
5-1 工具类MysqlGenerator.java的使用
5-1-1 开发前准备
5-1-1-0 建表
在MySQL数据库中建好表，例如一个cuser表，有id,login_name,nickname字段。
5-1-1-0 编写2种Java Bean
一种是普通的bean，用于返回结果或其他一般用途，另一种是特殊的bean，用于接收请求参数，配合MysqlGenerator工具类生产sql语句。
特殊bean主要是putter方法特殊，举例如下
package com.shop.beans.param;
import java.io.Serializable;
import com.shop.beans.basic.MyParams;
public class ParamCUser extends MyParams implements Serializable {
// id,login_name,nickname
private static final long serialVersionUID = 1L;
private int id;
private String login_name;
private String nickname;
//getter
public int getId() {
return id;
}
public String getLogin_name() {
return login_name;
}
public String getNickname() {
return nickname;
}
//setter
public void setId(int id) {
put("id",id);
this.id = id;
}
public void setLogin_name(String login_name) {
put("login_name",login_name);
this.login_name = login_name;
}
public void setNickname(String nickname) {
put("nickname",nickname);
this.nickname = nickname;
}
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
sb.append(getClass().getSimpleName());
sb.append(" [");
sb.append("Hash = ").append(hashCode());
sb.append(", id=").append(id);
sb.append(", login_name=").append(login_name);
sb.append(", nickname=").append(nickname);
sb.append(", serialVersionUID=").append(serialVersionUID);
sb.append("]");
return sb.toString();
}
}
这种特殊的bean，可以手写，也可以使用这个工具，可以根据mysql表直接生成，非常方便，具体请查看开源项目：JavaBeanGenerator
5-1-2 增
有了特殊的bean，从Controller中接收了参数之后，就可以开始开发了，有3种新增的方式，请查阅例子
@Autowired
private UserDao dao;
/**
*
* @param cuser 特殊bean
* @return
*/
public JsonBase addCUser(ParamCUser cuser){
cuser.setCreate_time(DateUtil.getCurrentTimestamp());//特殊bean可以像普通bean那样set值
cuser.setLast_login_time(DateUtil.getCurrentTimestamp());
// allFieldsInsertSQL，所有字段都会插入
String sql = MysqlGenerator.allFieldsInsertSQL(cuser, TableName.C_USER);
// 除去指定字段插入，第三个参数指定即可，多个字段可以用英文逗号隔开
String sql2 = MysqlGenerator.exceptFieldsInsertSQL(cuser, TableName.C_USER, "id,login_name");
// 指定字段插入，第三个参数指定即可，多个可以用英文逗号隔开
String sql3 = MysqlGenerator.specificFieldsInsertSQL(cuser, TableName.C_USER, "id,login_name,nickname");
Debugger.so(sql);
Debugger.so(sql2);
Debugger.so(sql3);
int reInt = dao.insert(sql, cuser.getParams());
return reInt > 0 ? CM.getReturnInfo("新增成功") : CM.getFailInfo(CS.UNCONFIRM_ERROR, "新增失败");
}
5-1-3 删
根据id去删，不怕把整个表都删了，支持根据多个字段删除，具体原理可以直接看源码，很容易理解。
/**
*
* @param paramPostLike 特殊bean
* @return
*/
public JsonBase remove_like(ParamPostLike paramPostLike) {
String sql = MysqlGenerator.deleteSQL(TableName.POST_LIKE, "openid,post_id");
int ret = dao.delete(sql, paramPostLike.getParams());
return ret > 0 ? CM.getReturnInfo("unlike ok") : CM.getFailInfo(CS.UNCONFIRM_ERROR, "unlike 失败");
}
5-1-4 改
具体参数和用法可以直接看方法源码，很容易理解
//所以字段都更新
MysqlGenerator.allFieldsUpdateSQL()
//指定字段更新
MysqlGenerator.specificFieldsUpdateSQL()
//出去某字段，其余都更新
MysqlGenerator.exceptFieldsUpdateSQL()
5-1-5 查
我们查询主要靠手写，可以在Navicat或者类似工具上编写好，复制到代码里，如果不想写太多字符串拼接，可以用@Multiline注解,这样就可以在注释里使用多行文本了
/**
SELECT cm.*, cu.`nickname`, cu.`avatar`
FROM post_comment AS cm
LEFT JOIN c_user AS cu ON (cu.`openid` = cm.`from_openid`)
WHERE 1=1
AND cm.to_post_id = :to_post_id AND cm.to_comment_id = 0
ORDER BY cm.create_time DESC
*/
@Multiline private String GET_COMMENTS_BY_ID;
编写好查询sql之后，直接调用spring-jdbc的方法就可以查询了。
微信小程序配置
工程名shop-mp,如果需要发布小程序,需要有https证书，就需要配置好服务器域名，登录小程序账号之后，在【设置】-【开发设置】下找到。需要配置模板消息的话，还要自己申请一下模块消息。预览的话可以直接使用微信的【微信Web开发者工具】打开即可，主要需要配置好请求的地址url，在小程序/shop-mp/config/global_config.js里配置。
// 开发状态
const isDebug = false;
// const localhost = '127.0.0.1';
const localhost = '192.168.1.161';
module.exports = {
isDebug: isDebug,
//版本号。
VERSION_CODE: 44,
//签名的字符串
SIGN_KEY: 'foobar',
// A用户（小区）id，每个小区有一个id
AUSER_ID: 1,
// 小程序码的链接
MPCODE_URL: 'http://wx2.sinaimg.cn/mw690/8f8f5f45gy1fr5xyj7im8j2076076q43.jpg',
// 小程序web-view URL业务域名
BUSINESS_DOMAIN: 'xxx.com',
//这里配置为你的url，本地就localhost
URL_BASE: isDebug ? 'http://' + localhost +':8000' : 'https://xxxxxxxx'
}
5-2 文档系统的使用
把编写好的markdown文件丢进apidoc/md里面就行了，工程部署之后可以在http://host:port/apidoc/yourdocname.html查看，支持子文件夹，记得修改文档的名称，防止url泄露。有时间也可以做一个验证。
6 项目展示
6-1 顺碧小圈-微信小程序
6-2 文档模块效果图
7 联系作者
基于spring-boot的社区社交微信小程序，适合做脚手架、二次开发
注：本文著作权归作者，由demo大师代发，拒绝转载，转载需要作者授权