一、文件夹说明
代码下载 地址:校园跑腿、校园脱单、代理、帮忙拿快递的微信小程序
- server 后端项目
- project： 项目
- CBD： 校园跑腿服务（校园CBD中心）
- server-app: 小程序api
- server-pc: 小程序后台管理
- service-cgs-base-service: 项目mapper公共包
- CBD： 校园跑腿服务（校园CBD中心）
- project： 项目
- web_pc： vue+elementUI： 后台管理页面
- wechat_app： 小程序
- service-admin: 后台管理的公共模块（定时任务，系统日志）
- 后台系统用户
- 登陆
- 权限
- 部门
- 角色
- service-common: 系统一些公共类
- service-email: 邮件
- service-syslog: 系统日志
- service-wx-pay: 微信支付
二、有部分是自己造的*(需要找我要jar包)
-
根 pom.xml
-
上传工具类
<dependency> <groupId>cn.yj</groupId> <artifactId>tools-upload</artifactId> <version>1.0-SNAPSHOT</version> </dependency>启用方法： App启动累加上注解：
@SpringBootApplication @Import(value = {InitUploadImportSelector.class}) public class App { public static void main(String[] args) { SpringApplication.run(App.class, args); } }支持 Minio和fasdfs 、本地方式上传，对应的配置文件：
application-upload.yml############## mino分布式图片存储 #################### file: upload-type: MINIO # MINIO、LOCAL local: path: /Users/yongjian/work/file/ # 本地上传文件到目录 host: http://127.0.0.1:${server.port}/${server.servlet.context-path}/localFile # 资源访问前缀 minio: end: point: http://thisforyou.cn:9004 point1: http://thisforyou.cn:9004 accessKey: minioadmin secretKey: 123456 bucket: cbd-dev ############## fastdfs 配置 #################### fastdfs: connect_timeout_in_seconds: 60 network_timeout_in_seconds: 60 charset: UTF-8 http_tracker_http_port: 80 http_anti_steal_token: false http_secret_key: 123456 tracker_servers: memoryoverflow.cn\:22122 -
HTTP工具类
<dependency> <groupId>cn.yj.tools</groupId> <artifactId>tools-http</artifactId> <version>${http-utils}</version> </dependency> -
Service 类的接口的参数非空校验包
<dependency> <groupId>cn.yj</groupId> <artifactId>service-params-check</artifactId> <version>${service-params-check}</version> </dependency>启用校验：启动累加上注解：@EnableCheckMethodParams
@SpringBootApplication @EnableCheckMethodParams public class App { public static void main(String[] args) { SpringApplication.run(App.class, args); } }使用方式：有两个注解
@CheckObjectValue(keyValue = @KeyValue(type = Map.class, name = {"articleNo"}))
，@Require例如：
@CheckObjectValue(keyValue = @KeyValue(type = Task.class, name = {"effectivTime", "userCode", "content", "urgentState"})) @Override public R publish(TaskVo task) { // ... }KeyValue-type:当前接口的校验类，name：当前类的要校验非空的字段
public boolean agreeComment(@Require String commentNo, @Require String userCode) { // .... }@Require 校验非空状态
-
分页组件工具
该主件事基于pageHelper的包装，不影响原有的pageHelper的使用
<dependency> <groupId>cn.yj</groupId> <artifactId>annotation-pagehelper</artifactId> <version>${annotation-pagehelper}</version> </dependency>1、在mapper接口上加上注解：
@StartPage
例如：@StartPage List<ArticleVo> findList(@Param("map") Map<String, Object> map, @Param("page") Page<? extends Article> page);mapper接口上必须要有入参：Page 对象。
service上使用：
@Override public Page<ArticleVo> listPage(Map<String, Object> params, Page<ArticleVo> page) { baseMapper.findList(params, page); return page; }2、也可以不使用注解的形式
@Override public Page<ArticleVo> listPage(Map<String, Object> params, Page<ArticleVo> page) { page.startPage(); page.setRows(baseMapper.findList(params, page)); return page; }该工具包事SpringBoot的starter自动配置包。引入即可使用。
-
-
部分基础异常类包装
<dependency> <groupId>cn.yj</groupId> <artifactId>tools-exception</artifactId> <version>${tools-exception}</version> </dependency> -
部分公共基础工具
<dependency> <groupId>cn.yj.tools</groupId> <artifactId>tools-common-utils</artifactId> <version>${tools-utils-v}</version> </dependency> -
yml文件读取工具包
<dependency> <groupId>cn.yj.tools</groupId> <artifactId>tools-read-config</artifactId> <version>${read-config}</version> </dependency>该工具类事主要提供静态方法读取 yaml,properties文件的工具。启用该工具：
@SpringBootApplication @EnableReadConfig(classLoader = App.class) public class App { public static void main(String[] args) { SpringApplication.run(App.class, args); } }工具类：
/** * <br> * <p> * 该工具类 只做读取资源文件的功能操作。 基于SpringBoot使用 * <p> * <p> * <p> * 1、工具类加载会默认读取： * <p> * <p> * <p> * 开发环境：resources/config 目录下的资源文件 其次是 resources/ * jar包环境：jar包同级目录下的 config 资源文件每其次是 jar同级的资源文件，其次是 jar包内 config资源文件，其次是 jar包内的 资源文件。 * <p> * resources/config -> resources/ * jar=config --> jar/ --> jar内的resources/config --> jar包内的resources/ * <p> * <p> * 1、默认优先加载 application.yml 资源文件 其次是yml文件。这一点与SpringBoot相似 * 2、文件加载顺序 非jar包环境 开发环境下: * 优先读取 resources/config 资源目录下的 application.yml 和 config.yml/config.properties 文件，如果读取成功，就不会继续加载 resources 下的其他配置文件。 * 默认会加载 application application-dev/application-prod application-test 这三个。 * dev test prod 会取决于 application 文件下的 active配置：假如是 dev 就会加载对应的 application-dev 文件。 * config.yml优先于config.properties * 3、jar包读取： * 优先读取与jar包同级下的 config目录下的资源文件，其次是与jar包同级的资源文件 其次就是读取 jar包内的资源文件。 * <p> * 4、自定义资源文件加载： * 支持文件 yml 和 properties 两种后缀的文件。不支持 xml文件。自定义文件的加载顺序，在前面者优先加载。 * <p> * <p> * 5、关于相同文件名：如果存在相同的文件名（包含路径不同）后者不会被加载。 * <p> * 6、取值问题：取值的顺序是 先加载的文件，后取值。会先取后面加载的资源文件的先，如果存在相同的key 后面的文件优先。 * <p> * * 暂时不支持直接读取 map 和 list 的配置 * * * * 例如： * * user: * * lists: * * - 张三 * * - 李四 * * - 王五 * 但是可以自定义格式：lists:[张三,李四,王五] or lists:张三,李四,王五 * * map格式： map:{name:tom,age:18} // * * * <p> * <p> * <p> * 7、自定义加载文件问题：加载系统资源文件务必上上 `classpath:` * 例如：classpath: user.config * 加载系统资源文件： 例如：/Users/yongjian/work/shell/config.properties * * @author 永健 * @since 2020-09-17 13:46 */ public class PropertiesUtils extends ConfigRead { /** * 加载文件 * <p> * 系统路径写法：系统路径：/Users/yongjian/application.yml * 类路径：classpath:application.yml 或者 classpath:spring/application.yml * * @param path 文件路径 */ private static void load(String... path) { if (path != null && path.length != 0) { for (int i = 0; i < path.length; i++) { String filePath = path[i].trim(); if (filePath.length() > 0) { System.out.println("加载资源文件："+filePath); } } } } /** * 获取属性值 * <p> * <p> * 加载顺序冲从上往下，读取顺序从下网上。 * application.yml * application-dev.yml * application-prod.yml * application-test.yml * config.yml * 自定义加载的文件 * * <p> * 获取顺序： 自定义加载的/config.yml/config.properties->prod/dev/test->application * 如果有重复的key,会优先于读取后面加载的文件key。 * * @param key key * @return 值 */ public static String getStringValue(String key, String defaultValue) { Object value = getObjectValue(key); return value == null ? defaultValue : String.valueOf(value); } public static String getStringValue(String key) { Object value = getObjectValue(key); return value == null ? null : String.valueOf(value); } public static int getIntValue(String key, Integer defaultValue) { Object value = getObjectValue(key); return value == null ? defaultValue : Integer.valueOf(value.toString()); } public static int getIntValue(String key) { Object value = getObjectValue(key); return value == null ? 0 : Integer.valueOf(value.toString()); } public static boolean getBooleanValue(String key, boolean defaultValue) { Object value = getObjectValue(key); return value == null ? defaultValue : Boolean.valueOf(value.toString()); } public static boolean getBooleanValue(String key) { Object value = getObjectValue(key); return value == null ? false : Boolean.valueOf(value.toString()); } public static <T> List<T> getList(String key) { Object value = getObjectValue(key); String vl = ""; if (value != null) { vl = value.toString().replaceAll(" ", ""); vl = vl.replace("[", "").replace("]", ""); String[] split = vl.split(","); return (List<T>) Arrays.asList(split); } return null; } public static Map<String, Object> getMap(String key) { Object value = getObjectValue(key); String vl = ""; if (value != null) { vl = value.toString(); return changeMap(vl); } return null; } private static Map<String, Object> changeMap(String vl) { Map<String, Object> map = null; vl = vl.replaceAll(" ", ""); if (vl.startsWith("{") && vl.endsWith("}")) { vl = vl.replace("{", "").replace("}", ""); String[] split = vl.split(","); map = new HashMap<>(); for (String item : split) { if (!item.contains(":")) { throw new RuntimeException("解析数据出错,请按照格式配置,例如：{name:tom,age:18}"); } String[] keyValues = item.split(":"); if (keyValues.length != 2 || "".equals(keyValues[0])) { throw new RuntimeException("解析数据出错,请按照格式配置,例如：{name:tom,age:18}"); } map.put(keyValues[0], keyValues[1]); } } return map; } } -
微信小程序相关接口包装工具；小程序获取Token解密 获取获取用户信息等
<dependency> <groupId>cn.yj.wechat</groupId> <artifactId>wechat</artifactId> <version>0.0.1</version> </dependency>
三、 项目配置说明
好像没有多少事需要特别注意的。不懂的可以私我。
-
高德key需要替换成自己的
applications: geoKey: 085f5a65cd254be133e74cbd5ee160c0456 -
小程序需要替换成自己的
applications:
wechat:
mini:
appId: wx53c2168b5ad5c0a525
secret: ded80da4f198338a061e1ae31480e1cc21
- 文件上传（自己封装的工具只实现了 本地图片上传和minio文件服务器上传，其它需要自己实现）
- 提供了上传文件接口 FileUpload.java
- 增加实现的话,需要重写
InitUploadImportSelector.java的selectImports(AnnotationMetadata annotationMetadata)方法,按需加载
。然后App启动类上替换成自己的@Import(value = {InitUploadImportSelector.class})将InitUploadImportSelector替换成自己的即可。 - file.upload-type: 指定系统实例化上传实现
file:
upload-type: LOCAL # MINIO(minio服务器)、LOCAL(本地上传)
local:
path: /Users/yongjian/work/file/ # 本地上传文件到目录 文件默认要加上 /。否则文件无法映射
host: http://127.0.0.1:${server.port}/${server.servlet.context-path}/localFile # 资源访问前缀
minio:
end:
point: http://thisforyou.cn:9004 # 两个填写一致就行了。这个是上传文件ip。内网的时候可以填写不一致
point1: http://thisforyou.cn:9004 # 这个是外网访问minio图片的ip
accessKey: minioadmin
secretKey: 123456
- 启动盲盒支付
- 在 service-wx-pay 模块中的配置文件 application-wxPay.yml。 wechat.pay.start：true 开启盲盒支付。默认不开启
- 引用微信支付模块需 注册 PayAutoConfig.class
# 微信
wechat:
pay:
start: true
appId: wx8944343 #小程序id
mchId: 12313123131 #商户id
mchSerialNo: 11
apiV3Key: 1
key-path: classpath:apiclient_key.pem
# 支付成功回调
pay-notice-url: https://aliyun.thisforyou.cn/api/pay/wxPayNotice
refund-notice-url: https://aliyun.thisforyou.cn/api/pay/wxRefundNotice
-
个人开发者在小程序授权的时候会失败，无法获取手机号（需要自行更改）
-
邮件配置（请查看application.email.yml）进行修改成自己的账号
四、项目演示地址：
请各位进入如后台的时候，不要删除必要数据，谢谢各位。
1、后台管理
-
PC后台管理
第一次访问可能有点慢，访问地址： https://aliyun.thisforyou.cn/server-view/#/login
账号：test/123456 （没有修改权限）
小程序
-
小程序
代码下载 地址:校园跑腿、校园脱单、代理、帮忙拿快递的微信小程序