基于spring-boot的社区社交微信小程序,适合做脚手架、二次开发

时间:2023-03-09 02:33:13
基于spring-boot的社区社交微信小程序,适合做脚手架、二次开发

基于spring-boot的社区社交微信小程序,适合做脚手架、二次开发

代码地址如下:
http://www.demodashi.com/demo/13867.html

1 概述

笔者做的一个后端基于spring-boot的社区社交微信小程序,可以作为开发的脚手架,开发速度快,灵活,前后端分离,很适合二次开发。数据主要存储在MySQL上,笔者封装了一个MysqlGenerator.java工具类,结合spring jdbc,做数据库操作很方便。另外提供了一个文档系统,后端人员产出接口直接写出markdown文件就行,和前端沟通很方便。

2 详细

笔者所在的小区有很多居民,我觉得可以提供一个平台给大家,方便进行信息共享、闲置买卖等,也提供一些常用便民工具,例如电话查询,交通信息查询,另外一些商家也可以发布自己的服务让更多人知晓,例如汽车年审,废品回收,特产,搬家服务等。

笔者做的这个后端,是基于spring-boot的,主要特点如下:

  1. 方便开发部署,支持一键发布,配置好git之后发送一个http请求,就执行一个脚本,自动拉取最新代码并发布,脚本都在工程根目录。
  2. 自建文档系统,直接写markdown文件丢进指定文件夹即可,方便给前端人员查阅(暂未做登录验证,请注意保护文档地址url不泄露)。
  3. 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 工程目录

基于spring-boot的社区社交微信小程序,适合做脚手架、二次开发

4 配置

4-1 账号配置

基于spring-boot的社区社交微信小程序,适合做脚手架、二次开发

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 顺碧小圈-微信小程序

基于spring-boot的社区社交微信小程序,适合做脚手架、二次开发

6-2 文档模块效果图

基于spring-boot的社区社交微信小程序,适合做脚手架、二次开发

7 联系作者

基于spring-boot的社区社交微信小程序,适合做脚手架、二次开发

基于spring-boot的社区社交微信小程序,适合做脚手架、二次开发

代码地址如下:
http://www.demodashi.com/demo/13867.html

注:本文著作权归作者,由demo大师代发,拒绝转载,转载需要作者授权