人人開源框架使用 renren fast

本文轉載自查看原文 2018-11-28 21:39 4972 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

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