人人开源框架使用 renren fast

2023-08-10 16:32:52

参考地址人人开源官网：

https://www.renren.io/guide/

1.介绍

1.1.项目描述

renren-fast 是一个轻量级的 Spring Boot 快速开发平台，能快速开发项目并交付【接私活利器】完善的 XSS 防范及脚本过滤，彻底杜绝 XSS 攻击，实现前后端分离，通过 token 进行数据交互推荐使用阿里云服务器部署项目，免费领取阿里云优惠券，请点击免费领取

1.2.获取帮助

后台地址：https://gitee.com/renrenio/renren-fast
element-ui地址：https://github.com/daxiongYang/renren-fast-vue
代码生成器：https://gitee.com/renrenio/renren-generator
如需关注项目最新动态或担心以后找不到项目，可以Watch、Star项目，同时也是对项目最好的支持

1.3.官方QQ群

高级群:324780204(大牛云集，跟大牛学习新技能)
普通群:145799952(学习交流，互相解答各种疑问)

2.快速开始

本项目是前后端分离的，需要先部署好后端，再部署前端页面，才能看到项目的页面效果。

2.1.后端部署

环境要求 JDK1.8 、 MySQL5.5+
通过 git ，下载renren-fast源码，如下:

git clone

git clone https://git.oschina.net/renrenio/renren-fast.git

用 idea 打开项目， File -> Open 如下图:
用 eclipse 打开项目，如下图:

创建数据库 renren_fast ，数据库编码为 UTF-8
执行 doc/db.sql 文件，初始化数据（默认支持MySQL）
修改 application-dev.yml ，更新MySQL账号和密码
运行 io.renren.RenrenApplication.java 的 main 方法，则可启动项目
Swagger路径：http://localhost:8080/renren-fast/swagger/index.html
Swagger注释路径：http://localhost:8080/renren-fast/swagger-ui.html

2.2.前端部署

renren-fast-vue基于vue、element-ui构建开发，实现renren-fast后台管理前端功能，
提供一套更优的前端解决方案。欢迎star或fork前端Git库，方便日后寻找，及二次开发。

开发环境，需要安装node8.x最新版
git clone
1. # 克隆项目
2. git clone https://github.com/daxiongYang/renren-fast-vue.git
3. # 安装依赖
4. npm install
5. # 启动服务
6. npm run dev
生成环境，打包并把dist目录文件，部署到Nginx里
git clone
1. # 构建生产环境(默认) npm run build
2. # 构建测试环境
3. npm run build --qa
4. # 构建验收环境
5. npm run build --uat
6. # 构建生产环境
7. npm run build --prod
8. # 安装Nginx，并配置Nginx server {
9. listen 80;
10. server_name localhost;
11. location / {
12. root E:\\renren-fast-vue; index index.html index.htm;
13. } }
14. # 启动Nginx后，访问如下路径即可 http://localhost
登录的账号密码：admin/admin

2.3.配置文件

conf file
1. # Tomcat
2. server:
3. tomcat:
4. uri-encoding: UTF-8
5. max-threads: 1000
6. min-spare-threads: 30
7. port: 8080 #tomcat端口号
8. context-path: /renren-fast
9. spring:
10. # 环境 dev|test|prod
11. profiles:
12. active: dev
13. # jackson时间格式化
14. jackson:
15. time-zone: GMT+8
16. date-format: yyyy-MM-dd HH:mm:ss
17. http:
18. multipart:
19. max-file-size: 100MB
20. max-request-size: 100MB
21. enabled: true
22. redis:
23. open: false # 是否开启redis缓存 true开启 false关闭
24. database: 0
25. host: localhost
26. port: 6379
27. password: # 密码（默认为空）
28. timeout: 6000 # 连接超时时长（毫秒）
29. pool:
30. max-active: 1000 # 连接池最大连接数（使用负值表示没有限制）
31. max-wait: -1 # 连接池最大阻塞等待时间（使用负值表示没有限制）
32. max-idle: 10 # 连接池中的最大空闲连接
33. min-idle: 5 # 连接池中的最小空闲连接
34. #mybatis
35. mybatis-plus:
36. mapper-locations: classpath:mapper/**/*.xml
37. #实体扫描，多个package用逗号或者分号分隔
38. typeAliasesPackage: io.renren.modules.*.entity
39. global-config:
40. #主键类型 0:"数据库ID自增", 1:"用户输入ID",2:"全局唯一ID (数字类型唯一ID)", 3:"全局唯一ID UUID";
41. id-type: 0
42. #字段策略 0:"忽略判断",1:"非 NULL 判断"),2:"非空判断"
43. field-strategy: 2
44. #驼峰下划线转换
45. db-column-underline: true
46. #刷新mapper 调试神器
47. refresh-mapper: true
48. #数据库大写下划线转换
49. #capital-mode: true
50. #序列接口实现类配置
51. #key-generator: com.baomidou.springboot.xxx
52. #逻辑删除配置
53. logic-delete-value: -1
54. logic-not-delete-value: 0
55. #自定义填充策略接口实现
56. #meta-object-handler: com.baomidou.springboot.xxx
57. #自定义SQL注入器
58. sql-injector: com.baomidou.mybatisplus.mapper.LogicSqlInjector
59. configuration:
60. map-underscore-to-camel-case: true
61. cache-enabled: false
62. call-setters-on-nulls: true
63. renren:
64. # APP模块，是通过jwt认证的，如果要使用APP模块，则需要修改【加密秘钥】
65. jwt:
66. # 加密秘钥
67. secret: f4e2e52034348f86b67cde581c0f9eb5[www.renren.io]
68. # token有效时长，7天，单位秒
69. expire: 604800
70. header: token
71. # 数据库配置
72. spring:
73. datasource:
74. type: com.alibaba.druid.pool.DruidDataSource
75. driverClassName: com.mysql.jdbc.Driver
76. druid:
77. first: #数据源1
78. url: jdbc:mysql://localhost:3306/renren_fast?allowMultiQueries=true&useUnicode=true&characterEncoding=UTF-8
79. username: renren
80. password: 123456
81. second: #数据源2
82. url: jdbc:mysql://localhost:3306/bdshop?allowMultiQueries=true&useUnicode=true&characterEncoding=UTF-8
83. username: renren
84. password: 123456
85. initial-size: 10
86. max-active: 100
87. min-idle: 10
88. max-wait: 60000

