# bbs

**Repository Path**: qianzhifeng/bbs

## Basic Information

- **Project Name**: bbs
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 2
- **Created**: 2019-08-14
- **Last Updated**: 2021-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# JavaBBS社区


## 简介
	1、JavaBBS是一款使用Java编写的简易社区系统。
	2、采用前后端分离的机制实现。前台项目通过http访问RESTFulAPI获取信息渲染页面。
	3、项目技术分层明显,模块分离，采用springboot构建模块。
	4、前台页面来自FlyUI的开源社区模板
    5、实现了异常/常用数据库/控制器 代码复用
    6、使用了DTO层封装数据，保证数据形式的一致

## 运行环境
- JDK 8
- Maven
- MySQL
- Redis


## 系统结构图
	1、quark-common :采用了Springdata+MySql实现基础服务抽象,DAO层，Entity以及DTO
	2、quark-admin：采用springboot+shiro搭建的细粒度的基于URL的权限管理系统，进行帖子管理，回复管理，用户管理等操作
	3、quark-rest：使用springMVC搭建RESTFul服务，采用WebSocket协议+stomp协议搭建推送服务，实现一对一推送与一对多推送，面向各个客户端
	4、quark-portal：前台社区系统，使用springMVC进行页面跳转与拦截，采用前后端分离的机制实现。前台展示模块通过http协议访问RESTFulAPI获取数据，
	使用LayUI，jQuery渲染页面渲染页面
	5、quark-chat:采用Netty+WebSocket协议搭建的聊天室服务，通过JSON传递数据，Ping-Pong心跳检测机制保证链路可用性。
	6、使用Redis进行了热点缓存，Ehcache进行数据库的二级缓存提高应用的效率
 ![image](https://raw.githubusercontent.com/jiujiujiujiujiuaia/bbs/master/resource/images/systemv2.png)  <br>
	

## 主要技术
- Springboot
- Netty
- thymeleaf
- swagger2
- Bootstrap
- LayUI

## swagger2生成的RESTFul API文档
(默认在http://loclhost:8081下)
 ![image](https://raw.githubusercontent.com/jiujiujiujiujiuaia/bbs/master/resource/images/quark_rest_1.JPG)  <br>
 ![image](https://raw.githubusercontent.com/jiujiujiujiujiuaia/bbs/master/resource/images/quark_rest_2.JPG)  <br>

## WebSocket聊天室
### 应用层协议
![image](https://raw.githubusercontent.com/jiujiujiujiujiuaia/bbs/master/resource/images/quark_chat_protocol.JPG)
 
		PING_CODE = 0x01;//Ping消息(client)
		PONG_CODE = 0x02;//Pong消息(server)
		AUTH_REQUEST_CODE = 0x03;//认证消息(client)
		AUTH_RESPONSE_CODE = 0x04;//认证消息(server)
		MESSAGE_REQUEST_CODE = 0x05;//消息(client)
		MESSAGE_RESPONSE_CODE = 0x06;//消息(server)
		SYS_USERSINFO_CODE = 0x07;//在线人数消息
		SYS_MESSAGE_CODE = 0x08;//系统消息
		SYS_ERRORMESSAGE_CODE = 0x09;//系统错误消息

### 通信模型
![image](https://raw.githubusercontent.com/jiujiujiujiujiuaia/bbs/master/resource/images/quark_chat_message.png) 

## 环境部署
	导入resource文件夹下的sql文件
	Redis服务器：默认端口
	Nginx部署图片服务器到目录：root   D:\home;
	后台管理员：账号：ycw 密码：root

## 效果图
![image](https://raw.githubusercontent.com/jiujiujiujiujiuaia/bbs/master/resource/images/quark_portal_1.JPG)  <br>
![image](https://raw.githubusercontent.com/jiujiujiujiujiuaia/bbs/master/resource/images/quark_portal_4.JPG)  <br>
![image](https://raw.githubusercontent.com/jiujiujiujiujiuaia/bbs/master/resource/images/quark_admin_1.JPG)  <br>
![image](https://raw.githubusercontent.com/jiujiujiujiujiuaia/bbs/master/resource/images/quark_chat.JPG)  <br>