人人开源框架使用 renren fast

参考地址人人开源官网：

• 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

1. 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，效果如下所示：

• 

• 

• 

• 

• 我们就操作了这几步，就把查询、新增、修改、删除就完成了，是不是很快啊，下面就是我们才生成的代码，如下所示：

• 

捐赠获取完整版