2.4.数据交互

一般情况下，web项目都是通过session进行认证，每次请求数据时，都会把jsessionid放在cookie中，以便与服务端保持会话

本项目是前后端分离的，通过token进行认证（登录时，生成唯一的token凭证），每次请求数据时，都会把token放在header中，服务端解析token，并确定用户身份及用户权限，数据通过json交互

数据交互流程：

3.项目实战

3.1.功能描述

我们来完成一个商品的列表、添加、修改、删除功能，熟悉如何快速开发自己的业务功能模块。

我们先建一个商品表tb_goods，表结构如下所示：
create table
1. CREATE TABLE `tb_goods` (
2. `goods_id` bigint NOT NULL AUTO_INCREMENT,
3. `name` varchar(50) COMMENT '商品名',
4. `intro` varchar(500) COMMENT '介绍',
5. `price` decimal(10,2) COMMENT '价格',
6. `num` int COMMENT '数量',
7. PRIMARY KEY (`goods_id`)
8. ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='商品管理';
接下来，我们利用代码生成器，帮我们生成基础代码，可以大大的节省重复工作量，代码生成器Git地址：https://gitee.com/renrenio/renren-generator

3.2.使用代码生成器

代码生成器是Spring Boot开发的项目，通过git clone把项目下载到本地后，直接运行main方法，就可以通过http://localhost打开，我们先来看看配置文件，如下所示：
conf file
1. #配置文件：generator.properties
2. #包名
3. package=io.renren.modules.generator
4. #作者
5. author=chenshun
6. #Email
7. email=sunlightcs@gmail.com
8. #表前缀(类名不会包含表前缀)
9. tablePrefix=tb_
10. #类型转换，配置信息
11. tinyint=Integer
12. smallint=Integer
13. mediumint=Integer
14. int=Integer
15. integer=Integer
16. bigint=Long
17. float=Float
18. double=Double
19. decimal=BigDecimal
20. bit=Boolean
21. char=String
22. varchar=String
23. tinytext=String
24. text=String
25. mediumtext=String
26. longtext=String
27. date=Date
28. datetime=Date
29. timestamp=Date
上面的配置文件，可以配置包名、作者信息、表前缀、类型转换。其中，类型转换是指，MySQL中的类型与JavaBean中的类型，是怎么一个对应关系。如果有缺少的类型，可自行在generator.properties文件中补充。

再看看application.yml配置文件，我们只要修改数据库名、账号、密码，就可以了。其中，数据库名是指待生成的表，所在的数据库。
conf file
1. # Tomcat
2. server:
3. tomcat:
4. max-threads: 10
5. min-spare-threads: 10
6. port: 80
7. # mysql
8. spring:
9. datasource:
10. type: com.alibaba.druid.pool.DruidDataSource
11. driverClassName: com.mysql.jdbc.Driver
12. url: jdbc:mysql://localhost:3306/renren_fast?useUnicode=true&characterEncoding=UTF-8
13. username: renren
14. password: 123456
15. jackson:
16. time-zone: GMT+8
17. date-format: yyyy-MM-dd HH:mm:ss
18. resources:
19. static-locations: classpath:/static/,classpath:/views/
20. # Mybatis配置
21. mybatis:
22. mapperLocations: classpath:mapper/**/*.xml
在数据库renren_fast中，执行建表语句，创建tb_goods表，再启动renren-generator项目(运行RenrenApplication.java的main方法即可)，如下所示：

我们只需勾选tb_goods，点击【生成代码】按钮，则可生成相应代码，如下所示：

3.3.测试项目

我们先在renren_fast库中，执行goods_menu.sql语句，这个SQL是生成菜单的，SQL语句如下所示：
create table
1. -- 菜单SQL
2. INSERT INTO `sys_menu` (`parent_id`, `name`, `url`, `perms`, `type`, `icon`, `order_num`)
3. VALUES ('1', '商品管理', 'modules/generator/goods.html', NULL, '1', 'fa fa-file-code-o', '6');
4. -- 按钮父菜单ID
5. set @parentId = @@identity;
6. -- 菜单对应按钮SQL
7. INSERT INTO `sys_menu` (`parent_id`, `name`, `url`, `perms`, `type`, `icon`, `order_num`)
8. SELECT @parentId, '查看', null, 'goods:list,goods:info', '2', null, '6';
9. INSERT INTO `sys_menu` (`parent_id`, `name`, `url`, `perms`, `type`, `icon`, `order_num`)
10. SELECT @parentId, '新增', null, 'goods:save', '2', null, '6';
11. INSERT INTO `sys_menu` (`parent_id`, `name`, `url`, `perms`, `type`, `icon`, `order_num`)
12. SELECT @parentId, '修改', null, 'goods:update', '2', null, '6';
13. INSERT INTO `sys_menu` (`parent_id`, `name`, `url`, `perms`, `type`, `icon`, `order_num`)
14. SELECT @parentId, '删除', null, 'goods:delete', '2', null, '6';
然后把生成的main目录覆盖renren-fast的main目录，再重启renren-fast，效果如下所示：